1luks-tools(1)               General Commands Manual              luks-tools(1)
2
3
4

NAME

6       luks-tools - Utilities for working with LUKS-protected filesystems
7

OVERVIEW

9       The  luks-tools  package  contains  various  utilities for working with
10       LUKS-protected filesystems.  HAL uses these utilities to  automatically
11       mount  encrypted  volumes  when they are attached to a system, provided
12       the user can produce the correct passphrase.  These utilities are writ‐
13       ten  as  separate  programs  to  allow MAC systems like SELinux to have
14       fine-grained control over them.
15
16
17
18       luks-format
19
20              A utility that formats a filesystem to contain a LUKS encryption
21              header.
22
23
24       luks-is-encrypted
25
26              A  tool  that  can  determine  if  a  filesystem contains a LUKS
27              encryption header.
28
29
30       luks-setup
31
32              A utility that sets up the dm-crypt device map for a partition.
33
34
35       gnome-luks-format
36
37              A GNOME front-end for luks-format.
38
39

NASTY DETAILS

41       The following is an example of how to create  an  encrypted  filesystem
42       and prepare it for mounting:
43
44
45              luks-format -v -t ext3 -c aes -l 256 -n MyLuksVolume /dev/sda4
46
47       The luks-format step may take quite some time because it overwrites the
48       partition with random data before it does anything else.
49
50
51       Once luks-format has been run, a device mapper entry  should  exist  in
52       /dev/mapper.  This device may be mounted as any other appropriate block
53       device:
54
55
56              mount /dev/mapper/luks_crypto_f20d9b37-ebe6-42c9-9665-CV035a81f0f3 /mnt
57
58       A volume that has already been initialized with a LUKS header and  for‐
59       matted may be mounted as follows:
60
61
62
63              luks-setup /dev/sda4
64              mount /dev/mapper/luks_crypto_f20d9b37-ebe6-42c9-9665-cb035a81f0f3 /mnt
65

AUTHORS

67       W. Michael Petullo <mike@flyn.org>
68
69
70
71                                                                 luks-tools(1)
Impressum