Sun Microsystems, Inc.
spacerspacer
spacer   www.sun.com docs.sun.com | | |  
spacer
black dot
   
A   B   C   D   E   F   G   H   I   J   K   L   M   N   O   P   Q   R   S   T   U   V   W   X   Y   Z
    
 
Sockets Library Functionsgetpeername(3SOCKET)


NAME

 getpeername - get name of connected peer

SYNOPSIS

 
cc [ flag ... ] file ... -lsocket -lnsl [ library ... ]
#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 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), prior to any truncation. The name is truncated if the buffer provided is too small.

RETURN VALUES

 

If successful, getpeername() returns 0; otherwise it returns -1 and sets errno to indicate the error.

ERRORS

 

The call succeeds unless:

EBADF
The argument s is not a valid descriptor.
ENOMEM
There was insufficient user memory for the operation to complete.
ENOSR
There were insufficient STREAMS resources available for the operation to complete.
ENOTCONN
The socket is not connected.
ENOTSOCK
The argument s is not a socket.

ATTRIBUTES

 

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPEATTRIBUTE VALUE
MT-LevelSafe

SEE ALSO

 

accept(3SOCKET), bind(3SOCKET), getsockname(3SOCKET), socket(3SOCKET), attributes(5), socket(3HEAD)


SunOS 5.9Go To TopLast Changed 26 Mar 1998

 
      
      
Copyright 2002 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.