picnoir/Systemd
1
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

man: document journal features of systemctl(1)

Browse source
This commit is contained in:
Lennart Poettering 2012-03-16 01:00:23 +01:00
parent 2af777ba96
commit 5c3246b1a6
3 changed files with 53 additions and 18 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

6
TODO
View file

@ -82,10 +82,6 @@ Features:
* add interface to allow immediate rotation of the journal, and even flushing. * add interface to allow immediate rotation of the journal, and even flushing.
* don't log coredumps of PID 1 into the journal
* if a journal file is corrupt, rotate it and create a new one
* dbus: in fedora, make the machine a symlink to /etc/machine-id * dbus: in fedora, make the machine a symlink to /etc/machine-id
* journald: reuse XZ context * journald: reuse XZ context
@ -94,8 +90,6 @@ Features:
* write RPM spec macros for presets * write RPM spec macros for presets
* write man pages for systemd-cat
* journal: write man pages for API * journal: write man pages for API
* journal: OR matches are borked * journal: OR matches are borked

57
man/systemctl.xml
View file

@ -414,6 +414,45 @@
PolicyKit before executing the PolicyKit before executing the
operation.</para></listitem> operation.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry>
<term><option>--lines=</option></term>
<term><option>-n</option></term>
<listitem><para>When used with
<command>status</command> controls the
number of journal lines to show,
counting from the most recent
ones. Takes a positive integer
argument. Defaults to
10.</para></listitem>
</varlistentry>
<varlistentry>
<term><option>--follow</option></term>
<term><option>-f</option></term>
<listitem><para>When used with
<command>status</command> continously
prints new journal entries as they are
appended to the
journal.</para></listitem>
</varlistentry>
<varlistentry>
<term><option>--output=</option></term>
<term><option>-o</option></term>
<listitem><para>When used with
<command>status</command> controls the
formatting of the journal entries that
are shown. For the available choices
see
<citerefentry><refentrytitle>systemd-journalctl</refentrytitle><manvolnum>1</manvolnum></citerefentry>. Defaults
to
<literal>short</literal>.</para></listitem>
</varlistentry>
</variablelist> </variablelist>
<para>The following commands are understood:</para> <para>The following commands are understood:</para>
@ -558,14 +597,15 @@
<listitem><para>Show terse runtime <listitem><para>Show terse runtime
status information about one or more status information about one or more
units. This function is intended to units, followed by its most recent log
generate human-readable output. If you data from the journal. This function
are looking for computer-parsable is intended to generate human-readable
output, use <command>show</command> output. If you are looking for
instead. If a PID is passed computer-parsable output, use
information about the unit the process <command>show</command> instead. If a
of the PID belongs to is PID is passed information about the
shown.</para></listitem> unit the process of the PID belongs to
is shown.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><command>show [NAME...|JOB...]</command></term> <term><command>show [NAME...|JOB...]</command></term>
@ -1139,6 +1179,7 @@
<para> <para>
<citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
<citerefentry><refentrytitle>systemadm</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>systemadm</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
<citerefentry><refentrytitle>systemd-journalctl</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
<citerefentry><refentrytitle>systemd-loginctl</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>systemd-loginctl</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
<citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>, <citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
<citerefentry><refentrytitle>systemd.special</refentrytitle><manvolnum>7</manvolnum></citerefentry>, <citerefentry><refentrytitle>systemd.special</refentrytitle><manvolnum>7</manvolnum></citerefentry>,

8
man/systemd-journalctl.xml
View file

@ -125,9 +125,9 @@
<term><option>-f</option></term> <term><option>-f</option></term>
<listitem><para>Show only most recent <listitem><para>Show only most recent
entries, and continously print new journal entries, and continously print
entries as they are appended to the new entries as they are appended to
journal.</para></listitem> the journal.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
@ -157,7 +157,7 @@
<term><option>-o</option></term> <term><option>-o</option></term>
<listitem><para>Controls the <listitem><para>Controls the
formatting of the entries that are formatting of the journal entries that are
shown. Takes one of shown. Takes one of
<literal>short</literal>, <literal>short</literal>,
<literal>short-monotonic</literal>, <literal>short-monotonic</literal>,