zmq_getsockopt(3)

'ZMQ_AFFINITY' 选项将检索指定 'socket' 上新建连接的 I/O 线程亲和性。

亲和性决定了套接字的 context 相关联的 0MQ I/O 线程池中的哪些线程将处理新建连接。值为零表示没有亲和性，意味着工作将在线程池中的所有 0MQ I/O 线程之间公平分配。对于非零值，最低位对应于线程 1，次低位对应于线程 2，依此类推。例如，值为 3 指定 'socket' 上的后续连接将由 I/O 线程 1 和 2 专门处理。

另请参阅 zmq_init 以获取关于为特定 context 分配 I/O 线程数量的详细信息。

'ZMQ_BACKLOG' 选项将检索指定 'socket' 的未完成对等端连接队列的最大长度；这仅适用于面向连接的传输。详细信息请参考您的操作系统关于 'listen' 函数的文档。

'ZMQ_BINDTODEVICE' 选项检索此套接字绑定的设备名称，例如接口或 VRF。如果套接字绑定到某个接口，则套接字只处理从该接口接收到的数据包。如果设备是 VRF 设备，则后续绑定/连接到该套接字将使用 VRF 路由表中的地址。

检索 connect() 系统调用超时前等待的时间。connect() 系统调用通常需要很长时间才会返回超时错误。设置此选项允许库在更短的时间间隔内使调用超时。

检索套接字的当前长期公钥。您可以提供 32 字节的缓冲区来检索二进制密钥值，或者提供 41 字节的缓冲区来检索可打印的 Z85 格式密钥。注意：要获取可打印的密钥，缓冲区必须有 41 字节大小，以容纳 40 个字符的密钥值和一个 null 字节。

检索套接字的当前长期私钥。您可以提供 32 字节的缓冲区来检索二进制密钥值，或者提供 41 字节的缓冲区来检索可打印的 Z85 格式密钥。注意：要获取可打印的密钥，缓冲区必须有 41 字节大小，以容纳 40 个字符的密钥值和一个 null 字节。

检索客户端套接字的当前服务器密钥。您可以提供 32 字节的缓冲区来检索二进制密钥值，或者提供 41 字节的缓冲区来检索可打印的 Z85 格式密钥。注意：要获取可打印的密钥，缓冲区必须有 41 字节大小，以容纳 40 个字符的密钥值和一个 null 字节。

'ZMQ_EVENTS' 选项将检索指定 'socket' 的事件状态。返回的值是一个位掩码，由以下事件标志的组合进行 OR 操作构建而成：

由 'ZMQ_FD' 选项返回的文件描述符已准备好读取，但后续检索 'ZMQ_EVENTS' 选项未返回实际事件的组合是有效的；应用程序应简单地忽略这种情况，并重新启动其轮询操作/事件循环。

'ZMQ_FD' 选项将检索与指定 'socket' 关联的文件描述符。返回的文件描述符可用于将套接字集成到现有事件循环中；0MQ 库将通过使文件描述符变为可读来以边缘触发的方式指示套接字上的任何待处理事件。

返回之前在套接字上设置的 'ZMQ_GSSAPI_PLAINTEXT' 选项（如果存在）。值为 '1' 表示通信将使用明文。值为 '0' 表示通信将加密。

'ZMQ_GSSAPI_PRINCIPAL' 选项将检索为 GSSAPI 安全机制设置的主体名称。返回的值将是一个以 NULL 结尾的字符串，可以为空。返回的大小应包含结尾的 null 字节。

返回之前在套接字上设置的 'ZMQ_GSSAPI_SERVER' 选项（如果存在）。

'ZMQ_GSSAPI_SERVICE_PRINCIPAL' 选项将检索 GSSAPI 客户端套接字打算连接到的 GSSAPI 服务器的主体名称。返回的值将是一个以 NULL 结尾的字符串，可以为空。返回的大小应包含结尾的 null 字节。

