Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

getsockname(2) [ultrix man page]

getsockname(2)							System Calls Manual						    getsockname(2)

Name
       getsockname - get socket name

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

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

Description
       The  system  call  returns the current name for the specified socket descriptor s.  The namelen parameter should be initialized to indicate
       the amount of space pointed to by name.	On return it contains the actual size, in bytes, of the name returned.

Return Values
       A zero is returned if the call succeeds, -1 if it fails.

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

Diagnostics
       The call succeeds unless:

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

       [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), socket(2)

																    getsockname(2)

Check Out this Related Man Page

getsockname(3SOCKET)					     Sockets Library Functions					      getsockname(3SOCKET)

NAME
getsockname - get socket name SYNOPSIS
cc [ flag ... ] file ... -lsocket -lnsl [ library ... ] #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 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 in bytes of the name returned. RETURN VALUES
If successful, getsockname() returns 0; otherwise it returns -1 and sets errno to indicate the error. ERRORS
The call succeeds unless: EBADF The argument s is not a valid file descriptor. ENOMEM There was insufficient memory available for the operation to complete. ENOSR There were insufficient STREAMS resources available for the operation to complete. ENOTSOCK The argument s is not a socket. ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |MT-Level |Safe | +-----------------------------+-----------------------------+ SEE ALSO
bind(3SOCKET), getpeername(3SOCKET), socket(3SOCKET), attributes(5) SunOS 5.10 12 Dec 1997 getsockname(3SOCKET)
Man Page