.\" Copyright (c) 1983, 1991 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.
.\"
.\"     @(#)socket.2	6.8 (Berkeley) 3/10/91
.\"
.\" Modified Sat Jul 24 10:36:46 1993 by Rik Faith <faith@cs.unc.edu>
.\" Modified Tue Oct 22 22:10:43 1996 by Eric S. Raymond <esr@thyrsus.com>
.\" Translated into Spanish Tue Feb 17 15:37:13 CET 1998 by Gerardo
.\" Aburruzaga Garca <gerardo.aburruzaga@uca.es>
.\"
.TH SOCKET 2 "17 Febrero 1998" "BSD" "Manual del Programador de Linux"
.SH NOMBRE
socket \- crea un extremo de una comunicacin
.SH SINOPSIS
.B #include <sys/types.h>
.br
.B #include <sys/socket.h>
.sp
.BI "int socket(int " dominio ", int " tipo ", int " protocolo );
.SH DESCRIPCIN
.B Socket
crea un extremo de una comunicacin y devuelve un descriptor.

El parmetro
.I dominio
especifica un dominio de comunicaciones dentro del cual tendr lugar
la comunicacin; esto selecciona la familia de protocolo que deber
emplearse. Estas familias se definen en el fichero de cabecera
.IR sys/socket.h .
Los formatos actualmente reconocidos son

