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

FreeBSD Manual Pages

  
 
  

home | help
getpeername(2)							getpeername(2)

Name
       getpeername - get name of connected peer

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

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

Description
       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
       fails.

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

Diagnostics
       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)

								getpeername(2)

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

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=getpeername&sektion=2&manpath=ULTRIX+4.2>

home | help