BEZEICHNUNG

       getpeername - holt den Namen einer verbundenen Gegenstelle

ÜBERSICHT

       #include <sys/socket.h>

       int getpeername(int sockfd, struct sockaddr *addr, socklen_t *addrlen);

BESCHREIBUNG

       getpeername()  schreibt  die  Adresse  der  Gegenstelle,  die mit dem Socket sockfd verbunden ist, in den
       Puffer, auf den addr zeigt. Der Parameter addrlen sollte die Größe  des  freien  Speicherplatzes  an  der
       Adresse  addr  enthalten. Nach dem Aufruf enthält addrlen die Größe des zurückgegebenen Namens (in Byte).
       Der Name wird abgeschnitten, wenn der zur Verfügung gestellte Puffer zu klein ist.

       Die zurückgegebene Adresse wird gekürzt, falls der bereitgestellte Puffer zu klein ist.  In  diesem  Fall
       gibt addrlen einen Wert zurück, der größer als der übergebene Wert ist.

RÜCKGABEWERT

       Bei  Erfolg  wird  Null  zurückgegeben.  Bei  einem  Fehler  wird -1 zurückgegeben und errno entsprechend
       gesetzt.

FEHLER

       EBADF  Das Argument sockfd ist kein zulässiger Dateideskriptor.

       EFAULT Das Argument addr zeigt aus dem vom Prozess adressierbaren Adressraum heraus.

       EINVAL addrlen 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.

       ENOTCONN
              Der Socket ist nicht verbunden.

       ENOTSOCK
              Der Dateideskriptor sockfd zeigt nicht auf ein Socket.

KONFORM ZU

       POSIX.1-2001, POSIX.1-2008, SVr4, 4.4BSD (getpeername() erschien erstmals in 4.2BSD).

ANMERKUNGEN

       Für Hintergrundinformationen zum Typ socklen_t siehe accept(2).

       Bei Datenstrom-Sockets  kann,  sobald  connect(2)  aufgerufen  wurde,  jeder  der  Sockets  getpeername()
       ausführen,  um  die  Adresse  des  Peer-Sockets  zu  ermitteln.  Andererseits sind Datagramm-Sockets ohne
       Verbindung. Der Aufruf von connect(2) mit einem Datagramm-Socket  setzt  vielmehr  die  Peer-Adresse  für
       ausgehende  Datagramme,  die  mit  write(2)  oder recv(2) gesendet wurden. Der Aufruf von connect(2) kann
       getpeername() nutzen, um die zuvor für den Socket gesetzte Peer-Adresse  zu  ermitteln.  Der  Peer-Socket
       jedoch  beachtet  diese  Information  nicht  und der Aufruf von getpeername() dort wird keine verwertbare
       Information liefern, es sei denn, connect(2) wurde ebenfalls auf dem Peer aufgerufen. Beachten Sie  auch,
       dass der Empfänger eines Datagramms die Absenderadresse mittels recvfrom(2) ermitteln kann.

SIEHE AUCH

       accept(2), bind(2), getsockname(2), ip(7), socket(7), unix(7)

KOLOPHON

       Diese  Seite  ist  Teil  der  Veröffentlichung  5.03  des Projekts Linux-man-pages. Eine Beschreibung des
       Projekts, Informationen, wie Fehler gemeldet werden können sowie die aktuelle Version dieser Seite finden
       sich unter https://www.kernel.org/doc/man-pages/.

ÜBERSETZUNG

       Die deutsche Übersetzung dieser Handbuchseite  wurde  von  Dennis  Stampfer  <kontakt@dstampfer.de>,  Dr.
       Tobias Quathamer <toddy@debian.org> und Mario Blättermann <mario.blaettermann@gmail.com> 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
       <debian-l10n-german@lists.debian.org>.

Linux                                          15. September 2017                                 GETPEERNAME(2)