返回之前在套接字上设置的 'ZMQ_GSSAPI_SERVICE_PRINCIPAL_NAMETYPE' 选项（如果存在）。值为 'ZMQ_GSSAPI_NT_HOSTBASED' (0) 表示用 'ZMQ_GSSAPI_SERVICE_PRINCIPAL' 指定的名称被解释为主机名。值为 'ZMQ_GSSAPI_NT_USER_NAME' (1) 表示被解释为本地用户名。值为 'ZMQ_GSSAPI_NT_KRB5_PRINCIPAL' (2) 表示被解释为未解析的主体名称字符串（仅对 krb5 GSSAPI 机制有效）。

返回之前在套接字上设置的 'ZMQ_GSSAPI_PRINCIPAL_NAMETYPE' 选项（如果存在）。值为 'ZMQ_GSSAPI_NT_HOSTBASED' (0) 表示用 'ZMQ_GSSAPI_PRINCIPAL' 指定的名称被解释为主机名。值为 'ZMQ_GSSAPI_NT_USER_NAME' (1) 表示被解释为本地用户名。值为 'ZMQ_GSSAPI_NT_KRB5_PRINCIPAL' (2) 表示被解释为未解析的主体名称字符串（仅对 krb5 GSSAPI 机制有效）。

'ZMQ_HANDSHAKE_IVL' 选项将检索指定 'socket' 的最大握手间隔。握手是在首次打开连接时发生的套接字配置信息（套接字类型、路由 ID、安全设置）交换，仅适用于面向连接的传输。如果在配置的时间内未完成握手，连接将被关闭。值 0 表示没有握手时间限制。

此选项名称现已废弃。请使用 ZMQ_ROUTING_ID 代替。目前 ZMQ_IDENTITY 仍作为别名保留。

检索连接时附加值的状态。如果设置为 1，将延迟连接时管道的附加，直到底层连接完成。如果没有其他连接，这将导致套接字阻塞，但会防止等待连接的管道队列填满。

返回 'ZMQ_INVERT_MATCHING' 选项的值。值为 1 表示套接字使用反转前缀匹配。

在 'PUB' 和 'XPUB' 套接字上，这会导致消息发送到所有连接的套接字，'除了' 订阅了与消息匹配的前缀的那些。在 'SUB' 套接字上，这会导致用户只接收与套接字任何订阅都'不'匹配的传入消息。

无论何时在 'PUB' 套接字上将 'ZMQ_INVERT_MATCHING' 设置为 1，所有连接到它的 'SUB' 套接字也必须将此选项设置为 1。否则将导致 'SUB' 套接字拒绝 'PUB' 套接字发送给它们的所有内容。'XSUB' 套接字不需要这样做，因为它们不过滤传入消息。

检索套接字的仅 IPv4 选项。此选项已废弃。请使用 ZMQ_IPV6 选项。

检索套接字的 IPv6 选项。值为 1 表示套接字上启用了 IPv6，而 0 表示套接字仅使用 IPv4。启用 IPv6 后，套接字将连接到 IPv4 和 IPv6 主机，或接受来自它们的连接。

'ZMQ_LAST_ENDPOINT' 选项将检索 TCP 和 IPC 传输绑定的最后一个端点。返回的值将是 ZMQ DSN 格式的字符串。请注意，如果 TCP 主机是 INADDR_ANY（由 * 表示），则返回的地址将是 0.0.0.0（对于 IPv4）。注意：由于 getsockname() 不工作，在 GNU/Hurd 上不支持 IPC。

'ZMQ_LINGER' 选项将检索指定 'socket' 的逗留期。逗留期决定了套接字通过 zmq_close 关闭后，尚未发送给对等端的待处理消息将在内存中停留多久，并进一步影响通过 zmq_ctx_term 终止套接字的 context。以下概述了不同的行为：

该选项将检索入站消息的限制。如果对等端发送的消息大于 ZMQ_MAXMSGSIZE，它将被断开连接。值 -1 表示“无限制”。

