Skip site navigation (1)Skip section navigation (2)

FreeBSD Man Pages

Man Page or Keyword Search:
Man Architecture
Apropos Keyword Search (all sections) Output format
home | help
GETSOCKNAME(2)		  FreeBSD System Calls Manual		GETSOCKNAME(2)

NAME
     getsockname -- get	socket name

LIBRARY
     Standard C	Library	(libc, -lc)

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

     int
     getsockname(int s,	struct sockaddr	*name, socklen_t *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).

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.

ERRORS
     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 parameter points to memory not	in a valid
			part of	the process address space.

SEE ALSO
     bind(2), getpeername(2), socket(2)

BUGS
     Names bound to sockets in the UNIX	domain are inaccessible; getsockname
     returns a zero length name.

HISTORY
     The getsockname() function	call appeared in 4.2BSD.

FreeBSD	10.1			 June 4, 1993			  FreeBSD 10.1

NAME | LIBRARY | SYNOPSIS | DESCRIPTION | RETURN VALUES | ERRORS | SEE ALSO | BUGS | HISTORY

Want to link to this manual page? Use this URL:
<http://www.freebsd.org/cgi/man.cgi?query=getsockname&sektion=2&manpath=FreeBSD+4.8-RELEASE>

home | help