getpeername(2)                 DG/UX 5.4R3.00                 getpeername(2)


NAME
       getpeername - get name of connected peer

SYNOPSIS
       #include <sys/socket.h>

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

   where:
       s         File descriptor of socket whose name is requested

       name      Structure to receive the name of connected peer

       namelen   On input contains the number of bytes available for the
                 peer name; updated to indicate the number of bytes returned

DESCRIPTION
       Getpeername  returns the name of the peer connected to socket s.  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).

ACCESS CONTROL
       None.  (See domain information [inet(3N), unixipc(6F)] for domain-
       specific restrictions.)

RETURN VALUE
       0      Completed successfully.

       -1     An error occurred.  errno is set to indicate the error.

DIAGNOSTICS
       Errno may be set to one of the following error codes:

       EBADF     The argument s is not a valid descriptor.

       ENOTSOCK  The argument s is not a file of type S_IFSOCK (socket
                 special).

       ENOTCONN  The socket is not connected.

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

       EFAULT    The name parameter points to memory not in a valid part of
                 the process address space, or the namelen parameter is < 0.

SEE ALSO
       bind(2), connect(2), getsockname(2), socket(2), inet(3N),
       unixipc(6F).




Licensed material--property of copyright holder(s)                         1