GETPEERNAME(2)							GETPEERNAME(2)

NAME    [Toc]    [Back]

     getpeername - get name of connected peer

SYNOPSIS    [Toc]    [Back]

     #include <sys/types.h>
     #include <sys/socket.h>

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

DESCRIPTION    [Toc]    [Back]

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

DIAGNOSTICS    [Toc]    [Back]

     A 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.

     [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.

SEE ALSO    [Toc]    [Back]

     accept(2),	bind(2), socket(2), getsockname(2)

NOTES    [Toc]    [Back]

     ABI-compliant versions of the above call can be obtained from
     libsocket.so.

     This call does not	return useful results when used	on sockets of type
     AF_UNIX, unless the remote	end was	explicitly bound to a pathname.


									PPPPaaaaggggeeee 1111