getsockname() - Namen des Sockets abfragen

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

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

Beschreibung

Die Funktion getsockname() liefert den aktuellen Namen für den Socket s.

name zeigt auf einen Speicherbereich. *name enthält nach erfolgreicher Ausführung von getsockname() den Namen (Adresse) des Sockets s. Das tatsächliche Format der sockaddr-Struktur hängt von der Adressfamilie ab und ist im Abschnitt "Socket-Adressierung" beschrieben.

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 *name 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.

ENOTSOCK

Der Deskriptor s referenziert eine Datei, keinen Socket.

Siehe auch

bind(), getpeername(), socket()