GETPEERNAME(3N-SVR4)RISC/os Reference Manual GETPEERNAME(3N-SVR4)



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).
















                        Printed 11/19/92                   Page 1