Sockets Library Functions                    getpeername(3SOCKET)



NAME
     getpeername - get name of connected peer

SYNOPSIS
     cc [ flag ... ] file ... -lsocket  -lnsl  [ library ... ]
     #include 
     #include 

     int getpeername(int s, struct sockaddr *name, socklent *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), prior to any truncation.  The  name  is
     truncated if the buffer provided is too small.

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

ERORS
     The call succeeds unless:

     EBADF       The argument s is not a valid descriptor.


     ENOMEM      There  was  insufficient  user  memory  for  the
                 operation to complete.


     ENOSR       There were insufficient STREAMS resources avail-
                 able for the operation to complete.


     ENOTCON    The socket is not connected.


     ENOTSOCK    The argument s is not a socket.


ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:









SunOS 5.11          Last change: 26 Mar 1998                    1






Sockets Library Functions                    getpeername(3SOCKET)



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     MT-Level                     Safe                        
    


SEE ALSO
     accept(3SOCKET),    bind(3SOCKET),     getsockname(3SOCKET),
     socket(3SOCKET), attributes(5), socket.h(3HEAD)













































SunOS 5.11          Last change: 26 Mar 1998                    2