From 6f8c4b60c37208aaea9ed14d89bae9ce3522d2ba Mon Sep 17 00:00:00 2001 From: Luca Boccassi Date: Tue, 21 May 2024 16:28:23 +0100 Subject: [PATCH 1/2] Add manpage for dlopen-notes --- Makefile | 1 + man/dlopen-notes.1 | 36 ++++++++++++++++++++++++++++++++++++ 2 files changed, 37 insertions(+) create mode 100644 man/dlopen-notes.1 diff --git a/Makefile b/Makefile index 13de305..988a297 100644 --- a/Makefile +++ b/Makefile @@ -2,6 +2,7 @@ all: install: install -m 755 -D dlopen-notes.py $(DESTDIR)/usr/bin/dlopen-notes + install -m 644 -D man/dlopen-notes.1 $(DESTDIR)/usr/share/man/man1/dlopen-notes.1 check: make -C test check diff --git a/man/dlopen-notes.1 b/man/dlopen-notes.1 new file mode 100644 index 0000000..1768540 --- /dev/null +++ b/man/dlopen-notes.1 @@ -0,0 +1,36 @@ +.TH DLOPEN\-NOTES 1 "May 2024" +.SH NAME +dlopen\-notes \- parses dlopen elf metadata +.SH SYNOPSIS +.B dlopen\-notes +.RI [ OPTION ...] +.SH DESCRIPTION +ELF binaries store link-time dependencies in their headers, which can be parsed +by various tools. There is no machine-readable metadata about dependencies +loaded at build time via +.BR \%dlopen (3) +available by default. The ELF Dlopen Metadata specification aims to fill this +gap, by defining a common format. +.PP +This tool allows parsing such a note, and printing out the result in various +formats. +.SH OPTIONS +.TP +.BI \-\-raw +Show the original JSON extracted from input files +.TP +.BI \-\-sonames +List all sonames and their priorities, one soname per line +.TP +.BI \-\-features= [FEATURE...] +Print the description of the specified features +.TP +.BR \-h ", " \-\-help +Show a short help message and exit. +.SH SEE ALSO +.ad l +.nh +.BR dh\-dlopenlibdeps (1), +.UR https://systemd.io/ELF_DLOPEN_METADATA/ +.B Dlopen Metadata for ELF Files +.UE From 4f378dc5a8712b21375a0a12eadd99e72f5616fa Mon Sep 17 00:00:00 2001 From: Luca Boccassi Date: Tue, 21 May 2024 16:30:38 +0100 Subject: [PATCH 2/2] debian: install dlopen-notes manpage --- debian/dh-dlopenlibdeps.manpages | 1 + 1 file changed, 1 insertion(+) diff --git a/debian/dh-dlopenlibdeps.manpages b/debian/dh-dlopenlibdeps.manpages index 87a4db4..3fb12d3 100644 --- a/debian/dh-dlopenlibdeps.manpages +++ b/debian/dh-dlopenlibdeps.manpages @@ -1 +1,2 @@ debian/dh_dlopenlibdeps.1 +usr/share/man/man1/dlopen-notes.1