mirror of
https://github.com/systemd/systemd
synced 2024-09-16 06:43:18 +00:00
73e97bb064
With <para><filename>…</filename></para>, we get a separate "paragraph" for each line, i.e. entries separated by empty lines. This uses up a lot of space and was only done because docbook makes it hard to insert a newline. In some other places, <literallayout> was used, but then we cannot indent the source text (because the whitespace would end up in the final page). We can get the desired result with <simplelist>. With <simplelist> the items are indented in roff output, but not in html output. In some places this looks better then no indentation, and in others it would probably be better to have no indent. But this is a minor issue and we cannot control that. (I didn't convert all spots. There's a bunch of other man pages which have two lines, e.g. an executable and service file, and it doesn't matter there so much.)
91 lines
3.6 KiB
XML
91 lines
3.6 KiB
XML
<?xml version='1.0'?>
|
|
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
|
|
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
|
|
<!-- SPDX-License-Identifier: LGPL-2.1-or-later -->
|
|
|
|
<refentry id="homed.conf" conditional='ENABLE_HOMED'
|
|
xmlns:xi="http://www.w3.org/2001/XInclude">
|
|
<refentryinfo>
|
|
<title>homed.conf</title>
|
|
<productname>systemd</productname>
|
|
</refentryinfo>
|
|
|
|
<refmeta>
|
|
<refentrytitle>homed.conf</refentrytitle>
|
|
<manvolnum>5</manvolnum>
|
|
</refmeta>
|
|
|
|
<refnamediv>
|
|
<refname>homed.conf</refname>
|
|
<refname>homed.conf.d</refname>
|
|
<refpurpose>Home area/user account manager configuration files</refpurpose>
|
|
</refnamediv>
|
|
|
|
<refsynopsisdiv>
|
|
<para><simplelist>
|
|
<member><filename>/etc/systemd/homed.conf</filename></member>
|
|
<member><filename>/etc/systemd/homed.conf.d/*.conf</filename></member>
|
|
<member><filename>/run/systemd/homed.conf.d/*.conf</filename></member>
|
|
<member><filename>/usr/lib/systemd/homed.conf.d/*.conf</filename></member>
|
|
</simplelist></para>
|
|
</refsynopsisdiv>
|
|
|
|
<refsect1>
|
|
<title>Description</title>
|
|
|
|
<para>These configuration files control default parameters for home areas/user accounts created and
|
|
managed by
|
|
<citerefentry><refentrytitle>systemd-homed.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>.</para>
|
|
|
|
</refsect1>
|
|
|
|
<xi:include href="standard-conf.xml" xpointer="main-conf" />
|
|
|
|
<refsect1>
|
|
<title>Options</title>
|
|
|
|
<para>The following options are available in the [Home] section:</para>
|
|
|
|
<variablelist class='home-directives'>
|
|
|
|
<varlistentry>
|
|
<term><varname>DefaultStorage=</varname></term>
|
|
<listitem><para>The default storage to use for home areas. Takes one of <literal>luks</literal>,
|
|
<literal>fscrypt</literal>, <literal>directory</literal>, <literal>subvolume</literal>,
|
|
<literal>cifs</literal>. For details about these options, see
|
|
<citerefentry><refentrytitle>homectl</refentrytitle><manvolnum>1</manvolnum></citerefentry>. If not
|
|
configured or assigned the empty string, the default storage is automatically determined: if not
|
|
running in a container environment and <filename>/home/</filename> is not itself encrypted, defaults
|
|
to <literal>luks</literal>. Otherwise defaults to <literal>subvolume</literal> if
|
|
<filename>/home/</filename> is on a btrfs file system, and <literal>directory</literal>
|
|
otherwise. Note that the storage selected on the <command>homectl</command> command line always takes
|
|
precedence.</para>
|
|
|
|
<xi:include href="version-info.xml" xpointer="v246"/></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><varname>DefaultFileSystemType=</varname></term>
|
|
<listitem><para>When using <literal>luks</literal> as storage (see above), selects the default file
|
|
system to use inside the user's LUKS volume. Takes one of <literal>btrfs</literal>,
|
|
<literal>ext4</literal> or <literal>xfs</literal>. If not specified defaults to
|
|
<literal>btrfs</literal>. This setting has no effect if a different storage mechanism is used. The
|
|
file system type selected on the <command>homectl</command> command line always takes
|
|
precedence.</para>
|
|
|
|
<xi:include href="version-info.xml" xpointer="v246"/></listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
</refsect1>
|
|
|
|
<refsect1>
|
|
<title>See Also</title>
|
|
<para>
|
|
<citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
|
|
<citerefentry><refentrytitle>systemd-homed.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>
|
|
</para>
|
|
</refsect1>
|
|
|
|
</refentry>
|