lib/luks1/af.h

   1 /*
   2  * AFsplitter - Anti forensic information splitter
   3  *
   4  * Copyright (C) 2004 Clemens Fruhwirth <clemens@endorphin.org>
   5  * Copyright (C) 2009-2023 Red Hat, Inc. All rights reserved.
   6  *
   7  * AFsplitter diffuses information over a large stripe of data,
   8  * therefore supporting secure data destruction.
   9  *
  10  * This program is free software; you can redistribute it and/or
  11  * modify it under the terms of the GNU General Public License
  12  * as published by the Free Software Foundation; either version 2
  13  * of the License, or (at your option) any later version.
  14  *
  15  * This program is distributed in the hope that it will be useful,
  16  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  17  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  18  * GNU Library General Public License for more details.
  19  *
  20  * You should have received a copy of the GNU General Public License
  21  * along with this program; if not, write to the Free Software
  22  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
  23  */
  24 #ifndef INCLUDED_CRYPTSETUP_LUKS_AF_H
  25 #define INCLUDED_CRYPTSETUP_LUKS_AF_H
  26
  27 #include <stddef.h>
  28
  29 struct crypt_device;
  30 struct volume_key;
  31
  32 /*
  33  * AF_split operates on src and produces information split data in
  34  * dst. src is assumed to be of the length blocksize. The data stripe
  35  * dst points to must be capable of storing blocksize*blocknumbers.
  36  * blocknumbers is the data multiplication factor.
  37  *
  38  * AF_merge does just the opposite: reproduces the information stored in
  39  * src of the length blocksize*blocknumbers into dst of the length
  40  * blocksize.
  41  *
  42  * On error, both functions return -1, 0 otherwise.
  43  */
  44
  45 int AF_split(struct crypt_device *ctx, const char *src, char *dst,
  46              size_t blocksize, unsigned int blocknumbers, const char *hash);
  47 int AF_merge(const char *src, char *dst, size_t blocksize,
  48              unsigned int blocknumbers, const char *hash);
  49 size_t AF_split_sectors(size_t blocksize, unsigned int blocknumbers);
  50
  51 int LUKS_encrypt_to_storage(
  52         char *src, size_t srcLength,
  53         const char *cipher,
  54         const char *cipher_mode,
  55         struct volume_key *vk,
  56         unsigned int sector,
  57         struct crypt_device *ctx);
  58
  59 int LUKS_decrypt_from_storage(
  60         char *dst, size_t dstLength,
  61         const char *cipher,
  62         const char *cipher_mode,
  63         struct volume_key *vk,
  64         unsigned int sector,
  65         struct crypt_device *ctx);
  66
  67 #endif