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
   9 <refentry id="journal-upload.conf" conditional='HAVE_MICROHTTPD'
  10           xmlns:xi="http://www.w3.org/2001/XInclude">
  11   <refentryinfo>
  12     <title>journal-upload.conf</title>
  13     <productname>systemd</productname>
  14
  15     <authorgroup>
  16       <author>
  17         <contrib>Monkey with a keyboard</contrib>
  18         <firstname>Zbigniew</firstname>
  19         <surname>Jędrzejewski-Szmek</surname>
  20         <email>zbyszek@in.waw.pl</email>
  21       </author>
  22     </authorgroup>
  23   </refentryinfo>
  24
  25   <refmeta>
  26     <refentrytitle>journal-upload.conf</refentrytitle>
  27     <manvolnum>5</manvolnum>
  28   </refmeta>
  29
  30   <refnamediv>
  31     <refname>journal-upload.conf</refname>
  32     <refname>journal-upload.conf.d</refname>
  33     <refpurpose>Configuration files for the journal upload service</refpurpose>
  34   </refnamediv>
  35
  36   <refsynopsisdiv>
  37     <para><filename>/etc/systemd/journal-upload.conf</filename></para>
  38     <para><filename>/etc/systemd/journal-upload.conf.d/*.conf</filename></para>
  39     <para><filename>/run/systemd/journal-upload.conf.d/*.conf</filename></para>
  40     <para><filename>/usr/lib/systemd/journal-upload.conf.d/*.conf</filename></para>
  41   </refsynopsisdiv>
  42
  43   <refsect1>
  44     <title>Description</title>
  45
  46     <para>These files configure various parameters of
  47     <citerefentry><refentrytitle>systemd-journal-upload.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>.
  48     See
  49     <citerefentry><refentrytitle>systemd.syntax</refentrytitle><manvolnum>5</manvolnum></citerefentry>
  50     for a general description of the syntax.</para>
  51   </refsect1>
  52
  53   <xi:include href="standard-conf.xml" xpointer="main-conf" />
  54
  55   <refsect1>
  56     <title>Options</title>
  57
  58     <para>All options are configured in the <literal>[Upload]</literal> section:</para>
  59
  60     <variablelist>
  61       <varlistentry>
  62         <term><varname>URL=</varname></term>
  63
  64         <listitem><para>The URL to upload the journal entries to. See the description
  65         of <varname>--url=</varname> option in
  66         <citerefentry><refentrytitle>systemd-journal-upload</refentrytitle><manvolnum>8</manvolnum></citerefentry>
  67         for the description of possible values. There is no default value, so either this
  68         option or the command-line option must be always present to make an upload.</para></listitem>
  69       </varlistentry>
  70
  71       <varlistentry>
  72         <term><varname>ServerKeyFile=</varname></term>
  73
  74         <listitem><para>SSL key in PEM format.</para></listitem>
  75       </varlistentry>
  76
  77       <varlistentry>
  78         <term><varname>ServerCertificateFile=</varname></term>
  79
  80         <listitem><para>SSL CA certificate in PEM format.</para></listitem>
  81       </varlistentry>
  82
  83       <varlistentry>
  84         <term><varname>TrustedCertificateFile=</varname></term>
  85
  86         <listitem><para>SSL CA certificate.</para></listitem>
  87       </varlistentry>
  88
  89     </variablelist>
  90
  91   </refsect1>
  92
  93   <refsect1>
  94       <title>See Also</title>
  95       <para>
  96         <citerefentry><refentrytitle>systemd-journal-upload.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
  97         <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
  98         <citerefentry><refentrytitle>systemd-journald.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>
  99       </para>
 100   </refsect1>
 101
 102 </refentry>