HPUX getpeername[2]

 getpeername(2)                                               getpeername(2)





 NAME
      getpeername - get address of connected peer

 SYNOPSIS
      #include <sys/socket.h>

    AF_CCITT only:
      #include <x25/x25addrstr.h>

      int getpeername(int s, void *addr, int *addrlen);

 DESCRIPTION
      getpeername() returns the address of the peer socket connected to the
      socket indicated by s, where s is a socket descriptor.  addr points to
      a socket address structure in which this address is returned.  addrlen
      points to an object of type int, which should be initialized to
      indicate the size of the address structure.  On return, it contains
      the actual size of the address returned (in bytes).  If addr does not
      point to enough space to contain the whole address of the peer, only
      the first addrlen bytes of the address are returned.

    AF_CCITT only:
      The addr struct contains the X.25 addressing information of the remote
      peer socket connected to socket s.  However, the x25ifname[] field of
      the addr struct contains the name of the local X.25 interface through
      which the call arrived.

 RETURN VALUE
      Upon successful completion, getpeername() returns 0; otherwise it
      returns -1 and sets errno to indicate the error.

 ERRORS
      getpeername() fails if any of the following conditions are
      encountered:

           [EBADF]             The argument s is not a valid file
                               descriptor.

           [ENOTSOCK]          The argument s is a file, not a socket.

           [ENOTCONN]          The socket is not connected.

           [ENOBUFS]           Insufficient resources were available in the
                               system to perform the operation.

           [EFAULT]            The addr or addrlen parameters are not valid
                               pointers.

           [EINVAL]            The socket has been shut down.





 Hewlett-Packard Company            - 1 -     HP-UX Release 9.0: August 1992






 getpeername(2)                                               getpeername(2)





           [EOPNOTSUPP]        Operation not supported for AF_UNIX sockets.

 AUTHOR
      getpeername() was developed by the University of California, Berkeley.

 SEE ALSO
      bind(2), socket(2), getsockname(2), inet(7F), af_ccitt(7F).















































 Hewlett-Packard Company            - 2 -     HP-UX Release 9.0: August 1992