derek.holloway
7502bf64a4
CodeQL / Analyze (actions) (push) Canceled after 0s
CodeQL / Analyze (python) (push) Canceled after 0s
pre-commit / pre-commit (push) Canceled after 0s
Multi-Arch CI / setup (push) Canceled after 0s
Publish build_manylinux_x86_64 images / publish_build_manylinux_x86_64 (push) Canceled after 0s
Setup (Multi-Arch) / setup (push) Canceled after 0s
Multi-Arch CI / Linux::${{ fromJSON(needs.setup.outputs.linux_build_config || '{}').build_variant_label || 'skip' }} (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Publish no_rocm_image_ubi10 image / publish_no_rocm_image_ubi10 (push) Canceled after 0s
Multi-Arch CI / Windows::${{ fromJSON(needs.setup.outputs.windows_build_config || '{}').build_variant_label || 'skip' }} (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Multi-Arch CI / Manifest Diff (push) Canceled after 0s
TheRock Manifest Diff Report / Generate Manifest Diff Report (push) Canceled after 0s
Multi-Arch CI / CI Summary (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04 (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04_ocl_rt images / publish_no_rocm_image_ubuntu24_04_ocl_rt (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04_rocgdb (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04_rocgdb images / publish_no_rocm_image_ubuntu24_04_rocgdb (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04_ocl_rt (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Unit Tests / Unit Tests :: ubuntu-24.04 (push) Canceled after 0s
Unit Tests / Unit Tests :: windows-2022 (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04_media (push) Canceled after 0s
Unit Tests / Unit Tests Summary (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04_openmpi (push) Canceled after 0s
67 lines
1.9 KiB
ReStructuredText
67 lines
1.9 KiB
ReStructuredText
================
|
|
LeakSanitizer
|
|
================
|
|
|
|
.. contents::
|
|
:local:
|
|
|
|
Introduction
|
|
============
|
|
|
|
LeakSanitizer is a run-time memory leak detector. It can be combined with
|
|
:doc:`AddressSanitizer` to get both memory error and leak detection, or
|
|
used in a stand-alone mode. LSan adds almost no performance overhead
|
|
until the very end of the process, at which point there is an extra leak
|
|
detection phase.
|
|
|
|
Usage
|
|
=====
|
|
|
|
:doc:`AddressSanitizer`: integrates LeakSanitizer and enables it by default on
|
|
supported platforms.
|
|
|
|
.. code-block:: console
|
|
|
|
$ cat memory-leak.c
|
|
#include <stdlib.h>
|
|
void *p;
|
|
int main() {
|
|
p = malloc(7);
|
|
p = 0; // The memory is leaked here.
|
|
return 0;
|
|
}
|
|
% clang -fsanitize=address -g memory-leak.c ; ASAN_OPTIONS=detect_leaks=1 ./a.out
|
|
==23646==ERROR: LeakSanitizer: detected memory leaks
|
|
Direct leak of 7 byte(s) in 1 object(s) allocated from:
|
|
#0 0x4af01b in __interceptor_malloc /projects/compiler-rt/lib/asan/asan_malloc_linux.cc:52:3
|
|
#1 0x4da26a in main memory-leak.c:4:7
|
|
#2 0x7f076fd9cec4 in __libc_start_main libc-start.c:287
|
|
SUMMARY: AddressSanitizer: 7 byte(s) leaked in 1 allocation(s).
|
|
|
|
To use LeakSanitizer in stand-alone mode, link your program with
|
|
``-fsanitize=leak`` flag. Make sure to use ``clang`` (not ``ld``) for the
|
|
link step, so that it would link in proper LeakSanitizer run-time library
|
|
into the final executable.
|
|
|
|
Security Considerations
|
|
=======================
|
|
|
|
LeakSanitizer is a bug detection tool and its runtime is not meant to be
|
|
linked against production executables. While it may be useful for testing,
|
|
LeakSanitizer's runtime was not developed with security-sensitive
|
|
constraints in mind and may compromise the security of the resulting executable.
|
|
|
|
Supported Platforms
|
|
===================
|
|
|
|
* Android
|
|
* Fuchsia
|
|
* Linux
|
|
* macOS
|
|
* NetBSD
|
|
|
|
More Information
|
|
================
|
|
|
|
`<https://github.com/google/sanitizers/wiki/AddressSanitizerLeakSanitizer>`_
|