X-Git-Url: https://git.lttng.org/?p=lttng-ust.git;a=blobdiff_plain;f=src%2Flib%2Flttng-ust-libc-wrapper%2FREADME.md;fp=src%2Flib%2Flttng-ust-libc-wrapper%2FREADME.md;h=a87e91204e7135be0dde05be36118d33a3bbccc2;hp=0000000000000000000000000000000000000000;hb=e03d7c66c57bf268b87296566a5160039f35ccfb;hpb=79f8dc6f50b20fb6b1d99f9bd97d70aa361bc6ad

diff --git a/src/lib/lttng-ust-libc-wrapper/README.md b/src/lib/lttng-ust-libc-wrapper/README.md
new file mode 100644
index 00000000..a87e9120
--- /dev/null
+++ b/src/lib/lttng-ust-libc-wrapper/README.md
@@ -0,0 +1,17 @@
+<!--
+SPDX-FileCopyrightText: 2023 EfficiOS, Inc.
+
+SPDX-License-Identifier: CC-BY-4.0
+-->
+
+# LTTng-UST libc wrapper
+
+`liblttng-ust-libc` is used for instrumenting some calls to libc in a program,
+without need for recompiling it.
+
+This library defines a `malloc()` function that is instrumented with a
+tracepoint. It also calls the libc `malloc()` afterwards. When loaded with
+LD\_PRELOAD, it replaces the libc `malloc()` function, in effect instrumenting
+all calls to `malloc()`. The same is performed for `free()`.
+
+See the "run" script for a usage example.