Scroll to navigation

GETSOCKNAME(2) Руководство программиста Linux GETSOCKNAME(2)

ИМЯ

getsockname - получить имя сокета

СИНТАКСИС

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

ОПИСАНИЕ

getsockname() возвращает текущий адрес, к которому привязан сокет sockfd, в буфере, указываемом addr. В параметре addrlen должно быть указано, сколько места выделено (в байтах), на которое указывает addr. При возврате в этом параметре передается реальный размер адреса сокета.

Возвращаемый адрес урежется, если предоставленный буфер окажется слишком маленьким; в этом случае в addrlen будет возвращено значение большее чем было в вызове.

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ

При успешном выполнении возвращается 0. В случае ошибки возвращается -1, а errno устанавливается в соответствующее значение.

ОШИБКИ

Аргумент sockfd не является допустимым файловым дескриптором.
Аргумент addr указывает на память в недопустимой части адресуемого пространства процесса.
Неправильное значение аргумента addrlen (например, отрицательное).
Недостаточно ресурсов в системе для выполнения операции.
Файловый дескриптор sockfd указывает не на каталог.

СООТВЕТСТВИЕ СТАНДАРТАМ

POSIX.1-2001, POSIX.1-2008, SVr4, 4.4BSD, (getsockname() впервые появился в 4.2BSD).

ЗАМЕЧАНИЯ

Описание типа socklen_t смотрите в accept(2).

СМ. ТАКЖЕ

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

ЗАМЕЧАНИЯ

Эта страница является частью проекта Linux man-pages версии 5.10. Описание проекта, информацию об ошибках и последнюю версию этой страницы можно найти по адресу https://www.kernel.org/doc/man-pages/.

ПЕРЕВОД

Русский перевод этой страницы руководства был сделан Azamat Hackimov <azamat.hackimov@gmail.com>, Dmitry Bolkhovskikh <d20052005@yandex.ru>, Vladislav <ivladislavefimov@gmail.com>, Yuri Kozlov <yuray@komyakino.ru> и Иван Павлов <pavia00@gmail.com>

Этот перевод является бесплатной документацией; прочитайте Стандартную общественную лицензию GNU версии 3 или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.

Если вы обнаружите ошибки в переводе этой страницы руководства, пожалуйста, отправьте электронное письмо на man-pages-ru-talks@lists.sourceforge.net.

15 сентября 2017 г. Linux