lib/tcrypt/tcrypt.h

   1 /*
   2  * TCRYPT - header defitinion
   3  *
   4  * Copyright (C) 2012, Red Hat, Inc. All rights reserved.
   5  * Copyright (C) 2012, Milan Broz
   6  *
   7  * This program is free software; you can redistribute it and/or
   8  * modify it under the terms of the GNU General Public License
   9  * version 2 as published by the Free Software Foundation.
  10  *
  11  * This program is distributed in the hope that it will be useful,
  12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14  * GNU General Public License for more details.
  15  *
  16  * You should have received a copy of the GNU General Public License
  17  * along with this program; if not, write to the Free Software
  18  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
  19  */
  20
  21 #include "libcryptsetup.h"
  22
  23 #ifndef _CRYPTSETUP_TCRYPT_H
  24 #define _CRYPTSETUP_TCRYPT_H
  25
  26 #define TCRYPT_HDR_SALT_LEN 64
  27 #define TCRYPT_HDR_IV_LEN   16
  28 #define TCRYPT_HDR_LEN     448
  29 #define TCRYPT_HDR_KEY_LEN 192
  30 #define TCRYPT_HDR_MAGIC "TRUE"
  31 #define TCRYPT_HDR_MAGIC_LEN 4
  32
  33 #define TCRYPT_HDR_HIDDEN_OFFSET_OLD -1536
  34 #define TCRYPT_HDR_HIDDEN_OFFSET 65536
  35
  36 #define TCRYPT_LRW_IKEY_LEN 16
  37 #define TCRYPT_KEY_POOL_LEN 64
  38 #define TCRYPT_KEYFILE_LEN  1048576
  39
  40 #define TCRYPT_HDR_FLAG_SYSTEM    (1 << 0)
  41 #define TCRYPT_HDR_FLAG_NONSYSTEM (1 << 1)
  42
  43 struct tcrypt_phdr {
  44         char salt[TCRYPT_HDR_SALT_LEN];
  45
  46         /* encrypted part, TCRYPT_HDR_LEN bytes */
  47         union {
  48         struct __attribute__((__packed__)) {
  49                 char     magic[TCRYPT_HDR_MAGIC_LEN];
  50                 uint16_t version;
  51                 uint16_t version_tc;
  52                 uint32_t keys_crc32;
  53                 uint64_t _reserved1[2]; /* data/header ctime */
  54                 uint64_t hidden_volume_size;
  55                 uint64_t volume_size;
  56                 uint64_t mk_offset;
  57                 uint64_t mk_size;
  58                 uint32_t flags;
  59                 uint32_t sector_size;
  60                 uint8_t  _reserved2[120];
  61                 uint32_t header_crc32;
  62                 char     keys[256];
  63         } d;
  64         char e[TCRYPT_HDR_LEN];
  65         };
  66 } __attribute__((__packed__));
  67
  68 struct crypt_dm_active_device;
  69 struct volume_key;
  70 struct device;
  71
  72 int TCRYPT_read_phdr(struct crypt_device *cd,
  73                      struct tcrypt_phdr *hdr,
  74                      struct crypt_params_tcrypt *params);
  75
  76 int TCRYPT_init_by_name(struct crypt_device *cd, const char *name,
  77                         const struct crypt_dm_active_device *dmd,
  78                         struct device **device,
  79                         struct crypt_params_tcrypt *tcrypt_params,
  80                         struct tcrypt_phdr *tcrypt_hdr);
  81
  82 int TCRYPT_activate(struct crypt_device *cd,
  83                      const char *name,
  84                      struct tcrypt_phdr *hdr,
  85                      struct crypt_params_tcrypt *params,
  86                      uint32_t flags);
  87
  88 int TCRYPT_deactivate(struct crypt_device *cd,
  89                       const char *name);
  90
  91 uint64_t TCRYPT_get_data_offset(struct tcrypt_phdr *hdr);
  92 uint64_t TCRYPT_get_iv_offset(struct tcrypt_phdr *hdr);
  93
  94 int TCRYPT_get_volume_key(struct crypt_device *cd,
  95                           struct tcrypt_phdr *hdr,
  96                           struct crypt_params_tcrypt *params,
  97                           struct volume_key **vk);
  98
  99 int TCRYPT_dump(struct crypt_device *cd,
 100                 struct tcrypt_phdr *hdr,
 101                 struct crypt_params_tcrypt *params);
 102
 103 #endif