Dies ist der Vorgabebefehl, falls keiner angegeben ist. Er fragt die TPM2 PCR-Werte 11 des Systems ab und zeigt sie an. Die Daten werden in einem ähnlichen Format wie beim nachfolgenden Befehl calculate geschrieben und können dazu verwandt werden, schnell die Erwartungen mit der Realität abzugleichen.

Hinzugefügt in Version 252.

Berechnet die erwarteten Werte, die in PCR-Register 11 nach dem Hochfahren des vereinigten Kernelabbildes, das aus den mit --linux=, --osrel=, --cmdline=, --initrd=, --ucode=, --splash=, --dtb=, --uname=, --sbat=, --pcrpkey=, --profile=, --dtbauto=, --hwids= angegeben Komponenten bestehen wird (siehe nachfolgend), gesehen werden. Nur --linux= ist verpflichtend. (Geben Sie alternativ --current an, um die aktuellen Werte aus PCR-Register 11 zu verwenden.)

Hinzugefügt in Version 252.

Wie bei dem Befehl calculate wird der erwartete Wert, der nach dem Starten eines vereinigten Kernelabbildes in TPM2-PCR-Register 11 gesehene Wert, vorberechnet. Dann wird der entstandene Wert kryptographisch mit dem asymetrischen Schlüsselpaar (RSA), das über --private-key= und --public-key= konfiguriert ist, signiert. Dies schreibt ein JSON-Objekt in die Standardausgabe, das die Signaturen für alle angegebenen PCR-Bänke enthält (siehe nachfolgend --bank=). Dies kann zum Entsperren verschlüsselter Zugangsberechtigungen (siehe systemd-creds(1)) oder LUKS-Datenträger (siehe systemd-cryptsetup@.service(8)) verwandt werden. Dies ermöglicht das Binden von Geheimnissen an eine Gruppe von Kerneln, für die solche PCR-11-Signaturen bereitgestellt werden können.

Beachten Sie, dass ein TPM2-Gerät verfügbar sein muss, damit das Signieren stattfinden kann, obwohl das Ergebnis nicht mit einem TPM2-Gerät oder seinen Zustand verknüpft ist.

Hinzugefügt in Version 252.

Wird das mit dem Unterbefehl calculate oder sign verwandt, konfiguriert es die Dateien, aus der die Komponenten des vereinigten Kernelabbildes gelesen werden. Jede Option entspricht dem gleich benannten Abschnitt in der PE-Datei des vereinigten Kernels. Der Schalter --linux= erwartet den Pfad zu der ELF-Kerneldatei, die der vereinigte PE-Kernel umschließen wird. Alle Schalter außer --linux= sind optional. Jede Option darf höchstens einmal verwandt werden.

Hinzugefügt in Version 252.

Mit den Ausnahmen --profile=, --dtbauto= und --hwids=, die in Version 257 hinzugefügt wurden.

Wird das mit dem Unterbefehl calculate oder sign verwandt, akzeptiert es die derzeit im System wirksamen PCR-11-Werte (die typischerweise die Hashes des aktuell gestarteten Kernels widerspiegeln sollten). Dies kann anstelle von --linux= und den anderen, oben aufgeführten Schaltern verwandt werden.

Hinzugefügt in Version 252.

Steuert die PCR-Bänke, für die PCR-Werte vorabberechnet werden sollen – im Falle des Aufrufs von calculate oder sign – oder die Bänke, die in der Ausgabe status angezeigt werden sollen. Kann mehrfach verwandt werden, um mehrere Bänke anzugeben. Falls nicht angegeben, ist die Vorgabe die vier Bänke »sha1«, »sha256«, »sha384«, »sha512«.

Hinzugefügt in Version 252.

Diese Schalter akzeptieren Pfade auf PEM-kodierte RSA-Schlüsseldateien, zur Verwendung mit dem Befehl sign.

Beachten Sie die Unterschiede zwischen den Schaltern --pcrpkey= und --public-key=. Ersterer wählt die Daten, die im PE-Abschnitt ».pcrpkey« des vereinigten Kernelabbildes aufgenommen werden sollen, während letzterer den öffentlichen Schlüssel des Schlüsselpaars aufnimmt, der zum Signieren des entstehenden PCR-11-Wertes verwandt wird. Ersterer ist der Schlüssel, den das gestartete System wahrscheinlich zum Sperren der Verschlüsselung von Platten und Zugangsberechtigungen verwenden wird, während letzterer der Schlüssel ist, der zum erneuten Entsperren solcher Ressourcen verwandt wird. Daher sollte typischerweise in beiden Fällen der gleiche PEM-Schlüssel bereitgestellt werden.

Falls der --public-key= nicht, aber --private-key= angegeben ist, wird der öffentliche Schlüssel automatisch vom privaten Schlüssel abgeleitet.

--certificate= kann seit v256 zum Festlegen eines X.509-Zertifikats als Alternative zu --public-key= verwandt werden.

Hinzugefügt in Version 252.

