systemd-cat.xml revision 73e231abde39f22097df50542c745e01de879836
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering This file is part of systemd.
44f44a29cc1346c0783d679374ce98d81bf6400cLennart Poettering Copyright 2012 Lennart Poettering
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering systemd is free software; you can redistribute it and/or modify it
5430f7f2bc7330f3088b894166bf3524a067e3d8Lennart Poettering under the terms of the GNU Lesser General Public License as published by
5430f7f2bc7330f3088b894166bf3524a067e3d8Lennart Poettering the Free Software Foundation; either version 2.1 of the License, or
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering (at your option) any later version.
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering systemd is distributed in the hope that it will be useful, but
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering WITHOUT ANY WARRANTY; without even the implied warranty of
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
5430f7f2bc7330f3088b894166bf3524a067e3d8Lennart Poettering Lesser General Public License for more details.
5430f7f2bc7330f3088b894166bf3524a067e3d8Lennart Poettering You should have received a copy of the GNU Lesser General Public License
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering along with systemd; If not, see <http://www.gnu.org/licenses/>.
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering <refentryinfo>
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering </authorgroup>
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering </refentryinfo>
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering <refentrytitle>systemd-cat</refentrytitle>
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering <refpurpose>Connect a pipeline or program's output with the journal</refpurpose>
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering <refsynopsisdiv>
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering <command>systemd-cat <arg choice="opt" rep="repeat">OPTIONS</arg> <arg>COMMAND</arg> <arg choice="opt" rep="repeat">ARGUMENTS</arg></command>
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering </cmdsynopsis>
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering <command>systemd-cat <arg choice="opt" rep="repeat">OPTIONS</arg></command>
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering </cmdsynopsis>
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering </refsynopsisdiv>
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering <para><command>systemd-cat</command> may be used to
6db2742802b70938f0f2d373110ed734d4fb9813Zbigniew Jędrzejewski-Szmek connect the standard input and output of a process to the
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering journal, or as a filter tool in a shell pipeline to
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering pass the output the previous pipeline element
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering generates to the journal.</para>
79640424059328268b9fb6c5fa8eb777b27a177eJan Engelhardt <para>If no parameter is passed,
9adf646d0ae85192027319e2f47f2d092a298d99Lennart Poettering <command>systemd-cat</command> will write
6db2742802b70938f0f2d373110ed734d4fb9813Zbigniew Jędrzejewski-Szmek everything it reads from standard input (stdin) to the journal.</para>
79640424059328268b9fb6c5fa8eb777b27a177eJan Engelhardt <para>If parameters are passed, they are executed as
6db2742802b70938f0f2d373110ed734d4fb9813Zbigniew Jędrzejewski-Szmek command line with standard output (stdout) and standard
6db2742802b70938f0f2d373110ed734d4fb9813Zbigniew Jędrzejewski-Szmek error output (stderr) connected to the journal, so
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering that all it writes is stored in the journal.</para>
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering <para>The following options are understood:</para>
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering <variablelist>
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering <varlistentry>
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering </varlistentry>
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering <varlistentry>
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering </varlistentry>
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering <varlistentry>
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering <term><option>--identifier=</option></term>
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering that is used to identify the logging
79640424059328268b9fb6c5fa8eb777b27a177eJan Engelhardt tool. If not specified, no identification
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering string is written to the journal.</para></listitem>
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering </varlistentry>
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering <varlistentry>
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering <term><option>--priority=</option></term>
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering priority level for the logged
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering messages. Pass one of
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering value between 0 and 7 (corresponding
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering to the same named levels). These
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering priority values are the same as
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering <citerefentry><refentrytitle>syslog</refentrytitle><manvolnum>3</manvolnum></citerefentry>. Defaults
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering this simply controls the default,
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering individual lines may be logged with
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering different levels if they are prefixed
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering accordingly. For details see
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering </varlistentry>
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering <varlistentry>
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering <term><option>--level-prefix=</option></term>
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering read are parsed for syslog priority
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering level prefixes. If enabled (the
79640424059328268b9fb6c5fa8eb777b27a177eJan Engelhardt default), a line prefixed with a
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering priority prefix such as
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering similar for the other priority
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering levels. Takes a boolean
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering </varlistentry>
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering </variablelist>
b040723ea412209e0edf54647fa5aa4287411507Jan Engelhardt <para>On success, 0 is returned, a non-zero failure
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering code otherwise.</para>
845c53246f73a505f12bb7f685a530045fa60a40Zbigniew Jędrzejewski-Szmek <para>This calls <filename noindex='true'>/bin/ls</filename>
6db2742802b70938f0f2d373110ed734d4fb9813Zbigniew Jędrzejewski-Szmek with standard output and error connected to the
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering journal:</para>
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering <programlisting># systemd-cat ls</programlisting>
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering <para>This builds a shell pipeline also
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering invoking <filename>/bin/ls</filename> and
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering writes the output it generates to the
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering journal:</para>
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering <programlisting># ls | systemd-cat</programlisting>
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering <para>Even though the two examples have very similar
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering effects the first is preferable since only one process
6db2742802b70938f0f2d373110ed734d4fb9813Zbigniew Jędrzejewski-Szmek is running at a time, and both stdout and stderr are
73e231abde39f22097df50542c745e01de879836Jan Engelhardt captured while in the second example, only stdout is
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering captured.</para>
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering <citerefentry><refentrytitle>systemctl</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
9aac0b2c19c558b853da7a6d67a0929b2d44dee4Lennart Poettering <citerefentry><refentrytitle>logger</refentrytitle><manvolnum>1</manvolnum></citerefentry>