getpeername man page on BSDi

getpeername man page on BSDi

Man page or keyword search:
man Server 6284 pages
apropos Keyword Search (all sections)
Output format

GETPEERNAME(2)		    BSD Programmer's Manual		GETPEERNAME(2)

NAME
     getpeername - get name of connected peer

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

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

DESCRIPTION
     Getpeername() returns the name of the peer connected to socket s. The
     namelen pointer refers to a value-result parameter; it should initially
     contain the amount of space pointed to by addr; on return that location
     will contain the actual length (in bytes) of the address returned.	 If
     the buffer provided is too small, the name is truncated and the full size
     is returned in the location to which namelen points.

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

ERRORS
     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 per-
		 form the operation.

     [EFAULT]	 The name parameter points to memory not in a valid part of
		 the process address space.

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

HISTORY
     The getpeername function call appeared in 4.2BSD.

4.2 Berkeley Distribution	 June 4, 1993				     1

[top]

List of man pages available for BSDi

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]

Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................

Vote for polarhome