getpeername(3N)                                             getpeername(3N)

NAME
     getpeername - get name of the associated partner

SYNOPSIS
     #include <sys/socket.h>

     int getpeername(int s, struct sockaddr *name, int *namelen);

DESCRIPTION
     getpeername() returns the name and/or address of the partner 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.

DIAGNOSTICS
     If it fails, the global variable errno displays one of the following
     error codes:

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



















Page 1                       Reliant UNIX 5.44                Printed 11/98