NAME
getsockname - get socket name
SYNOPSIS
#include <sys/socket.h>
I int getsockname(int s , struct sockaddr * name , socklen_t * namelen );
DESCRIPTION
R getsockname ()
returns the current
name
for the specified socket.
The
namelen
parameter should be initialized to indicate
the amount of space pointed to by
R name .
On return it contains the actual size of the name
returned (in bytes).
RETURN VALUE
On success, zero is returned.
On error, -1 is returned, and
errno
is set appropriately.
ERRORS
EBADF
The argument
s
is not a valid descriptor.
EFAULT
The
name
parameter points to memory not in a valid part of the
process address space.
EINVAL
namelen
is invalid (e.g., is negative).
ENOBUFS
Insufficient resources were available in the system
to perform the operation.
ENOTSOCK
The argument
s
is a file, not a socket.
CONFORMING TO
SVr4, 4.4BSD (the
R getsockname ()
function call appeared in 4.2BSD), POSIX.1-2001.
NOTES
The third argument of
R 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
accept(2).
SEE ALSO