X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fsystemd-cat.xml;h=e5a867be2262f0fcc1ad2d9eadbf949a1567bcff;hp=350a345d431dac361de17029b15ae7faf566ce0b;hb=9700d6980f7c212b10a69399e6430b82a6f45587;hpb=9adf646d0ae85192027319e2f47f2d092a298d99 diff --git a/man/systemd-cat.xml b/man/systemd-cat.xml index 350a345d4..e5a867be2 100644 --- a/man/systemd-cat.xml +++ b/man/systemd-cat.xml @@ -8,20 +8,21 @@ Copyright 2012 Lennart Poettering systemd is free software; you can redistribute it and/or modify it - under the terms of the GNU General Public License as published by - the Free Software Foundation; either version 2 of the License, or + under the terms of the GNU Lesser General Public License as published by + the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version. systemd is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU - General Public License for more details. + Lesser General Public License for more details. - You should have received a copy of the GNU General Public License + You should have received a copy of the GNU Lesser General Public License along with systemd; If not, see . --> - + systemd-cat @@ -60,18 +61,18 @@ Description systemd-cat may be used to - connect STDOUT and STDERR of a process with the + connect the standard input and output of a process to the journal, or as a filter tool in a shell pipeline to pass the output the previous pipeline element generates to the journal. - If no parameter is passed + If no parameter is passed, systemd-cat will write - everything it reads from standard input (STDIN) to the journal. + everything it reads from standard input (stdin) to the journal. - If parameters are passed they are executed as - command line with standard output (STDOUT) and standard - error output (STDERR) connected to the journal, so + If parameters are passed, they are executed as + command line with standard output (stdout) and standard + error output (stderr) connected to the journal, so that all it writes is stored in the journal. @@ -81,20 +82,8 @@ The following options are understood: - - - - - Prints a short help - text and exits. - - - - - - Prints a short version - string and exits. - + + @@ -102,7 +91,7 @@ Specify a short string that is used to identify the logging - tool. If not specified no identifying + tool. If not specified, no identification string is written to the journal. @@ -120,12 +109,12 @@ warning, notice, info, - debug, resp. a + debug, or a value between 0 and 7 (corresponding to the same named levels). These priority values are the same as defined by - syslog3. Defaults + syslog3. Defaults to info. Note that this simply controls the default, individual lines may be logged with @@ -141,7 +130,7 @@ Controls whether lines read are parsed for syslog priority level prefixes. If enabled (the - default) a line prefixed with a + default), a line prefixed with a priority prefix such as <5> is logged at priority 5 @@ -158,7 +147,7 @@ Exit status - On success 0 is returned, a non-zero failure + On success, 0 is returned, a non-zero failure code otherwise. @@ -168,8 +157,8 @@ Invoke a program - This calls /bin/ls - with STDOUT/STDERR connected to the + This calls /bin/ls + with standard output and error connected to the journal: # systemd-cat ls @@ -188,8 +177,8 @@ Even though the two examples have very similar effects the first is preferable since only one process - is running at a time, and both STDOUT and STDERR are - captured while in the second example only STDOUT is + is running at a time, and both stdout and stderr are + captured while in the second example, only stdout is captured.