getpeername(3N-xs)            (X/OPEN SOCKETS)           getpeername(3N-xs)

NAME
     getpeername - get the name of the peer socket

SYNOPSIS
     cc [flag ...] file ... -lxnet [library ...]

     #include <sys/socket.h>

     int getpeername(int socket, struct sockaddr *address,
                     sizet *addresslen);

DESCRIPTION
     The getpeername function retrieves the peer address of the specified
     socket, stores this address in the sockaddr structure pointed to by
     the address argument, and stores the length of this address in the
     object pointed to by the addresslen argument.

     If the actual length of the address is greater than the length of the
     supplied sockaddr structure, the stored address will be truncated.

     If the protocol permits connections by unbound clients, and the peer
     is not bound, then the value stored in the object pointed to by
     address is unspecified.

RETURN VALUE
     Upon successful completion, 0 is returned. Otherwise, -1 is returned
     and errno is set to indicate the error.

ERRORS
     The getpeername function will fail if:

     EBADF           The socket argument is not a valid file descriptor.

     ENOTSOCK        The socket argument does not refer to a socket.

     ENOTCONN        The socket is not connected or otherwise has not had
                     the peer prespecified.

     EINVAL          The socket has been shut down.

     EOPNOTSUPP      The operation is not supported for the socket proto-
                     col.

     The getpeername function may fail if:

     ENOBUFS         Insufficient resources were available in the system to
                     complete the call.

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





Page 1                       Reliant UNIX 5.44                Printed 11/98

getpeername(3N-xs)            (X/OPEN SOCKETS)           getpeername(3N-xs)

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




















































Page 2                       Reliant UNIX 5.44                Printed 11/98