table of contents
- bookworm 4.18.1-1
- bookworm-backports 4.24.0-2~bpo12+1
- testing 4.24.0-2
- unstable 4.24.0-2
SYSTEMD-CRYPTSETUP-GENERATOR(8) | systemd-cryptsetup-generator | SYSTEMD-CRYPTSETUP-GENERATOR(8) |
BEZEICHNUNG¶
systemd-cryptsetup-generator - Unit-Generator für /etc/crypttab
ÜBERSICHT¶
/lib/systemd/system-generators/systemd-cryptsetup-generator
BESCHREIBUNG¶
Systemd-cryptsetup-generator ist ein Generator, der in der frühen Phase des Systemstarts und wenn die Konfiguration des Systemverwalters neu geladen wird /etc/crypttab in native System-Units übersetzt. Dies erzeugt die notwendigen systemd-cryptsetup@.service(8).
systemd-cryptsetup-generator implementiert systemd.generator(7).
KERNEL-BEFEHLSZEILE¶
Systemd-cryptsetup-generator versteht die folgenden Kernelbefehlszeilenparameter:
luks=, rd.luks=
luks.crypttab=, rd.luks.crypttab=
luks.uuid=, rd.luks.uuid=
Falls /etc/crypttab Einträge mit der gleichen UUID enthält, werden der Name, die Schlüsseldatei und die dort angegebenen Optionen benutzt. Andernfalls wird das Gerät den Namen »luks-UUID« tragen.
Falls /etc/crypttab existiert, werden nur die auf der Kernelbefehlszeile angegebenen Zeilen in der Initrd oder in der echten Wurzel aktiviert.
luks.name=, rd.luks.name=
Dieser Parameter ist das Gegenstück zu dem ersten crypttab(5)-Feld volume-name.
rd.luks.name= wird nur in der Initrd berücksichtigt, während luks.name= sowohl vom Hauptsystem als auch in der Initrd berücksichtigt wird.
luks.data=, rd.luks.data=
Für solche Einträge, die mit rd.luks.uuid= oder luks.uuid= festgelegt werden, wird das Datengerät auf die durch rd.luks.data= oder luks.data= der entsprechenden UUID festgelegten gesetzt.
Der LUKS-Datengeräteparameter ist zur Angabe von verschlüsselten Datengeräten mit abgetrennten Kopfzeilen, die in luks.options-Einträgen, die das Argument »header=« enthalten, festgelegt sind, nützlich. Beispiel: rd.luks.uuid=b40f1abf-2a53-400a-889a-2eccc27eaa40 rd.luks.options=b40f1abf-2a53-400a-889a-2eccc27eaa40=header=/Pfad/zur/luks.hdr rd.luks.data=b40f1abf-2a53-400a-889a-2eccc27eaa40=/dev/sdx. Daher wird in diesem Fall versucht, ein LUKS-Gerät zu entsperren, das aus Datengeräten »/dev/sdx« zusammengebaut ist und dessen LUKS-Kopfzeilen (Metadaten) in »Pfad/zur/luks.hdr«-Datei abgelegt sind. Diese Syntax wird derzeit nur auf einer gerätebezogenen Basis unterstützt, d.h. Sie müssen die UUID des LUKS-Geräts angeben.
Dieser Parameter ist das Gegenstück zu dem zweiten crypttab(5)-Feld encrypted-device.
rd.luks.data= wird nur in der Initrd berücksichtigt, während luks.data= sowohl vom Hauptsystem als auch in der Initrd berücksichtigt wird.
luks.key=, rd.luks.key=
Für solche Einträge, die mit rd.luks.uuid= oder luks.uuid= festgelegt werden, wird die Passwortdatei auf die durch rd.luks.key= oder luks.key= der entsprechenden UUID festgelegten gesetzt oder auf die Passwortdatei, die ohne eine UUID festgelegt wurde.
Es ist auch möglich, ein externes Gerät festzulegen, das vor dem Entsperren des LUKS-Gerätes eingehängt werden soll. Systemd-cryptsetup wird auf dem Gerät gespeicherte Passwortdateien verwenden. Das Gerät, das die Passwortdatei enthält, wird durch Anhängen eines Doppelpunkts und einer Gerätekennung an den Passwortdateipfad festgelegt. Beispiel: rd.luks.uuid=b40f1abf-2a53-400a-889a-2eccc27eaa40 rd.luks.key=b40f1abf-2a53-400a-889a-2eccc27eaa40=/keyfile:LABEL=keydev. Daher wird in diesem Fall versucht, ein auf dem Blockgerät mit dem Bezeichner »keydev« liegendes Dateisystem einzuhängen. Diese Syntax wird derzeit nur auf einer gerätebezogenen Basis unterstützt, d.h. Sie müssen die UUID des LUKS-Geräts angeben.
Dieser Parameter ist das Gegenstück zu dem dritten crypttab(5)-Feld key-file.
rd.luks.key= wird nur in der Initrd berücksichtigt, während luks.key= sowohl vom Hauptsystem als auch in der Initrd berücksichtigt wird.
luks.options=, rd.luks.options=
Falls nur eine Liste von Optionen ohne eine UUID angegeben wird, werden sie auf alle UUIDs, die nicht woanders angegeben werden und die keinen Eintrag in /etc/crypttab haben, angewandt.
Dieser Parameter ist das Gegenstück zu dem vierten crypttab(5)-Feld options.
Es ist möglich, ein externes Gerät festzulegen, das vor dem Entsperren des LUKS-Gerätes eingehängt werden soll. Systemd-cryptsetup wird LUKS-Geräte durch Kombination der in luks.data festgelegten Daten mit den in dem Argument »header=« gefundenen Kopfzeilen zusammenbauen. Beispiel: rd.luks.uuid=b40f1abf-2a53-400a-889a-2eccc27eaa40 rd.luks.options=b40f1abf-2a53-400a-889a-2eccc27eaa40=header=/luks.hdr:LABEL=hdrdev rd.luks.data=b40f1abf-2a53-400a-889a-2eccc27eaa40=/dev/sdx. Daher wird in diesem Fall versucht, ein auf dem Blockgerät mit dem Bezeichner »hdrdev« liegendes Dateisystem einzuhängen und nach »luks.hdr« auf diesem Dateisystem zu suchen. Besagte Kopfzeilen werden zum Entsperren (Entschlüsseln) der auf /dev/sdx gespeicherten verschlüsselten Daten verwandt. Diese Syntax wird derzeit nur auf einer gerätebezogenen Basis unterstützt, d.h. Sie müssen die UUID des LUKS-Geräts angeben.
rd.luks.options= wird nur von anfänglichen RAM-Platten (Initrd) berücksichtigt, während luks.options= sowohl vom Hauptsystem als auch in der Initrd berücksichtigt wird.
SIEHE AUCH¶
systemd(1), crypttab(5), systemd-cryptsetup@.service(8), systemd-cryptenroll(1), cryptsetup(8), systemd-fstab-generator(8)
ÜBERSETZUNG¶
Die deutsche Übersetzung dieser Handbuchseite wurde von Helge Kreutzmann <debian@helgefjell.de> erstellt.
Diese Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.
Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die Mailingliste der Übersetzer.
systemd 254 |