ttyname(3)

BEZEICHNUNG
ttyname, ttyname_r - den Namen eines Terminals zurückgeben

BIBLIOTHEK
Standard-C-Bibliothek (libc, -lc)

ÜBERSICHT
#include <unistd.h>

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-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 gesetzt, um den Fehler anzuzeigen. Die Funktion ttyname_r() gibt bei Erfolg 0 zurück und eine Fehlernummer bei einem Fehler.

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

STANDARDS
POSIX.1-2008.

GESCHICHTE
POSIX.1-2001, 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)

Ü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 (https://www.gnu.org/licenses/gpl-3.0.html) 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 (debian-l10n-german@lists.debian.org).