From c9648aa659bb1acfc7dc214e75900734e011be6b Mon Sep 17 00:00:00 2001 From: Zbigniew Jędrzejewski-Szmek Date: Fri, 1 Apr 2016 09:07:17 -0400 Subject: man: move KillSignal in the right section in directives list --- man/systemd.nspawn.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'man') diff --git a/man/systemd.nspawn.xml b/man/systemd.nspawn.xml index 5ec878512a..ce900a5db1 100644 --- a/man/systemd.nspawn.xml +++ b/man/systemd.nspawn.xml @@ -224,7 +224,7 @@ - + KillSignal= Specify the process signal to send to the container's PID 1 when nspawn itself receives SIGTERM, in -- cgit v1.2.3-54-g00ecf From f396232996b5d347cd743ff1d181ed6e5b7209f7 Mon Sep 17 00:00:00 2001 From: Zbigniew Jędrzejewski-Szmek Date: Sat, 2 Apr 2016 10:40:09 -0400 Subject: man: add more cross-references to coredump.conf(5) and systemd-coredump(8) Fixes #2901. --- man/coredump.conf.xml | 9 ++++++++- man/systemd-coredump.xml | 34 ++++++++++++++++++---------------- 2 files changed, 26 insertions(+), 17 deletions(-) (limited to 'man') diff --git a/man/coredump.conf.xml b/man/coredump.conf.xml index a0a497b467..2064a96523 100644 --- a/man/coredump.conf.xml +++ b/man/coredump.conf.xml @@ -60,7 +60,14 @@ These files configure the behavior of systemd-coredump8, - a handler for core dumps invoked by the kernel. + a handler for core dumps invoked by the kernel. Whether systemd-coredump is used + is determined by the kernel's + kernel.core_pattern sysctl8 + setting. See + systemd-coredump8 + and + core5 + pages for the details. diff --git a/man/systemd-coredump.xml b/man/systemd-coredump.xml index f1598461ef..0d3115094c 100644 --- a/man/systemd-coredump.xml +++ b/man/systemd-coredump.xml @@ -60,12 +60,13 @@ signal and dumps core. For it to be used in this capacity, it must be specified by the kernel.core_pattern sysctl8 - setting. Systemd installs - /usr/lib/sysctl.d/50-coredump.conf which - configures kernel.core_pattern to invoke - systemd-coredump. This file may be masked or - overridden to use a different setting following normal - sysctl.d5 rules. + setting. The syntax of this setting is explained in + core5. + Systemd installs /usr/lib/sysctl.d/50-coredump.conf which configures + kernel.core_pattern to invoke systemd-coredump. + This file may be masked or overridden to use a different setting following normal + sysctl.d5 + rules. The behavior of a specific program upon reception of a signal is governed by a few factors which are described in detail @@ -77,18 +78,19 @@ systemd.exec5). - systemd-coredump will log the coredump - including a backtrace if possible, and store the core (contents of - process' memory contents) in an external file on disk in - /var/lib/systemd/coredump, or directly in - the journal. This behavior may be modified using - coredump.conf5. + The behaviour of systemd-coredump is configured through + /etc/systemd/coredump.conf and other configuration files. See + coredump.conf5 + for details. By default, systemd-coredump will log the coredump including a + backtrace if possible, and store the core (contents of process' memory contents) in an external + file on disk in /var/lib/systemd/coredump. - Apart from the - journalctl1 - log viewer, + The log entry and a backtrace are stored in the journal, and can be viewed with + journalctl1. coredumpctl1 - may be used to list and extract coredumps. + may be used to list and extract coredumps or load them in + gdb1. + -- cgit v1.2.3-54-g00ecf From 7382a3cc232a0b60f1cd4604ce8fa9ae79f654e9 Mon Sep 17 00:00:00 2001 From: Zbigniew Jędrzejewski-Szmek Date: Sat, 2 Apr 2016 11:05:11 -0400 Subject: man: describe how to reload sysctl configuration Also fixes option name (s/--path/--prefix/). --- man/systemd-coredump.xml | 9 ++++++ man/systemd-sysctl.service.xml | 69 ++++++++++++++++++++++++++++++++++++------ 2 files changed, 68 insertions(+), 10 deletions(-) (limited to 'man') diff --git a/man/systemd-coredump.xml b/man/systemd-coredump.xml index 0d3115094c..aa352448b2 100644 --- a/man/systemd-coredump.xml +++ b/man/systemd-coredump.xml @@ -91,6 +91,15 @@ may be used to list and extract coredumps or load them in gdb1. + + The coredump helper is invoked anew each time. Therefore, any configuration + changes will take effect on the invocation of systemd-coredump. + If the sysctl configuration is modified, it must be updated in the kernel before + it takes effect, see + systemd-sysctl8 + and + sysctl8. + diff --git a/man/systemd-sysctl.service.xml b/man/systemd-sysctl.service.xml index 9027ff0f3f..686b2cdef4 100644 --- a/man/systemd-sysctl.service.xml +++ b/man/systemd-sysctl.service.xml @@ -62,24 +62,29 @@ systemd-sysctl.service is an early boot service that configures sysctl8 - kernel parameters. + kernel parameters by invoking /usr/lib/systemd/systemd-sysctl. - If invoked with no arguments, it applies all directives from - all configuration files in - sysctl.d5 - are searched for a matching file. If one or more filenames are passed on - the command line, only the directives in these files are applied. - + When invoked with no arguments, /usr/lib/systemd/systemd-sysctl applies + all directives from configuration files listed in + sysctl.d5. + If one or more filenames are passed on the command line, only the directives in these files are + applied. + + In addition, option may be used to limit which sysctl + settings are applied. See sysctl.d5 - for information about the configuration of this service. + for information about the configuration of sysctl settings. After sysctl configuration is + changed on disk, it must be written to the files in /proc/sys before it + takes effect. It is possible to update specific settings, or simply to reload all configuration, + see Examples below. Options - - + + Only apply rules with the specified prefix. @@ -91,6 +96,50 @@ + + Examples + + + Reset all sysctl settings + + systemctl restart systemd-sysctl + + + + View coredump handler configuration + + # sysctl kernel.core_pattern +kernel.core_pattern = |/usr/libexec/abrt-hook-ccpp %s %c %p %u %g %t %P %I + + + + + Update coredump handler configuration + + # /usr/lib/systemd/systemd-sysctl --prefix kernel.core_pattern + + This searches all the directories listed in + sysctl.d5 + for configuration files and writes /proc/sys/kernel/core_pattern. + + + + Update coredump handler configuration according to a specific file + + # /usr/lib/systemd/systemd-sysctl 50-coredump.conf + + This applies all the settings found in 50-coredump.conf. + Either /etc/sysctl.d/50-coredump.conf, or + /run/sysctl.d/50-coredump.conf, or + /usr/lib/sysctl.d/50-coredump.conf will be used, in the order + of preference. + + + See + sysctl8 + for various ways to directly apply sysctl settings. + + See Also -- cgit v1.2.3-54-g00ecf From 6dfde7acf1405adbb7adb2adc6969c4eb3c0990a Mon Sep 17 00:00:00 2001 From: Zbigniew Jędrzejewski-Szmek Date: Tue, 5 Apr 2016 21:00:10 -0400 Subject: man: also mention systemd-coredump@.service and systemd-coredump.socket Added in 3c171f0b1e. --- Makefile-man.am | 12 +++++++++++- man/systemd-coredump.xml | 11 +++++++++++ 2 files changed, 22 insertions(+), 1 deletion(-) (limited to 'man') diff --git a/Makefile-man.am b/Makefile-man.am index a7e348b1f1..db9b090432 100644 --- a/Makefile-man.am +++ b/Makefile-man.am @@ -1849,11 +1849,21 @@ MANPAGES += \ man/coredumpctl.1 \ man/systemd-coredump.8 MANPAGES_ALIAS += \ - man/coredump.conf.d.5 + man/coredump.conf.d.5 \ + man/systemd-coredump.socket.8 \ + man/systemd-coredump@.service.8 man/coredump.conf.d.5: man/coredump.conf.5 +man/systemd-coredump.socket.8: man/systemd-coredump.8 +man/systemd-coredump@.service.8: man/systemd-coredump.8 man/coredump.conf.d.html: man/coredump.conf.html $(html-alias) +man/systemd-coredump.socket.html: man/systemd-coredump.html + $(html-alias) + +man/systemd-coredump@.service.html: man/systemd-coredump.html + $(html-alias) + endif if ENABLE_EFI diff --git a/man/systemd-coredump.xml b/man/systemd-coredump.xml index aa352448b2..51dc27e8d3 100644 --- a/man/systemd-coredump.xml +++ b/man/systemd-coredump.xml @@ -45,11 +45,15 @@ systemd-coredump + systemd-coredump.socket + systemd-coredump@.service Log and store core dumps /usr/lib/systemd/systemd-coredump + systemd-coredump@.service + systemd-coredump.socket @@ -85,6 +89,13 @@ backtrace if possible, and store the core (contents of process' memory contents) in an external file on disk in /var/lib/systemd/coredump. + When the kernel invokes systemd-coredump to handle a coredump, + it will connect to the socket created by the systemd-coredump.socket + unit, which in turn will spawn a systemd-coredump@.service instance + to process the coredump. Hence systemd-coredump.socket + and systemd-coredump@.service are helper units which do the actual + processing of coredumps and are subject to normal service management. + The log entry and a backtrace are stored in the journal, and can be viewed with journalctl1. coredumpctl1 -- cgit v1.2.3-54-g00ecf