Sockets Library Functions                           bind(3SOCKET)



NAME
     bind - bind a name to a socket

SYNOPSIS
     cc [ _f_l_a_g ... ] _f_i_l_e ... -lsocket -lnsl [ _l_i_b_r_a_r_y ... ]
     #include <sys/types.h>
     #include <sys/socket.h>

     int bind(int s, const struct sockaddr *name, int namelen);

DESCRIPTION
     bind() assigns a name to an unnamed socket. When a socket is
     created  with  socket(3SOCKET),  it  exists  in a name space
     (address family) but has no name assigned.  bind()  requests
     that the name pointed to by _n_a_m_e be assigned to the socket.

RETURN VALUES
     If the bind is successful, 0 is returned. A return value  of
     -1  indicates  an  error,  which is further specified in the
     global errno.

ERRORS
     The bind() call will fail if:

     EACCES
           The requested address is  protected  and  the  current
           user has inadequate permission to access it.

     EADDRINUSE
           The specified address is already in use.

     EADDRNOTAVAIL
           The specified address is not available  on  the  local
           machine.

     EBADF _s is not a valid descriptor.

     EINVAL
           _n_a_m_e_l_e_n is not the size of a  valid  address  for  the
           specified address family.

     EINVAL
           The socket is already bound to an address.

     ENOSR There were  insufficient  STREAMS  resources  for  the
           operation to complete.

     ENOTSOCK
           _s is a descriptor for a file, not a socket.

     The following errors are specific to binding  names  in  the
     UNIX domain:



SunOS 5.8           Last change: 22 Oct 1999                    1






Sockets Library Functions                           bind(3SOCKET)



     EACCES
           Search permission is denied for  a  component  of  the
           path prefix of the pathname in _n_a_m_e.

     EIO   An I/O error occurred while making the directory entry
           or allocating the inode.

     EISDIR
           A null pathname was specified.

     ELOOP Too many symbolic links were encountered in  translat-
           ing the pathname in _n_a_m_e.

     ENOENT
           A component of the path prefix of the pathname in _n_a_m_e
           does not exist.

     ENOTDIR
           A component of the path prefix of the pathname in _n_a_m_e
           is not a directory.

     EROFS The inode would reside on a read-only file system.

ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |______________________________|______________________________|
    | MT-Level                    | Safe                        |
    |______________________________|______________________________|


SEE ALSO
     unlink(2), socket(3SOCKET), attributes(5), socket(3HEAD)

NOTES
     Binding a name in the UNIX domain creates a  socket  in  the
     file system that must be deleted by the caller when it is no
     longer needed (using unlink(2)).

     The rules used in name binding  vary  between  communication
     domains.











SunOS 5.8           Last change: 22 Oct 1999                    2