getpeername(3N)                                             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 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)

















   7/91                                                                 Page 1