I have tranlate socket(2) man into chinese

subscribe linux-man

I will format it later

In memories of HIZUKI AYAKA ,the angel!

月
吹智也

SOCKET（2）

名字
socket - 建立一个用于交流的端点

概要

	#include <sys/type.h>  /*参见注意*/
	#include <sys/socket.h>

	int socket(int domain, int type, int protocol);

描述
socket() 建立一个用于交流的端点并且返回一个描述。

domain 参数指定一个通讯域名；选择的协议将会用于通讯。协议名在 <sys/socket.h> 中定义。 目前已知的格式包括：

名称 目的 手册页
AF_UNIX, AF_LOCAL 本地通讯 unix(7)
AF_INET IPv4 网络协议 ip(7)
AF_INET6 IPv6 网络协议 ipv6(7)
AF_IPX IPX - Novell 协议
AF_NETLINK Kernel user interface device netlink(7)
AF_X25 ITU-T X.25 / ISO-8208 协议 x25(7)
AF_AX25 Amateur radio AX.25 协议
AF_ATMPVC Access to raw ATM PVCs
AF_APPLETALK Appletalk ddp(7)
AF_PACKET Low level packet interface packet(7)

套接字 通过 type 参数来确定通信语义。目前定义的类型有：

SOCK_STREAM 提供有序的，可靠的，双向的，基于字节流的通讯。可能支持多信道传输。

SOCK_DGRAM 提供数据报（不面向连接的, 不可靠的固定最大长度的信息）

SOCK_SEQPACKET 提供有序的，可靠的，双向的，基于固定最大长度的数据报传输路径；需要一个读取整个伴有输入系统调用的包的用户。

SOCK_RAW 提供未加工(raw)的网络协议通道。

SOCK_RDM 提供可靠的数据报层，但是不保证顺序。

SOCK_PACKET 废弃的，不应该在新的程序中使用，参考packet(7)。

一些套接字类型并未被所有的协议实现； 例如，SOCK_SEQPACKET 并不被 AF_INET 实现。

从 Linux 2.6.27 开始， type 参数可以提供其他的功能： 注意一些 套接字 类型可能包括一下值的或位，用来修改 socket() 的行为。

SOCK_NONBLOCK 设置 O_NONBLOCK 的标志于新打开的文件描述符。 通过这个标志可以不用调用 fcntl(2) 来达到相同的结果。

SOCK_CLOEXEC 设置 close-on-exec (FD_CLOEXEC) 的标志于新打开的文件描述符。参加 open(2) 中关于 O_CLOEXEC 的描述，因为
一些原因这个标志很有用。

protocol 指定一个协议用于套接字。一般情况下，在给定的协议中只允许在一个 套接字 上使用一个协议， 注意 protocol 可以知道为数字 0 。 但是， 可能存在着很多协议， 但是在本手册的协议必须使用一个。协议用于指定通讯发生地方的“通讯域名”， 参考 protocol(5) 。 参考 getprotoent(3) 中关于如何把协议名称字符串与协议编号进行映射。

SOCK_STREAM 类型的套接字是双向直接流， 和管道十分相似。 他们不对记录溢出提供保护。 一个套接字流在接受或发出任何数据时必须处于已连接的状态。和其它套接字通过connect(2) 调用来建立连接。 一旦连接， 数据可能通过 read(2) 和 write(2) 调用传输，也或者是不同的 send(2) 和 recv(2) 调用。当会话结束时，可能会执行 close(2)。带外数据可能也用 send(2) 和 recv(2) 描述与接受。

SOCK_STREAM 类型的的通信协议应确保信息不丢失与重复。如果一块有协议缓冲的数据不能在合理时间内传输，连接会被认为超时。当在套接字上启用 SO_KEEPALIVE ，协议会以其特定方式检查另一端是否活着。当一个进程接受或发送了一个错误的数据流，会产生并接受一个 SIGPIPE 信号；对于采取默认处理此信号的进程，它将会退出。SOCK_SEQPACKET 套接字采用和 SOCK_STREAM 套接字相同的系统调用。唯一不同的是，read(2) 系统调用只会返回请求的数据量，并将余下到达的任何数据数据包丢弃。此外所有的消息边界的传入的​​数据报将被保留。

