getsockname

NAME

       getsockname - get socket name

SYNOPSIS

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

DESCRIPTION

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

RETURN VALUE

       On success, zero is returned.  On error, -1  is  returned,
       and  errno  is  set appropriately.  A 0 is returned if the
       call succeeds, -1 if it fails.

ERRORS

       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  sys-
               tem to perform the operation.

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

HISTORY

       The getsockname function call appeared in BSD 4.2.

BUGS

       Names bound to sockets in the UNIX domain  are  inaccessi-
       ble; getsockname returns a zero length name.

SEE ALSO

       bind(2), socket(2)