]> git.ipfire.org Git - thirdparty/systemd.git/blob - man/journal-upload.conf.xml
man: add a new page with a general description of common syntax
[thirdparty/systemd.git] / man / journal-upload.conf.xml
1 <?xml version='1.0'?> <!--*-nxml-*-->
2 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3 "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
4
5 <!--
6 SPDX-License-Identifier: LGPL-2.1+
7
8 This file is part of systemd.
9
10 Copyright 2016 Zbigniew Jędrzejewski-Szmek
11 -->
12
13 <refentry id="journal-upload.conf" conditional='HAVE_MICROHTTPD'
14 xmlns:xi="http://www.w3.org/2001/XInclude">
15 <refentryinfo>
16 <title>journal-upload.conf</title>
17 <productname>systemd</productname>
18
19 <authorgroup>
20 <author>
21 <contrib>Monkey with a keyboard</contrib>
22 <firstname>Zbigniew</firstname>
23 <surname>Jędrzejewski-Szmek</surname>
24 <email>zbyszek@in.waw.pl</email>
25 </author>
26 </authorgroup>
27 </refentryinfo>
28
29 <refmeta>
30 <refentrytitle>journal-upload.conf</refentrytitle>
31 <manvolnum>5</manvolnum>
32 </refmeta>
33
34 <refnamediv>
35 <refname>journal-upload.conf</refname>
36 <refname>journal-upload.conf.d</refname>
37 <refpurpose>Configuration files for the journal upload service</refpurpose>
38 </refnamediv>
39
40 <refsynopsisdiv>
41 <para><filename>/etc/systemd/journal-upload.conf</filename></para>
42 <para><filename>/etc/systemd/journal-upload.conf.d/*.conf</filename></para>
43 <para><filename>/run/systemd/journal-upload.conf.d/*.conf</filename></para>
44 <para><filename>/usr/lib/systemd/journal-upload.conf.d/*.conf</filename></para>
45 </refsynopsisdiv>
46
47 <refsect1>
48 <title>Description</title>
49
50 <para>These files configure various parameters of
51 <citerefentry><refentrytitle>systemd-journal-upload.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>.
52 See
53 <citerefentry><refentrytitle>systemd.syntax</refentrytitle><manvolnum>5</manvolnum></citerefentry>
54 for a general description of the syntax.</para>
55 </refsect1>
56
57 <xi:include href="standard-conf.xml" xpointer="main-conf" />
58
59 <refsect1>
60 <title>Options</title>
61
62 <para>All options are configured in the <literal>[Upload]</literal> section:</para>
63
64 <variablelist>
65 <varlistentry>
66 <term><varname>URL=</varname></term>
67
68 <listitem><para>The URL to upload the journal entries to. See the description
69 of <varname>--url=</varname> option in
70 <citerefentry><refentrytitle>systemd-journal-upload</refentrytitle><manvolnum>8</manvolnum></citerefentry>
71 for the description of possible values.</para></listitem>
72 </varlistentry>
73
74 <varlistentry>
75 <term><varname>ServerKeyFile=</varname></term>
76
77 <listitem><para>SSL key in PEM format.</para></listitem>
78 </varlistentry>
79
80 <varlistentry>
81 <term><varname>ServerCertificateFile=</varname></term>
82
83 <listitem><para>SSL CA certificate in PEM format.</para></listitem>
84 </varlistentry>
85
86 <varlistentry>
87 <term><varname>TrustedCertificateFile=</varname></term>
88
89 <listitem><para>SSL CA certificate.</para></listitem>
90 </varlistentry>
91
92 </variablelist>
93
94 </refsect1>
95
96 <refsect1>
97 <title>See Also</title>
98 <para>
99 <citerefentry><refentrytitle>systemd-journal-upload</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
100 <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
101 <citerefentry><refentrytitle>systemd-journald.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>
102 </para>
103 </refsect1>
104
105 </refentry>