NOMBRE

       bind - enlaza un nombre a un conector (socket)

SINOPSIS

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

       int bind(int sockfd, struct sockaddr *my_addr, socklen_t addrlen);

DESCRIPCIÓN

       bind  da  al  conector  sockfd  la dirección local my_addr.  my_addr tiene una longitud de addrlen bytes.
       Tradicionalmente, esto se conoce como “asignar un nombre a un conector.”  Cuando un conector se crea  con
       socket(2), existe en un espacio de nombres (familia de direcciones) pero carece de nombre.

       Normalmente,  es necesario asignar una dirección local usando bind a un conector SOCK_STREAM antes de que
       éste pueda recibir conexiones (vea accept(2)).

       Las reglas usadas en el enlace de nombres varían entre familias de direcciones. Consulte las entradas  de
       manual  de  la Sección 7 para obtener una información más detallada. Para AF_INET vea ip(7), para AF_UNIX
       vea unix(7), para AF_APPLETALK vea ddp(7), para AF_PACKET vea packet(7), para AF_X25 vea  x25(7)  y  para
       AF_NETLINK vea netlink(7).

VALOR DEVUELTO

       Se  devuelve  0  en  caso  de  éxito.  En  caso  de error, se devuelve -1 y a errno se le asigna un valor
       apropiado.

ERRORES

       EBADF  sockfd no es un descriptor válido.

       EINVAL El  conector  ya  está  enlazado  a  una  dirección.  Esto  puede  cambiar  en  el  futuro:  véase
              linux/unix/sock.c para más detalles.

       EACCES La dirección está protegida y el usuario no es el superusuario.

       Los siguientes errores son específicos a los conectores del dominio UNIX (AF_UNIX):

       EINVAL La dirección addr_len es incorrecta o el conector no pertenecia a la familia AF_UNIX.

       EROFS  El nodo-i del conector reside en un sistema de ficheros de `sólo lectura'.

       EFAULT my_addr señala fuera del espacio de direcciones accesible por el usuario.

       ENAMETOOLONG
              my_addr es demasiado larga.

       ENOENT El fichero no existe.

       ENOMEM No hay suficiente memoria disponible en el núcleo.

       ENOTDIR
              Un componente del camino no es un directorio.

       EACCES El permiso de búsqueda ha sido denegado en uno de los componentes del camino.

       ELOOP  Se han encontrado demasiados enlaces simbólicos al resolver my_addr.

FALLOS

       No están descritas las opciones de proxy transparente.

CONFORME A

       SVr4,  4.4BSD (la función bind apareció por primera vez en BSD 4.2). SVr4 documenta condiciones generales
       de error adicionales: EADDRNOTAVAIL, EADDRINUSE y ENOSR, y condiciones de error específicas  del  dominio
       UNIX adicionales: EIO y EISDIR.

NOTA

       El  tercer  argumento  de bind es en realidad un entero (y esto es lo que tienen BSD 4.*, libc4 y libc5).
       Cierta confusión en POSIX dio como resultado el actual socklen_t. Véase también accept(2).

VÉASE TAMBIÉN

       accept(2), connect(2), listen(2), socket(2), getsockname(2), ip(7), socket(7)