Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
getpeername(2)							getpeername(2)

       getpeername - get name of connected peer

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

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

       The  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, in bytes,	of the
       name returned.

Return Values
       A zero is returned if the call succeeds,	 and  -1  is  returned	if  it

       Names  bound  to	sockets	in the UNIX domain are inaccessible; returns a
       zero length name.

       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
       bind(2),	getsockname(2),	socket(2)


Name | Syntax | Description | Return Values | Restrictions | Diagnostics | See Also

Want to link to this manual page? Use this URL:

home | help