Suggested-by: Kazuhito Hagio <[email protected]>
Reviewed-by: Stephen Brennan <[email protected]>
Signed-off-by: Tao Liu <[email protected]>
---
README | 6 ++++++
makedumpfile.8.in | 11 ++++++++++-
2 files changed, 16 insertions(+), 1 deletion(-)
diff --git a/README b/README
index a80b656..b674a10 100644
--- a/README
+++ b/README
@@ -65,6 +65,12 @@
# make USEZSTD=on ; make install
The user has to prepare zstd library.
+ - Build with extension support:
+ # make EXTENSION=on ; make install
+ The user has to prepare bpf library with version(>=v1.4.0).
+ Note: the extension will only work for kernels with DEBUG_INFO_BTF
+ & KALLSYMS enabled.
+
- Build the extension module for --eppic option.
# make eppic_makedumpfile.so
The user has to prepare eppic library from the following site:
diff --git a/makedumpfile.8.in b/makedumpfile.8.in
index 1edd0ff..b1a0991 100644
--- a/makedumpfile.8.in
+++ b/makedumpfile.8.in
@@ -2,7 +2,7 @@
.SH NAME
makedumpfile \- make a small dumpfile of kdump
.SH SYNOPSIS
-\fBmakedumpfile\fR [\fIOPTION\fR] [\-x \fIVMLINUX\fR|\-i \fIVMCOREINFO\fR]
\fIVMCORE\fR \fIDUMPFILE\fR
+\fBmakedumpfile\fR [\fIOPTION\fR] [\-x \fIVMLINUX\fR|\-i \fIVMCOREINFO\fR]
[--extension \fIEXTENSION1.SO\fR [--extension \fIEXTENSION2.SO\fR ..]]
\fIVMCORE\fR \fIDUMPFILE\fR
.br
\fBmakedumpfile\fR \-F [\fIOPTION\fR] [\-x \fIVMLINUX\fR|\-i \fIVMCOREINFO\fR]
\fIVMCORE\fR
.br
@@ -664,6 +664,15 @@ This option cannot be used with the --dump-dmesg,
--reassemble and -g options.
Display report messages. This is an alternative to enabling bit 4 in the level
provided to --message-level.
+.TP
+\fB\-\-extension\fR \fIEXTENSION.SO\fR
+Load makedumpfile extensions. By using extensions, users can programmably
+customize mm page keeping / discard, alone with the traditional page-flag
+(-d dump_level) based filtering; as well as kernel data erasure. The option
+can be used multiple times to select various extensions. NOTE: this option
+needs EXTENSION=on when build makedumpfile with libbpf(>=v1.4.0). Also this
+option only works for kernels with DEBUG_INFO_BTF & KALLSYMS enabled.
+
.SH ENVIRONMENT VARIABLES
.TP 8
--
2.54.0
