getsockname - liefert den Namen eines Sockets
Standard-C-Bibliothek (
libc,
-lc)
#include <sys/socket.h>
int getsockname(int sockfd, struct sockaddr *restrict Adr,
socklen_t *restrict adresslaenge);
Getsockname() liefert die aktuelle Adresse, an die das Socket
sockfd gebunden ist, in dem Puffer zurück, auf den
Adr
zeigt. Mit dem Parameter
adresslaenge muss die Größe des
Puffers (in Byte) übergeben werden, auf die
Adr zeigt. Bei der
Rückkehr enthält der Parameter die tatsächliche
Größe der Socket-Adresse.
Die zurückgegebene Adresse wird gekürzt, falls der bereitgestellte
Puffer zu klein ist. In diesem Fall gibt
adresslaenge einen Wert
zurück, der größer als der übergebene Wert ist.
Bei Erfolg wird Null zurückgegeben. Bei einem Fehler wird -1
zurückgegeben und
errno gesetzt, um den Fehler anzuzeigen.
- EBADF
- Das Argument sockdd ist kein zulässiger
Dateideskriptor.
- EFAULT
- Das Argument Adr zeigt aus dem vom Prozess
adressierbaren Adressraum heraus.
- EINVAL
-
adresslaenge ist nicht zulässig (ist z. B.
negativ).
- ENOBUFS
- Es waren im System zu wenig Ressourcen für die
Ausführung dieses Vorgangs verfügbar.
- ENOTSOCK
- Der Dateideskriptor sockdd zeigt nicht auf ein
Socket.
POSIX.1-2001, POSIX.1-2008, SVr4, 4.4BSD (
getsockname() war erstmals in
4.2BSD zu finden).
Für Hintergrundinformationen zum Typ
socklen_t siehe
accept(2).
bind(2),
socket(2),
getifaddrs(3),
ip(7),
socket(7),
unix(7)
Die deutsche Übersetzung dieser Handbuchseite wurde von Dennis Stampfer
<
[email protected]>, Martin Eberhard Schauer
<
[email protected]> und Mario Blättermann
<
[email protected]> erstellt.
Diese Übersetzung ist Freie Dokumentation; lesen Sie die
GNU
General Public License Version 3 oder neuer bezüglich der
Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.
Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken
Sie bitte eine E-Mail an die
Mailingliste
der Übersetzer