ptsname(3)

НАИМЕНОВАНИЕ
ptsname, ptsname_r - возвращает имя подчинённого псевдо-терминала

БИБЛИОТЕКА
Стандартная библиотека языка C (libc, -lc)

СИНТАКСИС
#include <stdlib.h>

char *ptsname(int fd);
int ptsname_r(size_t size;
              int fd, char buf[size], size_t size);

    Требования макроса тестирования свойств для glibc (см. feature_test_macros(7)):

ptsname():
    Начиная с glibc 2.24:
        _XOPEN_SOURCE >= 500
    В версии glibc 2.23 и более ранних:
        _XOPEN_SOURCE

ptsname_r():
    _GNU_SOURCE

ОПИСАНИЕ
The ptsname() function returns the name of the slave pseudoterminal device corresponding to the master referred to by the file descriptor fd.

The ptsname_r() function is the reentrant equivalent of ptsname(). It returns the name of the slave pseudoterminal device as a null-terminated string in the buffer pointed to by buf. The size argument specifies the number of bytes available in buf.

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ
При успешном выполнении ptsname() возвращает указатель на строку в статическом хранилище, которая будет перезаписана последующими вызовами. Данный указатель не нужно освобождать. При ошибке возвращается NULL.

On success, ptsname_r() returns 0. On failure, an error number is returned to indicate the error.

ОШИБКИ

EINVAL
    (только ptsname_r()) Значение buf равно NULL (эта ошибка возвращается только в glibc 2.25 и старее).

ENOTTY
    Значение fd не ссылается на устройство главного псевдо-терминала.

ERANGE
    (только ptsname_r()) Значение buf слишком мало.

АТРИБУТЫ
Описание терминов данного раздела смотрите в attributes(7).
Интерфейс | Атрибут | Значение
ptsname() | Безвредность в нитях | MT-Unsafe race:ptsname
ptsname_r() | Безвредность в нитях | MT-Safe

ВЕРСИИ
A version of ptsname_r() is documented on Tru64, HP-UX, and FreeBSD, but on those implementations, -1 is returned on error, with errno set to indicate the error. Avoid using this function in portable programs.

СТАНДАРТЫ

ptsname():
    POSIX.1-2008.

ptsname_r():
    POSIX.1-2024.

ИСТОРИЯ

ptsname():
    POSIX.1-2001. glibc 2.1.

Функция ptsname() является частью поддержки псевдо-терминалов UNIX 98 (смотрите pts(4)).

ptsname_r():
    GNU.

СМОТРИТЕ ТАКЖЕ
grantpt(3), posix_openpt(3), ttyname(3), unlockpt(3), pts(4), pty(7)

ПЕРЕВОД
Русский перевод этой страницы руководства разработал(и) 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>

Этот перевод является свободной программной документацией; он распространяется на условиях общедоступной лицензии GNU (GNU General Public License - GPL, https://www.gnu.org/licenses/gpl-3.0.html версии 3 или более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ.

Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите об этом разработчику(ам) по его(их) адресу(ам) электронной почты или по адресу списка рассылки русских переводчиков (debian-l10n-russian@lists.debian.org).