1SYSTEMD-VERITYSETUP-GENERAsTyOsRt(e8m)d-veritysetup-geSnYeSrTaEtMoDr-VERITYSETUP-GENERATOR(8)
2
3
4
6 systemd-veritysetup-generator - Unit generator for integrity protected
7 block devices
8
10 /usr/lib/systemd/system-generators/systemd-veritysetup-generator
11
13 systemd-veritysetup-generator is a generator that translates kernel
14 command line options configuring integrity protected block devices
15 (verity) into native systemd units early at boot and when configuration
16 of the system manager is reloaded. This will create systemd-
17 veritysetup@.service(8) units as necessary.
18
19 Currently, only a single verity device may be se up with this
20 generator, backing the root file system of the OS.
21
22 systemd-veritysetup-generator implements systemd.generator(7).
23
25 systemd-veritysetup-generator understands the following kernel command
26 line parameters:
27
28 systemd.verity=, rd.systemd.verity=
29 Takes a boolean argument. Defaults to "yes". If "no", disables the
30 generator entirely. rd.systemd.verity= is honored only by the
31 initial RAM disk (initrd) while systemd.verity= is honored by both
32 the host system and the initrd.
33
34 roothash=
35 Takes a root hash value for the root file system. Expects a hash
36 value formatted in hexadecimal characters, of the appropriate
37 length (i.e. most likely 256 bit/64 characters, or longer). If not
38 specified via systemd.verity_root_data= and
39 systemd.verity_root_hash=, the hash and data devices to use are
40 automatically derived from the specified hash value. Specifically,
41 the data partition device is looked for under a GPT partition UUID
42 derived from the first 128bit of the root hash, the hash partition
43 device is looked for under a GPT partition UUID derived from the
44 last 128bit of the root hash. Hence it is usually sufficient to
45 specify the root hash to boot from an integrity protected root file
46 system, as device paths are automatically determined from it — as
47 long as the partition table is properly set up.
48
49 systemd.verity_root_data=, systemd.verity_root_hash=
50 These two settings take block device paths as arguments, and may be
51 use to explicitly configure the data partition and hash partition
52 to use for setting up the integrity protection for the root file
53 system. If not specified, these paths are automatically derived
54 from the roothash= argument (see above).
55
57 systemd(1), systemd-veritysetup@.service(8), veritysetup(8), systemd-
58 fstab-generator(8)
59
60
61
62systemd 241 SYSTEMD-VERITYSETUP-GENERATOR(8)