− get socket name
getsockname(int sockfd, struct sockaddr
returns the current address to which the socket
sockfd is bound, in the buffer pointed to by
addr. The addrlen argument should be
initialized to indicate the amount of space (in bytes)
pointed to by addr. On return it contains the actual
size of the socket address.
address is truncated if the buffer provided is too small; in
this case, addrlen will return a value greater than
was supplied to the call.
zero is returned. On error, −1 is returned, and
errno is set appropriately.
The argument sockfd is
not a valid descriptor.
The addr argument points to memory not in a valid
part of the process address space.
addrlen is invalid (e.g., is negative).
Insufficient resources were
available in the system to perform the operation.
The file descriptor
sockfd does not refer to a socket.
POSIX.1-2008, SVr4, 4.4BSD (getsockname() first
appeared in 4.2BSD).
argument of getsockname() is in reality an
int * (and this is what 4.x BSD and libc4 and
libc5 have). Some POSIX confusion resulted in the present
socklen_t, also used by glibc. See also
socket(2), getifaddrs(3), ip(7),
This page is
part of release 4.04 of the Linux man-pages project.
A description of the project, information about reporting
bugs, and the latest version of this page, can be found at