运行时配置和并发提示

Boost.Asio 提供了一些运行时配置选项，可用于精细调整 Boost.Asio 的行为，例如启用或禁用特定的优化。可用配置选项如下表所示。

章节	键	类型	Default	描述
`scheduler`	`concurrency_hint`	`int`	`0`	这是对 `io_context` 实现的一个建议，指示应使用多少个活动线程来运行完成处理程序。当使用 Windows I/O 完成端口后端时，此值将传递给 `CreateIoCompletionPort`。当使用基于事件循环的后端时，该实现将值 `1` 识别为 `io_context` 将从单个线程运行的指示，并基于此假设应用多项优化。例如，当一个处理程序从另一个处理程序内部发布时，新的处理程序将被添加到快速的线程本地队列中（结果是新的处理程序会等到当前正在执行的处理程序完成）。无论为此配置选项指定什么值，`io_context` 或 `thread_pool` 仍然提供完全的线程安全，并且可以从任何线程使用不同的 I/O 对象。
`scheduler`	`locking`	`bool`	`true`	使用基于事件循环的后端时，此选项用于启用或禁用调度程序中的锁定。当设置为 `false` 时，此选项具有以下限制： — 必须小心确保对 `io_context` 及其任何关联的 I/O 对象（如套接字和计时器）的所有操作一次只发生在一个线程中。 — 异步解析操作将以 `operation_not_supported` 失败。 — 如果 `signal_set` 与 `io_context` 一起使用，则 `signal_set` 对象不能与程序中的任何其他 io_context 一起使用。
`scheduler`	`locking_spin_count`	`int`	`0`	当使用基于事件循环的后端时，尝试在不阻塞的情况下获取调度程序内部锁的次数。
`scheduler`	`task_usec`	`int`	`-1`	调度程序等待其事件循环任务完成的最长时间（以微秒为单位）。值为 `-1` 表示对此等待时间没有限制。可以设置为 `0` 以启用 CPU 密集型自旋。
`scheduler`	`wait_usec`	`int`	`-1`	调度程序在空闲线程（即未执行处理程序或等待事件循环的线程）上等待唤醒事件的最长时间（以微秒为单位）。值为 `-1` 表示对此等待时间没有限制。可以设置为 `0` 以在多线程执行上下文中启用 CPU 密集型自旋。
`reactor`	`preallocated_io_objects`	`unsigned int`	`0`	在构造时分配的内部事件循环 I/O 对象状态的数量。事件循环实现使用每个 I/O 对象的状态来跟踪未完成操作的队列等内容。这些状态对象在 I/O 对象销毁后会被回收，但如果没有可用的未使用的状态对象，则会分配新的状态对象。如果构造时已知 I/O 对象的上限，则可以通过设置此配置选项来确保构造完成后不会发生分配。
`reactor`	`registration_locking`	`bool`	`true`	在事件循环周围启用或禁用 I/O 对象注册和注销的锁定。如果设置为 `false`，则必须注意不要同时打开或关闭 I/O 对象。
`reactor`	`registration_locking_spin_count`	`int`	`0`	在执行 I/O 对象注册或注销时，尝试在不阻塞的情况下获取事件循环锁的次数。
`reactor`	`io_locking`	`bool`	`true`	在事件循环中启用或禁用每个 I/O 对象的锁定。如果设置为 `false`，则必须注意确保 `io_context` 的运行函数（即 `run`、`run_for`、`run_until`、`run_one`、`run_one_for`、`run_one_until`、`poll` 和 `poll_one`），以及上下文的关联 I/O 对象（如套接字和计时器）上的所有操作，一次只发生在一个线程中。
`reactor`	`io_locking_spin_count`	`int`	`0`	在不阻塞的情况下尝试获取事件循环的每个 I/O 对象锁的次数。
`reactor`	`reset_edge_on_partial_read`	`bool`	`false`	仅限 Linux `epoll` 后端。当设置为 `true` 时，对流式套接字的读取操作被视为已消耗了边沿触发的就绪通知，在执行进一步的读取操作之前需要新的就绪边沿。当设置为 `false`（默认值）时，套接字被视为可读，直到读取操作因 `EAGAIN` 而失败。
`reactor`	`use_eventfd`	`bool`	`true`	仅限 Linux `epoll` 后端。当设置为 `true` 时，事件循环使用 `eventfd` 描述符来唤醒被阻塞的 `epoll_wait` 调用。当设置为 `false` 时，则使用管道。
`reactor`	`use_timerfd`	`bool`	`true`	仅限 Linux `epoll` 后端。当设置为 `true` 时，事件循环使用 `timerfd` 描述符来管理超时。当设置为 `false` 时，则计算到下一次超时的持续时间，并将其作为超时值传递给 `epoll_wait`。
`timer`	`heap_reserve`	`unsigned int`	`0`	在内部计时器队列堆中预留的条目数。如果构造时已知计时器的上限，则可以通过设置此配置选项来确保构造完成后不会发生计时器分配。
`resolver`	`threads`	`unsigned int`	`0`	用于异步名称解析的内部线程数。如果非零，则在构造第一个解析器对象时创建指定数量的线程。否则，在第一次 `async_resolve` 调用时最多创建一个线程。

