getsockname()

Updated: April 19, 2023

Get the name of a socket

Synopsis:

#include <sys/socket.h>

int getsockname( int s, 
                 struct sockaddr * name,
                 socklen_t * namelen );

Arguments:

s
The file descriptor of the socket whose name you want to get.
name
A pointer to a sockaddr object where the function can store the socket's name.
namelen
A pointer to a socklen_t object that initially indicates the amount of space pointed to by name. The function updates namelen to contain the actual size of the name (in bytes).

Library:

libsocket

Use the -l socket option to qcc to link against this library.

Description:

The getsockname() function returns the current name for the specified socket.

Returns:

0
Success.
-1
An error occurred (errno is set).

Errors:

EBADF
Invalid descriptor s.
EFAULT
The name parameter points to memory that isn't in a valid part of the process address space.
EINVAL
The socket has been shut down.
ENOBUFS
Insufficient resources were available in the system to perform the operation.

Classification:

POSIX 1003.1

Safety:  
Cancellation point No
Interrupt handler No
Signal handler Yes
Thread Yes