getsockname(3N-xs)            (X/OPEN SOCKETS)           getsockname(3N-xs)

NAME
     getsockname - Den Namen des Sockets abrufen

SYNTAX
     cc [flag ...] file ... -lxnet [library ...]

     #include <sys/socket.h>

     int getsockname(int socket, struct sockaddr *address,
                     sizet *addresslen);

BESCHREIBUNG
     Die Funktion getsockname ruft den lokal gebundenen Namen des angegebe-
     nen Sockets ab, speichert diese Adresse in der sockaddr-Struktur, auf
     die das Argument address zeigt, und speichert die Länge dieser Adresse
     in dem Objekt, auf das das Argument addresslen zeigt.

     Überschreitet die tatsächliche Länge der Adresse die der angegebenen
     sockaddr-Struktur, wird die gespeicherte Adresse abgeschnitten.

     Ist der Socket nicht an einen lokalen Namen gebunden, wird der in dem
     Objekt gespeicherte Wert, auf das address zeigt, nicht näher spezifi-
     ziert.

RÜCKGABEWERT
     Bei erfolgreicher Ausführung wird 0 zurückgegeben, das Argument
     address zeigt auf die Adresse des Sockets und addresslen auf die
     Länge der Adresse. Andernfalls wird -1 zurückgegeben und errno
     gesetzt, um den Fehler anzuzeigen.

FEHLER
     Die Funktion getsockname schlägt fehl, wenn eine der folgenden Bedin-
     gungen zutrifft:

     EBADF           Das Argument socket ist kein gültiger Dateideskriptor.

     ENOTSOCK        Das Argument socket verweist nicht auf einen Socket.

     EOPNOTSUPP      Die Operation wird für das Protokoll dieses Socket
                     nicht unterstützt.

     Die Funktion getsockname kann fehlschlagen, wenn eine der folgenden
     Bedingungen zutrifft:

     EINVAL          Der Socket wurde geschlossen.

     ENOBUFS         Die im System verfügbaren Ressourcen reichen für die
                     Ausführung des Aufrufs nicht aus.

     ENOSR           Die verfügbaren STREAMS-Ressourcen reichen für die
                     Ausführung der Operation nicht aus.




Seite 1                      Reliant UNIX 5.44               Gedruckt 11/98

getsockname(3N-xs)            (X/OPEN SOCKETS)           getsockname(3N-xs)

SIEHE AUCH
     accept(3N-xs), bind(3N-xs), getpeername(3N-xs), socket(3N-xs).




















































Seite 2                      Reliant UNIX 5.44               Gedruckt 11/98