.RS
.TP 0.9i
AF_UNIX
(protocolos internos de UNIX)
.TP
AF_INET
(protocolos de ARPA Internet)
.TP
AF_ISO
(protocolos ISO)
.TP
AF_NS
(protocolos de Xerox Network Systems)
.TP
AF_IMPLINK
(capa de enlace IMP \*(lqanfitrin en IMP\*(rq)
.RE

El zcalo tiene el
.I tipo
indicado, que especifica la semntica de la comunicacin. Los tipos
definidos en la actualidad son:

.RS
.nf
SOCK_STREAM
SOCK_DGRAM
SOCK_RAW
SOCK_SEQPACKET
SOCK_RDM
.fi
.RE

Un tipo
.B SOCK_STREAM
proporciona flujos de bytes basados en una conexin bidireccional
secuenciada, confiable. Se puede admitir un mecanismo de transmisin
de datos fuera-de-banda.
Un zcalo
.B SOCK_DGRAM
soporta datagramas (mensajes no confiables, sin conexin, de una
longitud mxima (normalmente pequea) fija).
Un zcalo
.B SOCK_SEQPACKET
puede proporcionar un camino de transmisin de datos basado en
conexin bidireccional secuenciado, confiable, para datagramas de
longitud mxima fija; se puede requerir un consumidor para leer un
paquete entero con cada llamada al sistema de lectura. Esta facilidad
es especfica del protocolo, y est actualmente implementada solamente
para
.BR AF_NS .
Zcalos
.B SOCK_RAW
proporcionan acceso a interfaces y protocolos de red internos. Los tipos
.BR SOCK_RAW ,
que slo est disponible para el sper-usuario, y
.BR SOCK_RDM ,
que est planificado, pero no an implementado, no se describen aqu.

El
.I protocolo
especifica un protocolo particular para ser usado con el
zcalo. Normalmente slo existe un protocolo que admita un tipo
particular de zcalo dentro de una familia de protocolos dada. Sin
embargo, es posible que puedan existir varios protocolos, en cuyo caso
un protocolo particular puede especificarse de esta manera. El nmero
de protocolo a emplear es particular al 
\*(lqdominio de comunicacin\*(rq en el que la comunicacin va a tener
lugar; vea 
.BR protocols (5).

Los zcalos del tipo
.B SOCK_STREAM
son flujos de bytes bidireccionales, similar a tuberas. Un zcalo de
flujo debe estar en un estado
.I conectado
antes de que cualquier dato pueda ser enviado o recibido en l. Se
crea una conexin con otro zcalo mediante la llamada
.BR connect (2).
Una vez hecha la conexin, los datos pueden transferirse utilizando
llamadas 
.BR read (2)
y
.BR write (2)
o alguna variante de las llamadas
.BR send (2)
y
.BR recv (2).
Cuando una sesin se ha completado, se puede efectuar un
.BR close (2).
Los datos fuera-de-banda pueden transmitirse tambin como se describe en
.BR send (2)
y recibirse segn se describe en
.BR recv (2).

Los protocolos de comunicaciones usados para implementar un
.B SOCK_STREAM
aseguran que los datos no se pierden ni se duplican. Si un trozo de
dato para el cual el protocolo de la pareja tiene espacio de bfer no
puede ser transmitido satisfactoriamente en un perodo razonable de
tiempo, entonces la conexin se considera rota y las llamadas
indicarn un error devolviendo \-1 y con el cdigo
.B ETIMEDOUT
en la variable global
.IR errno .

Los protocolos opcionalmente mantienen los zcalos
.I calientes
forzando transmisiones ms o menos cada minuto en ausencia de otra
actividad. Entonces se induce un error si no se descubre una respuesta
en una conexin en otro caso inactiva en un perodo extendido de
tiempo (p. ej. 5 minutos). Se lanza una seal
.B SIGPIPE
si un proceso enva en un flujo roto; esto provoca que procesos
simples, que no manejan la seal, acaben.

Los zcalos
.B SOCK_SEQPACKET
emplean las mismas llamadas al sistema que los
.BR SOCK_STREAM .
La nica diferencia es que las llamadas a
.BR read (2)
devolvern solamente la cantidad de datos pedidos, y los que queden en
el paquete que llega se perdern.

Los zcalos
.B SOCK_DGRAM
y
.B SOCK_RAW
permiten el envo de datagramas a los correspondientes nombrados en
llamadas a 
.BR send (2).
Los datagramas se reciben generalmente con
.BR recvfrom (2),
que devuelve el siguiente datagrama con su direccin de retorno.

Una llamada a
.BR fcntl (2)
puede utilizarse para especificar que un grupo de proceso reciba una seal
.B SIGURG
cuando lleguen los datos fuera-de-banda. Tambin puede activar la E/S
no bloqueante y la notificacin asncrona de los eventos a travs de
.BR SIGIO .

La operacin de los zcalos se controla por
.I opciones
en el nivel de los zcalos.
Estas opciones se definen en el fichero de cabecera
.IR sys/socket.h .
.BR Setsockopt (2)
y
.BR getsockopt (2)
se emplean para establecer y obtener opciones, respectivamente.
.SH "VALORES DEVUELTOS"
Se devuelve un \-1 si ocurre un error; en otro caso el valor devuelto
es un descriptor para referenciar el zcalo.
.SH ERRORES
.TP 0.8i
.B EPROTONOSUPPORT
El tipo de protocolo, o el protocolo especificado, no es reconocido
dentro de este dominio.
.TP
.B EMFILE
La tabla de descriptores por proceso est llena.
.TP
.B ENFILE
La tabla de ficheros del sistema est llena.
.TP
.B EACCES
Se deniega el permiso para crear un zcalo del tipo o protocolo
especificado. 
.TP
.B ENOBUFS
No hay bastante espacio de bfer. El zcalo no puede crearse hasta que
no queden libres los recursos suficientes.
.SH "CONFORME CON"
4.4BSD (la llamada a funcin
.B socket
apareci en 4.2BSD). Generalmente transportable a o desde 
sistemas no BSD que admitan clones de la capa de zcalos de BSD
(incluyendo variantes System V).
.SH "VASE TAMBIN"
.BR accept "(2), " bind "(2), " connect "(2), " getprotoent "(3), "
.BR getsockname "(2), " getsockopt "(2), " ioctl "(2), " listen "(2), "
.BR read "(2), " recv "(2), " select "(2), " send "(2), " shutdown "(2), "
.BR socketpair "(2), " write (2)
.sp
"An Introductory 4.3 BSD Interprocess Communication Tutorial"
est reimpreso en
.I UNIX Programmer's Supplementary Documents Volume 1
.sp
"BSD Interprocess Communication Tutorial"
est reimpreso en
.I UNIX Programmer's Supplementary Documents Volume 1