.\" -*- 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 6.03" 
.SH НАИМЕНОВАНИЕ
ptsname, ptsname_r \- возвращает имя подчинённого псевдо\-терминала
.SH БИБЛИОТЕКА
Стандартная библиотека языка C (\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>,
Darima Kogan <silverdk99@gmail.com>,
Max Is <ismax799@gmail.com>,
Yuri Kozlov <yuray@komyakino.ru>,
Иван Павлов <pavia00@gmail.com>
и
Kirill Rekhov <krekhov.dev@gmail.com>
.
.PP
Этот перевод является свободной программной документацией; он распространяется
на условиях общедоступной лицензии GNU (GNU General Public License - GPL,
.UR https://www.gnu.org/licenses/gpl-3.0.html
.UE
версии 3 или более поздней) в отношении
авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ.
.PP
Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста,
сообщите об этом разработчику(ам) по его(их) адресу(ам) электронной почты или по адресу
.MT <debian-l10n-russian@lists.debian.org>
списка рассылки русских переводчиков
.ME .