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

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

文档

• 最新版本（docs.rs）

jemalloc 是一个通用内存分配器，其文档

可以在这里找到

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

当前 jemalloc 版本: 5.2.1.

平台支持

请参阅 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-sys时，在jemalloc支持的某些POSIX目标上启用后台线程的运行时支持。默认情况下，后台线程在运行时被禁用。此选项允许在运行时动态地启用它们。

• 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:无法在静态TLS块中分配内存in static TLS block，您可能希望启用此选项。

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