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. There is no default value, so either this
  72         option or the command-line option must be always present to make an upload.</para></listitem>
  73       </varlistentry>
  74
  75       <varlistentry>
  76         <term><varname>ServerKeyFile=</varname></term>
  77
  78         <listitem><para>SSL key in PEM format.</para></listitem>
  79       </varlistentry>
  80
  81       <varlistentry>
  82         <term><varname>ServerCertificateFile=</varname></term>
  83
  84         <listitem><para>SSL CA certificate in PEM format.</para></listitem>
  85       </varlistentry>
  86
  87       <varlistentry>
  88         <term><varname>TrustedCertificateFile=</varname></term>
  89
  90         <listitem><para>SSL CA certificate.</para></listitem>
  91       </varlistentry>
  92
  93     </variablelist>
  94
  95   </refsect1>
  96
  97   <refsect1>
  98       <title>See Also</title>
  99       <para>
 100         <citerefentry><refentrytitle>systemd-journal-upload.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
 101         <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
 102         <citerefentry><refentrytitle>systemd-journald.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>
 103       </para>
 104   </refsect1>
 105
 106 </refentry>