'ZMQ_MECHANISM' 选项将检索套接字的当前安全机制。

该选项将检索出站多播数据包使用的生存时间。默认值 1 表示多播数据包不会离开本地网络。

'ZMQ_MULTICAST_MAXTPDU' 选项将检索出站多播数据包使用的最大传输数据单元大小。

此值必须设置为小于或等于所有需要多播接收的网络路径的最小最大传输单元（MTU）。

'ZMQ_PLAIN_PASSWORD' 选项将检索为 PLAIN 安全机制设置的最后一个密码。返回的值将是一个以 NULL 结尾的字符串，可以为空。返回的大小应包含结尾的 null 字节。

返回之前在套接字上设置的 'ZMQ_PLAIN_SERVER' 选项（如果存在）。

'ZMQ_PLAIN_USERNAME' 选项将检索为 PLAIN 安全机制设置的最后一个用户名。返回的值将是一个以 NULL 结尾的字符串，可以为空。返回的大小应包含结尾的 null 字节。

'ZMQ_USE_FD' 选项将检索已分配给 ZMQ 套接字的预分配文件描述符（如果存在）。如果套接字未设置预分配文件描述符，将返回 -1。

ZMQ_PRIORITY: 检索套接字优先级 _{~~~~~~~~~~~~~}~ 获取将在此套接字上发送的所有数据包的协议定义优先级，操作系统支持时有效。

'ZMQ_RATE' 选项将检索使用指定 'socket' 的多播传输的最大发送或接收数据速率。

'ZMQ_RCVBUF' 选项将检索指定 'socket' 的底层内核接收缓冲区大小。详细信息请参考您的操作系统关于 'SO_RCVBUF' 套接字选项的文档。

'ZMQ_RCVHWM' 选项将返回指定 'socket' 上入站消息的高水位标记。高水位标记是 0MQ 为指定 'socket' 与之通信的任何单个对等端在内存中排队的最大未处理消息数的硬限制。值为零表示无限制。

如果达到此限制，套接字将进入异常状态，并且根据套接字类型，0MQ 将采取适当的行动，例如阻塞或丢弃已发送的消息。关于每种套接字类型采取的具体行动的详细信息，请参考 zmq_socket 中的单独套接字描述。

'ZMQ_RCVMORE' 选项将返回 True (1)，如果从 'socket' 最后接收到的消息部分是带有更多后续部分的。如果没有后续的数据部分，此选项将返回 False (0)。

有关多部分消息的详细描述，请参考 zmq_send 和 zmq_recv。

检索套接字上接收操作的超时时间。如果值为 0，zmq_recv(3) 将立即返回，如果没有可接收的消息，则返回 EAGAIN 错误。如果值为 -1，将阻塞直到有消息可用。对于所有其他值，它将等待该时间量，然后返回 EAGAIN 错误。

'ZMQ_RECONNECT_IVL' 选项将检索指定 'socket' 的初始重连间隔。重连间隔是 0MQ 在尝试重连断开的对等端时（使用面向连接的传输）等待的时间段。值 -1 表示不重连。

'ZMQ_RECONNECT_IVL_MAX' 选项将检索指定 'socket' 的最大重连间隔。0MQ 在重连尝试之间最多等待配置的时间间隔。间隔会随每次尝试呈指数增长（即：加倍），直到达到 ZMQ_RECONNECT_IVL_MAX。默认值表示重连间隔完全基于 ZMQ_RECONNECT_IVL，并且不执行指数退避。

'ZMQ_RECONNECT_STOP' 选项将检索自动重连将停止的条件。

'ZMQ_RECONNECT_STOP_CONN_REFUSED' 选项将在 0MQ 从 connect 接收到 ECONNREFUSED 返回码时停止重连。这表明指定端点没有绑定任何代码。

'ZMQ_RECOVERY_IVL' 选项将检索使用指定 'socket' 的多播传输的恢复间隔。恢复间隔决定了接收者可以离开多播组的最大时间（以毫秒为单位），超过此时间将发生不可恢复的数据丢失。

