SOCKET
Section: Linux Programmer's Manual (2)Updated: 2009-01-19
查看本页索引 返回目录
名字
socket - 建立一个用于交流的端点概要
#include <sys/types.h> /* See NOTES */#include <sys/socket.h>
int socket(int domain, int type, int protocol);
描述
socket() 建立一个用于交流的端点并且返回一个描述符。The domain 参数指定一个通讯域名；选择的协议将会用于通讯。协议名在 <sys/socket.h> 中定义。 目前已知的格式包括：
| 名称 | 目的：手册页 | |
| AF_UNIX, 本地通讯: | unix(7) |
unix(7)
|
| AF_INET | IPv4 网络协议 |
ip(7)
|
| AF_INET6 | IPv6 网络协议 |
ipv6(7)
|
| AF_IPX | IPX - Novell 协议 | |
| AF_NETLINK | 内核用户界面设备 |
netlink(7)
|
| AF_X25 | ITU-T X.25 / ISO-8208 协议 |
x25(7)
|
| AF_AX25 | Amateur radio AX.25 protocol | |
| AF_ATMPVC | Access to raw ATM PVCs | |
| AF_APPLETALK | Appletalk |
ddp(7)
|
| AF_PACKET | 底层包连接 |
packet(7)
|
套接字通过 type, 参数来确定通信语义。目前定义的类型有：
- SOCK_STREAM
- 提供有序的，可靠的，双向的，基于字节流的通讯。可能支持带外传输。
- SOCK_DGRAM
- 提供数据报（不面向连接的, 不可靠的固定最大长度的信息）。
- SOCK_SEQPACKET
- 提供有序的，可靠的，双向的，基于固定最大长度的数据报传输路径；需要一个读取整个伴有输入系统调用的包的用户。
- SOCK_RAW
- 提供未加工(raw)的网络协议通道。
- SOCK_RDM
- 提供可靠的数据报层，但是不保证顺序。
- SOCK_PACKET
- 废弃的，不应该在新的程序中使用，参考 packet(7)。
一些套接字类型并未被所有的协议实现； 例如， SOCK_SEQPACKET 并不被 AF_INET 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 。 但是，可能存在着很多协议，但是在本手册的协议必须使用一个。协议用于指定通讯发生地方的``通讯域名''，参考 protocols(5) 。参考 getprotoent(3) 中关于如何把协议名称字符串与协议编号进行映射。
SOCK_STREAM 类型的套接字是双向直接数据流的，和管道十分相似。他们不对记录溢出提供保护。一个套接字流在接受或发出任何数据时必须处于 connected 的状态。和其它套接字通过 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)和 setsockopt(2) 用于分别用于设置和读取选项。
返回值
成功时，会返回新套接字的文件描述符。错误时，返回 -1 ，同时 errno 会被适当设置。错误
- EACCES
- 不允许创建指定的 类型 和/或 指定的协议的套接字。
- EAFNOSUPPORT
- 工具不支持指定的地址。
- EINVAL
- 未知协议，或协议组不可用。
- EINVAL
- 错误的 type 标志。
- EMFILE
- 进程文件表溢出。
- ENFILE
- 已经达到系统上限的文件打开数。
- ENOBUFS 或 ENOMEM
- 没有足够的内存，直到有可用的资源套接字不能被创建。
- EPROTONOSUPPORT
- 协议类型或指定的协议不被当前域所支持。
兼容性
4.4BSD, POSIX.1-2001.
SOCK_NONBLOCK 和 SOCK_CLOEXEC 标志是 Linux 特有的。 socket() appeared in 4.2BSD. 出现于 4.2BSD 。通常，非 BSD 系统的 BSD 套接字层克隆是可移植的（包括 System V 的变种）。
注意
并不要求包含 <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)。 中有一个使用 socket() 的例子。参见
accept(2), bind(2), connect(2), fcntl(2), getpeername(2), getsockname(2), getsockopt(2), ioctl(2), listen(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” 在 中被重印。
"BSD Interprocess Communication Tutorial" 在 UNIX Programmer's Supplementary Documents Volume 1 中被重印。
COLOPHON
This page is part of release 3.27 of the Linux man-pages project. A description of the project, and information about reporting bugs, can be found at http://www.kernel.org/doc/man-pages/. 译者于2011-07-26翻译，于2013-02-08修订 译文与原文的版权协议一致本页面中文版由中文 man 手册页计划提供。
中文 man 手册页计划：https://github.com/man-pages-zh/manpages-zh
Index
This document was created by man2html, using the manual pages.
Time: 03:18:35 GMT, July 01, 2024
