* Implement --use-random and --use-urandom for luksFormat to allow setting of RNG...
[platform/upstream/cryptsetup.git] / lib / internal.h
1 #ifndef INTERNAL_H
2 #define INTERNAL_H
3
4 #ifdef HAVE_CONFIG_H
5 #       include "config.h"
6 #endif
7
8 #include <stdint.h>
9 #include <stdarg.h>
10 #include <unistd.h>
11 #include <inttypes.h>
12
13 #include "nls.h"
14 #include "utils_crypt.h"
15
16 #define SECTOR_SHIFT            9
17 #define SECTOR_SIZE             (1 << SECTOR_SHIFT)
18 #define DEFAULT_DISK_ALIGNMENT  1048576 /* 1MiB */
19 #define DEFAULT_MEM_ALIGNMENT   4096
20
21 /* private struct crypt_options flags */
22
23 #define CRYPT_FLAG_FREE_DEVICE  (1 << 24)
24 #define CRYPT_FLAG_FREE_CIPHER  (1 << 25)
25
26 #define CRYPT_FLAG_PRIVATE_MASK ((unsigned int)-1 << 24)
27
28 #define at_least(a, b) ({ __typeof__(a) __at_least = (a); (__at_least >= (b))?__at_least:(b); })
29
30 struct crypt_device;
31
32 struct hash_type {
33         char            *name;
34         void            *private;
35         int             (*fn)(void *data, int size, char *key,
36                               int sizep, const char *passphrase);
37 };
38
39 struct hash_backend {
40         const char              *name;
41         struct hash_type *      (*get_hashes)(void);
42         void                    (*free_hashes)(struct hash_type *hashes);
43 };
44
45 struct device_infos {
46         uint64_t        size;
47         int             readonly;
48 };
49
50 struct volume_key {
51         size_t keylength;
52         char key[];
53 };
54
55 struct volume_key *crypt_alloc_volume_key(unsigned keylength, const char *key);
56 struct volume_key *crypt_generate_volume_key(struct crypt_device *cd, unsigned keylength);
57 void crypt_free_volume_key(struct volume_key *vk);
58
59 int crypt_confirm(struct crypt_device *cd, const char *msg);
60
61 void set_error_va(const char *fmt, va_list va);
62 void set_error(const char *fmt, ...);
63 const char *get_error(void);
64 void set_debug_level(int level);
65
66 int init_crypto(struct crypt_device *ctx);
67 struct hash_backend *get_hash_backend(const char *name);
68 void put_hash_backend(struct hash_backend *backend);
69 int hash(const char *backend_name, const char *hash_name,
70          char *result, size_t size,
71          const char *passphrase, size_t sizep);
72
73 /* Device mapper backend */
74 const char *dm_get_dir(void);
75 int dm_init(struct crypt_device *context, int check_kernel);
76 void dm_exit(void);
77 int dm_remove_device(const char *name, int force, uint64_t size);
78 int dm_status_device(const char *name);
79 int dm_query_device(const char *name,
80                     char **device,
81                     uint64_t *size,
82                     uint64_t *skip,
83                     uint64_t *offset,
84                     char **cipher,
85                     int *key_size,
86                     char **key,
87                     int *read_only,
88                     int *suspended,
89                     char **uuid);
90 int dm_create_device(const char *name, const char *device, const char *cipher,
91                      const char *type, const char *uuid,
92                      uint64_t size, uint64_t skip, uint64_t offset,
93                      size_t key_size, const char *key,
94                      int read_only, int reload);
95 int dm_suspend_and_wipe_key(const char *name);
96 int dm_resume_and_reinstate_key(const char *name,
97                                 size_t key_size,
98                                 const char *key);
99
100 int sector_size_for_device(const char *device);
101 ssize_t write_blockwise(int fd, const void *buf, size_t count);
102 ssize_t read_blockwise(int fd, void *_buf, size_t count);
103 ssize_t write_lseek_blockwise(int fd, const char *buf, size_t count, off_t offset);
104 int device_ready(struct crypt_device *cd, const char *device, int mode);
105 int get_device_infos(const char *device, struct device_infos *infos, struct crypt_device *cd);
106 int wipe_device_header(const char *device, int sectors);
107
108 void logger(struct crypt_device *cd, int class, const char *file, int line, const char *format, ...);
109 #define log_dbg(x...) logger(NULL, CRYPT_LOG_DEBUG, __FILE__, __LINE__, x)
110 #define log_std(c, x...) logger(c, CRYPT_LOG_NORMAL, __FILE__, __LINE__, x)
111 #define log_verbose(c, x...) logger(c, CRYPT_LOG_VERBOSE, __FILE__, __LINE__, x)
112 #define log_err(c, x...) do { \
113         logger(c, CRYPT_LOG_ERROR, __FILE__, __LINE__, x); \
114         set_error(x); } while(0)
115
116 int crypt_get_debug_level(void);
117 void debug_processes_using_device(const char *name);
118
119 int crypt_memlock_inc(struct crypt_device *ctx);
120 int crypt_memlock_dec(struct crypt_device *ctx);
121
122 void get_topology_alignment(const char *device,
123                             unsigned long *required_alignment, /* bytes */
124                             unsigned long *alignment_offset,   /* bytes */
125                             unsigned long default_alignment);
126
127 enum { CRYPT_RND_NORMAL = 0, CRYPT_RND_KEY = 1 };
128 int crypt_random_init(struct crypt_device *ctx);
129 int crypt_random_get(struct crypt_device *ctx, char *buf, size_t len, int quality);
130 void crypt_random_exit(void);
131 int crypt_random_default_key_rng(void);
132
133 #endif /* INTERNAL_H */