Merge branch 'upstream' into tizen
[platform/upstream/cryptsetup.git] / man / cryptsetup-luksKillSlot.8.adoc
1 = cryptsetup-luksKillSlot(8)
2 :doctype: manpage
3 :manmanual: Maintenance Commands
4 :mansource: cryptsetup {release-version}
5 :man-linkstyle: pass:[blue R < >]
6 :COMMON_OPTIONS:
7 :ACTION_LUKSKILLSLOT:
8
9 == Name
10
11 cryptsetup-luksKillSlot - wipe a key-slot from the LUKS device
12
13 == SYNOPSIS
14
15 *cryptsetup _luksKillSlot_ [<options>] <device> <key slot number>*
16
17 == DESCRIPTION
18
19 Wipe the key-slot number <key slot> from the LUKS device. Except running
20 in batch-mode (-q) a remaining passphrase must be supplied, either
21 interactively or via --key-file. This command can remove the last
22 remaining key-slot, but requires an interactive confirmation when doing
23 so. Removing the last passphrase makes a LUKS container permanently
24 inaccessible.
25
26 *<options>* can be [--key-file, --keyfile-offset, --keyfile-size,
27 --header, --disable-locks, --type, --verify-passphrase, --timeout].
28
29 *WARNING:* If you read the passphrase from stdin (without further
30 argument or with '-' as an argument to --key-file), batch-mode (-q) will
31 be implicitly switched on and no warning will be given when you remove
32 the last remaining passphrase from a LUKS container. Removing the last
33 passphrase makes the LUKS container permanently inaccessible.
34
35 *NOTE:* If there is no passphrase provided (on stdin or through
36 --key-file argument) and batch-mode (-q) is active, the key-slot is
37 removed without any other warning.
38
39 include::man/common_options.adoc[]
40 include::man/common_footer.adoc[]