ptsname(3C)                                                     ptsname(3C)

NAME
     ptsname - Name der Slave-Pseudo-Datensichtstation ermitteln

SYNTAX
     #include <stdlib.h>

     char *ptsname(int fildes);

BESCHREIBUNG
     Die Funktion ptsname() liefert den Namen der Slave-Pseudo-Datensicht-
     station, die einer Master-Pseudo-Datensichtstation zugeordnet ist.
     fildes ist eine Dateikennzahl, die von einem erfolgreichen Öffnen der
     Haupt-Pseudo-Datensichtstation geliefert wurde. ptsname() liefert
     einen Zeiger auf eine Zeichenkette, die den mit dem Nullbyte abge-
     schlossenen Pfadnamen des Slave-Geräts in der Form /dev/pts/N enthält,
     wobei N eine ganze Zahl zwischen 0 und 255 ist.

DIAGNOSE
     Bei erfolgreicher Beendigung liefert die Funktion ptsname() einen Zei-
     ger auf eine Zeichenkette, die den Namen der Slave-Pseudo-
     Datensichtstation enthält. Dieser Zeiger zeigt auf einen statischen
     Datenbereich, der bei jedem Aufruf von ptsname() überschrieben wird.

     Im Fehlerfall liefert ptsname() den Wert 0. Dies kann auftreten wenn
     fildes keine gültige Dateikennzahl ist oder wenn der Name des Slave-
     Geräts im Dateisystem nicht existiert.

SIEHE AUCH
     open(2), grantpt(3C), ttyname(3C), unlockpt(3C).


























Seite 1                      Reliant UNIX 5.44               Gedruckt 11/98