.\" -*- coding: UTF-8 -*- '\" t .\" %%%LICENSE_START(PUBLIC_DOMAIN) .\" This page is in the public domain. - aeb .\" %%%LICENSE_END .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH ptsname 3 "29 октября 2025 г." "Справочные страницы Linux 6.17" .SH НАИМЕНОВАНИЕ ptsname, ptsname_r \- возвращает имя подчинённого псевдо\-терминала .SH БИБЛИОТЕКА Стандартная библиотека языка C (\fIlibc\fP,\ \fI\-lc\fP) .SH ОБЗОР .nf \fB#include \fP .P \fBchar *ptsname(int \fP\fIfd\fP\fB);\fP \fBint ptsname_r(\fPsize_t size; \fB int \fP\fIfd\fP\fB, char \fP\fIbuf\fP\fB[\fP\fIsize\fP\fB], size_t \fP\fIsize\fP\fB);\fP .fi .P .RS -4 Требования макроса тестирования свойств для glibc (см. \fBfeature_test_macros\fP(7)): .RE .P \fBptsname\fP(): .nf .\" || (_XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED) Начиная с glibc 2.24: _XOPEN_SOURCE >= 500 В версии glibc 2.23 и более ранних: _XOPEN_SOURCE .fi .P \fBptsname_r\fP(): .nf _GNU_SOURCE .fi .SH ОПИСАНИЕ The \fBptsname\fP() function returns the name of the slave pseudoterminal device corresponding to the master referred to by the file descriptor \fIfd\fP. .P The \fBptsname_r\fP() function is the reentrant equivalent of \fBptsname\fP(). It returns the name of the slave pseudoterminal device as a null\-terminated string in the buffer pointed to by \fIbuf\fP. The \fIsize\fP argument specifies the number of bytes available in \fIbuf\fP. .SH "ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ" При успешном выполнении \fBptsname\fP() возвращает указатель на строку в статическом хранилище, которая будет перезаписана последующими вызовами. Данный указатель не нужно освобождать. При ошибке возвращается NULL. .P .\" In glibc, the error number is not only returned as the return value .\" but also stored in errno. But this is not true for musl libc. On success, \fBptsname_r\fP() returns 0. On failure, an error number is returned to indicate the error. .SH ОШИБКИ .TP \fBEINVAL\fP .\" glibc commit 8f0a947cf55f3b0c4ebdf06953c57eff67a22fa9 (только \fBptsname_r\fP()) Значение \fIbuf\fP равно NULL (эта ошибка возвращается только в glibc 2.25 и старее). .TP \fBENOTTY\fP Значение \fIfd\fP не ссылается на устройство главного псевдо\-терминала. .TP \fBERANGE\fP (только \fBptsname_r\fP()) Значение \fIbuf\fP слишком мало. .SH АТРИБУТЫ Описание терминов данного раздела смотрите в \fBattributes\fP(7). .TS allbox; lbx lb lb l l l. Интерфейс Атрибут Значение T{ .na .nh \fBptsname\fP() T} Безвредность в нитях MT\-Unsafe race:ptsname T{ .na .nh \fBptsname_r\fP() T} Безвредность в нитях MT\-Safe .TE .SH ВЕРСИИ A version of \fBptsname_r\fP() is documented on Tru64, HP\-UX, and FreeBSD, but on those implementations, \-1 is returned on error, with \fIerrno\fP set to indicate the error. Avoid using this function in portable programs. .SH СТАНДАРТЫ .TP \fBptsname\fP(): POSIX.1\-2008. .TP \fBptsname_r\fP(): POSIX.1\-2024. .SH ИСТОРИЯ .TP \fBptsname\fP(): POSIX.1\-2001. glibc 2.1. .P Функция \fBptsname\fP() является частью поддержки псевдо\-терминалов UNIX 98 (смотрите \fBpts\fP(4)). .TP \fBptsname_r\fP(): GNU. .SH "СМОТРИТЕ ТАКЖЕ" \fBgrantpt\fP(3), \fBposix_openpt\fP(3), \fBttyname\fP(3), \fBunlockpt\fP(3), \fBpts\fP(4), \fBpty\fP(7) .PP .SH ПЕРЕВОД Русский перевод этой страницы руководства разработал(и) Alexey, Azamat Hackimov , kogamatranslator49 , Darima Kogan , Max Is , Yuri Kozlov и Иван Павлов . .PP Этот перевод является свободной программной документацией; он распространяется на условиях общедоступной лицензии GNU (GNU General Public License - GPL, .UR https://www.gnu.org/licenses/gpl-3.0.html .UE версии 3 или более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ. .PP Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите об этом разработчику(ам) по его(их) адресу(ам) электронной почты или по адресу .MT списка рассылки русских переводчиков .ME .