.\" Hey Emacs! This file is -*- nroff -*- source. .\" .\" Copyright 1993 Rickard E. Faith (faith@cs.unc.edu) .\" Portions extracted from /usr/include/sys/socket.h, which does not have .\" any authorship information in it. It is probably available under the GPL. .\" .\" Permission is granted to make and distribute verbatim copies of this .\" manual provided the copyright notice and this permission notice are .\" preserved on all copies. .\" .\" Permission is granted to copy and distribute modified versions of this .\" manual under the conditions for verbatim copying, provided that the .\" entire resulting derived work is distributed under the terms of a .\" permission notice identical to this one .\" .\" Since the Linux kernel and libraries are constantly changing, this .\" manual page may be incorrect or out-of-date. The author(s) assume no .\" responsibility for errors or omissions, or for damages resulting from .\" the use of the information contained herein. The author(s) may not .\" have taken the same level of care in the production of this manual, .\" which is licensed free of charge, as they might when working .\" professionally. .\" .\" Formatted or processed versions of this manual, if unaccompanied by .\" the source, must acknowledge the copyright and authors of this work. .\" .\" .\" Other portions are from the 6.9 (Berkeley) 3/10/91 man page: .\" .\" Copyright (c) 1983 The Regents of the University of California. .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. All advertising materials mentioning features or use of this software .\" must display the following acknowledgement: .\" This product includes software developed by the University of .\" California, Berkeley and its contributors. .\" 4. Neither the name of the University nor the names of its contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" Translated 1 Jul 1996 miguel A. Sepulveda (angel@vivaldi.princeton.edu) .\" Revised Tue May 12 12:54:05 1998 by Cesar D. Lobejon (cesar@alien.mec.es) .\" Modified 1998,1999 by Andi Kleen .\" $Id: connect.2,v 1.1 2004/07/14 11:21:40 pepin.jimenez Exp $ .\" Translation revised Sun Apr 4 1999 by Juan Piernas .\" Translation revised Sat Jun 26 1999 by Juan Piernas .\" Translation revised Sat Jan 8 2000 by Juan Piernas .\" .TH CONNECT 2 "3 octubre 1998" "Linux 2.2" "Manual del Programador de Linux" .SH NOMBRE connect \- inicia una conexión en un conector (socket) .SH SINOPSIS .B #include .br .B #include .sp .BI "int connect(int " sockfd ", const struct sockaddr *" serv_addr , .BI "socklen_t " addrlen ");" .SH DESCRIPCIÓN El descriptor de fichero .I sockfd debe referenciar a un conector. Si el conector es del tipo .B SOCK_DGRAM entonces la dirección .I 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 .B SOCK_STREAM o .BR SOCK_SEQPACKET , esta llamada intenta hacer una conexión a otro conector. El otro conector está especificado por .IR serv_addr , la cual es una dirección (de longitud .IR addrlen ) en el espacio de comunicaciones del conector. Cada espacio de comunicaciones interpreta el parámetro .I serv_addr a su manera. .PP Generalmente, los conectores de protocolos orientados a conexión pueden conectarse con éxito mediante .B connect una vez solamente; los conectores de protocolos no orientados a conexión pueden usar .B 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 .I sa_family de .B sockaddr se le ha asignado el valor .BR AF_UNSPEC . .SH "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 .I errno un valor apropiado. .SH ERRORES Los siguientes sólo son errores generales de conector. Puede haber otros códigos de error específicos del dominio. .TP .B EBADF El descriptor del fichero no es un índice válido de la tabla de descriptores. .TP .B EFAULT La estructura de dirección del conector está fuera del espacio de direcciones del usuario. .TP .B ENOTSOCK El descriptor del fichero no está asociado con un conector. .TP .B EISCONN El conector ya está conectado. .TP .B ECONNREFUSED No hay nadie escuchando en la dirección remota. .TP .B 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. .TP .B ENETUNREACH Red inaccesible. .TP .B EADDRINUSE La dirección local ya está en uso. .TP .B EINPROGRESS El conector es no bloqueante y la conexión no puede completarse inmediatamente. Es posible usar .BR select (2) o .BR poll (2) para completarla seleccionando el conector para escritura. Después que .B select indique que la escritura es posible, use .BR getsockopt (2) para leer la opción .B SO_ERROR al nivel .B SOL_SOCKET para determinar si .B connect se completó con éxito .RB ( BSO_ERROR será cero) o sin éxito .RB ( BSO_ERROR será uno de los códigos de error usuales listados aquí, explicando la razón del fallo). .TP .B EALREADY El conector es no bloqueante y todavía no se ha terminado un intento de conexión anterior. .TP .B EAGAIN No hay más puertos locales libres o las entradas en la cache de enrutamiento son insuficientes. Para .B PF_INET vea la sysctl .B net.ipv4.ip_local_port_range en .BR ip (7) para ver cómo incrementar el número de puertos locales. .TP .B EAFNOSUPPORT La dirección pasada no tiene la familia de direcciones correcta en su campo .IR sa_family . .TP .B 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. .SH CONFORME A SVr4, 4.4BSD (la función .B connect apareció por primera vez en BSD 4.2). SVr4 documenta adicionalmente los códigos de error generales .BR EADDRNOTAVAIL , .BR EINVAL , .BR EAFNOSUPPORT , .BR EALREADY , .BR EINTR , .B EPROTOTYPE y .BR ENOSR . También documenta muchas condiciones de error adicionales que no se describen aquí. .SH NOTA El tercer argumento de .B 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 .BR accept (2). .SH FALLOS (BUGS) Desconectar un conector llamando a .B connect con una dirección .B AF_UNSPEC no se ha implementado todavía. .SH "VÉASE TAMBIÉN" .BR accept (2), .BR bind (2), .BR listen (2), .BR socket (2), .BR getsockname (2)