xref: /original-bsd/lib/libc/sys/getsockname.2 (revision e2bb50a5)
Copyright (c) 1983 The Regents of the University of California.
All rights reserved.

%sccs.include.redist.man%

@(#)getsockname.2 6.3 (Berkeley) 06/23/90

GETSOCKNAME 2 ""
C 5
NAME
getsockname - get socket name
SYNOPSIS

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

DESCRIPTION
Getsockname returns the current name for the specified socket. 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).
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 [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"
bind(2), socket(2)
BUGS
Names bound to sockets in the UNIX domain are inaccessible; getsockname returns a zero length name.