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

EBADF
    Argument sockfd nie jest prawidłowym deskryptorem.

EFAULT
    Parametr addr wskazuje poza dostępną przestrzeń adresową procesu.

EINVAL
    addrlen jest nieprawidłowe (np. jest ujemne).

ENOBUFS
    Dostępna ilość zasobów systemowych jest niewystarczająca dla wykonania operacji.

ENOTSOCK
    Deskryptor pliku sockfd nie odnosi się do gniazda.

STANDARDY
POSIX.1-2024.

HISTORIA
POSIX.1-2001, SVr4, 4.2BSD.

ZOBACZ TAKŻE
bind(2), socket(2), getifaddrs(3), ip(7), socket(7), unix(7)

TŁUMACZENIE
Tłumaczenie niniejszej strony podręcznika: 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 (https://www.gnu.org/licenses/gpl-3.0.html) 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.