getpeername(3N)						       getpeername(3N)

NAME    [Toc]    [Back]

     getpeername - get name of connected peer

SYNOPSIS    [Toc]    [Back]

     int getpeername(int s, caddr_t name, int *namelen);

DESCRIPTION    [Toc]    [Back]

     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).  The	name is	truncated if the
     buffer provided is	too small.

RETURN VALUE    [Toc]    [Back]

     0 is returned if the call succeeds, -1 if it fails.

ERRORS    [Toc]    [Back]

     The call succeeds unless:

     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    [Toc]    [Back]

     accept(3N), bind(3N), getsockname(3N), socket(3N).

NOTES    [Toc]    [Back]

     The type of address structure passed to accept depends on the address
     family.  UNIX domain sockets (address family AF_UNIX) require a
     socketaddr_un structure as	defined	in sys/un.h; Internet domain sockets
     (address family AF_INET) require a	sockaddr_in structure as defined in
     netinet/in.h.  Other address families may require other structures.  Use
     the structure appropriate to the address family; cast the structure
     address to	a generic caddr_t in the call to getpeername and pass the size
     of	the structure in the namelen argument.


									PPPPaaaaggggeeee 1111