GETSOCKNAME(2) BSD Programmer's Manual GETSOCKNAME(2)NAME
getsockname - get socket name
SYNOPSIS
#include <sys/types.h>
#include <sys/socket.h>
int
getsockname(int s, struct sockaddr *name, socklen_t *namelen);
DESCRIPTIONGetsockname() returns the current name for the specified socket. The
namelen pointer refers to a value-result parameter; it should initially
contain the amount of space pointed to by addr; on return that location
will contain the actual length (in bytes) of the address returned. If
the buffer provided is too small, the name is truncated and the full size
is returned in the location to which namelen points.
DIAGNOSTICS
A 0 is returned if the call succeeds, -1 if it fails.
ERRORS
The call succeeds unless:
[EBADF] The argument s is not a valid descriptor.
[ENOTSOCK] The argument s is a file, not a socket.
[ENOBUFS] Insufficient resources were available in the system to per-
form the operation.
[EFAULT] The name parameter points to memory not in a valid part of
the process address space.
SEE ALSObind(2), socket(2)BUGS
Names bound to sockets in the LOCAL domain are inaccessible; getsockname
returns a zero length name.
HISTORY
The getsockname function call appeared in 4.2BSD.
4.2 Berkeley Distribution June 4, 1993 1