Who is Connected to Me?
-----------------------
- Function: int getpeername (int SOCKET, struct sockaddr *ADDR,
socklen_t *LENGTH-PTR)
The `getpeername' function returns the address of the socket that
SOCKET is connected to; it stores the address in the memory space
specified by ADDR and LENGTH-PTR. It stores the length of the
address in `*LENGTH-PTR'.
Note:Socket Addresses, for information about the format of the
address. In some operating systems, `getpeername' works only for
sockets in the Internet domain.
The return value is `0' on success and `-1' on error. The
following `errno' error conditions are defined for this function:
`EBADF'
The argument SOCKET is not a valid file descriptor.
`ENOTSOCK'
The descriptor SOCKET is not a socket.
`ENOTCONN'
The socket SOCKET is not connected.
`ENOBUFS'
There are not enough internal buffers available.