getsockname

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

bind(2), socket(2)