getpeername() - Namen des Kommunikationspartners abfragen

#include <sys/socket.h>
#include <netinet/in.h>

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

Beschreibung

Die Funktion getpeername() liefert den Namen des Kommunikationspartners, der mit dem Socket s verbunden ist.

name zeigt auf einen Speicherbereich. *name enthält nach erfolgreicher Ausführung von getpeername() die Adresse des Kommunikationspartners.

Die size_t-Variable, auf die der Parameter namelen zeigt, gibt zu Beginn die Größe des durch name referenzierten Speicherbereichs an. Bei Rückkehr der Funktion enthält *namelen die aktuelle Größe (in Bytes) des zurückgelieferten Namens.

Returnwert

0:

Bei Erfolg.

-1:

Bei Fehler. errno wird gesetzt, um den Fehler anzuzeigen.

Fehler

EBADF

Der Parameter s ist kein gültiger Deskriptor.

EFAULT

Der Parameter name zeigt auf einen Bereich außerhalb des Prozess-Adressbereichs.

ENOTCONN

Der Socket hat keine Verbindung.

ENOTSOCK

Der Deskriptor s referenziert eine Datei, keinen Socket.

Siehe auch

accept(), bind(), getsockname(), socket()