Skip to contentSkip to conversation

man/man5/core.5: Update compression format for systemd-coredump

PATCH In review Patsy Griffin 3 participants 3 messages May 1 – May 3 Man-pages: manual pages for Linux -- Sections 2, 3, 4, 5, and 7

lore
Share & tools
lore

Patsy Griffin

author
#0 lore raw

PATCH 1/1 man/man5/core.5: Update compression format for systemd-coredump

As of version 246, systemd-coredump defaults to zstd compression for core dumps, rather than lz4.

Signed-off-by Patsy Griffin <[email protected]>
---
 man/man5/core.5 | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)
man/man5/core.5 +7 -2
index 4da5819b6..83c49d42d 100644
@@ -515,9 +515,14 @@ program:
 In this case, core dumps will be placed in the location configured for
 .BR systemd\-coredump (8),
 typically as
-.BR lz4 (1)
-compressed files in the directory
+.BR zstd (1)
+compressed files
+ending in ".zst"
+.\" Since Systemd 246:
+.\" commit ef5924aa313d1892bb491c870ba3c429454dfc76
+in the directory
 .IR /var/lib/systemd/coredump/ .
+Compression on or off is configurable via coredump.conf(5).
 One can list the core dumps that have been recorded by
 .BR systemd\-coredump (8)
 using
Signature · 1 line
2.51.1
Reviewed-by on v1 1/1
#1 lore raw
Quoted 4 lines · Patsy Griffin

As of version 246, systemd-coredump defaults to zstd compression for core dumps, rather than lz4.

Signed-off-by Patsy Griffin <[email protected]>

LGTM.

I thought coredump.conf allowed you to specify which compression format, but I was wrong, you can only turn it on or off. This looks correct and on my system all my coredumps are *.zst today. Best to update this to match latest deployments.

Reviewed-by Carlos O'Donell <[email protected]>
Quoted 25 lines
---
  man/man5/core.5 | 9 +++++++--
  1 file changed, 7 insertions(+), 2 deletions(-)
man/man5/core.5 +7 -2
index 4da5819b6..83c49d42d 100644
@@ -515,9 +515,14 @@ program:
  In this case, core dumps will be placed in the location configured for
  .BR systemd\-coredump (8),
  typically as
-.BR lz4 (1)
-compressed files in the directory
+.BR zstd (1)
+compressed files
+ending in ".zst"
+.\" Since Systemd 246:
+.\" commit ef5924aa313d1892bb491c870ba3c429454dfc76
+in the directory
  .IR /var/lib/systemd/coredump/ .
+Compression on or off is configurable via coredump.conf(5).
  One can list the core dumps that have been recorded by
  .BR systemd\-coredump (8)
  using
Signature · 2 lines
Cheers,
Carlos.
maintainer
#2 lore raw

Hi Patsy, Carlos,

Quoted 6 lines · Carlos O'Donell
Quoted 4 lines · Patsy Griffin

As of version 246, systemd-coredump defaults to zstd compression for core dumps, rather than lz4.

Signed-off-by Patsy Griffin <[email protected]>
Quoted 8 lines

LGTM.

I thought coredump.conf allowed you to specify which compression format, but I was wrong, you can only turn it on or off. This looks correct and on my system all my coredumps are *.zst today. Best to update this to match latest deployments.

Reviewed-by Carlos O'Donell <[email protected]>

Thanks!

Quoted 5 lines
Quoted 5 lines
---
  man/man5/core.5 | 9 +++++++--
  1 file changed, 7 insertions(+), 2 deletions(-)
Quoted 13 lines

man/man5/core.5 program: · line 520

Quoted 13 lines
man/man5/core.5 +3 -2
index 4da5819b6..83c49d42d 100644
@@ -515,9 +515,14 @@ program:
  In this case, core dumps will be placed in the location configured for
  .BR systemd\-coredump (8),
  typically as
-.BR lz4 (1)
-compressed files in the directory
+.BR zstd (1)
+compressed files
+ending in ".zst"

I think this should be added to suffixes(7).

Also, I doubt the suffix should be documented here. Is it an uncommon suffix for zstd(1)-compressed files? If it's the/a common suffix, it should be enough to document it in suffixes(7) and say it's zstd(1) here.

Have a lovely night!
Alex

Quoted 14 lines
Quoted 8 lines
man/man5/core.5 +4 -0
+.\" Since Systemd 246:
+.\" commit ef5924aa313d1892bb491c870ba3c429454dfc76
+in the directory
  .IR /var/lib/systemd/coredump/ .
+Compression on or off is configurable via coredump.conf(5).
  One can list the core dumps that have been recorded by
  .BR systemd\-coredump (8)
  using
Signature · 2 lines
Cheers,
Carlos.
Signature · 1 line
<https://www.alejandro-colomar.es>