ptsname(3) Library Functions Manual ptsname(3) NAZWA ptsname, ptsname_r - uzyskuje nazwe podrzednego urzadzenia pseudoterminala BIBLIOTEKA Standardowa biblioteka C (libc, -lc) SKLADNIA #include char *ptsname(int fd); int ptsname_r(size_t size; int fd, char buf[size], size_t size); Wymagane ustawienia makr biblioteki glibc (patrz feature_test_macros(7)): ptsname(): Od glibc 2.24: _XOPEN_SOURCE >= 500 glibc 2.23 i wczesniejsze: _XOPEN_SOURCE ptsname_r(): _GNU_SOURCE OPIS Funkcja ptsname() zwraca nazwe podrzednego urzadzenia pseudoterminala zwiazanego z urzadzeniem nadrzednym, do ktorego odnosi sie deskryptor pliku fd. Funkcja ptsname_r() jest wielobieznym odpowiednikiem ptsname(). Zwraca nazwe podrzednego urzadzenia pseudoterminala jako lancuch zakonczony znakiem null w buforze, na ktory wskazuje buf. Argument size okresla liczbe bajtow dostepnych w buf. WARTOSC ZWRACANA W przypadku powodzenia, ptsname() zwraca wskaznik do lancucha w magazynie statycznym, ktory zostanie nadpisany kolejnymi wywolaniami. Wskaznika nie mozna zwalniac. W przypadku niepowodzenia, zwracane jest NULL. W przypadku powodzenia ptsname_r() zwraca zero. W razie niepowodzenia zwracany jest numer bledu, wskazujac blad. BLEDY EINVAL (tylko ptsname_r()) buf wynosi NULL (blad zwracany tylko w przypadku glibc 2.25 i wczesniejszej). ENOTTY fd nie odnosi sie do nadrzednego urzadzenia pseudoterminala. ERANGE (tylko ptsname_r()) buf jest zbyt maly. ATRYBUTY Informacje o pojeciach uzywanych w tym rozdziale mozna znalezc w podreczniku attributes(7). +-----------+--------------------------+-------------------------------+ |Interfejs | Atrybut | Wartosc | +-----------+--------------------------+-------------------------------+ |ptsname() | Bezpieczenstwo watkowe | MT-niebezpieczne race:ptsname | +-----------+--------------------------+-------------------------------+ |ptsname_r()| Bezpieczenstwo watkowe | MT-bezpieczne | +-----------+--------------------------+-------------------------------+ WERSJE Wersje ptsname_r() udokumentowano na Tru64 i HP-UX, jednak w tych implementacjach przy bledzie zwracane jest -1, z ustawionym errno wskazujacym blad. Nalezy unikac tej funkcji w przenosnych programach. STANDARDY ptsname(): POSIX.1-2008. ptsname_r() jest rozszerzeniem systemu Linux, ktore zaproponowano do nastepnego glownego wydania POSIX.1 (wydanie 8). HISTORIA ptsname(): POSIX.1-2001. glibc 2.1. ptsname() jest czescia obslugi pseudoterminali UNIX 98 (zob. pts(4)). ZOBACZ TAKZE grantpt(3), posix_openpt(3), ttyname(3), unlockpt(3), pts(4), pty(7) TLUMACZENIE Tlumaczenie niniejszej strony podrecznika: Michal Kulach Niniejsze tlumaczenie jest wolna dokumentacja. Blizsze informacje o warunkach licencji mozna uzyskac zapoznajac sie z GNU General Public License w wersji 3 lub nowszej. Nie przyjmuje sie ZADNEJ ODPOWIEDZIALNOSCI. Bledy w tlumaczeniu strony podrecznika prosimy zglaszac na adres listy dyskusyjnej . Linux man-pages 6.15 28 czerwca 2025 r. ptsname(3)