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