BEZEICHNUNG

       ttyname, ttyname_r - den Namen eines Terminals zurückgeben

ÜBERSICHT

       #include <unistd.h>

       char *ttyname(int dd);

       int ttyname_r(int dd, char *puffer,
                     size_t pufferlaenge);

BESCHREIBUNG

       Die  Funktion  ttyname()  gibt  einen  Zeiger  auf einen Null-terminierten Pfadnamen des Terminal-Gerätes
       zurück, das mit dem Dateideskriptor dd geöffnet ist, oder bei einem Fehler NULL (zum  Beispiel,  wenn  dd
       nicht  mit  einem  Terminal  verbunden  ist).  Der  Rückgabewert  kann  auf  statische  Daten zeigen, die
       möglicherweise beim nächsten Aufruf überschrieben  werden.  Die  Funktion  ttyname_r()  speichert  diesen
       Pfadnamen im Puffer puffer, der die Länge pufferlaenge hat.

RÜCKGABEWERT

       Die  Funktion  ttyname()  gibt  bei Erfolg einen Zeiger auf einen Pfadnamen zurück. Bei einem Fehler wird
       NULL zurückgegeben und errno entsprechend gesetzt. Die Funktion ttyname_r() gibt bei Erfolg 0 zurück  und
       bei einem Fehler eine Fehlernummer.

FEHLER

       EBADF  falscher Datei-Deskriptor

       ENODEV dd  bezieht  sich auf ein Slave-Pseudoterminal-Gerät, aber der entsprechende Pfadname konnte nicht
              gefunden werden (siehe ANMERKUNGEN).

       ENOTTY dd bezieht sich nicht auf ein Terminal-Gerät.

       ERANGE (ttyname_r())  pufferlaenge war zu klein, um den Pfadnamen aufzunehmen.

ATTRIBUTE

       Siehe attributes(7) für eine Erläuterung der in diesem Abschnitt verwandten Ausdrücke.
       ┌───────────────┬───────────────────────┬────────────────────────┐
       │ Schnittstelle │ Attribut              │ Wert                   │
       ├───────────────┼───────────────────────┼────────────────────────┤
       │ ttyname()     │ Multithread-Fähigkeit │ MT-Unsafe race:ttyname │
       ├───────────────┼───────────────────────┼────────────────────────┤
       │ ttyname_r()   │ Multithread-Fähigkeit │ MT-Safe                │
       └───────────────┴───────────────────────┴────────────────────────┘

KONFORM ZU

       POSIX.1-2001, POSIX.1-2008, 4.2BSD.

ANMERKUNGEN

       Ein Prozess, der einen Dateideskriptor, der sich auf ein pts(4)-Gerät bezieht, beim Umschalten auf  einen
       anderen  Einhängenamensraum,  der eine andere /dev/ptmx-Instanz verwendet, geöffnet hält, kann immer noch
       zufälligerweise herausfinden,  dass  ein  Gerätepfad  des  gleichen  Namens  für  diesen  Dateideskriptor
       existiert.  Allerdings  bezieht  sich  dieser  Gerätepfad  auf ein anderes Gerät und kann daher nicht zum
       Zugriff auf das Gerät, auf das sich der Dateideskriptor bezieht, verwandt  werden.  Wird  ttyname()  oder
       ttyname_r()  mit  dem Dateideskriptor in dem neuen Namensraum aufgerufen, dann werden die Funktionen NULL
       zurückliefern und errno auf ENODEV setzen.

SIEHE AUCH

       tty(1), fstat(2), ctermid(3), isatty(3), pts(4)

KOLOPHON

       Diese Seite ist Teil der Veröffentlichung  5.10  des  Projekts  Linux-man-pages.  Eine  Beschreibung  des
       Projekts, Informationen, wie Fehler gemeldet werden können sowie die aktuelle Version dieser Seite finden
       sich unter https://www.kernel.org/doc/man-pages/.

ÜBERSETZUNG

       Die  deutsche  Übersetzung dieser Handbuchseite wurde von Martin Schulze <joey@infodrom.org>, Chris Leick
       <c.leick@vollbio.de> und Helge Kreutzmann <debian@helgefjell.de> erstellt.

       Diese Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder  neuer
       bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.

       Wenn  Sie  Fehler  in  der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die
       Mailingliste der Übersetzer.

Linux                                           10. Oktober 2019                                      TTYNAME(3)