.\" -*- 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 "5 февраля 2023 г." "Linux man\-pages 6.03" 
.SH ИМЯ
ptsname, ptsname_r \- возвращает имя подчинённого псевдо\-терминала
.SH LIBRARY
Standard C library (\fIlibc\fP, \fI\-lc\fP)
.SH СИНТАКСИС
.nf
\fB#include <stdlib.h>\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 ВЕРСИИ
\fBptsname\fP()  is provided since glibc 2.1.
.SH АТРИБУТЫ
Описание терминов данного раздела смотрите в \fBattributes\fP(7).
.ad l
.nh
.TS
allbox;
lbx lb lb
l l l.
Интерфейс	Атрибут	Значение
T{
\fBptsname\fP()
T}	Безвредность в нитях	MT\-Unsafe race:ptsname
T{
\fBptsname_r\fP()
T}	Безвредность в нитях	MT\-Safe
.TE
.hy
.ad
.sp 1
.SH СТАНДАРТЫ
.TP 
\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)
.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 .