jemalloc-sys - Rust 对 C 库 jemalloc 的绑定

注意：Rust 分配器 API 在 tikv-jemallocator Crates 中实现了 jemalloc。

文档

• 最新版本（docs.rs）

jemalloc 是一个通用内存分配器，其文档可在以下位置找到

API 文档

• Wiki（设计文档、演示、分析、调试、调整等）
• Wiki

当前 jemalloc 版本: 5.2.1.

平台支持

请参阅 tikv-jemallocator Crates 的平台支持。

特性

大多数特性对应于 jemalloc 特性 - 参考 jemalloc/INSTALL.md。

Cargo 特性

此 Crates 提供以下 cargo 特性标志

• profiling (通过 --enable-prof 配置 jemalloc)：启用堆分析功能和泄漏检测功能。有关使用详情，请参阅 jemalloc 的 "opt.prof" 选项文档。启用时，有几种回溯方法，配置脚本将选择以下列表中首先似乎可以正常工作的一种

  • libunwind（需要 --enable-prof-libunwind）
  • libgcc（除非禁用 --disable-prof-libgcc）
  • gcc intrinsics（除非禁用 --disable-prof-gcc）

• stats（使用 jemalloc 的 --enable-stats 配置）：启用统计收集功能。有关使用详情，请参阅 jemalloc 的 "opt.stats_print" 选项文档。

• debug（使用 jemalloc 的 --enable-debug 配置）：启用断言和验证代码。这会显著影响性能，但在应用程序开发期间非常有用。

• background_threads_runtime_support（默认启用）：当在 jemalloc 支持的一些 POSIX 目标上构建 jemalloc-sys 时启用后台线程运行时支持。默认情况下，在运行时禁用后台线程。此选项允许在运行时动态启用它们。

• background_threads（默认禁用）：在运行时默认启用后台线程。当设置为 true 时，将在需要时创建后台线程（后台线程的数量不会超过 CPU 或活动区域的数量）。线程定期运行，并异步处理清理。关闭时，后台线程将同步终止。请注意，在 fork(2) 函数后，子进程的状态将禁用，而不管父进程的状态如何。有关相关统计信息，请参阅 stats.background_thread。可以使用 opt.background_thread 来设置默认选项。后台线程仅在选定的基于 pthread 的平台上可用。

• unprefixed_malloc_on_supported_platforms：当禁用时，使用 --with-jemalloc-prefix=_rjem_ 配置 jemalloc。启用此选项会导致像 malloc 这样的符号在没有任何前缀的情况下发出，覆盖了由 libc 定义的符号。这通常会导致同一程序中链接的 C 和 C++ 代码也使用 jemalloc。在某些平台上，由于去前缀会导致段错误，因此始终使用前缀。

• disable_initial_exec_tls（默认禁用）：当启用时，jemalloc 使用 --disable-initial-exec-tls 选项进行构建。它禁用了 jemalloc 内部线程局部存储的初始-exec TLS 模型（在支持显式设置的平台上）。这可以允许 jemalloc 在程序启动后动态加载（例如使用 dlopen）。如果您遇到错误 yourlib.so: cannot allocate memory in static TLS block，您可能希望启用此选项。

• disable_cache_oblivious（默认禁用）：当启用时，jemalloc 使用 --disable-cache-oblivious 选项进行构建。在这种情况下，所有大分配都将作为实现原语进行页面对齐。这可能会严重损害 CPU 缓存利用率。然而，缓存无关布局的成本是每个大分配额外一个页面，这可能对某些应用程序来说不可行。