'ZMQ_ROUTING_ID' 选项将检索指定 'socket' 的路由 ID。路由 ID 仅由请求/应答模式使用。具体来说，它可以与 ROUTER 套接字结合使用，将消息路由到具有特定路由 ID 的对等端。

路由 ID 必须至少为一字节，最多为 255 字节长。以零字节开头的身份保留供 0MQ 基础设施使用。

'ZMQ_SNDBUF' 选项将检索指定 'socket' 的底层内核发送缓冲区大小。详细信息请参考您的操作系统关于 'SO_SNDBUF' 套接字选项的文档。

'ZMQ_SNDHWM' 选项将返回指定 'socket' 上出站消息的高水位标记。高水位标记是 0MQ 为指定 'socket' 与之通信的任何单个对等端在内存中排队的最大未处理消息数的硬限制。值为零表示无限制。

如果达到此限制，套接字将进入异常状态，并且根据套接字类型，0MQ 将采取适当的行动，例如阻塞或丢弃已发送的消息。关于每种套接字类型采取的具体行动的详细信息，请参考 zmq_socket 中的单独套接字描述。

检索套接字上发送操作的超时时间。如果值为 0，zmq_send(3) 将立即返回，如果无法发送消息，则返回 EAGAIN 错误。如果值为 -1，将阻塞直到消息发送成功。对于所有其他值，它将尝试发送消息该时间量，然后返回 EAGAIN 错误。

'ZMQ_SOCKS_PROXY' 选项将检索 SOCKS5 代理地址的字符串格式。返回的值将是一个以 NULL 结尾的字符串，可以为空。返回的大小应包含结尾的 null 字节。

覆盖 'SO_KEEPALIVE' 套接字选项（操作系统支持时）。默认值 -1 表示跳过任何覆盖并使用操作系统默认值。

覆盖 'TCP_KEEPCNT' 套接字选项（操作系统支持时）。默认值 -1 表示跳过任何覆盖并使用操作系统默认值。

覆盖 'TCP_KEEPIDLE'（某些操作系统上是 'TCP_KEEPALIVE'）套接字选项（操作系统支持时）。默认值 -1 表示跳过任何覆盖并使用操作系统默认值。

覆盖 'TCP_KEEPINTVL' 套接字选项（操作系统支持时）。默认值 -1 表示跳过任何覆盖并使用操作系统默认值。

在支持的操作系统上，检索未确认 TCP 重传超时前的时间。系统通常遵循指数退避策略进行多次 TCP 重传。这意味着在网络中断后，可能需要很长时间才能重新建立会话。设置此选项允许在更短的时间间隔内发生超时。

'ZMQ_THREAD_SAFE' 选项将检索一个布尔值，指示套接字是否线程安全。请参阅 zmq_socket 了解哪些套接字是线程安全的。

检索套接字的 IP_TOS 选项。

'ZMQ_TYPE' 选项将检索指定 'socket' 的套接字类型。套接字类型在创建套接字时指定，之后无法修改。

'ZMQ_ZAP_DOMAIN' 选项将检索为套接字设置的最后一个 ZAP 域。返回的值将是一个以 NULL 结尾的字符串，可以为空。空字符串表示 ZAP 认证已禁用。返回的大小应包含结尾的 null 字节。

'ZMQ_ZAP_ENFORCE_DOMAIN' 选项将检索决定是否严格要求 ZAP 域的标志。

ZMQ_VMCI_BUFFER_SIZE 选项将检索套接字底层缓冲区的大小。用于连接建立前的协商过程。

ZMQ_VMCI_BUFFER_MIN_SIZE 选项将检索套接字底层缓冲区的最小大小。用于连接建立前的协商过程。

ZMQ_VMCI_BUFFER_MAX_SIZE 选项将检索套接字底层缓冲区的最大大小。用于连接建立前的协商过程。

ZMQ_VMCI_CONNECT_TIMEOUT 选项将检索套接字的连接超时。

