Files
u-boot/doc/usage/index.rst
Simon Glass dfb03773ca luks: Add detection of LUKS partition
Provide a function which can detect a LUKS partition. Add a test, using
mmc11

Series-to: concept
Cover-letter:
luks: Provide basic support for unlocking a LUKS1 partition
With full-disk encryption (FDE) it is traditional to unlock a LUKS
partition within userspace as part of the initial ramdisk passed to
Linux. The user is prompted for a passphrase and then the disk is
unlocked.

This works well but does have some drawbacks:
- firmware has no way of knowing whether the boot will success
- the 'passphrase' prompt comes quite late in the boot, which can be
  confusing for the user
- specifically it is not possible to provide an integrated 'boot' UI in
  firmware where the user can enter the passphrase
- in a VM environment, the key may be known in advance, but there is no
  way to take advantage of this
- it is not possible to use an encryted disk unless also using a ramdisk

This series makes a small step towards improving U-Boot in this area. It
allows a passphrase to be checked against a LUKS1-encrypted partition.
It also provides read-only access to the unencrypted data, so that files
can be read.
END

Co-developed-by: Claude <noreply@anthropic.com>
Signed-off-by: Simon Glass <sjg@chromium.org>
2025-10-24 21:02:11 +01:00

159 lines
1.9 KiB
ReStructuredText

Use U-Boot
==========
.. toctree::
:maxdepth: 1
spl_boot
blkmap
console
dfu
environment
fdt_overlays
fit/index
luks
netconsole
partitions
cmdline
semihosting
smbios
measured_boot
upl
Shell commands
--------------
.. toctree::
:maxdepth: 1
cmd/acpi
cmd/addr_find
cmd/addrmap
cmd/armffa
cmd/askenv
cmd/base
cmd/bdinfo
cmd/bind
cmd/blkcache
cmd/blkmap
cmd/bootd
cmd/bootdev
cmd/bootefi
cmd/bootelf
cmd/bootflow
cmd/booti
cmd/bootm
cmd/bootmenu
cmd/bootmeth
cmd/bootstd
cmd/bootz
cmd/button
cmd/cat
cmd/cbcmos
cmd/cbsysinfo
cmd/cedit
cmd/chid
cmd/cli
cmd/cls
cmd/cmp
cmd/coninfo
cmd/conitrace
cmd/cp
cmd/cpu
cmd/cpuid
cmd/cyclic
cmd/dm
cmd/ebtupdate
cmd/echo
cmd/efi
cmd/eficonfig
cmd/efidebug
cmd/env
cmd/event
cmd/exception
cmd/exit
cmd/extension
cmd/false
cmd/fatinfo
cmd/fatload
cmd/fdt
cmd/font
cmd/for
cmd/fwu_mdata
cmd/gpio
cmd/gpt
cmd/history
cmd/host
cmd/if
cmd/itest
cmd/imxtract
cmd/lcdputs
cmd/load
cmd/loadb
cmd/loadm
cmd/loads
cmd/loadx
cmd/loady
cmd/luks
cmd/meminfo
cmd/mbr
cmd/md
cmd/mmc
cmd/msr
cmd/mtest
cmd/mtrr
cmd/mv
cmd/panic
cmd/part
cmd/part_find
cmd/pause
cmd/pinmux
cmd/printenv
cmd/pstore
cmd/pwm
cmd/qfw
cmd/read
cmd/reset
cmd/rng
cmd/saves
cmd/sb
cmd/sbi
cmd/scmi
cmd/scp03
cmd/seama
cmd/setcurs
cmd/setexpr
cmd/sf
cmd/shim
cmd/size
cmd/sleep
cmd/sm
cmd/smbios
cmd/sound
cmd/source
cmd/tcpm
cmd/temperature
cmd/tkey
cmd/tftpput
cmd/trace
cmd/true
cmd/upl
cmd/ums
cmd/unbind
cmd/ut
cmd/video
cmd/virtio
cmd/wdt
cmd/wget
cmd/write
cmd/xxd
Booting OS
----------
.. toctree::
:maxdepth: 1
os/plan9
os/vxworks