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)