Scroll to navigation

getsockname(2) System Calls Manual getsockname(2)

NAZWA

getsockname - pobiera nazwę gniazda

BIBLIOTEKA

Standardowa biblioteka C (libc, -lc)

SKŁADNIA

#include <sys/socket.h>
int getsockname(int sockfd, struct sockaddr *restrict addr,
                socklen_t *restrict addrlen);

OPIS

getsockname() zwraca bieżący adres, z którym powiązane jest gniazdo sockfd, w buforze na który wskazuje addr. Argument addrlen powinien być zainicjowany tak, aby podawał rozmiar obszaru wskazywanego przez addr (w bajtach). Po zakończeniu, zawiera on rzeczywisty rozmiar adresu gniazda.

Zwracany adres jest przycinany, jeśli udostępniony bufor jest zbyt mały; w tym przypadku addrlen zwróci wartość większą niż była podana w wywołaniu.

WARTOŚĆ ZWRACANA

Po pomyślnym zakończeniu zwracane jest zero. Po błędzie zwracane jest -1 i ustawiane errno, wskazując błąd.

BŁĘDY

Argument sockfd nie jest prawidłowym deskryptorem.
Parametr addr wskazuje poza dostępną przestrzeń adresową procesu.
addrlen jest nieprawidłowe (np. jest ujemne).
Dostępna ilość zasobów systemowych jest niewystarczająca dla wykonania operacji.
Deskryptor pliku sockfd nie odnosi się do gniazda.

STANDARDY

POSIX.1-2008.

HISTORIA

POSIX.1-2001, SVr4, 4.4BSD (pojawiło się pierwotnie w 4.2BSD).

ZOBACZ TAKŻE

bind(2), socket(2), getifaddrs(3), ip(7), socket(7), unix(7)

TŁUMACZENIE

Autorami polskiego tłumaczenia niniejszej strony podręcznika są: Przemek Borys <pborys@dione.ids.pl>, Andrzej Krzysztofowicz <ankry@green.mf.pg.gda.pl> i Michał Kułach <michal.kulach@gmail.com>

Niniejsze tłumaczenie jest wolną dokumentacją. Bliższe informacje o warunkach licencji można uzyskać zapoznając się z GNU General Public License w wersji 3 lub nowszej. Nie przyjmuje się ŻADNEJ ODPOWIEDZIALNOŚCI.

Błędy w tłumaczeniu strony podręcznika prosimy zgłaszać na adres listy dyskusyjnej manpages-pl-list@lists.sourceforge.net.

2 maja 2024 r. Linux man-pages (niewydane)