mirror of
https://github.com/google/tcmalloc.git
synced 2026-10-28 08:35:56 +08:00
Vaibhav Gogte CA
7c38292288
When `use_bitmap_for_small = true`, free objects are tracked in an outline bitmap at the end of the span rather than an inline linked list, so neither popping nor pushing touches object memory unless explicitly checked. - Poison backing span memory with `0xA5` before `BuildFreelist` in `State` so uninitialized outline bitmap words surface immediately. - Track `allocated_idx` in `State` to verify that popped and pushed objects are aligned, lie within `[0, objects_per_span * object_size)` (not overlapping the outline tail bitmap), and are never allocated twice concurrently. - Write per-object canary bytes on pop and verify them on push. PiperOrigin-RevId: 1008456250
TCMalloc
This repository contains the TCMalloc C++ code.
TCMalloc is Google's customized implementation of C's malloc() and C++'s
operator new used for memory allocation within our C and C++ code. TCMalloc is
a fast, multi-threaded malloc implementation.
Building TCMalloc
Bazel is the official build system for TCMalloc. Experimental support for CMake is available as well.
The TCMalloc Platforms Guide contains information on platform support for TCMalloc.
Documentation
All users of TCMalloc should consult the following documentation resources:
- The TCMalloc Quickstart covers downloading, installing, building, and testing TCMalloc, including incorporating within your codebase.
- The TCMalloc Overview covers the basic architecture of TCMalloc, and how that may affect configuration choices.
- The TCMalloc Reference covers the C and C++ TCMalloc API endpoints.
More advanced usages of TCMalloc may find the following documentation useful:
- The TCMalloc Tuning Guide covers the configuration choices in more depth, and also illustrates other ways to customize TCMalloc. This also covers important operating system-level properties for improving TCMalloc performance.
- The TCMalloc Design Doc covers how TCMalloc works underneath the hood, and why certain design choices were made. Most developers will not need this level of implementation detail.
- The TCMalloc Compatibility Guide which documents our expectations for how our APIs are used.
License
The TCMalloc library is licensed under the terms of the Apache license. See LICENSE for more information.
Disclaimer: This is not an officially supported Google product.