getsockname(2)
get socket name
LIBRARY
Lb libc
SYNOPSIS
In sys/types.h
In sys/socket.h
Ft int
Fn getsockname int s struct sockaddr * restrict name socklen_t * restrict namelen
DESCRIPTION
The
Fn getsockname
system call
returns the current
Fa name
for the specified socket.
The
Fa namelen
argument should be initialized to indicate
the amount of space pointed to by
Fa name .
On return it contains the actual size of the name
returned (in bytes).
RETURN VALUES
Rv -std getsockname
ERRORS
The call succeeds unless:
- Bq Er EBADF
-
The argument
Fa s
is not a valid descriptor.
- Bq Er ECONNRESET
-
The connection has been reset by the peer.
- Bq Er EINVAL
-
The value of the
Fa namelen
argument is not valid.
- Bq Er ENOTSOCK
-
The argument
Fa s
is a file, not a socket.
- Bq Er ENOBUFS
-
Insufficient resources were available in the system
to perform the operation.
- Bq Er EFAULT
-
The
Fa name
argument points to memory not in a valid part of the
process address space.
HISTORY
The
Fn getsockname
system call appeared in
BSD 4.2
BUGS
Names bound to sockets in the UNIX domain are inaccessible;
Fn getsockname
returns a zero length name.
