getpeername(3N)

NAME
     getpeername - get name of connected peer

SYNOPSIS
     int getpeername(int s, caddr_t name, int *namelen);

DESCRIPTION
     getpeername returns the name of the peer connected to socket s.  The int
     pointed to by 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).  The name is truncated if the
     buffer provided is too small.

RETURN VALUE
     0 is returned if the call succeeds, -1 if it fails.

ERRORS
     The call succeeds unless:

     EBADF               The argument s is not a valid descriptor.

     ENOTSOCK            The argument s is a file, not a socket.

     ENOTCONN            The socket is not connected.

     ENOMEM              There was insufficient user memory for the operation
                         to complete.

     ENOSR               There were insufficient STREAMS resources available
                         for the operation to complete.

SEE ALSO
     accept(3N), bind(3N), getsockname(3N), socket(3N).

NOTES
     The type of address structure passed to accept depends on the address
     family.  UNIX domain sockets (address family AF_UNIX) require a
     socketaddr_un structure as defined in sys/un.h; Internet domain sockets
     (address family AF_INET) require a sockaddr_in structure as defined in
     netinet/in.h.  Other address families may require other structures.  Use
     the structure appropriate to the address family; cast the structure
     address to a generic caddr_t in the call to getpeername and pass the size
     of the structure in the namelen argument.