ultrix man page for getsockname

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)