NAZWA¶

ptsname, ptsname_r - uzyskuje nazwę podrzędnego urządzenia pseudoterminala

BIBLIOTEKA¶

Standardowa biblioteka C (libc, -lc)

SKŁADNIA¶

#include <stdlib.h>

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

ptsname():

    Od glibc 2.24:


        _XOPEN_SOURCE >= 500


    glibc 2.23 i wcześniejsze:


        _XOPEN_SOURCE

ptsname_r():

    _GNU_SOURCE

OPIS¶

Funkcja ptsname() zwraca nazwę podrzędnego urządzenia pseudoterminala związanego z urządzeniem nadrzędnym, do którego odnosi się deskryptor pliku fd.

Funkcja ptsname_r() jest wielobieżnym odpowiednikiem ptsname(). Zwraca nazwę podrzędnego urządzenia pseudoterminala jako łańcuch zakończono znakiem null w buforze, na który wskazuje buf. Argument buflen określa liczbę bajtów dostępnych w buf.

WARTOŚĆ ZWRACANA¶

W przypadku powodzenia, ptsname() zwraca wskaźnik do łańcucha w magazynie statycznym, który zostanie nadpisany kolejnymi wywołaniami. Wskaźnika nie można zwalniać. W przypadku niepowodzenia, zwracane jest NULL.

W przypadku powodzenia ptsname_r() zwraca zero. W razie niepowodzenia zwracany jest numer błędu, wskazując błąd.

BŁĘDY¶

EINVAL

(tylko ptsname_r()) buf wynosi NULL (błąd zwracany tylko w przypadku glibc 2.25 i wcześniejszej).

ENOTTY

fd nie odnosi się do nadrzędnego urządzenia pseudoterminala.

ERANGE

(tylko ptsname_r()) buf jest zbyt mały.

ATRYBUTY¶

Informacje o pojęciach używanych w tym rozdziale można znaleźć w podręczniku attributes(7).

WERSJE¶

Wersję ptsname_r() udokumentowano na Tru64 i HP-UX, jednak w tych implementacjach przy błędzie zwracane jest -1, z ustawionym errno wskazującym błąd. Należy unikać tej funkcji w przenośnych programach.

STANDARDY¶

ptsname():

POSIX.1-2008.

ptsname_r() jest rozszerzeniem systemu Linux, które zaproponowano do następnego głównego wydania POSIX.1 (wydanie 8).

HISTORIA¶

ptsname():

POSIX.1-2001. glibc 2.1.

ptsname() jest częścią obsługi pseudoterminali UNIX 98 (zob. pts(4)).

ZOBACZ TAKŻE¶

grantpt(3), posix_openpt(3), ttyname(3), unlockpt(3), pts(4), pty(7)

TŁUMACZENIE¶

Autorami polskiego tłumaczenia niniejszej strony podręcznika są: Michał Kułach <michal.kulach@gmail.com>

Niniejsze tłumaczenie jest wolną dokumentacją. Bliższe informacje o warunkach licencji można uzyskać zapoznając się z GNU General Public License w wersji 3 lub nowszej. Nie przyjmuje się ŻADNEJ ODPOWIEDZIALNOŚCI.

Błędy w tłumaczeniu strony podręcznika prosimy zgłaszać na adres listy dyskusyjnej manpages-pl-list@lists.sourceforge.net.