xref: /original-bsd/lib/libc/sys/getpeername.2 (revision 61b6c03f)
Copyright (c) 1983 Regents of the University of California.
All rights reserved. The Berkeley software License Agreement
specifies the terms and conditions for redistribution.

@(#)getpeername.2 6.2 (Berkeley) 05/13/86

GETPEERNAME 2 ""
C 5
NAME
getpeername - get name of connected peer
SYNOPSIS

getpeername(s, name, namelen) int s; struct sockaddr *name; int *namelen;

DESCRIPTION
Getpeername returns the name of the peer connected to socket s . The namelen parameter 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). The name is truncated if the buffer provided is too small.
DIAGNOSTICS
A 0 is returned if the call succeeds, -1 if it fails.
ERRORS
The call succeeds unless:

15 [EBADF] The argument s is not a valid descriptor.

15 [ENOTSOCK] The argument s is a file, not a socket.

15 [ENOTCONN] The socket is not connected.

15 [ENOBUFS] Insufficient resources were available in the system to perform the operation.

15 [EFAULT] The name parameter points to memory not in a valid part of the process address space.

"SEE ALSO"
accept(2), bind(2), socket(2), getsockname(2)