getpeername(2)
get name of connected peer
LIBRARY
Lb libc
SYNOPSIS
In sys/types.h
In sys/socket.h
Ft int
Fn getpeername int s struct sockaddr * restrict name socklen_t * restrict namelen
DESCRIPTION
The
Fn getpeername
system call
returns the name of the peer connected to
socket
Fa s .
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).
The name is truncated if the buffer provided is too small.
RETURN VALUES
Rv -std getpeername
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 ENOTCONN
-
The socket is not connected.
- 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 getpeername
system call appeared in
BSD 4.2
