Man page - ptsname(3)

Packages contains this manual

Available languages:

en fr pl ja ru ro

Manual

ptsname

NAZWA
BIBLIOTEKA
SKŁADNIA
OPIS
WARTOŚĆ ZWRACANA
BŁĘDY
ATRYBUTY
WERSJE
STANDARDY
HISTORIA
ZOBACZ TAKŻE
TŁUMACZENIE

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 );

Wymagane ustawienia makr biblioteki glibc (patrz feature_test_macros (7)):

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).

Image grohtml-3996499-1.png

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

Tłumaczenie niniejszej strony podręcznika: 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 .