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

NAME
     getpeername - Den Namen des Peer-Socket abrufen

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

     #include <sys/socket.h>

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

BESCHREIBUNG
     Die Funktion getpeername ruft die Peer-Adresse des angegebenen Socket
     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.

     Läßt das Protokoll Verbindungen von ungebundenen Clients zu, und ist
     der Peer nicht gebunden, wird der in dem Objekt gespeicherte Wert, auf
     das address zeigt, nicht näher spezifiziert.

RÜCKGABEWERT
     Bei erfolgreicher Ausführung wird 0 zurückgegeben. Andernfalls wird -1
     zurückgegeben und errno gesetzt, um den Fehler anzuzeigen.

FEHLER
     Die Funktion getpeername 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.

     ENOTCONN        Es ist keine Verbindung zum Socket hergestellt, oder
                     für den Socket wurde der Peer nicht vorab angegeben.

     EINVAL          Der Socket wurde geschlossen.

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

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

     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

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

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




















































Seite 2                      Reliant UNIX 5.44               Gedruckt 11/98