检索当前多播环回配置。值为 1 表示在此套接字上发送的多播数据包将环回发送到本地监听接口。

检索 router 套接字的当前通知设置。返回的值是由 ZMQ_NOTIFY_CONNECT 和 ZMQ_NOTIFY_DISCONNECT 标志组成的位掩码，分别表示连接和断开连接通知已启用。值为 '0' 表示通知已关闭。

获取在单个 'recv' 系统调用中可以接收的最大消息数量。

不能为零。

获取在单个 'send' 系统调用中可以发送的最大消息数量。

不能为零。

获取主题（前缀）订阅的数量，可以是：* 在 (X)PUB 套接字上从所有连接的 (X)SUB 套接字接收到的，或者 * 在 (X)SUB 套接字上从所有连接的 (X)PUB 套接字确认的。

获取控制 NORM 传输操作的 NORM 发送方模式。NORM 支持固定速率操作 (0='ZMQ_NORM_FIXED')、拥塞控制模式 (1='ZMQ_NORM_CC')、容错拥塞控制 (2='ZMQ_NORM_CCL')、启用显式拥塞通知 (ECN) 的拥塞控制 (3='ZMQ_NORM_CCE') 和仅 ECN 拥塞控制 (4='ZMQ_NORM_CCE_ECNONLY')。默认值是 TCP 友好的拥塞控制模式。固定速率模式（使用 'ZMQ_RATE' 设置的数据速率）提供更好的性能，但必须小心防止数据丢失。

检索多播接收方的 NORM 单播 NACK 模式设置状态。如果设置，NORM 接收方将使用单播而不是多播向发送方发送否定确认 (NACK)。指定单播地址的 NORM 传输端点默认将使用单播 NACK（无需设置 'ZMQ_NORM_UNICAST_NACK'）。

获取 NORM 传输发送方、接收方和流的 NORM 缓冲区大小。

获取 NORM 发送方段大小，这是单个 NORM 消息的最大消息有效载荷大小（ZMQ 消息可能会被拆分成多个 NORM 消息）。理想情况下，考虑到额外的 NORM 消息头（最多 48 字节）后，此值应适合系统/网络最大传输单元 (MTU)。

获取 NORM 发送方块大小，这是 NORM FEC 编码块中的段数。NORM 修复操作在块边界处进行。最大值为 255，但奇偶校验数据包 ('ZMQ_NORM_NUM_PARITY') 被限制为 (255 - 'ZMQ_NORM_BLOCK_SIZE') 的值。最小值为 ('ZMQ_NORM_NUM_PARITY' + 1)。如果提供了无效设置，实际值可能因 'ZMQ_NORM_NUM_PARITY' 和 'ZMQ_NORM_NUM_AUTOPARITY' 的设置而异。

获取发送方愿意为每个 FEC 编码块计算的最大 NORM 奇偶校验符号段数，用于修复丢失的数据。最大值为 255，但进一步限制为 (255 - 'ZMQ_NORM_BLOCK_SIZE') 的值。最小值为 'ZMQ_NORM_NUM_AUTOPARITY'。如果提供了无效设置，实际值可能因 'ZMQ_NORM_NUM_AUTOPARITY' 的设置而异。

获取发送方将在每个 FEC 编码块末尾主动发送的 NORM 奇偶校验符号段数。默认情况下，不会发送主动奇偶校验段；相反，奇偶校验段仅在响应修复请求 (NACK) 时发送。最大值为 255，但进一步限制为最大值 'ZMQ_NORM_NUM_PARITY'。

获取 NORM 流推送模式的状态，该模式会改变发送方在将新数据加入队列时的行为。默认情况下，NORM 在等待传输和/或修复旧数据时会停止接受新消息。启用推送模式会丢弃最旧的数据（可能是待修复或可能从未传输的数据），以便接受新数据。在更重要的是快速传递新数据而非可靠传递旧数据的情况下，这可能很有用。