.\" 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.
.\"
.\"     $Id: socket.2,v 1.4 1999/05/13 11:33:42 freitag Exp $
.\"
.\" 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>
.\" Modified 1998,1999 by Andi Kleen <ak@muc.de>
.\" Translated into Spanish Tue Feb 17 15:37:13 CET 1998 by
.\" 	Gerardo Aburruzaga Garca <gerardo.aburruzaga@uca.es>
.\" Translation revised Tue Apr 6 1999 by Juan Piernas <piernas@ditec.um.es>
.\" Translation revised Sun Jun 27 1999 by Juan Piernas <piernas@ditec.um.es>
.\"
.TH SOCKET 2 "24 abril 1999" "Pgina man de Linux" "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.
.PP
El parmetro
.I dominio
especifica un dominio de comunicaciones. Esto selecciona la familia de
protocol que se usar para la comunicacin. Estas familias se definen en
.BR <sys/socket.h> .
Los formatos actualmente reconocidos incluyen:
.TP
.BR PF_UNIX ", " PF_LOCAL
Protocolos UNIX para comunicacin local
.TP
.B PF_INET
Protocolos de Internet IPv4. Vea
.BR ip (7)
.TP
.B PF_INET6
Protocolos de Internet IPv6
.TP
.B PF_IPX
Protocolos IPX \- Novell
.TP
.B PF_NETLINK
Dispositivo de la intefaz de usuario del ncleo
.TP
.B PF_X25
Protocolo ITU-T X.25 / ISO-8208
.TP
.B PF_AX25
Protocolo AX.25 de radio para aficionados
.TP
.B PF_ATMPVC
Acceso directo a PVCs ATM
.TP
.B PF_APPLETALK
Appletalk. Vea
.BR ddp (7)
.TP
.B
PF_PACKET
Interfaz de paquetes de bajo nivel. Vea
.BR packet (7)
.PP
El conector tiene el
.I tipo
indicado, que especifica la semntica de la comunicacin. Los tipos
definidos en la actualidad son:
.TP
.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.
.TP
.B SOCK_DGRAM
Admite datagramas (mensajes no confiables, sin conexin, de una
longitud mxima fija).
.TP
.B SOCK_SEQPACKET
Proporciona un camino de transmisin de datos basado en
conexin bidireccional secuenciado, confiable, para datagramas de
longitud mxima fija; se requiere un consumidor para leer un
paquete entero con cada llamada al sistema de lectura.
.TP
.B SOCK_RAW
Proporciona acceso directo a los protocolos de red.
.TP
.B SOCK_RDM
Proporciona una capa de datagramas fiables que no garantiza el orden.
.TP
.B SOCK_PACKET
Obsoleto y no debera utilizarse en programas nuevos. Vea
.BR packet (7).
.PP
Algunos tipos de conectores pueden no ser implementados por todas las
familias de protocolos. Por ejemplo,
.B SOCK_SEQPACKET
no est actualmente implementado en Linux para
.BR AF_INET .
.PP
El
.I protocolo
especifica un protocolo particular para ser usado con el
conector. Normalmente slo existe un protocolo que admita un tipo
particular de conector 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 especfico al 
\*(lqdominio de comunicacin\*(rq en el que la comunicacin va a tener
lugar; vea 
.BR protocols (5).
Consulte
.BR getprotoent (3)
para ver cmo asociar una cadenas con el nombre de un protocolo a un nmero
de protocolo.
.PP
Los conectores del tipo
.B SOCK_STREAM
son flujos de bytes bidireccionales, similar a tuberas. Un conector 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 conector 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).
.PP
Los protocolos de comunicaciones que implementan 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 muerta. Cuando se activa
.B SO_KEEPALIVE
en el conector el protocolo comprueba de una manera especfica del protocolo
si el otro extremo todava est vivo. Se lanza una seal
.B SIGPIPE
si un proceso enva o recibe en un flujo roto; esto provoca que procesos
simples, que no manejan la seal, acaben.
Los conectores
.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. Tambin se conservarn todos los lmites de
mensaje en los datagramas que lleguen.
.PP
Los conectores
.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.
.PP
.B SOCK_PACKET
es un tipo de conector obsoleto para recibir paquetes crudos directamente
desde el manejador de dispositivo. Use
.BR packet (7)
en su lugar.
.PP
Una llamada a
.BR fcntl (2)
con el argumento
.B F_SETOWN
puede utilizarse para especificar que un grupo de proceso reciba una seal
.B SIGURG
cuando lleguen los datos fuera-de-banda o la seal
.B SIGPIPE
cuando una conexin
.B SOCK_STREAM
se rompa inesperadamente. Tambin puede usarse para configurar el proceso o
grupo de procesos que recibirn la E/S y la notificacin asncrona de los
eventos de E/S a travs de
.BR SIGIO .
Usar
.B F_SETOWN
es equivalente a una llamada a
.BR ioctl (2)
con el argumento SIOSETOWN.
.PP
Cuando la red seala una condicin de error al mdulo del protocolo (por
ejemplo, usando un mensaje ICMP para IP) se activa la bandera de error
pendiente para el conector. La siguiente operacin sobre ese conector
devolver el cdigo de error del error pendiente. Para algunos protocolos es
posible habilitar una cola de error por conector para obtener informacin
detallada del error. Vea
.B IP_RECVERR
en
.BR ip (7) .
.PP
La operacin de los conectores se controla por
.I opciones
en el nivel de los conectores.
Estas opciones se definen en
.IR <sys/socket.h> .
.BR Setsockopt (2)
y
.BR getsockopt (2)
se emplean para establecer y obtener opciones, respectivamente.
.SH "VALOR DEVUELTO"
Se devuelve un \-1 si ocurre un error; en otro caso el valor devuelto
es un descriptor para referenciar el conector.
.SH ERRORES
.TP 0.8i
.B EPROTONOSUPPORT
El tipo de protocolo, o el protocolo especificado, no es reconocido
dentro de este dominio.
.TP
.B ENFILE
No hay suficiente memoria en el ncleo para reservar una nueva estructura de
conector.
.TP
.B EMFILE
Se ha desbordado la tabla de ficheros del proceso.
.TP
.B EACCES
Se deniega el permiso para crear un conector del tipo o protocolo
especificado. 
.TP
.B ENOBUFS " o " ENOMEM
No hay suficiente memoria disponible. El conector no puede crearse hasta que
no queden libres los recursos suficientes.
.TP
.B EINVAL
Protocolo desconocido o familia de protocolo no disponible.
.PP
Los mdulos de los protocolos subyacentes pueden generar otros errores.
.SH "CONFORME A"
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 conectores de BSD
(incluyendo variantes System V).
.SH NOTA
Las constantes evidentes usadas en BSD 4.* para las familias de protocolos
son PF_UNIX, PF_INET, etc., mientras que AF_UNIX, etc. se usan para las
familias de direcciones. Sin embargo, ya la pgina de manual BSD promete:
"La familia de protocolos generalmente es la misma que la familia de
direcciones" y los estndares subsiguientes usan AF_* en todas partes.
.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)
.PP
\(lqAn Introductory 4.3 BSD Interprocess Communication Tutorial\(rq
est reimpreso en
.I UNIX Programmer's Supplementary Documents Volume 1.
.PP
\(lqBSD Interprocess Communication Tutorial\(rq
est reimpreso en
.I UNIX Programmer's Supplementary Documents Volume 1.