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

man: journal-remote: active mode without --url option requires output filename

Browse source 
Closes #6675.
This commit is contained in:
Yu Watanabe 2017-08-27 16:20:12 +09:00
parent 0c700d392d
commit c298b083c6
1 changed files with 20 additions and 17 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

37
man/systemd-journal-remote.xml
View file

@ -106,6 +106,8 @@
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><arg choice="opt" rep="repeat">SOURCES</arg></term>
<listitem><para>When <option>-</option> is given as a <listitem><para>When <option>-</option> is given as a
positional argument, events will be read from standard input. positional argument, events will be read from standard input.
Other positional arguments will be treated as filenames Other positional arguments will be treated as filenames
@ -124,6 +126,20 @@
instance, e.g. http://some.host:19531/ or instance, e.g. http://some.host:19531/ or
https://some.host:19531/.</para></listitem> https://some.host:19531/.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry>
<term><option>--getter='<replaceable>PROG</replaceable> <arg choice="opt" rep="repeat">OPTIONS</arg>'</option></term>
<listitem><para>Program to invoke to retrieve data. The journal
event stream must be generated on standard output.</para>
<para>Examples:</para>
<programlisting>--getter='curl "-HAccept: application/vnd.fdo.journal" https://some.host:19531/'</programlisting>
<programlisting>--getter='wget --header="Accept: application/vnd.fdo.journal" -O- https://some.host:19531/'</programlisting>
</listitem>
</varlistentry>
</variablelist> </variablelist>
<para>Passive sources can be specified in the following <para>Passive sources can be specified in the following
@ -225,8 +241,9 @@
escaped hostname of the source endpoint of the connection, or the escaped hostname of the source endpoint of the connection, or the
numerical address if the hostname cannot be determined.</para> numerical address if the hostname cannot be determined.</para>
<para>In case of "active" sources, the output file name must <para>In the case that "active" sources are given by the positional
always be given explicitly.</para> arguments or <option>--getter=</option> option, the output file name
must always be given explicitly.</para>
</refsect1> </refsect1>
<refsect1> <refsect1>
@ -265,20 +282,6 @@
The default is <literal>no</literal>.</para></listitem> The default is <literal>no</literal>.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry>
<term><option>--getter=<replaceable>PROG --option1 --option2</replaceable></option></term>
<listitem><para>Program to invoke to retrieve data. The journal
event stream must be generated on standard output.</para>
<para>Examples:</para>
<programlisting>--getter='curl "-HAccept: application/vnd.fdo.journal" https://some.host:19531/'</programlisting>
<programlisting>--getter='wget --header="Accept: application/vnd.fdo.journal" -O- https://some.host:19531/'</programlisting>
</listitem>
</varlistentry>
<xi:include href="standard-options.xml" xpointer="help" /> <xi:include href="standard-options.xml" xpointer="help" />
<xi:include href="standard-options.xml" xpointer="version" /> <xi:include href="standard-options.xml" xpointer="version" />
</variablelist> </variablelist>
@ -288,7 +291,7 @@
<title>Examples</title> <title>Examples</title>
<para>Copy local journal events to a different journal directory: <para>Copy local journal events to a different journal directory:
<programlisting> <programlisting>
journalctl -o export | systemd-journal-remote -o /tmp/dir - journalctl -o export | systemd-journal-remote -o /tmp/dir/foo.journal -
</programlisting> </programlisting>
</para> </para>