src/cryptsetup.h

   1 /*
   2  * cryptsetup - setup cryptographic volumes for dm-crypt
   3  *
   4  * Copyright (C) 2004 Jana Saout <jana@saout.de>
   5  * Copyright (C) 2004-2007 Clemens Fruhwirth <clemens@endorphin.org>
   6  * Copyright (C) 2009-2020 Red Hat, Inc. All rights reserved.
   7  * Copyright (C) 2009-2020 Milan Broz
   8  *
   9  * This program is free software; you can redistribute it and/or
  10  * modify it under the terms of the GNU General Public License
  11  * as published by the Free Software Foundation; either version 2
  12  * of the License, or (at your option) any later version.
  13  *
  14  * This program is distributed in the hope that it will be useful,
  15  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  16  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  17  * GNU General Public License for more details.
  18  *
  19  * You should have received a copy of the GNU General Public License
  20  * along with this program; if not, write to the Free Software
  21  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
  22  */
  23
  24 #ifndef CRYPTSETUP_H
  25 #define CRYPTSETUP_H
  26
  27 #include <string.h>
  28 #include <stdlib.h>
  29 #include <stdarg.h>
  30 #include <stdio.h>
  31 #include <stdint.h>
  32 #include <errno.h>
  33 #include <unistd.h>
  34 #include <inttypes.h>
  35 #include <limits.h>
  36 #include <ctype.h>
  37 #include <fcntl.h>
  38 #include <popt.h>
  39 #include <sys/stat.h>
  40 #include <sys/time.h>
  41
  42 #include "lib/nls.h"
  43 #include "lib/utils_crypt.h"
  44 #include "lib/utils_loop.h"
  45 #include "lib/utils_fips.h"
  46 #include "lib/utils_io.h"
  47 #include "lib/utils_blkid.h"
  48
  49 #include "libcryptsetup.h"
  50
  51 #define CONST_CAST(x) (x)(uintptr_t)
  52 #define DEFAULT_CIPHER(type)    (DEFAULT_##type##_CIPHER "-" DEFAULT_##type##_MODE)
  53 #define SECTOR_SIZE 512
  54 #define MAX_SECTOR_SIZE 4096
  55 #define ROUND_SECTOR(x) (((x) + SECTOR_SIZE - 1) / SECTOR_SIZE)
  56
  57 #define DEFAULT_WIPE_BLOCK      1048576 /* 1 MiB */
  58
  59 extern int opt_debug;
  60 extern int opt_debug_json;
  61 extern int opt_verbose;
  62 extern int opt_batch_mode;
  63 extern int opt_force_password;
  64 extern int opt_progress_frequency;
  65
  66 /* Common tools */
  67 void clogger(struct crypt_device *cd, int level, const char *file, int line,
  68              const char *format, ...)  __attribute__ ((format (printf, 5, 6)));
  69 void tool_log(int level, const char *msg, void *usrptr __attribute__((unused)));
  70 void quiet_log(int level, const char *msg, void *usrptr);
  71
  72 int yesDialog(const char *msg, void *usrptr);
  73 int noDialog(const char *msg, void *usrptr);
  74 void show_status(int errcode);
  75 const char *uuid_or_device(const char *spec);
  76 __attribute__ ((noreturn)) \
  77 void usage(poptContext popt_context, int exitcode, const char *error, const char *more);
  78 void dbg_version_and_cmd(int argc, const char **argv);
  79 int translate_errno(int r);
  80
  81 typedef enum { CREATED, UNLOCKED, REMOVED  } crypt_object_op;
  82 void tools_keyslot_msg(int keyslot, crypt_object_op op);
  83 void tools_token_msg(int token, crypt_object_op op);
  84
  85 extern volatile int quit;
  86 void set_int_block(int block);
  87 void set_int_handler(int block);
  88 void check_signal(int *r);
  89 int tools_signals_blocked(void);
  90
  91 int tools_get_key(const char *prompt,
  92                   char **key, size_t *key_size,
  93                   uint64_t keyfile_offset, size_t keyfile_size_max,
  94                   const char *key_file,
  95                   int timeout, int verify, int pwquality,
  96                   struct crypt_device *cd);
  97 void tools_passphrase_msg(int r);
  98 int tools_is_stdin(const char *key_file);
  99 int tools_string_to_size(struct crypt_device *cd, const char *s, uint64_t *size);
 100 int tools_is_cipher_null(const char *cipher);
 101
 102 void tools_clear_line(void);
 103
 104 int tools_wipe_progress(uint64_t size, uint64_t offset, void *usrptr);
 105 int tools_reencrypt_progress(uint64_t size, uint64_t offset, void *usrptr);
 106
 107 int tools_read_mk(const char *file, char **key, int keysize);
 108 int tools_write_mk(const char *file, const char *key, int keysize);
 109
 110 int tools_read_json_file(struct crypt_device *cd, const char *file, char **json, size_t *json_size);
 111 int tools_write_json_file(struct crypt_device *cd, const char *file, const char *json);
 112
 113 int tools_detect_signatures(const char *device, int ignore_luks, size_t *count);
 114 int tools_wipe_all_signatures(const char *path);
 115
 116 int tools_lookup_crypt_device(struct crypt_device *cd, const char *type,
 117                 const char *data_device_path, char *name, size_t name_length);
 118
 119 /* Log */
 120 #define log_dbg(x...) clogger(NULL, CRYPT_LOG_DEBUG, __FILE__, __LINE__, x)
 121 #define log_std(x...) clogger(NULL, CRYPT_LOG_NORMAL, __FILE__, __LINE__, x)
 122 #define log_verbose(x...) clogger(NULL, CRYPT_LOG_VERBOSE, __FILE__, __LINE__, x)
 123 #define log_err(x...) clogger(NULL, CRYPT_LOG_ERROR, __FILE__, __LINE__, x)
 124
 125 #endif /* CRYPTSETUP_H */