getpeername(3N)                                             getpeername(3N)

NAME
     getpeername - Name des verbundenen Partners abfragen

SYNTAX
     #include <sys/socket.h>

     int getpeername(int s, struct sockaddr *name, int *namelen);

BESCHREIBUNG
     getpeername() liefert den Namen bzw. die Adresse des Partners zurück,
     der mit dem Socket s verbunden ist. Der int-Wert, auf den der Parame-
     ter namelen zeigt, sollte initialisiert werden, um die Speichergröße
     anzuzeigen, auf die der Parameter name zeigt. Bei Rückkehr enthält der
     Parameter die tatsächliche Größe des Namens (in Bytes), der zurückge-
     liefert wurde. Wenn der Puffer zu klein ist, wird der Name abgeschnit-
     ten.

RÜCKGABEWERT
     Im Erfolgsfall wird 0 zurückgegeben, im Fehlerfall -1.

DIAGNOSE
     Im Fehlerfall zeigt die globale Variable errno folgende Fehlercodes
     an:

     EBADF       Das Argument s ist kein gültiger Deskriptor.

     ENOTSOCK    Das Argument s verweist nicht auf einen Socket.

     ENOTCONN    Der Socket ist nicht verbunden.

     ENOMEM      Es war nicht genügend Benutzerspeicher vorhanden, um die
                 Operation durchzuführen.

     ENOSR       Es waren nicht genügend STREAMS-Betriebsmittel vorhanden,
                 um die Operation durchzuführen.

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

















Seite 1                      Reliant UNIX 5.44               Gedruckt 11/98