Scroll to navigation

GETPEERNAME(2) Linux - příručka programátora GETPEERNAME(2)

JMÉNO

getpeername - vrať adresu vzdáleného konce soketu

SYNTAXE

#include <sys/socket.h> int getpeername(int s, struct sockaddr *name, int *namelen);

POPIS

Getpeername vrací jméno (adresu) počítače, který je na druhém konci soketu. s. Parametr namelen by měl být inicializován tak, aby indikoval velikost paměťového prostoru, na který ukazuje argument name. Po návratu bude obsahovat aktuální velikost vrácené adresy (v bajtech). Jméno je příslušně zkráceno, je-li velikost příliš malá.

NÁVRATOVÁ HODNOTA

V případě úspěchu je vrácena 0, jinak -1 a proměnná errno je příslušně nastavena.

CHYBY

Argument s není platným deskriptorem.
Argument s je deskriptorem souboru, není to soket.
Soket není spojen.
Systém nemá k dispozici dostatek vnitřních zdrojů, aby mohl tuto operaci provést.
Argument name ukazuje na paměť, která se nenachází v platné části adresového prostoru procesu. EINVAL Namelen je neplatné(například záporné číslo).

SPLŇUJE STANDARDY

SVr4, 4.4BSD (volání getpeername se poprvé objevilo ve 4.2BSD), POSIX.1-2001 . Třetí argument getpeername() je ve skutečnosti int * (použito v 4.x BSD a libc4 a libc5). Některé zmatky okolo POSIXu vyústily v přítomnost socklen_t, které je také užíváno v glibc. Viz accept (2).

DALŠÍ INFORMACE

accept(2), bind(2), getsockname(2)

TIRÁŽ

Tato stránka je součástí projektu Linux man-pages. Popis projektu a informace o hlášení chyb najdete na http://www.kernel.org/doc/man-pages/.

25. září 2009 BSD Man Page