mirror of
https://gitlab.com/cryptsetup/cryptsetup.git
synced 2025-12-05 16:00:05 +01:00
360f85dde7
This is based mainly on Grammarly. It unifies man pages to at least some level of grammar, so later we can focus on adding more readable content.
35 lines
1.5 KiB
Plaintext
35 lines
1.5 KiB
Plaintext
= cryptsetup-resize(8)
|
|
:doctype: manpage
|
|
:manmanual: Maintenance Commands
|
|
:mansource: cryptsetup {release-version}
|
|
:man-linkstyle: pass:[blue R < >]
|
|
:COMMON_OPTIONS:
|
|
:ACTION_RESIZE:
|
|
|
|
== Name
|
|
|
|
cryptsetup-resize - resize an active mapping
|
|
|
|
== SYNOPSIS
|
|
|
|
*cryptsetup _resize_ [<options>] <name>*
|
|
|
|
== DESCRIPTION
|
|
|
|
Resizes an active mapping <name>.
|
|
|
|
If --size (in 512-byte sectors) or --device-size is not specified, the size is computed from the underlying device.
|
|
For LUKS, it is the size of the underlying device without the area reserved for the LUKS header (see data payload offset in the *luksDump* command).
|
|
For a plain crypt device, the whole device size is used.
|
|
|
|
Note that this does not change the raw device geometry; it just changes how many sectors of the raw device are represented in the mapped device.
|
|
|
|
If cryptsetup detected a volume key for the active device loaded in the kernel keyring service, the resize action would first try to retrieve the key using a token.
|
|
Only if it failed, it'd ask for a passphrase to unlock a keyslot (LUKS) or to derive a volume key again (plain mode).
|
|
The kernel keyring is used by default for LUKS2 devices.
|
|
|
|
*<options>* can be [--size, --device-size, --token-id, --token-only, --token-type, --key-slot, --key-file, --keyfile-size, --keyfile-offset, --timeout, --disable-external-tokens, --disable-locks, --disable-keyring, --volume-key-keyring, --verify-passphrase, --timeout, --external-tokens-path].
|
|
|
|
include::man/common_options.adoc[]
|
|
include::man/common_footer.adoc[]
|