2 This file is part of systemd.
4 Copyright 2010 Lennart Poettering
6 systemd is free software; you can redistribute it and/or modify it
7 under the terms of the GNU Lesser General Public License as published by
8 the Free Software Foundation; either version 2.1 of the License, or
9 (at your option) any later version.
11 systemd is distributed in the hope that it will be useful, but
12 WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 Lesser General Public License for more details.
16 You should have received a copy of the GNU Lesser General Public License
17 along with systemd; If not, see <http://www.gnu.org/licenses/>.
21 #include <libcryptsetup.h>
26 #include "sd-device.h"
28 #include "alloc-util.h"
29 #include "ask-password-api.h"
30 #include "device-util.h"
34 #include "mount-util.h"
35 #include "parse-util.h"
36 #include "path-util.h"
37 #include "string-util.h"
41 static const char *arg_type
= NULL
; /* CRYPT_LUKS1, CRYPT_TCRYPT or CRYPT_PLAIN */
42 static char *arg_cipher
= NULL
;
43 static unsigned arg_key_size
= 0;
44 static int arg_key_slot
= CRYPT_ANY_SLOT
;
45 static unsigned arg_keyfile_size
= 0;
46 static unsigned arg_keyfile_offset
= 0;
47 static char *arg_hash
= NULL
;
48 static char *arg_header
= NULL
;
49 static unsigned arg_tries
= 3;
50 static bool arg_readonly
= false;
51 static bool arg_verify
= false;
52 static bool arg_discards
= false;
53 static bool arg_tcrypt_hidden
= false;
54 static bool arg_tcrypt_system
= false;
55 static bool arg_tcrypt_veracrypt
= false;
56 static char **arg_tcrypt_keyfiles
= NULL
;
57 static uint64_t arg_offset
= 0;
58 static uint64_t arg_skip
= 0;
59 static usec_t arg_timeout
= 0;
61 /* Options Debian's crypttab knows we don't:
71 static int parse_one_option(const char *option
) {
74 /* Handled outside of this tool */
75 if (STR_IN_SET(option
, "noauto", "auto", "nofail", "fail"))
78 if (startswith(option
, "cipher=")) {
88 } else if (startswith(option
, "size=")) {
90 if (safe_atou(option
+5, &arg_key_size
) < 0) {
91 log_error("size= parse failure, ignoring.");
95 if (arg_key_size
% 8) {
96 log_error("size= not a multiple of 8, ignoring.");
102 } else if (startswith(option
, "key-slot=")) {
104 arg_type
= CRYPT_LUKS1
;
105 if (safe_atoi(option
+9, &arg_key_slot
) < 0) {
106 log_error("key-slot= parse failure, ignoring.");
110 } else if (startswith(option
, "tcrypt-keyfile=")) {
112 arg_type
= CRYPT_TCRYPT
;
113 if (path_is_absolute(option
+15)) {
114 if (strv_extend(&arg_tcrypt_keyfiles
, option
+ 15) < 0)
117 log_error("Key file path '%s' is not absolute. Ignoring.", option
+15);
119 } else if (startswith(option
, "keyfile-size=")) {
121 if (safe_atou(option
+13, &arg_keyfile_size
) < 0) {
122 log_error("keyfile-size= parse failure, ignoring.");
126 } else if (startswith(option
, "keyfile-offset=")) {
128 if (safe_atou(option
+15, &arg_keyfile_offset
) < 0) {
129 log_error("keyfile-offset= parse failure, ignoring.");
133 } else if (startswith(option
, "hash=")) {
136 t
= strdup(option
+5);
143 } else if (startswith(option
, "header=")) {
144 arg_type
= CRYPT_LUKS1
;
146 if (!path_is_absolute(option
+7)) {
147 log_error("Header path '%s' is not absolute, refusing.", option
+7);
152 log_error("Duplicate header= options, refusing.");
156 arg_header
= strdup(option
+7);
160 } else if (startswith(option
, "tries=")) {
162 if (safe_atou(option
+6, &arg_tries
) < 0) {
163 log_error("tries= parse failure, ignoring.");
167 } else if (STR_IN_SET(option
, "readonly", "read-only"))
169 else if (streq(option
, "verify"))
171 else if (STR_IN_SET(option
, "allow-discards", "discard"))
173 else if (streq(option
, "luks"))
174 arg_type
= CRYPT_LUKS1
;
175 else if (streq(option
, "tcrypt"))
176 arg_type
= CRYPT_TCRYPT
;
177 else if (streq(option
, "tcrypt-hidden")) {
178 arg_type
= CRYPT_TCRYPT
;
179 arg_tcrypt_hidden
= true;
180 } else if (streq(option
, "tcrypt-system")) {
181 arg_type
= CRYPT_TCRYPT
;
182 arg_tcrypt_system
= true;
183 } else if (streq(option
, "tcrypt-veracrypt")) {
184 #ifdef CRYPT_TCRYPT_VERA_MODES
185 arg_type
= CRYPT_TCRYPT
;
186 arg_tcrypt_veracrypt
= true;
188 log_error("This version of cryptsetup does not support tcrypt-veracrypt; refusing.");
191 } else if (STR_IN_SET(option
, "plain", "swap", "tmp"))
192 arg_type
= CRYPT_PLAIN
;
193 else if (startswith(option
, "timeout=")) {
195 if (parse_sec(option
+8, &arg_timeout
) < 0) {
196 log_error("timeout= parse failure, ignoring.");
200 } else if (startswith(option
, "offset=")) {
202 if (safe_atou64(option
+7, &arg_offset
) < 0) {
203 log_error("offset= parse failure, refusing.");
207 } else if (startswith(option
, "skip=")) {
209 if (safe_atou64(option
+5, &arg_skip
) < 0) {
210 log_error("skip= parse failure, refusing.");
214 } else if (!streq(option
, "none"))
215 log_error("Encountered unknown /etc/crypttab option '%s', ignoring.", option
);
220 static int parse_options(const char *options
) {
221 const char *word
, *state
;
227 FOREACH_WORD_SEPARATOR(word
, l
, options
, ",", state
) {
228 _cleanup_free_
char *o
;
230 o
= strndup(word
, l
);
233 r
= parse_one_option(o
);
238 /* sanity-check options */
239 if (arg_type
!= NULL
&& !streq(arg_type
, CRYPT_PLAIN
)) {
241 log_warning("offset= ignored with type %s", arg_type
);
243 log_warning("skip= ignored with type %s", arg_type
);
249 static void log_glue(int level
, const char *msg
, void *usrptr
) {
250 log_debug("%s", msg
);
253 static int disk_major_minor(const char *path
, char **ret
) {
258 if (stat(path
, &st
) < 0)
261 if (!S_ISBLK(st
.st_mode
))
264 if (asprintf(ret
, "/dev/block/%d:%d", major(st
.st_rdev
), minor(st
.st_rdev
)) < 0)
270 static char* disk_description(const char *path
) {
272 static const char name_fields
[] =
273 "ID_PART_ENTRY_NAME\0"
275 "ID_MODEL_FROM_DATABASE\0"
278 _cleanup_(sd_device_unrefp
) sd_device
*device
= NULL
;
285 if (stat(path
, &st
) < 0)
288 if (!S_ISBLK(st
.st_mode
))
291 r
= sd_device_new_from_devnum(&device
, 'b', st
.st_rdev
);
295 NULSTR_FOREACH(i
, name_fields
) {
298 r
= sd_device_get_property_value(device
, i
, &name
);
299 if (r
>= 0 && !isempty(name
))
306 static char *disk_mount_point(const char *label
) {
307 _cleanup_free_
char *device
= NULL
;
308 _cleanup_endmntent_
FILE *f
= NULL
;
311 /* Yeah, we don't support native systemd unit files here for now */
313 if (asprintf(&device
, "/dev/mapper/%s", label
) < 0)
316 f
= setmntent("/etc/fstab", "r");
320 while ((m
= getmntent(f
)))
321 if (path_equal(m
->mnt_fsname
, device
))
322 return strdup(m
->mnt_dir
);
327 static int get_password(const char *vol
, const char *src
, usec_t until
, bool accept_cached
, char ***ret
) {
328 _cleanup_free_
char *description
= NULL
, *name_buffer
= NULL
, *mount_point
= NULL
, *maj_min
= NULL
, *text
= NULL
, *escaped_name
= NULL
;
329 _cleanup_strv_free_erase_
char **passwords
= NULL
;
330 const char *name
= NULL
;
338 description
= disk_description(src
);
339 mount_point
= disk_mount_point(vol
);
341 if (description
&& streq(vol
, description
))
342 /* If the description string is simply the
343 * volume name, then let's not show this
345 description
= mfree(description
);
347 if (mount_point
&& description
)
348 r
= asprintf(&name_buffer
, "%s (%s) on %s", description
, vol
, mount_point
);
349 else if (mount_point
)
350 r
= asprintf(&name_buffer
, "%s on %s", vol
, mount_point
);
351 else if (description
)
352 r
= asprintf(&name_buffer
, "%s (%s)", description
, vol
);
357 name
= name_buffer
? name_buffer
: vol
;
359 if (asprintf(&text
, "Please enter passphrase for disk %s!", name
) < 0)
363 (void) disk_major_minor(src
, &maj_min
);
366 escaped_name
= maj_min
;
369 escaped_name
= cescape(name
);
374 id
= strjoina("cryptsetup:", escaped_name
);
376 r
= ask_password_auto(text
, "drive-harddisk", id
, "cryptsetup", until
,
377 ASK_PASSWORD_PUSH_CACHE
| (accept_cached
*ASK_PASSWORD_ACCEPT_CACHED
),
380 return log_error_errno(r
, "Failed to query password: %m");
383 _cleanup_strv_free_erase_
char **passwords2
= NULL
;
385 assert(strv_length(passwords
) == 1);
387 if (asprintf(&text
, "Please enter passphrase for disk %s! (verification)", name
) < 0)
390 id
= strjoina("cryptsetup-verification:", escaped_name
);
392 r
= ask_password_auto(text
, "drive-harddisk", id
, "cryptsetup", until
, ASK_PASSWORD_PUSH_CACHE
, &passwords2
);
394 return log_error_errno(r
, "Failed to query verification password: %m");
396 assert(strv_length(passwords2
) == 1);
398 if (!streq(passwords
[0], passwords2
[0])) {
399 log_warning("Passwords did not match, retrying.");
404 strv_uniq(passwords
);
406 STRV_FOREACH(p
, passwords
) {
409 if (strlen(*p
)+1 >= arg_key_size
)
412 /* Pad password if necessary */
413 c
= new(char, arg_key_size
);
417 strncpy(c
, *p
, arg_key_size
);
428 static int attach_tcrypt(
429 struct crypt_device
*cd
,
431 const char *key_file
,
436 _cleanup_free_
char *passphrase
= NULL
;
437 struct crypt_params_tcrypt params
= {
438 .flags
= CRYPT_TCRYPT_LEGACY_MODES
,
439 .keyfiles
= (const char **)arg_tcrypt_keyfiles
,
440 .keyfiles_count
= strv_length(arg_tcrypt_keyfiles
)
445 assert(key_file
|| (passwords
&& passwords
[0]));
447 if (arg_tcrypt_hidden
)
448 params
.flags
|= CRYPT_TCRYPT_HIDDEN_HEADER
;
450 if (arg_tcrypt_system
)
451 params
.flags
|= CRYPT_TCRYPT_SYSTEM_HEADER
;
453 #ifdef CRYPT_TCRYPT_VERA_MODES
454 if (arg_tcrypt_veracrypt
)
455 params
.flags
|= CRYPT_TCRYPT_VERA_MODES
;
459 r
= read_one_line_file(key_file
, &passphrase
);
461 log_error_errno(r
, "Failed to read password file '%s': %m", key_file
);
465 params
.passphrase
= passphrase
;
467 params
.passphrase
= passwords
[0];
468 params
.passphrase_size
= strlen(params
.passphrase
);
470 r
= crypt_load(cd
, CRYPT_TCRYPT
, ¶ms
);
472 if (key_file
&& r
== -EPERM
) {
473 log_error("Failed to activate using password file '%s'.", key_file
);
479 return crypt_activate_by_volume_key(cd
, name
, NULL
, 0, flags
);
482 static int attach_luks_or_plain(struct crypt_device
*cd
,
484 const char *key_file
,
485 const char *data_device
,
489 bool pass_volume_key
= false;
493 assert(key_file
|| passwords
);
495 if (!arg_type
|| streq(arg_type
, CRYPT_LUKS1
)) {
496 r
= crypt_load(cd
, CRYPT_LUKS1
, NULL
);
498 log_error("crypt_load() failed on device %s.\n", crypt_get_device_name(cd
));
503 r
= crypt_set_data_device(cd
, data_device
);
506 if ((!arg_type
&& r
< 0) || streq_ptr(arg_type
, CRYPT_PLAIN
)) {
507 struct crypt_params_plain params
= {
508 .offset
= arg_offset
,
511 const char *cipher
, *cipher_mode
;
512 _cleanup_free_
char *truncated_cipher
= NULL
;
515 /* plain isn't a real hash type. it just means "use no hash" */
516 if (!streq(arg_hash
, "plain"))
517 params
.hash
= arg_hash
;
518 } else if (!key_file
)
519 /* for CRYPT_PLAIN, the behaviour of cryptsetup
520 * package is to not hash when a key file is provided */
521 params
.hash
= "ripemd160";
526 l
= strcspn(arg_cipher
, "-");
527 truncated_cipher
= strndup(arg_cipher
, l
);
528 if (!truncated_cipher
)
531 cipher
= truncated_cipher
;
532 cipher_mode
= arg_cipher
[l
] ? arg_cipher
+l
+1 : "plain";
535 cipher_mode
= "cbc-essiv:sha256";
538 /* for CRYPT_PLAIN limit reads
539 * from keyfile to key length, and
540 * ignore keyfile-size */
541 arg_keyfile_size
= arg_key_size
;
543 /* In contrast to what the name
544 * crypt_setup() might suggest this
545 * doesn't actually format anything,
546 * it just configures encryption
547 * parameters when used for plain
549 r
= crypt_format(cd
, CRYPT_PLAIN
, cipher
, cipher_mode
, NULL
, NULL
, arg_keyfile_size
, ¶ms
);
551 /* hash == NULL implies the user passed "plain" */
552 pass_volume_key
= (params
.hash
== NULL
);
556 return log_error_errno(r
, "Loading of cryptographic parameters failed: %m");
558 log_info("Set cipher %s, mode %s, key size %i bits for device %s.",
559 crypt_get_cipher(cd
),
560 crypt_get_cipher_mode(cd
),
561 crypt_get_volume_key_size(cd
)*8,
562 crypt_get_device_name(cd
));
565 r
= crypt_activate_by_keyfile_offset(cd
, name
, arg_key_slot
, key_file
, arg_keyfile_size
, arg_keyfile_offset
, flags
);
567 log_error_errno(r
, "Failed to activate with key file '%s': %m", key_file
);
573 STRV_FOREACH(p
, passwords
) {
575 r
= crypt_activate_by_volume_key(cd
, name
, *p
, arg_key_size
, flags
);
577 r
= crypt_activate_by_passphrase(cd
, name
, arg_key_slot
, *p
, strlen(*p
), flags
);
587 static int help(void) {
589 printf("%s attach VOLUME SOURCEDEVICE [PASSWORD] [OPTIONS]\n"
590 "%s detach VOLUME\n\n"
591 "Attaches or detaches an encrypted block device.\n",
592 program_invocation_short_name
,
593 program_invocation_short_name
);
598 int main(int argc
, char *argv
[]) {
599 int r
= EXIT_FAILURE
;
600 struct crypt_device
*cd
= NULL
;
608 log_error("This program requires at least two arguments.");
612 log_set_target(LOG_TARGET_AUTO
);
613 log_parse_environment();
618 if (streq(argv
[1], "attach")) {
623 crypt_status_info status
;
624 const char *key_file
= NULL
;
626 /* Arguments: systemd-cryptsetup attach VOLUME SOURCE-DEVICE [PASSWORD] [OPTIONS] */
629 log_error("attach requires at least two arguments.");
635 !streq(argv
[4], "-") &&
636 !streq(argv
[4], "none")) {
638 if (!path_is_absolute(argv
[4]))
639 log_error("Password file path '%s' is not absolute. Ignoring.", argv
[4]);
644 if (argc
>= 6 && argv
[5][0] && !streq(argv
[5], "-")) {
645 if (parse_options(argv
[5]) < 0)
649 /* A delicious drop of snake oil */
650 mlockall(MCL_FUTURE
);
653 log_debug("LUKS header: %s", arg_header
);
654 k
= crypt_init(&cd
, arg_header
);
656 k
= crypt_init(&cd
, argv
[3]);
658 log_error_errno(k
, "crypt_init() failed: %m");
662 crypt_set_log_callback(cd
, log_glue
, NULL
);
664 status
= crypt_status(cd
, argv
[2]);
665 if (status
== CRYPT_ACTIVE
|| status
== CRYPT_BUSY
) {
666 log_info("Volume %s already active.", argv
[2]);
672 flags
|= CRYPT_ACTIVATE_READONLY
;
675 flags
|= CRYPT_ACTIVATE_ALLOW_DISCARDS
;
678 until
= now(CLOCK_MONOTONIC
) + arg_timeout
;
682 arg_key_size
= (arg_key_size
> 0 ? arg_key_size
: (256 / 8));
687 /* Ideally we'd do this on the open fd, but since this is just a
688 * warning it's OK to do this in two steps. */
689 if (stat(key_file
, &st
) >= 0 && S_ISREG(st
.st_mode
) && (st
.st_mode
& 0005))
690 log_warning("Key file %s is world-readable. This is not a good idea!", key_file
);
693 for (tries
= 0; arg_tries
== 0 || tries
< arg_tries
; tries
++) {
694 _cleanup_strv_free_erase_
char **passwords
= NULL
;
697 k
= get_password(argv
[2], argv
[3], until
, tries
== 0 && !arg_verify
, &passwords
);
704 if (streq_ptr(arg_type
, CRYPT_TCRYPT
))
705 k
= attach_tcrypt(cd
, argv
[2], key_file
, passwords
, flags
);
707 k
= attach_luks_or_plain(cd
,
710 arg_header
? argv
[3] : NULL
,
715 else if (k
== -EAGAIN
) {
718 } else if (k
!= -EPERM
) {
719 log_error_errno(k
, "Failed to activate: %m");
723 log_warning("Invalid passphrase.");
726 if (arg_tries
!= 0 && tries
>= arg_tries
) {
727 log_error("Too many attempts; giving up.");
732 } else if (streq(argv
[1], "detach")) {
735 k
= crypt_init_by_name(&cd
, argv
[2]);
737 log_info("Volume %s already inactive.", argv
[2]);
741 log_error_errno(k
, "crypt_init_by_name() failed: %m");
745 crypt_set_log_callback(cd
, log_glue
, NULL
);
747 k
= crypt_deactivate(cd
, argv
[2]);
749 log_error_errno(k
, "Failed to deactivate: %m");
754 log_error("Unknown verb %s.", argv
[1]);
768 strv_free(arg_tcrypt_keyfiles
);