getsockname

INtime Help

Get socket name.

#include <sys/types.h>
#include <sys/socket.h>

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

Description

The getsockname() system call returns the current name for the specified socket. The namelen argument 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).

Remarks

Names bound to sockets in the UNIX domain (not supported by INtime) are inaccessible; getsockname() returns a zero length name.

Return Values

The getsockname() function returns the value 0 if successful; otherwise the value -1 is returned and the global variable errno is set to indicate the error.

The call succeeds unless:

`EBADF`	The argument s is not a valid descriptor.
`ECONNRESET`	The connection has been reset by the peer.
`ENOTSOCK`	The argument s is a file, not a socket.
`ENOBUFS`	Insufficient resources were available in the system to perform the operation.
`EFAULT`	The name argument points to memory not in a valid part of the process address space.

Requirements

Versions	Link to
INtime 4.0	netlib.lib