2 * veritysetup - setup cryptographic volumes for dm-verity
4 * Copyright (C) 2012, Red Hat, Inc. All rights reserved.
6 * This program is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU General Public License
8 * version 2 as published by the Free Software Foundation.
10 * This program is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 * GNU General Public License for more details.
15 * You should have received a copy of the GNU General Public License
16 * along with this program; if not, write to the Free Software
17 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
22 * - unify units / uint64 etc
23 * - check translations
24 * - support device without superblock
25 * - audit alloc errors / error path
26 * - change command names (cryptsetup style)
27 * - extend superblock (UUID)
28 * - warn if block_size > PAGE_SIZE
38 #include "cryptsetup.h"
40 #define PACKAGE_VERITY "veritysetup"
44 #define MODE_ACTIVATE 2
48 static int use_superblock = 1; /* FIXME: no superblock not supported */
50 static const char *dm_device = NULL;
51 static const char *data_device = NULL;
52 static const char *hash_device = NULL;
53 static const char *hash_algorithm = NULL;
54 static const char *root_hash = NULL;
56 static int version = 1;
57 static int data_block_size = 4096;
58 static int hash_block_size = 4096;
59 static char *data_blocks_string = NULL;
60 static long long data_blocks = 0;
61 static char *hash_start_string = NULL;
62 static const char *salt_string = NULL;
64 static unsigned salt_size = 32;
66 static off_t superblock_position = 0;
68 static int opt_verbose = 0;
69 static int opt_debug = 0;
70 static int opt_version_mode = 0;
72 static int hex_to_bytes(const char *hex, char *result)
74 char buf[3] = "xx\0", *endp;
77 len = strlen(hex) / 2;
78 for (i = 0; i < len; i++) {
79 memcpy(buf, &hex[i * 2], 2);
80 result[i] = strtoul(buf, &endp, 16);
87 __attribute__((format(printf, 5, 6)))
88 static void clogger(struct crypt_device *cd, int level, const char *file,
89 int line, const char *format, ...)
94 va_start(argp, format);
96 if (vasprintf(&target, format, argp) > 0) {
98 crypt_log(cd, level, target);
100 } else if (opt_debug)
101 printf("# %s:%d %s\n", file ?: "?", line, target);
103 } else if (opt_debug)
104 printf("# %s\n", target);
112 static void _log(int level, const char *msg, void *usrptr __attribute__((unused)))
116 case CRYPT_LOG_NORMAL:
119 case CRYPT_LOG_VERBOSE:
123 case CRYPT_LOG_ERROR:
126 case CRYPT_LOG_DEBUG:
128 printf("# %s\n", msg);
131 fprintf(stderr, "Internal error on logging class for msg: %s", msg);
136 static int action_dump(void)
138 struct crypt_device *cd = NULL;
139 struct crypt_params_verity params = {};
142 if ((r = crypt_init(&cd, hash_device)))
145 params.hash_area_offset = superblock_position;
146 r = crypt_load(cd, CRYPT_VERITY, ¶ms);
153 static int action_activate(int verify)
155 struct crypt_device *cd = NULL;
156 struct crypt_params_verity params = {};
157 uint32_t activate_flags = CRYPT_ACTIVATE_READONLY;
158 char root_hash_bytes[128];
161 if ((r = crypt_init(&cd, hash_device)))
165 params.flags |= CRYPT_VERITY_CHECK_HASH;
167 if (use_superblock) {
168 params.hash_area_offset = superblock_position;
169 r = crypt_load(cd, CRYPT_VERITY, ¶ms);
171 params.hash_name = hash_algorithm;
172 params.salt = salt_bytes;
173 params.salt_size = salt_size;
174 params.data_block_size = data_block_size;
175 params.hash_block_size = hash_block_size;
177 params.data_size = data_blocks * data_block_size / 512;
178 params.version = version;
179 params.flags |= CRYPT_VERITY_NO_HEADER;
180 r = crypt_load(cd, CRYPT_VERITY, ¶ms);
187 r = crypt_set_data_device(cd, data_device);
191 if (hex_to_bytes(root_hash, root_hash_bytes) !=
192 crypt_get_volume_key_size(cd)) {
196 r = crypt_activate_by_volume_key(cd, dm_device, root_hash_bytes,
197 crypt_get_volume_key_size(cd),
206 static int action_create(void)
208 struct crypt_device *cd = NULL;
209 struct crypt_params_verity params = {};
210 char salt_bytes[512];
213 if ((r = crypt_init(&cd, hash_device)))
216 params.hash_name = hash_algorithm;
217 params.data_device = data_device;
220 if (hex_to_bytes(salt_string, salt_bytes) != salt_size) {
224 params.salt = salt_bytes;
227 params.salt_size = salt_size;
228 params.data_block_size = data_block_size;
229 params.hash_block_size = hash_block_size;
230 params.data_size = data_blocks;
231 params.hash_area_offset = superblock_position;
232 params.version = version;
233 params.flags = CRYPT_VERITY_CREATE_HASH;
235 params.flags |= CRYPT_VERITY_NO_HEADER;
237 r = crypt_format(cd, CRYPT_VERITY, NULL, NULL, NULL, NULL, 0, ¶ms);
245 static __attribute__ ((noreturn)) void usage(poptContext popt_context,
246 int exitcode, const char *error,
249 poptPrintUsage(popt_context, stderr, 0);
251 log_err("%s: %s\n", more, error);
252 poptFreeContext(popt_context);
256 static void help(poptContext popt_context,
257 enum poptCallbackReason reason __attribute__((unused)),
258 struct poptOption *key,
259 const char *arg __attribute__((unused)),
260 void *data __attribute__((unused)))
262 if (key->shortName == '?') {
263 log_std("%s %s\n", PACKAGE_VERITY, PACKAGE_VERSION);
264 poptPrintHelp(popt_context, stdout, 0);
267 usage(popt_context, EXIT_SUCCESS, NULL, NULL);
270 static void _dbg_version_and_cmd(int argc, const char **argv)
274 log_std("# %s %s processing \"", PACKAGE_VERITY, PACKAGE_VERSION);
275 for (i = 0; i < argc; i++) {
278 log_std("%s", argv[i]);
283 int main(int argc, const char **argv)
285 static struct poptOption popt_help_options[] = {
286 { NULL, '\0', POPT_ARG_CALLBACK, help, 0, NULL, NULL },
287 { "help", '?', POPT_ARG_NONE, NULL, 0, N_("Show this help message"), NULL },
288 { "usage", '\0', POPT_ARG_NONE, NULL, 0, N_("Display brief usage"), NULL },
291 static struct poptOption popt_options[] = {
292 { NULL, '\0', POPT_ARG_INCLUDE_TABLE, popt_help_options, 0, N_("Help options:"), NULL },
293 { "version", '\0', POPT_ARG_NONE, &opt_version_mode, 0, N_("Print package version"), NULL },
294 { "verbose", 0 /*v*/, POPT_ARG_NONE, &opt_verbose, 0, N_("Shows more detailed error messages"), NULL },
295 { "debug", '\0', POPT_ARG_NONE, &opt_debug, 0, N_("Show debug messages"), NULL },
296 { "create", 'c', POPT_ARG_VAL, &mode, MODE_CREATE, "Create hash", NULL },
297 { "verify", 'v', POPT_ARG_VAL, &mode, MODE_VERIFY, "Verify integrity", NULL },
298 { "activate", 'a', POPT_ARG_VAL, &mode, MODE_ACTIVATE, "Activate the device", NULL },
299 { "dump", 'd', POPT_ARG_VAL, &mode, MODE_DUMP, "Dump the device", NULL },
300 { "no-superblock", 0, POPT_ARG_VAL, &use_superblock, 0, "Do not create/use superblock" },
301 { "format", 0, POPT_ARG_INT, &version, 0, "Format version (1 - normal format, 0 - original Chromium OS format)", "number" },
302 { "data-block-size", 0, POPT_ARG_INT, &data_block_size, 0, "Block size on the data device", "bytes" },
303 { "hash-block-size", 0, POPT_ARG_INT, &hash_block_size, 0, "Block size on the hash device", "bytes" },
304 { "data-blocks", 0, POPT_ARG_STRING, &data_blocks_string, 0, "The number of blocks in the data file", "blocks" },
305 { "hash-start", 0, POPT_ARG_STRING, &hash_start_string, 0, "Starting block on the hash device", "512-byte sectors" },
306 { "algorithm", 0, POPT_ARG_STRING, &hash_algorithm, 0, "Hash algorithm (default sha256)", "string" },
307 { "salt", 0, POPT_ARG_STRING, &salt_string, 0, "Salt", "hex string" },
310 poptContext popt_context;
313 static long long hash_start = 0;
315 crypt_set_log_callback(NULL, _log, NULL);
317 setlocale(LC_ALL, "");
318 bindtextdomain(PACKAGE, LOCALEDIR);
321 popt_context = poptGetContext("verity", argc, argv, popt_options, 0);
323 poptSetOtherOptionHelp(popt_context, "[-c|-v|-a|-d] [<device name> if activating] <data device> <hash device> [<root hash> if activating or verifying] [OPTION...]");
326 poptPrintHelp(popt_context, stdout, 0);
330 r = poptGetNextOpt(popt_context);
332 usage(popt_context, EXIT_FAILURE, poptStrerror(r),
333 poptBadOption(popt_context, POPT_BADOPTION_NOALIAS));
334 if (opt_version_mode) {
335 log_std("%s %s\n", PACKAGE_VERITY, PACKAGE_VERSION);
336 poptFreeContext(popt_context);
341 usage(popt_context, EXIT_FAILURE, _("Unknown action."),
342 poptGetInvocationName(popt_context));
344 if (mode == MODE_ACTIVATE) {
345 dm_device = poptGetArg(popt_context);
346 if (!dm_device || !*dm_device)
347 usage(popt_context, EXIT_FAILURE,
348 _("Missing activation device name."),
349 poptGetInvocationName(popt_context));
352 data_device = poptGetArg(popt_context);
354 usage(popt_context, EXIT_FAILURE, _("Missing data device name."),
355 poptGetInvocationName(popt_context));
357 hash_device = poptGetArg(popt_context);
359 usage(popt_context, EXIT_FAILURE, _("Missing hash device name."),
360 poptGetInvocationName(popt_context));
362 if (mode == MODE_ACTIVATE || mode == MODE_VERIFY) {
363 root_hash = poptGetArg(popt_context);
365 usage(popt_context, EXIT_FAILURE, _("Root hash not specified."),
366 poptGetInvocationName(popt_context));
369 if (data_blocks_string) {
370 data_blocks = strtoll(data_blocks_string, &end, 10);
371 if (!*data_blocks_string || *end)
372 usage(popt_context, EXIT_FAILURE,
373 _("Invalid number of data blocks."),
374 poptGetInvocationName(popt_context));
378 if (hash_start_string) {
379 hash_start = strtoll(hash_start_string, &end, 10);
380 if (!*hash_start_string || *end)
381 usage(popt_context, EXIT_FAILURE,
382 _("Invalid hash device offset."),
383 poptGetInvocationName(popt_context));
386 if (hash_start < 0 ||
387 (unsigned long long)hash_start * 512 / 512 != hash_start ||
388 (off_t)(hash_start * 512) < 0 ||
389 (off_t)(hash_start * 512) != hash_start * 512)
390 usage(popt_context, EXIT_FAILURE,
391 _("Invalid hash device offset."),
392 poptGetInvocationName(popt_context));
395 superblock_position = hash_start * 512;
397 if (salt_string || !use_superblock) {
398 if (!salt_string || !strcmp(salt_string, "-"))
400 salt_size = strlen(salt_string) / 2;
403 if (data_block_size < 512 || (data_block_size & (data_block_size - 1)) || data_block_size >= 1U << 31)
404 usage(popt_context, EXIT_FAILURE, _("Invalid data block size."),
405 poptGetInvocationName(popt_context));
407 if (hash_block_size < 512 || (hash_block_size & (hash_block_size - 1)) || hash_block_size >= 1U << 31)
408 usage(popt_context, EXIT_FAILURE, _("Invalid hash block size."),
409 poptGetInvocationName(popt_context));
411 if (data_blocks < 0 || (off_t)data_blocks < 0 || (off_t)data_blocks != data_blocks)
412 usage(popt_context, EXIT_FAILURE, _("Invalid number of data blocks."),
413 poptGetInvocationName(popt_context));
416 hash_algorithm = "sha256";
420 crypt_set_debug_level(-1);
421 _dbg_version_and_cmd(argc, argv);
426 r = action_activate(0);
429 r = action_activate(1);
439 poptFreeContext(popt_context);