Subroutine gethostname

Zweck

Ruft den Namen des lokalen Hosts ab.

Bibliothek

Standard-C-Bibliothek (libc.a)

Syntax

#include <unistd.h> int gethostname ( Name, NameLength) char *Name; size_t NameLength;

Beschreibung

Die Subroutine Gethostname ruft den Standardhostnamen des lokalen Hosts ab. Wenn überschüssiger Speicherplatz bereitgestellt wird, endet der zurückgegebene Name -Parameter auf null. Wenn nicht genügend Speicherplatz angegeben wird, wird der zurückgegebene Name abgeschnitten, damit er in den angegebenen Speicherplatz passt. Systemhostnamen sind auf 256 Zeichen begrenzt.

Die Subroutine Gethostname ermöglicht einem aufrufenden Prozess, den internen Hostnamen für eine Maschine in einem Netz zu bestimmen.

Alle Anwendungen, die die Subroutine Gethostname enthalten, müssen mit einem bestimmten Wert für das Makro _BSD-Datentabelle kompiliert werden. Zulässige Werte sind 43 und 44. Außerdem müssen alle Socketanwendungen die BSD-Bibliothek libbsd.a enthalten.

Parameter

Element	Beschreibung
Name	Gibt die Adresse eines Bytebereichs an, in dem der Hostname gespeichert werden soll
NameLength	Gibt die Länge des Name -Arrays an.

Rückgabewerte

Nach erfolgreicher Beendigung gibt das System den Wert 0 zurück.

Wenn die Subroutine Gethostname nicht erfolgreich ist, führt der Subroutinenhandler folgende Funktionen aus:

Gibt den Wert -1 an das aufrufende Programm zurück.
Verschiebt einen Fehlercode, der den spezifischen Fehler angibt, in die globale Variable Fehlernummer .

Fehlercodes

Die Subroutine Gethostname ist nicht erfolgreich, wenn Folgendes zutrifft:

Fehler	Beschreibung
EFAULT	Der Parameter Name oder NameLength gibt eine ungültige Adresse an.