这些配置选项与执行上下文（如 io_context 或 thread_pool）相关联。要使用非默认值，必须在构造时将配置服务安装到执行上下文中。下面的章节展示了实现此目的的几种方法。

从字符串进行配置

要从字符串读取配置选项，请使用 config_from_string 对象构造执行上下文。

boost::asio::io_context my_io_context{
    boost::asio::config_from_string{
      "scheduler.concurrency_hint=10\n"
      "scheduler.locking=1"}};

每个变量必须独占一行，格式为：

section.key=value

或者，如果指定了可选前缀：

prefix.section.key=value

空行和以 # 开头的行将被忽略。也允许在值后面包含以 # 开头的注释。

从环境变量进行配置

要从环境变量读取配置选项，请使用 config_from_env 对象构造执行上下文。

boost::asio::io_context my_io_context{
    boost::asio::config_from_env{"my_app"}};

环境变量名称是通过连接前缀、节和键，以 `_` 作为分隔符，然后将结果字符串转换为大写来形成的。例如，给定前缀 "my_app" 和 "scheduler" / "concurrency_hint" 选项，则值将从名为 MY_APP_SCHEDULER_CONCURRENCY_HINT` 的环境变量中读取。

从并发提示进行配置

为了向后兼容，io_context 构造函数可以接受一个整数作为并发提示。这用于初始化配置选项，如以下表格所述。

concurrency_hint 值	效果
`n`，其中 `n < 0xFFFF`	等同于设置 — `"scheduler"` / `"concurrency_hint"` 为 `n`。 — `"scheduler"` / `"locking"` 为 `true`。 — `"reactor"` / `"registration_locking"` 为 `true`。 — `"reactor"` / `"io_locking"` 为 `true`。
`BOOST_ASIO_CONCURRENCY_HINT_UNSAFE`	— `"scheduler"` / `"concurrency_hint"` 为 `1`。 — `"scheduler"` / `"locking"` 为 `false`。 — `"reactor"` / `"registration_locking"` 为 `false`。 — `"reactor"` / `"io_locking"` 为 `false`。
`BOOST_ASIO_CONCURRENCY_HINT_UNSAFE_IO`	— `"scheduler"` / `"concurrency_hint"` 为 `1`。 — `"scheduler"` / `"locking"` 为 `true`。 — `"reactor"` / `"registration_locking"` 为 `true`。 — `"reactor"` / `"io_locking"` 为 `false`。
`BOOST_ASIO_CONCURRENCY_HINT_SAFE`	— `"scheduler"` / `"concurrency_hint"` 为 `0`。 — `"scheduler"` / `"locking"` 为 `true`。 — `"reactor"` / `"registration_locking"` 为 `true`。 — `"reactor"` / `"io_locking"` 为 `true`。

默认构造的 io_context 对象所使用的并发提示可以通过在编译时定义 BOOST_ASIO_CONCURRENCY_HINT_DEFAULT 宏来覆盖。例如，在编译器命令行中指定

-DBOOST_ASIO_CONCURRENCY_HINT_DEFAULT=1

意味着在该程序的所有默认构造的 io_context 对象中都使用并发提示 1。同样，使用 1 构造的 io_context 对象所使用的并发提示可以通过定义 BOOST_ASIO_CONCURRENCY_HINT_1 来覆盖。例如，将

-DBOOST_ASIO_CONCURRENCY_HINT_1=BOOST_ASIO_CONCURRENCY_HINT_UNSAFE

传递给编译器将禁用所有这些对象的线程安全。

自定义配置选项

应用程序和第三方库可以利用 config 类将自己的配置选项与执行上下文关联起来，或访问上面列出的配置选项。通过向 get 成员函数传递节、键和默认值来访问配置参数的值。

boost::asio::config cfg{ctx};
bool enable_locking = cfg.get("scheduler", "locking", true);

Boost C++ 库

运行时配置和并发提示

从字符串进行配置

从环境变量进行配置

从并发提示进行配置

自定义配置选项