ttyname(3) Library Functions Manual ttyname(3) BEZEICHNUNG ttyname, ttyname_r - den Namen eines Terminals zuruckgeben BIBLIOTHEK Standard-C-Bibliothek (libc, -lc) UBERSICHT #include char *ttyname(int dd); int ttyname_r(int dd, char puffer[.pufferlaenge], size_t pufferlaenge); BESCHREIBUNG Die Funktion ttyname() gibt einen Zeiger auf einen mit Nullbyte abgeschlossenen Pfadnamen des Terminal-Gerates zuruck, das mit dem Dateideskriptor dd geoffnet ist, oder bei einem Fehler NULL (zum Beispiel, wenn dd nicht mit einem Terminal verbunden ist). Der Ruckgabewert kann auf statische Daten zeigen, die moglicherweise beim nachsten Aufruf uberschrieben werden. Die Funktion ttyname_r() speichert diesen Pfadnamen im Puffer puffer, der die Lange pufferlaenge hat. RUCKGABEWERT Die Funktion ttyname() gibt bei Erfolg einen Zeiger auf einen Pfadnamen zuruck. Bei einem Fehler wird NULL zuruckgegeben und errno gesetzt, um den Fehler anzuzeigen. Die Funktion ttyname_r() gibt bei Erfolg 0 zuruck und eine Fehlernummer bei einem Fehler. FEHLER EBADF falscher Datei-Deskriptor ENODEV dd bezieht sich auf ein Slave-Pseudoterminal-Gerat, aber der entsprechende Pfadname konnte nicht gefunden werden (siehe ANMERKUNGEN). ENOTTY dd bezieht sich nicht auf ein Terminal-Gerat. ERANGE (ttyname_r()) pufferlaenge war zu klein, um den Pfadnamen aufzunehmen. ATTRIBUTE Siehe attributes(7) fur eine Erlauterung der in diesem Abschnitt verwandten Ausdrucke. +-----------------+-------------------------+--------------------------+ |Schnittstelle | Attribut | Wert | +-----------------+-------------------------+--------------------------+ |ttyname() | Multithread-Fahigkeit | MT-Unsicher race:ttyname | +-----------------+-------------------------+--------------------------+ |ttyname_r() | Multithread-Fahigkeit | MT-Sicher | +-----------------+-------------------------+--------------------------+ STANDARDS POSIX.1-2008. GESCHICHTE POSIX.1-2001, 4.2BSD. ANMERKUNGEN Ein Prozess, der einen Dateideskriptor, der sich auf ein pts(4)-Gerat bezieht, beim Umschalten auf einen anderen Einhangenamensraum, der eine andere /dev/ptmx-Instanz verwendet, geoffnet halt, kann immer noch zufalligerweise herausfinden, dass ein Geratepfad des gleichen Namens fur diesen Dateideskriptor existiert. Allerdings bezieht sich dieser Geratepfad auf ein anderes Gerat und kann daher nicht zum Zugriff auf das Gerat, 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 zuruckliefern und errno auf ENODEV setzen. SIEHE AUCH tty(1), fstat(2), ctermid(3), isatty(3), pts(4) UBERSETZUNG Die deutsche Ubersetzung dieser Handbuchseite wurde von Martin Schulze , Chris Leick und Helge Kreutzmann erstellt. Diese Ubersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer bezuglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG ubernommen. Wenn Sie Fehler in der Ubersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die Mailingliste der Ubersetzer . Linux man-pages 6.06 31. Oktober 2023 ttyname(3)