getpeername(3N)         NETWORK FUNCTIONS         getpeername(3N)



NAME
     getpeername - get name of connected peer

SYNOPSIS
     int getpeername(s, name, namelen)
     int s;
     struct sockaddr *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  descrip-
                         tor.

     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)
















                          Last change:                          1