GETSOCKNAME(2) Linux Programmer's Manual GETSOCKNAME(2)
NAME
getsockname - get socket(2,7,n) name
SYNOPSIS
#include <sys/socket.h>
int getsockname(int s, struct sockaddr *name, socklen_t *namelen);
DESCRIPTION
Getsockname returns the current name for the specified socket. The
namelen parameter should be initialized to indicate the amount of space
pointed to by name. On return it contains the actual size of the name
returned (in(1,8) bytes).
RETURN VALUE
On success, zero is returned. On error(8,n), -1 is returned, and errno is
set(7,n,1 builtins) appropriately.
ERRORS
EBADF The argument s is not a valid descriptor.
EFAULT The name parameter points to memory not in(1,8) a valid part of the
process address space.
ENOBUFS
Insufficient resources were available in(1,8) the system to perform
the operation.
ENOTSOCK
The argument s is a file(1,n), not a socket.
CONFORMING TO
SVr4, 4.4BSD (the getsockname function call appeared in(1,8) 4.2BSD). SVr4
documents additional ENOMEM and ENOSR error(8,n) codes.
NOTE
The third argument of getsockname is in(1,8) reality an `int *' (and this is
what BSD 4.* and libc4 and libc5 have). Some POSIX confusion resulted
in(1,8) the present socklen_t, also used by glibc. See also accept(2,8)(2).
SEE ALSO
bind(2,n,1 builtins)(2), socket(2,7,n)(2)
BSD Man Page 1993-07-24 GETSOCKNAME(2)