getsockname(2) [ultrix man page]

getsockname(2)							System Calls Manual						    getsockname(2)

Name
       getsockname - get socket name

Syntax
       #include <sys/types.h>
       #include <sys/socket.h>

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

Description
       The  system  call  returns the current name for the specified socket descriptor 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
       A zero is returned if the call succeeds, -1 if it fails.

Restrictions
       Names bound to sockets in the UNIX domain are inaccessible; returns a zero-length name.

Diagnostics
       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 perform the operation.

       [EFAULT]       The name parameter points to memory not in a valid part of the process address space.

See Also
       bind(2), socket(2)

																    getsockname(2)

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), socket(3SOCKET), attributes(5)

SunOS 5.11							    12 Dec 1997 					      getsockname(3SOCKET)