|
|
C Interface
#include <sys/types.h>
#include <sys/socket.h>
#include <netinet/in.h>
int getpeername (s, addr, addrlen)
int s;
struct sockaddr_in *addr;
int *addrlen;
Description
The argument s is a socket descriptor. The getpeername
system call returns the address of the peer socket connected to the socket
indicated by s. The addr parameter points to a
socket address structure in which this address is returned. The
addrlen parameter points to an object of the type
int, which should be initialized to indicate the size of the
address structure. On return, the addrlen parameter contains
the actual size of the address returned (in bytes). If addr
does not point to enough space to contain the whole address of the peer, only
the first addrlen bytes of the address are returned.
This call is supported for AF_INET only.
Return Value
If the call is successful, a 0 is returned. If the call fails, a -1 is
returned, and an error code is stored in errno.
Errors
The following errors are returned by getpeername:
Error Code |
Description |
[EBADF] |
The argument s is not a valid file 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 addr or addrlen parameters are not
valid pointers. |
[EINVAL] |
The socket has been shut down. |
[EOPNOTSUPP] |
The operation is not supported for AF_UNIX sockets. |
Author
UCB (University of California at Berkeley)
See Also
bind,
socket,
getsockname
|