man/systemd-homed.service.xml

   1 <?xml version='1.0'?> <!--*-nxml-*-->
   2 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
   3   "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
   4 <!-- SPDX-License-Identifier: LGPL-2.1+ -->
   5
   6 <refentry id="systemd-homed.service" conditional='ENABLE_HOMED'>
   7
   8   <refentryinfo>
   9     <title>systemd-homed.service</title>
  10     <productname>systemd</productname>
  11   </refentryinfo>
  12
  13   <refmeta>
  14     <refentrytitle>systemd-homed.service</refentrytitle>
  15     <manvolnum>8</manvolnum>
  16   </refmeta>
  17
  18   <refnamediv>
  19     <refname>systemd-homed.service</refname>
  20     <refname>systemd-homed</refname>
  21     <refpurpose>Home Directory/User Account Manager</refpurpose>
  22   </refnamediv>
  23
  24   <refsynopsisdiv>
  25     <para><filename>systemd-homed.service</filename></para>
  26     <para><filename>/usr/lib/systemd/systemd-homed</filename></para>
  27   </refsynopsisdiv>
  28
  29   <refsect1>
  30     <title>Description</title>
  31
  32     <para><command>systemd-homed</command> is a system service that may be used to create, remove, change or
  33     inspect home directories.</para>
  34
  35     <para>Most of <command>systemd-homed</command>'s functionality is accessible through the
  36     <citerefentry><refentrytitle>homectl</refentrytitle><manvolnum>1</manvolnum></citerefentry> command.</para>
  37
  38     <para>See the <ulink url="https://systemd.io/HOME_DIRECTORY">Home Directories</ulink> documentation for
  39     details about the format and design of home directories managed by
  40     <filename>systemd-homed.service</filename>.</para>
  41
  42     <para>Each home directory managed by <filename>systemd-homed.service</filename> synthesizes a local user
  43     and group. These are made available to the system using the <ulink
  44     url="https://systemd.io/USER_GROUP_API">User/Group Record Lookup API via Varlink</ulink>, and thus may be
  45     browsed with
  46     <citerefentry><refentrytitle>userdbctl</refentrytitle><manvolnum>1</manvolnum></citerefentry>.</para>
  47   </refsect1>
  48
  49   <refsect1>
  50     <title>See Also</title>
  51     <para>
  52       <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
  53       <citerefentry><refentrytitle>homectl</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
  54       <citerefentry><refentrytitle>userdbctl</refentrytitle><manvolnum>1</manvolnum></citerefentry>
  55     </para>
  56   </refsect1>
  57 </refentry>