getpeername(3N)getpeername(3N)NAMEgetpeername - get name of connected peer
SYNOPSIS
int getpeername(int s, caddr_t name, int *namelen);
DESCRIPTIONgetpeername 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). The name is truncated if the
buffer provided is too small.
RETURN VALUE
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.
ENOMEM There was insufficient user memory for the operation
to complete.
ENOSR There were insufficient STREAMS resources available
for the operation to complete.
SEE ALSOaccept(3N), bind(3N), getsockname(3N), socket(3N).
NOTES
The type of address structure passed to accept depends on the address
family. UNIX domain sockets (address family AF_UNIX) require a
socketaddr_un structure as defined in sys/un.h; Internet domain sockets
(address family AF_INET) require a sockaddr_in structure as defined in
netinet/in.h. Other address families may require other structures. Use
the structure appropriate to the address family; cast the structure
address to a generic caddr_t in the call to getpeername and pass the size
of the structure in the namelen argument.
Page 1
