.\" -*- coding: UTF-8 -*- '\" t .\" %%%LICENSE_START(PUBLIC_DOMAIN) .\" This page is in the public domain. - aeb .\" %%%LICENSE_END .\" .\" 2004-12-17, mtk, added description of ptsname_r() + ERRORS .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH ptsname 3 "20 июля 2023 г." "Linux man\-pages 6.05.01" .SH ИМЯ ptsname, ptsname_r \- возвращает имя подчинённого псевдо\-терминала .SH LIBRARY Standard C library (\fIlibc\fP, \fI\-lc\fP) .SH СИНТАКСИС .nf \fB#include \fP .PP \fBchar *ptsname(int \fP\fIfd\fP\fB);\fP \fBint ptsname_r(int \fP\fIfd\fP\fB, char \fP\fIbuf\fP\fB[.\fP\fIbuflen\fP\fB], size_t \fP\fIbuflen\fP\fB);\fP .fi .PP .RS -4 Требования макроса тестирования свойств для glibc (см. \fBfeature_test_macros\fP(7)): .RE .PP \fBptsname\fP(): .nf .\" || (_XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED) Начиная с glibc 2.24: _XOPEN_SOURCE >= 500 В версии glibc 2.23 и более ранних: _XOPEN_SOURCE .fi .PP \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. .PP Функция \fBptsname_r\fP() является реентерабельным эквивалентном \fBptsname\fP(). Она сохраняет имя устройства подчинённого псевдо\-терминала в виде строки (завершающейся null) в буфер, указанный в \fIbuf\fP. В аргументе \fIbuflen\fP задаётся количество байт, доступных в \fIbuf\fP. .SH "ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ" При успешном выполнении \fBptsname\fP() возвращает указатель на строку в статическом хранилище, которая будет перезаписана последующими вызовами. Данный указатель не нужно освобождать. При ошибке возвращается NULL. .PP .\" 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 .sp 1 .SH ВЕРСИИ A version of \fBptsname_r\fP() is documented on Tru64 and HP\-UX, 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. .PP .\" FIXME . for later review when Issue 8 is one day released .\" http://austingroupbugs.net/tag_view_page.php?tag_id=8 .\" http://austingroupbugs.net/view.php?id=508 \fBptsname_r\fP() is a Linux extension, that is proposed for inclusion in the next major revision of POSIX.1 (Issue 8). .SH ИСТОРИЯ .TP \fBptsname\fP(): POSIX.1\-2001. glibc 2.1. .PP Функция \fBptsname\fP() является частью поддержки псевдо\-терминалов UNIX 98 (смотрите \fBpts\fP(4)). .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 , Kogan, Max Is , Yuri Kozlov и Иван Павлов . .PP Этот перевод является бесплатной документацией; прочитайте .UR https://www.gnu.org/licenses/gpl-3.0.html Стандартную общественную лицензию GNU версии 3 .UE или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ. .PP Если вы обнаружите ошибки в переводе этой страницы руководства, пожалуйста, отправьте электронное письмо на .MT man-pages-ru-talks@lists.sourceforge.net .ME .