GETSOCKNAME(2)	    UNIX Programmer's Manual	   GETSOCKNAME(2)



NAME
     getsockname - get socket name

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

DESCRIPTION
     _G_e_t_s_o_c_k_n_a_m_e returns the current _n_a_m_e for the specified
     socket.  The _n_a_m_e_l_e_n parameter should be initialized to
     indicate the amount of space pointed to by _n_a_m_e.  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:

     [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 _n_a_m_e 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;
     _g_e_t_s_o_c_k_n_a_m_e returns a zero length name.


















Printed 11/26/99	  May 15, 1985				1