diff options
author | Arian van Putten <arian.vanputten@gmail.com> | 2019-08-12 19:36:56 +0200 |
---|---|---|
committer | Zbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl> | 2019-08-22 13:39:54 +0200 |
commit | 0e4a4f56bebc94a99134d79c5e1148aa787fc4dc (patch) | |
tree | 56ad0f0c4cc2f01ec4b0464b3b0a1108edba9e65 /man | |
parent | 23f8fbb303f1073cd1e6b93d490ea43d03ca6823 (diff) | |
download | systemd-0e4a4f56bebc94a99134d79c5e1148aa787fc4dc.tar.gz |
journalctl: Make journalctl --user-unit= match on _SYSTEMD_USER_SLICE
journalctl --unit= already did this, and allows you to tail all the logs
for a certain slice easily. It seemed only natural to make --user-unit
behave in a similar way.
The _SYSTEMD_USER_SLICE field was not documented as being added by
journald, so I have added that to the documentation too.
Furthermore, I have documented the existing behaviour of --unit= and the
new behaviour of --user-unit=
The behaviour was actually not documented before, so I am also OK with
removing the match for the --unit= command instead. The user would then
have to manually provide _SYSTEMD_SLICE= filter to journalctl in both
cases. Both options work for me.
Diffstat (limited to 'man')
-rw-r--r-- | man/journalctl.xml | 13 | ||||
-rw-r--r-- | man/systemd.journal-fields.xml | 1 |
2 files changed, 12 insertions, 2 deletions
diff --git a/man/journalctl.xml b/man/journalctl.xml index 0ecab521fa..f6703b06d6 100644 --- a/man/journalctl.xml +++ b/man/journalctl.xml @@ -544,7 +544,12 @@ the unit (<literal>_SYSTEMD_UNIT=<replaceable>UNIT</replaceable></literal>), along with additional matches for messages from systemd and - messages about coredumps for the specified unit.</para> + messages about coredumps for the specified unit. A match + is also added for <literal>_SYSTEMD_SLICE=<replaceable>UNIT</replaceable></literal>, + such that if the provided <replaceable>UNIT</replaceable> is a + <citerefentry><refentrytitle>systemd.slice</refentrytitle><manvolnum>5</manvolnum></citerefentry> + unit, all logs of the children of the slice will be logged. + </para> <para>This parameter can be specified multiple times.</para> </listitem> @@ -558,7 +563,11 @@ (<literal>_SYSTEMD_USER_UNIT=</literal> and <literal>_UID=</literal>) and additional matches for messages from session systemd and messages about coredumps for the - specified unit.</para> + specified unit. A match + is also added for <literal>_SYSTEMD_USER_SLICE=<replaceable>UNIT</replaceable></literal>, + such that if the provided <replaceable>UNIT</replaceable> is a + <citerefentry><refentrytitle>systemd.slice</refentrytitle><manvolnum>5</manvolnum></citerefentry> + unit, all logs of the children of the unit will be logged.</para> <para>This parameter can be specified multiple times.</para> </listitem> diff --git a/man/systemd.journal-fields.xml b/man/systemd.journal-fields.xml index fa374bf0f8..c11ec050e5 100644 --- a/man/systemd.journal-fields.xml +++ b/man/systemd.journal-fields.xml @@ -188,6 +188,7 @@ <term><varname>_SYSTEMD_SLICE=</varname></term> <term><varname>_SYSTEMD_UNIT=</varname></term> <term><varname>_SYSTEMD_USER_UNIT=</varname></term> + <term><varname>_SYSTEMD_USER_SLICE=</varname></term> <term><varname>_SYSTEMD_SESSION=</varname></term> <term><varname>_SYSTEMD_OWNER_UID=</varname></term> |