GETSOCKNAME(3SOCKET) Sockets Library Functions GETSOCKNAME(3SOCKET)


NAME


getsockname - get socket name

SYNOPSIS


cc [ flag ... ] file ... -lsocket -lnsl [ library ... ]
#include <sys/types.h>
#include <sys/socket.h>

int getsockname(int s, struct sockaddr *name, socklen_t *namelen);


DESCRIPTION


getsockname() returns the current name for socket s. The namelen
parameter should be initialized to indicate the amount of space pointed
to by name. On return it contains the actual size in bytes of the name
returned.

RETURN VALUES


If successful, getsockname() returns 0; otherwise it returns -1 and sets
errno to indicate the error.

ERRORS


The call succeeds unless:

EBADF
The argument s is not a valid file descriptor.


ENOMEM
There was insufficient memory available for the operation to
complete.


ENOSR
There were insufficient STREAMS resources available for the
operation to complete.


ENOTSOCK
The argument s is not a socket.


ATTRIBUTES


See attributes(5) for descriptions of the following attributes:


+---------------+-----------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+-----------------+
|MT-Level | Safe |
+---------------+-----------------+

SEE ALSO


bind(3SOCKET), getpeername(3SOCKET), sockaddr(3SOCKET), socket(3SOCKET),
attributes(5)


December 12, 1997 GETSOCKNAME(3SOCKET)