Als Alternative zu --public-key= für den Befehl sign, können diese Schalter zum Signieren mit einem Hardware-Token verwandt werden. Die Option für den privaten Schlüssel kann einen Pfad oder eine URI akzeptieren, die an die OpenSSL-Engine oder den Bereitsteller weitergegeben wird, wie durch --private-key-source= festgelegt als ein Typ:Name-Tupel, wie engine:pkcs11. Die festgelegte OpenSSL-Signier-Engine oder der Bereitsteller werden zum Signieren verwandt.

Schalter zum Signieren mit einem Hardware-Token verwandt werden. Die Option --certificate= kann auch einen Pfad oder eine URI akzeptieren, die an den OpenSSL-Bereitsteller weitergegeben wird, wie durch --certificate-source= festgelegt als ein »Typ:Name«-Tupel, wie »provider:pkcs11«. Beachten Sie, dass anders als bei --private-key-source= diese Option nur Bereitsteller und keine Engines unterstützt.

Hinzugefügt in Version 256.

Steuert das zu verwendende TPM2-Gerät. Erwartet einen Geräteknotenpfad, der sich auf einen TPM2-Chip bezieht (z.B. /dev/tpmrm0). Alternativ kann der besondere Wert »auto« angegeben werden, um den Geräteknoten eines geeigneten TPM2-Gerätes (von dem es genau einen geben darf) automatisch zu bestimmen. Der besondere Wert »list« kann verwandt werden, um alle geeigneten, derzeit ermittelten TPM2-Geräte aufzuzählen.

Hinzugefügt in Version 252.

Steuert, für welche Systemstartphasen der erwartete PCR-11-Wert berechnet werden soll. Dies akzeptiert eine Reihe von Zeichenketten, getrennt durch Doppelpunkte, die die »Pfade« zum Eintritt einer bestimmten Phase des Systemstartprozesses kodieren. Jede der angegebenen Zeichenketten wird durch systemd-pcrphase-initrd.service, systemd-pcrphase-sysinit.service und systemd-pcrphase.service(8) in PCR 11 während verschiedener Meilensteine des Systemstartprozesses gemessen. Dieser Schalter kann mehrfach angegeben werden, um die PCR-Werte für mehrere Systemstartphasen auf einmal zu berechnen. Falls nicht verwandt ist die Vorgabe »enter-initrd«, »enter-initrd:leave-initrd«, »enter-initrd:leave-initrd:sysinit«, »enter-initrd:leave-initrd:sysinit:ready«, d.h. es werden die erwarteten PCR-Werte für die Systemstartphase in die Initrd, während des frühen Systemstarts, während des späten Systemstarts und während der Systemlaufzeit berechnet, aber die Phasen vor der Initrd oder beim Herunterfahren ausgeschlossen. Diese Einstellung wird von calculate und sign berücksichtigt. Bei der Verwendung mit letzterem ist sie besonders zur Erstellung von PCR-Signaturen nützlich, die nur zum Entsperren von Ressourcen während bestimmter Teile des Systemstartprozesses verwandt werden können.

Weitere Details zu PCR-Systemstartphasen finde Sie in systemd-pcrphase.service(8).

Hinzugefügt in Version 252.

Bei der Erstellung einer PCR-JSON-Signatur (über den Befehl sign) wird diese mit einer vorher erstellten PCR-JSON-Signatur kombiniert und als eine ausgegeben. Der angegebene Pfad muss sich auf eine normale Datei beziehen, die ein gültiges PCR-JSON-Signaturobjekt enthält. Die angegebene Datei wird nicht verändert. Sie wird zuerst gelesen und dann wird die frisch erstellte Signatur daran angehängt und das daraus enstandene Objekt wird in die Standardausgabe geschrieben. Verwenden Sie dies, um ein einzelnes JSON-Objekt zu erstellen, das aus Signaturen besteht, die mit einer Reihe von Signaturschlüsseln erstellt wurden (beispielsweise um einen Schlüssel pro Systemstartphase zu haben). Der Befehl wird Duplikate unterdrücken: Falls eine bestimmte Signatur bereits in dem JSON-Signaturobjekt enthalten ist, wird sie nicht erneut hinzugefügt.

Hinzugefügt in Version 253.

Zeigt die Ausgabe als JSON formatiert. Erwartet entweder »short« (für die kürzest mögliche Ausgabe ohne unnötigen Leerraum oder Zeilenumbrüche), »pretty« (für eine schönere Version der gleichen Ausgabe, mit Einzügen und Zeilenumbrüchen) oder »off« (um die JSON-Ausgabe auszuschalten, was die Vorgabe ist).

Leitet die Ausgabe nicht an ein Textanzeigeprogramm weiter.

Zeigt einen kurzen Hilfetext an und beendet das Programm.

Zeigt eine kurze Versionszeichenkette an und beendet das Programm.

