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)