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.
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)