SOCK_DGRAM 和 SOCK_RAW 类型的套接字支持用 sendto(2) 系统调用来发送数据报， 器数据报通常是用 recvfrom(2) 来接受的，这个调用会在下一个数据报中单独的返回发送者的地址。

SOCK_PACKET 是一个遗留的套接字类型，用来从设备驱动中接受原始数据，已经被 packet(7) 调用取代。

fcntl(2) 的 F_SETOWN 操作可以在带外数据到达时让进程或进程组会收到一个 SIGURG 信号，或者在 SOCK_STREAM 类型的连接在被不期望地打断时，收到 SIGPIPE 信号。这个操作也可能被用于让进程或进程组通过 SIGIO 接收 I/O 和 I/O 不同步的通知。使用 F_SETOWN
等同于使用了 FIOSETOWN 或 SIOCSPGRP 参数的 ioctl(2) 系统调用。

当网络向协议模型发出一个错误情况的信号(例如, 对 IP 使用 ICMP 消息） ，套接字将会设置上 pending 错误标志。 对套接字接下去的操作将会返回 pending 错误的错误代码。对于一些协议，可能会为每一个接字接启用一个用于取出详细错误信息的错误列队； 参见 ip(7) 中的 IP_RECVERR 。

套接字的操作由套接字级的选项来控制。 这些选项定义于 <sys/socket.h> 中。 setsockopt(2) 和 getsockopt(2) 用于分别用于设置和读取选项。

返回值
成功时，会返回新套接字的文件描述符。错误时，返回 -1 ，同时 errno 会被适当设置。

错误
EACCES 不允许创建指定的 类型 和/或 指定的协议的套接字。

EAFNOSUPPORT
工具不支持指定的地址。

EINVAL 未知协议，或协议组不可用。

EINVAL 错误的 type 标志。

EMFILE 进程文件表溢出。

ENFILE 已经达到系统上限的文件打开数。

ENOBUFS 或 ENOMEM
没有足够的内存，直到有可用的资源套接字不能被创建。

EPROTONOSUPPORT
协议类型或指定的协议不被当前域所支持。

其它的错误可能是由协议模型产生的。

兼容性
4.4BSD, POSIX.1-2001.

SOCK_NONBLOCK 与 SOCK_CLOEXEC 标志是 Linux 特有的。

socket() 出现于 4.2BSD 。通常，非 BSD 系统的 BSD 套接字层克隆是可移植的（包括 System V 的变种）。

注意
POSIX.1-2001 并不要求包含 <sys/types.h> ，这个头文件在 Linux 下是不必须的。 可是一些历史上的 (BSD) 工具要求这个头文件， 可移植程序很可能希望包含它。

4.x BSD 下明显固定的协议组有 PF_UNIX ， PF_INET ，等等，但是 AF_UNIX 等，它们是用于地址组的。可是 BSD 的 man page 保证“ 协议组一般等于地址组“，随后的标准在每个地方都使用了 AF_* 。

<sys/types.h> 文件头只在 libc4 以前是必须的。 一些包， 如 util-linux, claim ，是用于在所以 Linux 版本和库上可移植的。它们确实需要这个头文件。

例子
在 getaddrinfo(3) 中有一个使用套接字的例子。

参见

       accept(2),  bind(2),  connect(2),  fcntl(2),  getpeername(2), getsockname(2), getsockopt(2), ioctl(2), lis‐
       ten(2), read(2), recv(2), select(2), send(2), shutdown(2), socketpair(2), write(2), getprotoent(3),  ip(7),
       socket(7), tcp(7), udp(7), unix(7)

	“An  Introductory  4.3BSD Interprocess Communication Tutorial” 在 UNIX Programmer's Supplementary Documents Volume 1 中被重印。
 	
	“BSD Interprocess Communication Tutorial” 在 UNIX Programmer's Supplementary Documents Volume 1 中被重印