NOMBRE

       connect - inicia una conexión en un conector (socket)

SINOPSIS

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

       int connect(int sockfd, const struct sockaddr *serv_addr, socklen_t addrlen);

DESCRIPCIÓN

       El  descriptor  de  fichero  sockfd debe referenciar a un conector.  Si el conector es del
       tipo SOCK_DGRAM entonces la dirección serv_addr es la dirección a la que  por  defecto  se
       envían los datagramas y la única dirección de la que se reciben datagramas. Si el conector
       es del tipo SOCK_STREAM o SOCK_SEQPACKET, esta llamada intenta hacer una conexión  a  otro
       conector.  El  otro conector está especificado por serv_addr, la cual es una dirección (de
       longitud addrlen)  en  el  espacio  de  comunicaciones  del  conector.   Cada  espacio  de
       comunicaciones interpreta el parámetro serv_addr a su manera.

       Generalmente,  los  conectores  de  protocolos orientados a conexión pueden conectarse con
       éxito mediante connect una vez solamente; los conectores de  protocolos  no  orientados  a
       conexión pueden usar connect múltiples veces para cambiar sus asociaciones. Los conectores
       de protocolos no orientados a conexión pueden disolver la asociación  conectandose  a  una
       dirección en la que al miembro sa_family de sockaddr se le ha asignado el valor AF_UNSPEC.

VALOR DEVUELTO

       Si la conexión o enlace tiene éxito, se devuelve 0. En caso de error, se devuelve -1, y se
       asigna a la variable errno un valor apropiado.

ERRORES

       Los siguientes sólo son errores generales de conector.  Puede haber otros códigos de error
       específicos del dominio.

       EBADF  El descriptor del fichero no es un índice válido de la tabla de descriptores.

       EFAULT La  estructura  de dirección del conector está fuera del espacio de direcciones del
              usuario.

       ENOTSOCK
              El descriptor del fichero no está asociado con un conector.

       EISCONN
              El conector ya está conectado.

       ECONNREFUSED
              No hay nadie escuchando en la dirección remota.

       ETIMEDOUT
              Finalizó el plazo de tiempo mientras se intentaba la conexión.  El  servidor  puede
              estar  demasiado  ocupado  para  aceptar  nuevas  conexiones.  Dese cuenta que para
              conectores IP el plazo de tiempo puede ser muy largo cuando se han  habilitado  los
              "syncookies" en el servidor.

       ENETUNREACH
              Red inaccesible.

       EADDRINUSE
              La dirección local ya está en uso.

       EINPROGRESS
              El conector es no bloqueante y la conexión no puede completarse inmediatamente.  Es
              posible usar select(2) o poll(2) para completarla seleccionando  el  conector  para
              escritura.   Después   que   select  indique  que  la  escritura  es  posible,  use
              getsockopt(2) para leer la opción SO_ERROR al nivel SOL_SOCKET para  determinar  si
              connect se completó con éxito (BSO_ERROR será cero) o sin éxito (BSO_ERROR será uno
              de los códigos de error usuales listados aquí, explicando la razón del fallo).

       EALREADY
              El conector es no bloqueante y todavía no se ha terminado un  intento  de  conexión
              anterior.

       EAGAIN No  hay  más  puertos locales libres o las entradas en la cache de enrutamiento son
              insuficientes. Para PF_INET vea la  sysctl  net.ipv4.ip_local_port_range  en  ip(7)
              para ver cómo incrementar el número de puertos locales.

       EAFNOSUPPORT
              La  dirección  pasada  no  tiene  la  familia  de  direcciones correcta en su campo
              sa_family.

       EACCES, EPERM
              El usuario ha intentado conectarse a una dirección de difusión (broadcast) sin  que
              el  conector  tenga  activa  la  opción  de  difusión, o la petición de conexión ha
              fallado debido a una regla del cortafuegos local.

CONFORME A

       SVr4, 4.4BSD (la función connect apareció por primera vez en  BSD  4.2).   SVr4  documenta
       adicionalmente  los  códigos  de  error  generales  EADDRNOTAVAIL,  EINVAL,  EAFNOSUPPORT,
       EALREADY, EINTR, EPROTOTYPE y  ENOSR.   También  documenta  muchas  condiciones  de  error
       adicionales que no se describen aquí.

NOTA

       El  tercer argumento de connect 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.   El
       estándar  propuesto  todavía  no  ha sido adoptado pero glibc2 ya lo sigue y también tiene
       socklen_t. Vea también accept(2).

FALLOS (BUGS)

       Desconectar un  conector  llamando  a  connect  con  una  dirección  AF_UNSPEC  no  se  ha
       implementado todavía.

VÉASE TAMBIÉN

       accept(2), bind(2), listen(2), socket(2), getsockname(2)