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(7) for descriptions of the following attributes:


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

SEE ALSO

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

December 12, 1997 GETSOCKNAME(3SOCKET)