src/sqlcipher.h

   1 /*
   2 ** SQLCipher
   3 ** sqlcipher.h developed by Stephen Lombardo (Zetetic LLC)
   4 ** sjlombardo at zetetic dot net
   5 ** http://zetetic.net
   6 **
   7 ** Copyright (c) 2008, ZETETIC LLC
   8 ** All rights reserved.
   9 **
  10 ** Redistribution and use in source and binary forms, with or without
  11 ** modification, are permitted provided that the following conditions are met:
  12 **     * Redistributions of source code must retain the above copyright
  13 **       notice, this list of conditions and the following disclaimer.
  14 **     * Redistributions in binary form must reproduce the above copyright
  15 **       notice, this list of conditions and the following disclaimer in the
  16 **       documentation and/or other materials provided with the distribution.
  17 **     * Neither the name of the ZETETIC LLC nor the
  18 **       names of its contributors may be used to endorse or promote products
  19 **       derived from this software without specific prior written permission.
  20 **
  21 ** THIS SOFTWARE IS PROVIDED BY ZETETIC LLC ''AS IS'' AND ANY
  22 ** EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
  23 ** WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
  24 ** DISCLAIMED. IN NO EVENT SHALL ZETETIC LLC BE LIABLE FOR ANY
  25 ** DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
  26 ** (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
  27 ** LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
  28 ** ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  29 ** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
  30 ** SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  31 **
  32 */
  33 /* BEGIN SQLCIPHER */
  34 #ifdef SQLITE_HAS_CODEC
  35 #ifndef SQLCIPHER_H
  36 #define SQLCIPHER_H
  37
  38 #define SQLCIPHER_HMAC_SHA1 0
  39 #define SQLCIPHER_HMAC_SHA1_LABEL "HMAC_SHA1"
  40 #define SQLCIPHER_HMAC_SHA256 1
  41 #define SQLCIPHER_HMAC_SHA256_LABEL "HMAC_SHA256"
  42 #define SQLCIPHER_HMAC_SHA512 2
  43 #define SQLCIPHER_HMAC_SHA512_LABEL "HMAC_SHA512"
  44
  45
  46 #define SQLCIPHER_PBKDF2_HMAC_SHA1 0
  47 #define SQLCIPHER_PBKDF2_HMAC_SHA1_LABEL "PBKDF2_HMAC_SHA1"
  48 #define SQLCIPHER_PBKDF2_HMAC_SHA256 1
  49 #define SQLCIPHER_PBKDF2_HMAC_SHA256_LABEL "PBKDF2_HMAC_SHA256"
  50 #define SQLCIPHER_PBKDF2_HMAC_SHA512 2
  51 #define SQLCIPHER_PBKDF2_HMAC_SHA512_LABEL "PBKDF2_HMAC_SHA512"
  52
  53
  54 typedef struct {
  55   int (*activate)(void *ctx);
  56   int (*deactivate)(void *ctx);
  57   const char* (*get_provider_name)(void *ctx);
  58   int (*add_random)(void *ctx, void *buffer, int length);
  59   int (*random)(void *ctx, void *buffer, int length);
  60   int (*hmac)(void *ctx, int algorithm, unsigned char *hmac_key, int key_sz, unsigned char *in, int in_sz, unsigned char *in2, int in2_sz, unsigned char *out);
  61   int (*kdf)(void *ctx, int algorithm, const unsigned char *pass, int pass_sz, unsigned char* salt, int salt_sz, int workfactor, int key_sz, unsigned char *key);
  62   int (*cipher)(void *ctx, int mode, unsigned char *key, int key_sz, unsigned char *iv, unsigned char *in, int in_sz, unsigned char *out);
  63   const char* (*get_cipher)(void *ctx);
  64   int (*get_key_sz)(void *ctx);
  65   int (*get_iv_sz)(void *ctx);
  66   int (*get_block_sz)(void *ctx);
  67   int (*get_hmac_sz)(void *ctx, int algorithm);
  68   int (*ctx_init)(void **ctx);
  69   int (*ctx_free)(void **ctx);
  70   int (*fips_status)(void *ctx);
  71   const char* (*get_provider_version)(void *ctx);
  72 } sqlcipher_provider;
  73
  74 /* utility functions */
  75 void* sqlcipher_malloc(u64);
  76 void sqlcipher_mlock(void *, u64);
  77 void sqlcipher_munlock(void *, u64);
  78 void* sqlcipher_memset(void *, unsigned char, u64);
  79 int sqlcipher_ismemset(const void *, unsigned char, u64);
  80 int sqlcipher_memcmp(const void *, const void *, int);
  81 void sqlcipher_free(void *, u64);
  82 char* sqlcipher_version();
  83
  84 /* provider interfaces */
  85 int sqlcipher_register_provider(sqlcipher_provider *);
  86 sqlcipher_provider* sqlcipher_get_provider(void);
  87
  88 #define SQLCIPHER_MUTEX_PROVIDER          0
  89 #define SQLCIPHER_MUTEX_PROVIDER_ACTIVATE 1
  90 #define SQLCIPHER_MUTEX_PROVIDER_RAND     2
  91 #define SQLCIPHER_MUTEX_RESERVED1         3
  92 #define SQLCIPHER_MUTEX_RESERVED2         4
  93 #define SQLCIPHER_MUTEX_RESERVED3         5
  94 #define SQLCIPHER_MUTEX_COUNT             6
  95
  96 sqlite3_mutex* sqlcipher_mutex(int);
  97
  98 #endif
  99 #endif
 100 /* END SQLCIPHER */
 101