.\" -*- coding: UTF-8 -*-
.\" %%%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 "9 июня 2020 г." "" "Руководство программиста Linux"
.SH ИМЯ
ptsname, ptsname_r \- возвращает имя подчинённого псевдо\-терминала
.SH СИНТАКСИС
\fB#include <stdlib.h>\fP
.PP
\fBchar *ptsname(int \fP\fIfd\fP\fB);\fP
.br
\fBint ptsname_r(int \fP\fIfd\fP\fB, char *\fP\fIbuf\fP\fB, size_t \fP\fIbuflen\fP\fB);\fP
.PP
.RS -4
Требования макроса тестирования свойств для glibc
(см. \fBfeature_test_macros\fP(7)):
.RE
.PP
.ad l
\fBptsname\fP():
.br
.RS 4
начиная с glibc 2.24:
    _XOPEN_SOURCE\ >=\ 500 ||
        (_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED)
.br
glibc 2.23 и старее:
    _XOPEN_SOURCE
.RE
.PP
\fBptsname_r\fP():
    _GNU_SOURCE
.ad
.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 ВЕРСИИ
Функция \fBptsname\fP() появилась в glibc версии 2.1.
.SH АТРИБУТЫ
Описание терминов данного раздела смотрите в \fBattributes\fP(7).
.TS
allbox;
lb lb lb
l l l.
Интерфейс	Атрибут	Значение
T{
\fBptsname\fP()
T}	Безвредность в нитях	MT\-Unsafe race:ptsname
T{
\fBptsname_r\fP()
T}	Безвредность в нитях	MT\-Safe
.TE
.SH "СООТВЕТСТВИЕ СТАНДАРТАМ"
\fBptsname\fP():
 POSIX.1\-2001, POSIX.1\-2008.
.PP
Функция \fBptsname\fP() является частью поддержки псевдо\-терминалов UNIX 98
(смотрите \fBpts\fP(4)).
.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() является расширением Linux, которую предполагается
включить в следующую большую версию POSIX.1 (Issue 8). Версия этой функции
описана в Tru64 и HP\-UX, но в их реализациях при ошибке возвращается \-1, а в
\fIerrno\fP записывается номер ошибки. Не используйте эту функцию в переносимых
программах.
.SH "СМ. ТАКЖЕ"
\fBgrantpt\fP(3), \fBposix_openpt\fP(3), \fBttyname\fP(3), \fBunlockpt\fP(3), \fBpts\fP(4),
\fBpty\fP(7)
.SH ЗАМЕЧАНИЯ
Эта страница является частью проекта Linux \fIman\-pages\fP версии
5.10. Описание проекта, информацию об ошибках и последнюю версию этой
страницы можно найти по адресу \%https://www.kernel.org/doc/man\-pages/.
.PP
.SH ПЕРЕВОД
Русский перевод этой страницы руководства был сделан
Alexey,
Azamat Hackimov <azamat.hackimov@gmail.com>,
kogamatranslator49 <r.podarov@yandex.ru>,
Kogan,
Max Is <ismax799@gmail.com>,
Yuri Kozlov <yuray@komyakino.ru>
и
Иван Павлов <pavia00@gmail.com>
.
.PP
Этот перевод является бесплатной документацией; прочитайте
.UR https://www.gnu.org/licenses/gpl-3.0.html
Стандартную общественную лицензию GNU версии 3
.UE
или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.
.PP
Если вы обнаружите ошибки в переводе этой страницы руководства,
пожалуйста, отправьте электронное письмо на
.MT man-pages-ru-talks@lists.sourceforge.net
.ME .