$ ukify build \


     --linux=vmlinux \


     --initrd=initrd.cpio \


     --os-release=@os-release.txt \


     --cmdline=@cmdline.txt \


     --splash=splash.bmp \


     --devicetree=devicetree.dtb \


     --measure \


     --output=vmlinux.efi
11:sha1=d775a7b4482450ac77e03ee19bda90bd792d6ec7
11:sha256=bc6170f9ce28eb051ab465cd62be8cf63985276766cf9faf527ffefb66f45651
11:sha384=1cf67dff4757e61e5...7f49ad720be02fd07263e1f93061243aec599d1ee4b4
11:sha512=8e79acd3ddbbc8282...0c3e8ec0c714821032038f525f744960bcd082d937da

$ openssl genpkey -algorithm RSA -pkeyopt rsa_keygen_bits:2048 -out tpm2-pcr-private-key.pem
..+.+++++++++......+.........+......+.......+....+.....+.+...+..........
$ openssl rsa -pubout -in tpm2-pcr-private-key.pem -out tpm2-pcr-public-key.pem
$ systemd-measure sign \


     --linux=vmlinux \


     --osrel=os-release.txt \


     --cmdline=cmdline.txt \


     --initrd=initrd.cpio \


     --splash=splash.bmp \


     --dtb=devicetree.dtb \


     --pcrpkey=tpm2-pcr-public-key.pem \


     --bank=sha1 \


     --bank=sha256 \


     --private-key=tpm2-pcr-private-key.pem \


     --public-key=tpm2-pcr-public-key.pem >tpm2-pcr-signature.json
$ ukify build \


     --linux=vmlinux \


     --initrd=initrd.cpio \


     --os-release=@os-release.txt \


     --cmdline=@cmdline.txt \


     --splash=splash.bmp \


     --devicetree=devicetree.dtb \


     --pcr-private-key=tpm2-pcr-private-key.pem \


     --pcr-public-key=tpm2-pcr-public-key.pem \


     --pcr-banks=sha1,sha256 \


     --output=vmlinuz.efi

# systemd-cryptenroll --tpm2-device=auto \


     --tpm2-public-key=tpm2-pcr-public-key.pem \


     --tpm2-signature=tpm2-pcr-signature.json \


     /dev/sda5

# systemd-cryptsetup attach \


     datentrager5 /dev/sda5 - \


     tpm2-device=auto,tpm2-signature=/Pfad/zur/tpm2-pcr-signature.json

$ openssl genpkey -algorithm RSA -pkeyopt rsa_keygen_bits:2048 -out tpm2-pcr-private-key.pem
.+........+.+........+.......+...+...+........+....+......+..+..........
$ openssl rsa -pubout -in tpm2-pcr-private-key.pem -out tpm2-pcr-public-key.pem
$ openssl genpkey -algorithm RSA -pkeyopt rsa_keygen_bits:2048 -out tpm2-pcr-private-key-initrd.pem
..+.......++........+........+......+........+....+.....+.+..+..........
$ openssl rsa -pubout -in tpm2-pcr-private-key-initrd.pem -out tpm2-pcr-public-key-initrd.pem
$ ukify build \


     --linux=vmlinux-1.2.3 \


     --initrd=initrd.cpio \


     --os-release=@os-release.txt \


     --cmdline=@cmdline.txt \


     --splash=splash.bmp \


     --devicetree=devicetree.dtb \


     --pcr-private-key=tpm2-pcr-private-key.pem \


     --pcr-public-key=tpm2-pcr-public-key.pem \


     --phases=enter-initrd,enter-initrd:leave-initrd,enter-initrd:leave-initrd:sysinit,enter-initrd:leave-initrd:sysinit:ready \


     --pcr-banks=sha1,sha256 \


     --pcr-private-key=tpm2-pcr-private-key-initrd.pem \


     --pcr-public-key=tpm2-pcr-public-key-initrd.pem \


     --phases=enter-initrd \


     --uname=1.2.3 \


     --output=vmlinux-1.2.3.efi
+ /usr/lib/systemd/systemd-measure sign --linux=vmlinux-1.2.3 \
--osrel=os-release.txt --cmdline=cmdline.txt --dtb=devicetree.dtb \
--splash=splash.bmp --initrd=initrd.cpio --bank=sha1 --bank=sha256 \
--private-key=tpm2-pcr-private-key.pem --public-key=tpm2-pcr-public-key.pem \
--phase=enter-initrd --phase=enter-initrd:leave-initrd \
--phase=enter-initrd:leave-initrd:sysinit \
--phase=enter-initrd:leave-initrd:sysinit:ready
+ /usr/lib/systemd/systemd-measure sign --linux=vmlinux-1.2.3 \
--osrel=os-release.txt --cmdline=cmdline.txt --dtb=devicetree.dtb \
--splash=splash.bmp --initrd=initrd.cpio --bank=sha1 --bank=sha256 \
--private-key=tpm2-pcr-private-key-initrd.pem \
--public-key=tpm2-pcr-public-key-initrd.pem \
--phase=enter-initrd
Wrote unsigned vmlinux-1.2.3.efi