NAME    [Toc]    [Back]

     getsockname - get socket name

LIBRARY    [Toc]    [Back]

     Standard C Library (libc, -lc)

SYNOPSIS    [Toc]    [Back]

     #include <sys/socket.h>

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

DESCRIPTION    [Toc]    [Back]

     The getsockname() system call 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    [Toc]    [Back]

     A 0 is returned if the call succeeds, -1 if it fails.

ERRORS    [Toc]    [Back]

     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    [Toc]    [Back]

     bind(2), socket(2)

HISTORY    [Toc]    [Back]

     The getsockname() function call appeared in 4.2BSD.

BUGS    [Toc]    [Back]

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

BSD                            October 22, 2001                            BSD