3 <!DOCTYPE refentry PUBLIC
"-//OASIS//DTD DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
5 SPDX-License-Identifier: LGPL-2.1+
7 This file is part of systemd.
9 Copyright 2012 Lennart Poettering
11 <refentry id=
"systemd-cryptsetup@.service" conditional='HAVE_LIBCRYPTSETUP'
>
14 <title>systemd-cryptsetup@.service
</title>
15 <productname>systemd
</productname>
19 <contrib>Developer
</contrib>
20 <firstname>Lennart
</firstname>
21 <surname>Poettering
</surname>
22 <email>lennart@poettering.net
</email>
28 <refentrytitle>systemd-cryptsetup@.service
</refentrytitle>
29 <manvolnum>8</manvolnum>
33 <refname>systemd-cryptsetup@.service
</refname>
34 <refname>systemd-cryptsetup
</refname>
35 <refpurpose>Full disk decryption logic
</refpurpose>
39 <para><filename>systemd-cryptsetup@.service
</filename></para>
40 <para><filename>/usr/lib/systemd/systemd-cryptsetup
</filename></para>
44 <title>Description
</title>
46 <para><filename>systemd-cryptsetup@.service
</filename> is a
47 service responsible for setting up encrypted block devices. It is
48 instantiated for each device that requires decryption for
51 <para><filename>systemd-cryptsetup@.service
</filename> will ask
52 for hard disk passwords via the
<ulink
53 url=
"https://www.freedesktop.org/wiki/Software/systemd/PasswordAgents">
54 password agent logic
</ulink>, in order to query the user for the
55 password using the right mechanism at boot and during
58 <para>At early boot and when the system manager configuration is reloaded,
<filename>/etc/crypttab
</filename> is
59 translated into
<filename>systemd-cryptsetup@.service
</filename> units by
60 <citerefentry><refentrytitle>systemd-cryptsetup-generator
</refentrytitle><manvolnum>8</manvolnum></citerefentry>.
</para>
64 <title>See Also
</title>
66 <citerefentry><refentrytitle>systemd
</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
67 <citerefentry><refentrytitle>systemd-cryptsetup-generator
</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
68 <citerefentry><refentrytitle>crypttab
</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
69 <citerefentry project='die-net'
><refentrytitle>cryptsetup
</refentrytitle><manvolnum>8</manvolnum></citerefentry>