Previous: Setting Address, Up: Socket Addresses

#### 16.3.3 Reading the Address of a Socket

Use the function `getsockname` to examine the address of an Internet socket. The prototype for this function is in the header file `sys/socket.h`.

— Function: int getsockname (int socket, struct sockaddr *addr, socklen_t *length-ptr)

> The `getsockname` function returns information about the address of the socket socket in the locations specified by the addr and length-ptr arguments. Note that the length-ptr is a pointer; you should initialize it to be the allocation size of addr, and on return it contains the actual size of the address data.

> The format of the address data depends on the socket namespace. The length of the information is usually fixed for a given namespace, so normally you can know exactly how much space is needed and can provide that much. The usual practice is to allocate a place for the value using the proper data type for the socket's namespace, then cast its address to `struct sockaddr *` to pass it to `getsockname`.

> The return value is `0` on success and `-1` on error. The following `errno` error conditions are defined for this function:

> `EBADF`
>   The socket argument is not a valid file descriptor.
> `ENOTSOCK`
>   The descriptor socket is not a socket.
> `ENOBUFS`
>   There are not enough internal buffers available for the operation.

You can't read the address of a socket in the file namespace. This is consistent with the rest of the system; in general, there's no way to find a file's name from a descriptor for that file.