Scroll to navigation

TTYNAME(3) Linux-Programmierhandbuch TTYNAME(3)

BEZEICHNUNG

ttyname, ttyname_r - den Namen eines Terminals zurückgeben

ÜBERSICHT

#include <unistd.h>

char *ttyname(int fd);
int ttyname_r(int fd, 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 fd geöffnet ist, oder bei einem Fehler NULL (zum Beispiel, wenn fd 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
ENOTTY
Der Datei-Deskriptor 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.

SIEHE AUCH

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

KOLOPHON

Diese Seite ist Teil der Veröffentlichung 4.09 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> und Chris Leick <c.leick@vollbio.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 <debian-l10n-german@lists.debian.org>.

12. Dezember 2016 Linux