美文网首页
linux手册翻译——socket(2)

linux手册翻译——socket(2)

作者: 蟹蟹宁 | 来源:发表于2021-06-28 10:11 被阅读0次

    \color{#A00000}{NAME}
    socket - 创建一个用于通信的端点

    \color{#A00000}{SYNOPSIS}

    #include <sys/socket.h>
    int socket(int domain, int type, int protocol);
    

    \color{#A00000}{DESCRIPTION}
    socket() 创建用于通信的端点并返回引用该端点的文件描述符。 成功调用时返回的文件描述符,将是当前没有被进程打开的所有文件描述符中编号最低的。

    domain参数指定一个通信域; 以决定用于通信的协议族。 这些系列在 <sys/socket.h> 中定义。 目前 Linux 内核理解的格式包括:

    Name Purpose Man page
    AF_UNIX Local communication unix(7)
    AF_LOCAL Synonym for AF_UNIX
    AF_INET IPv4 Internet protocols ip(7)
    AF_AX25 Amateur radio AX.25 protocol ax25(4)
    AF_IPX IPX - Novell protocols
    AF_APPLETALK AppleTalk ddp(7)
    AF_X25 ITU-T X.25 / ISO-8208 protocol x25(7)
    AF_INET6 IPv6 Internet protocols ipv6(7)
    AF_DECnet DECet protocol sockets
    AF_KEY Key management protocol, originally developed for usage with IPsec
    AF_NETLINK Kernel user interface device netlink(7)
    AF_PACKET Low-level packet interface packet(7)
    AF_RDS Reliable Datagram Sockets (RDS) protocol rds(7) rds-rdma(7)
    AF_PPPOX Generic PPP transport layer, for setting up L2 tunnels (L2TP and PPPoE)
    AF_LLC Logical link control (IEEE 802.2 LLC) protocol
    AF_IB InfiniBand native addressing
    AF_MPLS Multiprotocol Label Switching
    AF_CAN Controller Area Network automotive bus protocol
    AF_TIPC TIPC, "cluster domain sockets" protocol
    AF_BLUETOOTH Bluetooth low-level socket protocol
    AF_ALG Interface to kernel crypto API
    AF_VSOCK VSOCK (originally "VMWare VSockets") protocol for hypervisor-guest communication vsock(7)
    AF_KCM KCM (kernel connection multiplexer) interface
    AF_XDP XDP (express data path) interface

    当然最常用的当然是AF_INET,即IPV4。
    上述地址族的更多详细信息以及其他几个地址族的信息可以在address_families(7)中找到。

    套接字具有指定的type,它指定了通信语义。 当前定义的类型有:

    • SOCK_STREAM
      数据流。提供有序的、可靠的、双向的、基于连接的字节流。 可以支持带外数据传输机制(Out-of-band data)。即我们的TCP。

    • SOCK_DGRAM
      支持数据报(固定最大长度的无连接、不可靠消息)。即我们的UDP。

    • SOCK_SEQPACKET
      为固定最大长度的数据报提供有序的、可靠的、基于双向连接的数据传输路径; 消费者需要在每次输入系统调用时读取整个数据包。

    • SOCK_RAW
      提供原生网络协议访问。

    • SOCK_RDM
      提供不保证排序的可靠数据报层。

    • SOCK_PACKET
      已过时,不应在新程序中使用。

    某些套接字类型可能不会被所有协议族实现。
    从 Linux 2.6.27 开始,type 参数有第二个用途:除了指定套接字类型之外,它还可以包含以下任何值的按位或,以修改 socket() 的行为:

    • SOCK_NONBLOCK
      Set the O_NONBLOCK file status flag on the open file description (see open(2)) referred to by the new file descriptor. Using this flag saves extra calls to fcntl(2) to achieve the same result.
    • SOCK_CLOEXEC
      Set the close-on-exec (FD_CLOEXEC) flag on the new file descriptor. See the description of the O_CLOEXEC flag in open(2) for reasons why this may be useful.

    老朋友了,上述两个,第一个是非阻塞,第二个是执行exec时自动关闭。

    protocol指定要与套接字一起使用的特定协议。 通常只存在一个协议来支持给定协议族中的特定套接字类型,在这种情况下,protocol 可以指定为 0。但是,可能存在许多协议,在这种情况下,必须在此指定特定协议方式。 特定协议对应的编号可以查看文件:/etc/protocols

    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)。

    An fcntl(2) F_SETOWN operation can be used to specify a process or process group to receive a SIGURG signal when the out-of-band data arrives or SIGPIPE signal when a SOCK_STREAM connection breaks unexpectedly. This operation may also be used to set the process or process group that receives the I/O and asynchronous notification of I/O events via SIGIO. Using F_SETOWN is equivalent to an ioctl(2) call with the FIOSETOWN or SIOCSPGRP argument.

    When the network signals an error condition to the protocol module (e.g., using an ICMP message for IP) the pending error flag is set for the socket. The next operation on this socket will return the error code of the pending error. For some protocols it is possible to enable a per-socket error queue to retrieve detailed information about the error; see IP_RECVERR in ip(7).

    套接字的操作由套接字选项控制。 这些选项在 <sys/socket.h> 中定义。 函数setsockopt(2) 和getsockopt(2) 用于设置和获取选项。对于选项的描述,详见socket(7).
    \color{#A00000}{RETURN VALUE}
    成功时,将返回新套接字的文件描述符。 出错时,返回 -1,并设置 errno 以指示错误。

    \color{#A00000}{ERRORS}

    • EACCES Permission to create a socket of the specified type and/or protocol is denied.
    • EAFNOSUPPORT The implementation does not support the specified address family.
    • EINVAL Unknown protocol, or protocol family not available.
    • EINVAL Invalid flags in type.
    • EMFILEThe per-process limit on the number of open file descriptors has been reached.
    • EMFILE The system-wide limit on the total number of open files has been reached.
    • ENOBUFS or ENOMEM 可用内存不足。 在释放足够的资源之前无法创建套接字。
    • EPROTONOSUPPORT The protocol type or the specified protocol is not supported within this domain.
      底层协议模块可能会产生其他错误。

    \color{#A00000}{CONFORMING TO}
    POSIX.1-2001, POSIX.1-2008, 4.4BSD.

    The SOCK_NONBLOCK and SOCK_CLOEXEC flags are Linux-specific.

    socket() appeared in 4.2BSD. It is generally portable to/from non-BSD systems supporting clones of the BSD socket layer (including System V variants).

    \color{#A00000}{NOTES}
    在 4.x BSD 下用于协议族的清单常量是 PF_UNIX、PF_INET 等,而 AF_UNIX、AF_INET 等用于地址族。 但是,BSD 手册页已经承诺:“协议族通常与地址族相同”,随后的标准到处都使用 AF_*。

    相关文章

      网友评论

          本文标题:linux手册翻译——socket(2)

          本文链接:https://www.haomeiwen.com/subject/xktqultx.html