lib/internal.h

   1 /*
   2  * libcryptsetup - cryptsetup library internal
   3  *
   4  * Copyright (C) 2004, Christophe Saout <christophe@saout.de>
   5  * Copyright (C) 2004-2007, Clemens Fruhwirth <clemens@endorphin.org>
   6  * Copyright (C) 2009-2012, Red Hat, Inc. All rights reserved.
   7  *
   8  * This program is free software; you can redistribute it and/or
   9  * modify it under the terms of the GNU General Public License
  10  * version 2 as published by the Free Software Foundation.
  11  *
  12  * This program is distributed in the hope that it will be useful,
  13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15  * GNU General Public License for more details.
  16  *
  17  * You should have received a copy of the GNU General Public License
  18  * along with this program; if not, write to the Free Software
  19  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
  20  */
  21
  22 #ifndef INTERNAL_H
  23 #define INTERNAL_H
  24
  25 #ifdef HAVE_CONFIG_H
  26 #       include "config.h"
  27 #endif
  28
  29 #include <stdint.h>
  30 #include <stdarg.h>
  31 #include <unistd.h>
  32 #include <inttypes.h>
  33
  34 #include "nls.h"
  35 #include "utils_crypt.h"
  36 #include "utils_loop.h"
  37 #include "utils_dm.h"
  38
  39 /* to silent gcc -Wcast-qual for const cast */
  40 #define CONST_CAST(x) (x)(uintptr_t)
  41
  42 #define SECTOR_SHIFT            9
  43 #define SECTOR_SIZE             (1 << SECTOR_SHIFT)
  44 #define DEFAULT_DISK_ALIGNMENT  1048576 /* 1MiB */
  45 #define DEFAULT_MEM_ALIGNMENT   4096
  46 #define MAX_ERROR_LENGTH        512
  47
  48 #define at_least(a, b) ({ __typeof__(a) __at_least = (a); (__at_least >= (b))?__at_least:(b); })
  49
  50 struct crypt_device;
  51
  52 struct volume_key {
  53         size_t keylength;
  54         char key[];
  55 };
  56
  57 struct volume_key *crypt_alloc_volume_key(unsigned keylength, const char *key);
  58 struct volume_key *crypt_generate_volume_key(struct crypt_device *cd, unsigned keylength);
  59 void crypt_free_volume_key(struct volume_key *vk);
  60
  61 int crypt_confirm(struct crypt_device *cd, const char *msg);
  62
  63 char *crypt_lookup_dev(const char *dev_id);
  64 int crypt_sysfs_check_crypt_segment(const char *device, uint64_t offset, uint64_t size);
  65 int crypt_sysfs_get_rotational(int major, int minor, int *rotational);
  66
  67 int sector_size_for_device(const char *device);
  68 int device_read_ahead(const char *dev, uint32_t *read_ahead);
  69 ssize_t write_blockwise(int fd, void *buf, size_t count);
  70 ssize_t read_blockwise(int fd, void *_buf, size_t count);
  71 ssize_t write_lseek_blockwise(int fd, char *buf, size_t count, off_t offset);
  72 int device_ready(struct crypt_device *cd, const char *device, int mode);
  73 int device_size(const char *device, uint64_t *size);
  74
  75 enum devcheck { DEV_OK = 0, DEV_EXCL = 1, DEV_SHARED = 2 };
  76 int device_check_and_adjust(struct crypt_device *cd,
  77                             const char *device,
  78                             enum devcheck device_check,
  79                             uint64_t *size,
  80                             uint64_t *offset,
  81                             uint32_t *flags);
  82
  83 void logger(struct crypt_device *cd, int class, const char *file, int line, const char *format, ...);
  84 #define log_dbg(x...) logger(NULL, CRYPT_LOG_DEBUG, __FILE__, __LINE__, x)
  85 #define log_std(c, x...) logger(c, CRYPT_LOG_NORMAL, __FILE__, __LINE__, x)
  86 #define log_verbose(c, x...) logger(c, CRYPT_LOG_VERBOSE, __FILE__, __LINE__, x)
  87 #define log_err(c, x...) logger(c, CRYPT_LOG_ERROR, __FILE__, __LINE__, x)
  88
  89 int crypt_get_debug_level(void);
  90 void debug_processes_using_device(const char *name);
  91
  92 int crypt_memlock_inc(struct crypt_device *ctx);
  93 int crypt_memlock_dec(struct crypt_device *ctx);
  94
  95 void get_topology_alignment(const char *device,
  96                             unsigned long *required_alignment, /* bytes */
  97                             unsigned long *alignment_offset,   /* bytes */
  98                             unsigned long default_alignment);
  99
 100 enum { CRYPT_RND_NORMAL = 0, CRYPT_RND_KEY = 1 };
 101 int crypt_random_init(struct crypt_device *ctx);
 102 int crypt_random_get(struct crypt_device *ctx, char *buf, size_t len, int quality);
 103 void crypt_random_exit(void);
 104 int crypt_random_default_key_rng(void);
 105
 106 int crypt_plain_hash(struct crypt_device *ctx,
 107                      const char *hash_name,
 108                      char *key, size_t key_size,
 109                      const char *passphrase, size_t passphrase_size);
 110 int PLAIN_activate(struct crypt_device *cd,
 111                      const char *name,
 112                      struct volume_key *vk,
 113                      uint64_t size,
 114                      uint32_t flags);
 115
 116 /**
 117  * Different methods used to erase sensitive data concerning
 118  * either encrypted payload area or master key inside keyslot
 119  * area
 120  */
 121 typedef enum {
 122         CRYPT_WIPE_ZERO, /**< overwrite area using zero blocks */
 123         CRYPT_WIPE_DISK, /**< erase disk (using Gutmann method if it is rotational disk)*/
 124         CRYPT_WIPE_SSD, /**< erase solid state disk (random write) */
 125         CRYPT_WIPE_RANDOM /**< overwrite area using some up to now unspecified
 126                             * random algorithm */
 127 } crypt_wipe_type;
 128
 129 int crypt_wipe(const char *device,
 130                uint64_t offset,
 131                uint64_t sectors,
 132                crypt_wipe_type type,
 133                int flags);
 134
 135 #endif /* INTERNAL_H */