summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorDmitry V. Levin <ldv@altlinux.org>2020-12-09 03:12:53 +0300
committerMark Wielaard <mark@klomp.org>2020-12-09 20:38:07 +0100
commitfc5e808d54d25c3e668506428d22df8a28072ab8 (patch)
tree17a957f3f18cd7e4c7735cc281de96de6ecb45ab /doc
parente917ef7ce9f55f8f0902310721ba7c76d6a67cad (diff)
downloadelfutils-fc5e808d54d25c3e668506428d22df8a28072ab8.tar.gz
debuginfod: export DEBUGINFOD_SONAME macro in debuginfod.h
Add DEBUGINFOD_SONAME macro to API for use by those of libdebuginfod clients that would like to dlopen the library in the same way as __libdwfl_debuginfod_init does. Signed-off-by: Dmitry V. Levin <ldv@altlinux.org>
Diffstat (limited to 'doc')
-rw-r--r--doc/ChangeLog4
-rw-r--r--doc/debuginfod_find_debuginfo.315
2 files changed, 19 insertions, 0 deletions
diff --git a/doc/ChangeLog b/doc/ChangeLog
index fdf352e7..d8f21dd6 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,7 @@
+2020-12-06 Dmitry V. Levin <ldv@altlinux.org>
+
+ * debuginfod_find_debuginfo.3: Document DEBUGINFOD_SONAME macro.
+
2020-11-11 Mark Wielaard <mark@klomp.org>
* debuginfod_find_debuginfo.3: Document debuginfod_set_verbose_fd
diff --git a/doc/debuginfod_find_debuginfo.3 b/doc/debuginfod_find_debuginfo.3
index 3c6d52f5..36c08490 100644
--- a/doc/debuginfod_find_debuginfo.3
+++ b/doc/debuginfod_find_debuginfo.3
@@ -209,6 +209,21 @@ removed from the cache during cleaning. These files should contain only an
ASCII decimal integer representing the interval or max unused age in seconds.
The default is one day and one week, respectively. Values of zero mean "immediately".
+.SH "MACROS"
+
+.SS "DEBUGINFOD_SONAME"
+
+Defined to the string that could be passed to
+.BR dlopen (3)
+if the library is loaded at runtime, for example
+
+.PP
+.in +4n
+.EX
+void *debuginfod_so = dlopen(DEBUGINFOD_SONAME, RTLD_LAZY);
+.EE
+.in
+
.SH "SECURITY"
.BR debuginfod_find_debuginfo (),
.BR debuginfod_find_executable (),