iv.sdpy: cosmetix

[iv.d.git] / gcrypt.d

/* gcrypt.h -  GNU Cryptographic Library Interface              -*- c -*-
 * Copyright (C) 1998-2015 Free Software Foundation, Inc.
 * Copyright (C) 2012-2015 g10 Code GmbH
 *
 * This file is part of Libgcrypt.
 *
 * Libgcrypt is free software; you can redistribute it and/or modify
 * it under the terms of the GNU Lesser General Public License as
 * published by the Free Software Foundation; either version 2.1 of
 * the License, or (at your option) any later version.
 *
 * Libgcrypt is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with this program; if not, see <http://www.gnu.org/licenses/>.
 */
module iv.gcrypt /*is aliced*/;
pragma(lib, "gcrypt");

import iv.alice;
import iv.gpgerror;

import core.stdc.stdarg : va_list;
import core.sys.posix.sys.socket : socklen_t;


extern(C) nothrow @nogc:

alias gcry_socklen_t = socklen_t;

/* This is required for error code compatibility. */
enum _GCRY_ERR_SOURCE_DEFAULT = GPG_ERR_SOURCE_GCRYPT;


/* The version of this header should match the one of the library. It
   should not be used by a program because gcry_check_version() should
   return the same version.  The purpose of this macro is to let
   autoconf (using the AM_PATH_GCRYPT macro) check that this header
   matches the installed library.  */
enum GCRYPT_VERSION = "1.6.3";

/* The version number of this header.  It may be used to handle minor
   API incompatibilities.  */
enum GCRYPT_VERSION_NUMBER = 0x010603;


/* Wrappers for the libgpg-error library.  */

alias gcry_error_t = gpg_error_t;
alias gcry_err_code_t = gpg_err_code_t;
alias gcry_err_source_t = gpg_err_source_t;

/*GPG_ERR_INLINE*/ gcry_error_t
gcry_err_make (gcry_err_source_t source, gcry_err_code_t code)
{
  return gpg_err_make (source, code);
}

/* The user can define GPG_ERR_SOURCE_DEFAULT before including this
   file to specify a default source for gpg_error.  */
enum GCRY_ERR_SOURCE_DEFAULT = GPG_ERR_SOURCE_USER_1;

/*GPG_ERR_INLINE*/ gcry_error_t
gcry_error (gcry_err_code_t code)
{
  return gcry_err_make (GCRY_ERR_SOURCE_DEFAULT, code);
}

/*GPG_ERR_INLINE*/ gcry_err_code_t
gcry_err_code (gcry_error_t err)
{
  return gpg_err_code (err);
}


/*GPG_ERR_INLINE*/ gcry_err_source_t
gcry_err_source (gcry_error_t err)
{
  return gpg_err_source (err);
}

/* Return a pointer to a string containing a description of the error
   code in the error value ERR.  */
const(char)* gcry_strerror (gcry_error_t err);

/* Return a pointer to a string containing a description of the error
   source in the error value ERR.  */
const(char)* gcry_strsource (gcry_error_t err);

/* Retrieve the error code for the system error ERR.  This returns
   GPG_ERR_UNKNOWN_ERRNO if the system error is not mapped (report
   this).  */
gcry_err_code_t gcry_err_code_from_errno (int err);

/* Retrieve the system error for the error code CODE.  This returns 0
   if CODE is not a system error code.  */
int gcry_err_code_to_errno (gcry_err_code_t code);

/* Return an error value with the error source SOURCE and the system
   error ERR.  */
gcry_error_t gcry_err_make_from_errno (gcry_err_source_t source, int err);

/* Return an error value with the system error ERR.  */
gcry_err_code_t gcry_error_from_errno (int err);


/* NOTE: Since Libgcrypt 1.6 the thread callbacks are not anymore
   used.  However we keep it to allow for some source code
   compatibility if used in the standard way.  */

/* Constants defining the thread model to use.  Used with the OPTION
   field of the struct gcry_thread_cbs.  */
enum {
  GCRY_THREAD_OPTION_DEFAULT  = 0,
  GCRY_THREAD_OPTION_USER     = 1,
  GCRY_THREAD_OPTION_PTH      = 2,
  GCRY_THREAD_OPTION_PTHREAD  = 3,
}

/* The version number encoded in the OPTION field of the struct
   gcry_thread_cbs.  */
enum GCRY_THREAD_OPTION_VERSION = 1;

/* Wrapper for struct ath_ops.  */
struct gcry_thread_cbs {
  /* The OPTION field encodes the thread model and the version number
     of this structure.
       Bits  7 - 0  are used for the thread model
       Bits 15 - 8  are used for the version number.  */
  uint option;
}
alias _GCRY_ATTR_INTERNAL = gcry_thread_cbs;

/+TODO
#define GCRY_THREAD_OPTION_PTH_IMPL                                     \
  static struct gcry_thread_cbs gcry_threads_pth = {                    \
    (GCRY_THREAD_OPTION_PTH | (GCRY_THREAD_OPTION_VERSION << 8))}

#define GCRY_THREAD_OPTION_PTHREAD_IMPL                                 \
  static struct gcry_thread_cbs gcry_threads_pthread = {                \
    (GCRY_THREAD_OPTION_PTHREAD | (GCRY_THREAD_OPTION_VERSION << 8))}
+/


/* A generic context object as used by some functions.  */
struct gcry_context {}
alias gcry_ctx_t = gcry_context*;

/* The data objects used to hold multi precision integers.  */
struct gcry_mpi {}
alias gcry_mpi_t = gcry_mpi*;
struct gcry_mpi_point {}
alias gcry_mpi_point_t = gcry_mpi_point*;

/*
#ifndef GCRYPT_NO_DEPRECATED
typedef struct gcry_mpi *GCRY_MPI _GCRY_GCC_ATTR_DEPRECATED;
typedef struct gcry_mpi *GcryMPI _GCRY_GCC_ATTR_DEPRECATED;
#endif
*/

/* A structure used for scatter gather hashing.  */
struct gcry_buffer_t {
  usize size;  /* The allocated size of the buffer or 0.  */
  usize off;   /* Offset into the buffer.  */
  usize len;   /* The used length of the buffer.  */
  void *data;   /* The buffer.  */
}


/* Check that the library fulfills the version requirement.  */
const(char)* gcry_check_version (const(char)* req_version);

/* Codes for function dispatchers.  */

/* Codes used with the gcry_control function. */
alias gcry_ctl_cmds = int;
enum  {
  /* Note: 1 .. 2 are not anymore used. */
  GCRYCTL_CFB_SYNC = 3,
  GCRYCTL_RESET    = 4,   /* e.g. for MDs */
  GCRYCTL_FINALIZE = 5,
  GCRYCTL_GET_KEYLEN = 6,
  GCRYCTL_GET_BLKLEN = 7,
  GCRYCTL_TEST_ALGO = 8,
  GCRYCTL_IS_SECURE = 9,
  GCRYCTL_GET_ASNOID = 10,
  GCRYCTL_ENABLE_ALGO = 11,
  GCRYCTL_DISABLE_ALGO = 12,
  GCRYCTL_DUMP_RANDOM_STATS = 13,
  GCRYCTL_DUMP_SECMEM_STATS = 14,
  GCRYCTL_GET_ALGO_NPKEY    = 15,
  GCRYCTL_GET_ALGO_NSKEY    = 16,
  GCRYCTL_GET_ALGO_NSIGN    = 17,
  GCRYCTL_GET_ALGO_NENCR    = 18,
  GCRYCTL_SET_VERBOSITY     = 19,
  GCRYCTL_SET_DEBUG_FLAGS   = 20,
  GCRYCTL_CLEAR_DEBUG_FLAGS = 21,
  GCRYCTL_USE_SECURE_RNDPOOL= 22,
  GCRYCTL_DUMP_MEMORY_STATS = 23,
  GCRYCTL_INIT_SECMEM       = 24,
  GCRYCTL_TERM_SECMEM       = 25,
  GCRYCTL_DISABLE_SECMEM_WARN = 27,
  GCRYCTL_SUSPEND_SECMEM_WARN = 28,
  GCRYCTL_RESUME_SECMEM_WARN  = 29,
  GCRYCTL_DROP_PRIVS          = 30,
  GCRYCTL_ENABLE_M_GUARD      = 31,
  GCRYCTL_START_DUMP          = 32,
  GCRYCTL_STOP_DUMP           = 33,
  GCRYCTL_GET_ALGO_USAGE      = 34,
  GCRYCTL_IS_ALGO_ENABLED     = 35,
  GCRYCTL_DISABLE_INTERNAL_LOCKING = 36,
  GCRYCTL_DISABLE_SECMEM      = 37,
  GCRYCTL_INITIALIZATION_FINISHED = 38,
  GCRYCTL_INITIALIZATION_FINISHED_P = 39,
  GCRYCTL_ANY_INITIALIZATION_P = 40,
  GCRYCTL_SET_CBC_CTS = 41,
  GCRYCTL_SET_CBC_MAC = 42,
  /* Note: 43 is not anymore used. */
  GCRYCTL_ENABLE_QUICK_RANDOM = 44,
  GCRYCTL_SET_RANDOM_SEED_FILE = 45,
  GCRYCTL_UPDATE_RANDOM_SEED_FILE = 46,
  GCRYCTL_SET_THREAD_CBS = 47,
  GCRYCTL_FAST_POLL = 48,
  GCRYCTL_SET_RANDOM_DAEMON_SOCKET = 49,
  GCRYCTL_USE_RANDOM_DAEMON = 50,
  GCRYCTL_FAKED_RANDOM_P = 51,
  GCRYCTL_SET_RNDEGD_SOCKET = 52,
  GCRYCTL_PRINT_CONFIG = 53,
  GCRYCTL_OPERATIONAL_P = 54,
  GCRYCTL_FIPS_MODE_P = 55,
  GCRYCTL_FORCE_FIPS_MODE = 56,
  GCRYCTL_SELFTEST = 57,
  /* Note: 58 .. 62 are used internally.  */
  GCRYCTL_DISABLE_HWF = 63,
  GCRYCTL_SET_ENFORCED_FIPS_FLAG = 64,
  GCRYCTL_SET_PREFERRED_RNG_TYPE = 65,
  GCRYCTL_GET_CURRENT_RNG_TYPE = 66,
  GCRYCTL_DISABLE_LOCKED_SECMEM = 67,
  GCRYCTL_DISABLE_PRIV_DROP = 68,
  GCRYCTL_SET_CCM_LENGTHS = 69,
  GCRYCTL_CLOSE_RANDOM_DEVICE = 70,
  GCRYCTL_INACTIVATE_FIPS_FLAG = 71,
  GCRYCTL_REACTIVATE_FIPS_FLAG = 72
}

/* Perform various operations defined by CMD. */
gcry_error_t gcry_control (gcry_ctl_cmds CMD, ...);


/* S-expression management. */

/* The object to represent an S-expression as used with the public key
   functions.  */
struct gcry_sexp {}
alias gcry_sexp_t = gcry_sexp*;

/*
#ifndef GCRYPT_NO_DEPRECATED
typedef struct gcry_sexp *GCRY_SEXP _GCRY_GCC_ATTR_DEPRECATED;
typedef struct gcry_sexp *GcrySexp _GCRY_GCC_ATTR_DEPRECATED;
#endif
*/

/* The possible values for the S-expression format. */
alias gcry_sexp_format = int;
enum {
  GCRYSEXP_FMT_DEFAULT   = 0,
  GCRYSEXP_FMT_CANON     = 1,
  GCRYSEXP_FMT_BASE64    = 2,
  GCRYSEXP_FMT_ADVANCED  = 3
}

/* Create an new S-expression object from BUFFER of size LENGTH and
   return it in RETSEXP.  With AUTODETECT set to 0 the data in BUFFER
   is expected to be in canonized format.  */
gcry_error_t gcry_sexp_new (gcry_sexp_t *retsexp,
                            const(void)* buffer, usize length,
                            int autodetect);

 /* Same as gcry_sexp_new but allows to pass a FREEFNC which has the
    effect to transfer ownership of BUFFER to the created object.  */
gcry_error_t gcry_sexp_create (gcry_sexp_t *retsexp,
                               void *buffer, usize length,
                               int autodetect, void function (void *) freefnc);

/* Scan BUFFER and return a new S-expression object in RETSEXP.  This
   function expects a printf like string in BUFFER.  */
gcry_error_t gcry_sexp_sscan (gcry_sexp_t *retsexp, usize *erroff,
                              const(char)* buffer, usize length);

/* Same as gcry_sexp_sscan but expects a string in FORMAT and can thus
   only be used for certain encodings.  */
gcry_error_t gcry_sexp_build (gcry_sexp_t *retsexp, usize *erroff,
                              const(char)* format, ...);

/* Like gcry_sexp_build, but uses an array instead of variable
   function arguments.  */
gcry_error_t gcry_sexp_build_array (gcry_sexp_t *retsexp, usize *erroff,
            const(char)* format, void **arg_list);

/* Release the S-expression object SEXP */
void gcry_sexp_release (gcry_sexp_t sexp);

/* Calculate the length of an canonized S-expresion in BUFFER and
   check for a valid encoding. */
usize gcry_sexp_canon_len (const(ubyte)* buffer, usize length,
                            usize *erroff, gcry_error_t *errcode);

/* Copies the S-expression object SEXP into BUFFER using the format
   specified in MODE.  */
usize gcry_sexp_sprint (gcry_sexp_t sexp, int mode, void *buffer,
                         usize maxlength);

/* Dumps the S-expression object A in a format suitable for debugging
   to Libgcrypt's logging stream.  */
void gcry_sexp_dump (const gcry_sexp_t a);

gcry_sexp_t gcry_sexp_cons (const gcry_sexp_t a, const gcry_sexp_t b);
gcry_sexp_t gcry_sexp_alist (const gcry_sexp_t *array);
gcry_sexp_t gcry_sexp_vlist (const gcry_sexp_t a, ...);
gcry_sexp_t gcry_sexp_append (const gcry_sexp_t a, const gcry_sexp_t n);
gcry_sexp_t gcry_sexp_prepend (const gcry_sexp_t a, const gcry_sexp_t n);

/* Scan the S-expression for a sublist with a type (the car of the
   list) matching the string TOKEN.  If TOKLEN is not 0, the token is
   assumed to be raw memory of this length.  The function returns a
   newly allocated S-expression consisting of the found sublist or
   `null' when not found.  */
gcry_sexp_t gcry_sexp_find_token (gcry_sexp_t list,
                                const(char)* tok, usize toklen);
/* Return the length of the LIST.  For a valid S-expression this
   should be at least 1.  */
int gcry_sexp_length (const gcry_sexp_t list);

/* Create and return a new S-expression from the element with index
   NUMBER in LIST.  Note that the first element has the index 0.  If
   there is no such element, `null' is returned.  */
gcry_sexp_t gcry_sexp_nth (const gcry_sexp_t list, int number);

/* Create and return a new S-expression from the first element in
   LIST; this called the "type" and should always exist and be a
   string. `null' is returned in case of a problem.  */
gcry_sexp_t gcry_sexp_car (const gcry_sexp_t list);

/* Create and return a new list form all elements except for the first
   one.  Note, that this function may return an invalid S-expression
   because it is not guaranteed, that the type exists and is a string.
   However, for parsing a complex S-expression it might be useful for
   intermediate lists.  Returns `null' on error.  */
gcry_sexp_t gcry_sexp_cdr (const gcry_sexp_t list);

gcry_sexp_t gcry_sexp_cadr (const gcry_sexp_t list);


/* This function is used to get data from a LIST.  A pointer to the
   actual data with index NUMBER is returned and the length of this
   data will be stored to DATALEN.  If there is no data at the given
   index or the index represents another list, `null' is returned.
   *Note:* The returned pointer is valid as long as LIST is not
   modified or released.  */
const(char)* gcry_sexp_nth_data (const gcry_sexp_t list, int number,
                                usize *datalen);

/* This function is used to get data from a LIST.  A malloced buffer to the
   data with index NUMBER is returned and the length of this
   data will be stored to RLENGTH.  If there is no data at the given
   index or the index represents another list, `null' is returned.  */
void *gcry_sexp_nth_buffer (const gcry_sexp_t list, int number,
                            usize *rlength);

/* This function is used to get and convert data from a LIST.  The
   data is assumed to be a Nul terminated string.  The caller must
   release the returned value using `gcry_free'.  If there is no data
   at the given index, the index represents a list or the value can't
   be converted to a string, `null' is returned.  */
char *gcry_sexp_nth_string (gcry_sexp_t list, int number);

/* This function is used to get and convert data from a LIST. This
   data is assumed to be an MPI stored in the format described by
   MPIFMT and returned as a standard Libgcrypt MPI.  The caller must
   release this returned value using `gcry_mpi_release'.  If there is
   no data at the given index, the index represents a list or the
   value can't be converted to an MPI, `null' is returned.  */
gcry_mpi_t gcry_sexp_nth_mpi (gcry_sexp_t list, int number, int mpifmt);

/* Convenience fucntion to extract parameters from an S-expression
 * using a list of single letter parameters.  */
gpg_error_t gcry_sexp_extract_param (gcry_sexp_t sexp,
                                     const(char)* path,
                                     const(char)* list,
                                     ...) /*_GCRY_GCC_ATTR_SENTINEL(0)*/;


/*******************************************
 *                                         *
 *  Multi Precision Integer Functions      *
 *                                         *
 *******************************************/

/* Different formats of external big integer representation. */
alias gcry_mpi_format = int;
enum {
  GCRYMPI_FMT_NONE= 0,
  GCRYMPI_FMT_STD = 1,    /* Twos complement stored without length.  */
  GCRYMPI_FMT_PGP = 2,    /* As used by OpenPGP (unsigned only).  */
  GCRYMPI_FMT_SSH = 3,    /* As used by SSH (like STD but with length).  */
  GCRYMPI_FMT_HEX = 4,    /* Hex format. */
  GCRYMPI_FMT_USG = 5,    /* Like STD but unsigned. */
  GCRYMPI_FMT_OPAQUE = 8  /* Opaque format (some functions only).  */
}

/* Flags used for creating big integers.  */
alias gcry_mpi_flag = int;
enum {
  GCRYMPI_FLAG_SECURE = 1,  /* Allocate the number in "secure" memory.  */
  GCRYMPI_FLAG_OPAQUE = 2,  /* The number is not a real one but just
                               a way to store some bytes.  This is
                               useful for encrypted big integers.  */
  GCRYMPI_FLAG_IMMUTABLE = 4, /* Mark the MPI as immutable.  */
  GCRYMPI_FLAG_CONST     = 8, /* Mark the MPI as a constant.  */
  GCRYMPI_FLAG_USER1 = 0x0100,/* User flag 1.  */
  GCRYMPI_FLAG_USER2 = 0x0200,/* User flag 2.  */
  GCRYMPI_FLAG_USER3 = 0x0400,/* User flag 3.  */
  GCRYMPI_FLAG_USER4 = 0x0800,/* User flag 4.  */
}


/* Macros to return pre-defined MPI constants.  */
/*
#define GCRYMPI_CONST_ONE   (_gcry_mpi_get_const (1))
#define GCRYMPI_CONST_TWO   (_gcry_mpi_get_const (2))
#define GCRYMPI_CONST_THREE (_gcry_mpi_get_const (3))
#define GCRYMPI_CONST_FOUR  (_gcry_mpi_get_const (4))
#define GCRYMPI_CONST_EIGHT (_gcry_mpi_get_const (8))
*/
gcry_mpi_t GCRYMPI_CONST_ONE () { return _gcry_mpi_get_const(1); }
gcry_mpi_t GCRYMPI_CONST_TWO () { return _gcry_mpi_get_const(2); }
gcry_mpi_t GCRYMPI_CONST_THREE () { return _gcry_mpi_get_const(3); }
gcry_mpi_t GCRYMPI_CONST_FOUR () { return _gcry_mpi_get_const(4); }
gcry_mpi_t GCRYMPI_CONST_EIGHT () { return _gcry_mpi_get_const(8); }


/* Allocate a new big integer object, initialize it with 0 and
   initially allocate memory for a number of at least NBITS. */
gcry_mpi_t gcry_mpi_new (uint nbits);

/* Same as gcry_mpi_new() but allocate in "secure" memory. */
gcry_mpi_t gcry_mpi_snew (uint nbits);

/* Release the number A and free all associated resources. */
void gcry_mpi_release (gcry_mpi_t a);

/* Create a new number with the same value as A. */
gcry_mpi_t gcry_mpi_copy (const gcry_mpi_t a);

/* Store the big integer value U in W and release U.  */
void gcry_mpi_snatch (gcry_mpi_t w, gcry_mpi_t u);

/* Store the big integer value U in W. */
gcry_mpi_t gcry_mpi_set (gcry_mpi_t w, const gcry_mpi_t u);

/* Store the unsigned integer value U in W. */
gcry_mpi_t gcry_mpi_set_ui (gcry_mpi_t w, /*unsigned long*/uint u);

/* Swap the values of A and B. */
void gcry_mpi_swap (gcry_mpi_t a, gcry_mpi_t b);

/* Return 1 if A is negative; 0 if zero or positive.  */
int gcry_mpi_is_neg (gcry_mpi_t a);

/* W = - U */
void gcry_mpi_neg (gcry_mpi_t w, gcry_mpi_t u);

/* W = [W] */
void gcry_mpi_abs (gcry_mpi_t w);

/* Compare the big integer number U and V returning 0 for equality, a
   positive value for U > V and a negative for U < V. */
int gcry_mpi_cmp (const gcry_mpi_t u, const gcry_mpi_t v);

/* Compare the big integer number U with the unsigned integer V
   returning 0 for equality, a positive value for U > V and a negative
   for U < V. */
int gcry_mpi_cmp_ui (const gcry_mpi_t u, /*unsigned long*/uint v);

/* Convert the external representation of an integer stored in BUFFER
   with a length of BUFLEN into a newly create MPI returned in
   RET_MPI.  If NSCANNED is not null, it will receive the number of
   bytes actually scanned after a successful operation. */
gcry_error_t gcry_mpi_scan (gcry_mpi_t *ret_mpi, gcry_mpi_format format,
                            const(void)* buffer, usize buflen,
                            usize *nscanned);

/* Convert the big integer A into the external representation
   described by FORMAT and store it in the provided BUFFER which has
   been allocated by the user with a size of BUFLEN bytes.  NWRITTEN
   receives the actual length of the external representation unless it
   has been passed as null. */
gcry_error_t gcry_mpi_print (gcry_mpi_format format,
                             ubyte *buffer, usize buflen,
                             usize *nwritten,
                             const gcry_mpi_t a);

/* Convert the big integer A int the external representation described
   by FORMAT and store it in a newly allocated buffer which address
   will be put into BUFFER.  NWRITTEN receives the actual lengths of the
   external representation. */
gcry_error_t gcry_mpi_aprint (gcry_mpi_format format,
                              ubyte **buffer, usize *nwritten,
                              const gcry_mpi_t a);

/* Dump the value of A in a format suitable for debugging to
   Libgcrypt's logging stream.  Note that one leading space but no
   trailing space or linefeed will be printed.  It is okay to pass
   null for A. */
void gcry_mpi_dump (const gcry_mpi_t a);


/* W = U + V.  */
void gcry_mpi_add (gcry_mpi_t w, gcry_mpi_t u, gcry_mpi_t v);

/* W = U + V.  V is an unsigned integer. */
void gcry_mpi_add_ui (gcry_mpi_t w, gcry_mpi_t u, /*unsigned long*/uint v);

/* W = U + V mod M. */
void gcry_mpi_addm (gcry_mpi_t w, gcry_mpi_t u, gcry_mpi_t v, gcry_mpi_t m);

/* W = U - V. */
void gcry_mpi_sub (gcry_mpi_t w, gcry_mpi_t u, gcry_mpi_t v);

/* W = U - V.  V is an unsigned integer. */
void gcry_mpi_sub_ui (gcry_mpi_t w, gcry_mpi_t u, /*unsigned long*/uint v );

/* W = U - V mod M */
void gcry_mpi_subm (gcry_mpi_t w, gcry_mpi_t u, gcry_mpi_t v, gcry_mpi_t m);

/* W = U * V. */
void gcry_mpi_mul (gcry_mpi_t w, gcry_mpi_t u, gcry_mpi_t v);

/* W = U * V.  V is an unsigned integer. */
void gcry_mpi_mul_ui (gcry_mpi_t w, gcry_mpi_t u, /*unsigned long*/uint v );

/* W = U * V mod M. */
void gcry_mpi_mulm (gcry_mpi_t w, gcry_mpi_t u, gcry_mpi_t v, gcry_mpi_t m);

/* W = U * (2 ^ CNT). */
void gcry_mpi_mul_2exp (gcry_mpi_t w, gcry_mpi_t u, /*unsigned long*/uint cnt);

/* Q = DIVIDEND / DIVISOR, R = DIVIDEND % DIVISOR,
   Q or R may be passed as null.  ROUND should be negative or 0. */
void gcry_mpi_div (gcry_mpi_t q, gcry_mpi_t r,
                   gcry_mpi_t dividend, gcry_mpi_t divisor, int round);

/* R = DIVIDEND % DIVISOR */
void gcry_mpi_mod (gcry_mpi_t r, gcry_mpi_t dividend, gcry_mpi_t divisor);

/* W = B ^ E mod M. */
void gcry_mpi_powm (gcry_mpi_t w,
                    const gcry_mpi_t b, const gcry_mpi_t e,
                    const gcry_mpi_t m);

/* Set G to the greatest common divisor of A and B.
   Return true if the G is 1. */
int gcry_mpi_gcd (gcry_mpi_t g, gcry_mpi_t a, gcry_mpi_t b);

/* Set X to the multiplicative inverse of A mod M.
   Return true if the value exists. */
int gcry_mpi_invm (gcry_mpi_t x, gcry_mpi_t a, gcry_mpi_t m);

/* Create a new point object.  NBITS is usually 0.  */
gcry_mpi_point_t gcry_mpi_point_new (uint nbits);

/* Release the object POINT.  POINT may be null. */
void gcry_mpi_point_release (gcry_mpi_point_t point);

/* Store the projective coordinates from POINT into X, Y, and Z.  */
void gcry_mpi_point_get (gcry_mpi_t x, gcry_mpi_t y, gcry_mpi_t z,
                         gcry_mpi_point_t point);

/* Store the projective coordinates from POINT into X, Y, and Z and
   release POINT.  */
void gcry_mpi_point_snatch_get (gcry_mpi_t x, gcry_mpi_t y, gcry_mpi_t z,
                                gcry_mpi_point_t point);

/* Store the projective coordinates X, Y, and Z into POINT.  */
gcry_mpi_point_t gcry_mpi_point_set (gcry_mpi_point_t point,
                                     gcry_mpi_t x, gcry_mpi_t y, gcry_mpi_t z);

/* Store the projective coordinates X, Y, and Z into POINT and release
   X, Y, and Z.  */
gcry_mpi_point_t gcry_mpi_point_snatch_set (gcry_mpi_point_t point,
                                            gcry_mpi_t x, gcry_mpi_t y,
                                            gcry_mpi_t z);

/* Allocate a new context for elliptic curve operations based on the
   parameters given by KEYPARAM or using CURVENAME.  */
gpg_error_t gcry_mpi_ec_new (gcry_ctx_t *r_ctx,
                             gcry_sexp_t keyparam, const(char)* curvename);

/* Get a named MPI from an elliptic curve context.  */
gcry_mpi_t gcry_mpi_ec_get_mpi (const(char)* name, gcry_ctx_t ctx, int copy);

/* Get a named point from an elliptic curve context.  */
gcry_mpi_point_t gcry_mpi_ec_get_point (const(char)* name,
                                        gcry_ctx_t ctx, int copy);

/* Store a named MPI into an elliptic curve context.  */
gpg_error_t gcry_mpi_ec_set_mpi (const(char)* name, gcry_mpi_t newvalue,
                                 gcry_ctx_t ctx);

/* Store a named point into an elliptic curve context.  */
gpg_error_t gcry_mpi_ec_set_point (const(char)* name, gcry_mpi_point_t newvalue,
                                   gcry_ctx_t ctx);

/* Store the affine coordinates of POINT into X and Y.  */
int gcry_mpi_ec_get_affine (gcry_mpi_t x, gcry_mpi_t y, gcry_mpi_point_t point,
                            gcry_ctx_t ctx);

/* W = 2 * U.  */
void gcry_mpi_ec_dup (gcry_mpi_point_t w, gcry_mpi_point_t u, gcry_ctx_t ctx);

/* W = U + V.  */
void gcry_mpi_ec_add (gcry_mpi_point_t w,
                      gcry_mpi_point_t u, gcry_mpi_point_t v, gcry_ctx_t ctx);

/* W = N * U.  */
void gcry_mpi_ec_mul (gcry_mpi_point_t w, gcry_mpi_t n, gcry_mpi_point_t u,
                      gcry_ctx_t ctx);

/* Return true if POINT is on the curve described by CTX.  */
int gcry_mpi_ec_curve_point (gcry_mpi_point_t w, gcry_ctx_t ctx);

/* Return the number of bits required to represent A. */
uint gcry_mpi_get_nbits (gcry_mpi_t a);

/* Return true when bit number N (counting from 0) is set in A. */
int      gcry_mpi_test_bit (gcry_mpi_t a, uint n);

/* Set bit number N in A. */
void     gcry_mpi_set_bit (gcry_mpi_t a, uint n);

/* Clear bit number N in A. */
void     gcry_mpi_clear_bit (gcry_mpi_t a, uint n);

/* Set bit number N in A and clear all bits greater than N. */
void     gcry_mpi_set_highbit (gcry_mpi_t a, uint n);

/* Clear bit number N in A and all bits greater than N. */
void     gcry_mpi_clear_highbit (gcry_mpi_t a, uint n);

/* Shift the value of A by N bits to the right and store the result in X. */
void     gcry_mpi_rshift (gcry_mpi_t x, gcry_mpi_t a, uint n);

/* Shift the value of A by N bits to the left and store the result in X. */
void     gcry_mpi_lshift (gcry_mpi_t x, gcry_mpi_t a, uint n);

/* Store NBITS of the value P points to in A and mark A as an opaque
   value.  On success A received the the ownership of the value P.
   WARNING: Never use an opaque MPI for anything thing else than
   gcry_mpi_release, gcry_mpi_get_opaque. */
gcry_mpi_t gcry_mpi_set_opaque (gcry_mpi_t a, void *p, uint nbits);

/* Store NBITS of the value P points to in A and mark A as an opaque
   value.  The function takes a copy of the provided value P.
   WARNING: Never use an opaque MPI for anything thing else than
   gcry_mpi_release, gcry_mpi_get_opaque. */
gcry_mpi_t gcry_mpi_set_opaque_copy (gcry_mpi_t a,
                                     const(void)* p, uint nbits);

/* Return a pointer to an opaque value stored in A and return its size
   in NBITS.  Note that the returned pointer is still owned by A and
   that the function should never be used for an non-opaque MPI. */
void *gcry_mpi_get_opaque (gcry_mpi_t a, uint *nbits);

/* Set the FLAG for the big integer A.  Currently only the flag
   GCRYMPI_FLAG_SECURE is allowed to convert A into an big intger
   stored in "secure" memory. */
void gcry_mpi_set_flag (gcry_mpi_t a, gcry_mpi_flag flag);

/* Clear FLAG for the big integer A.  Note that this function is
   currently useless as no flags are allowed. */
void gcry_mpi_clear_flag (gcry_mpi_t a, gcry_mpi_flag flag);

/* Return true if the FLAG is set for A. */
int gcry_mpi_get_flag (gcry_mpi_t a, gcry_mpi_flag flag);

/* Private function - do not use.  */
gcry_mpi_t _gcry_mpi_get_const (int no);

/* Unless the GCRYPT_NO_MPI_MACROS is used, provide a couple of
   convenience macros for the big integer functions. */
/+
#ifndef GCRYPT_NO_MPI_MACROS
#define mpi_new(n)          gcry_mpi_new( (n) )
#define mpi_secure_new( n ) gcry_mpi_snew( (n) )
#define mpi_release(a)      \
  do \
    { \
      gcry_mpi_release ((a)); \
      (a) = null; \
    } \
  while (0)

#define mpi_copy( a )          gcry_mpi_copy( (a) )
#define mpi_snatch( w, u)      gcry_mpi_snatch( (w), (u) )
#define mpi_set( w, u)         gcry_mpi_set( (w), (u) )
#define mpi_set_ui( w, u)      gcry_mpi_set_ui( (w), (u) )
#define mpi_abs( w )           gcry_mpi_abs( (w) )
#define mpi_neg( w, u)         gcry_mpi_neg( (w), (u) )
#define mpi_cmp( u, v )        gcry_mpi_cmp( (u), (v) )
#define mpi_cmp_ui( u, v )     gcry_mpi_cmp_ui( (u), (v) )
#define mpi_is_neg( a )        gcry_mpi_is_neg ((a))

#define mpi_add_ui(w,u,v)      gcry_mpi_add_ui((w),(u),(v))
#define mpi_add(w,u,v)         gcry_mpi_add ((w),(u),(v))
#define mpi_addm(w,u,v,m)      gcry_mpi_addm ((w),(u),(v),(m))
#define mpi_sub_ui(w,u,v)      gcry_mpi_sub_ui ((w),(u),(v))
#define mpi_sub(w,u,v)         gcry_mpi_sub ((w),(u),(v))
#define mpi_subm(w,u,v,m)      gcry_mpi_subm ((w),(u),(v),(m))
#define mpi_mul_ui(w,u,v)      gcry_mpi_mul_ui ((w),(u),(v))
#define mpi_mul_2exp(w,u,v)    gcry_mpi_mul_2exp ((w),(u),(v))
#define mpi_mul(w,u,v)         gcry_mpi_mul ((w),(u),(v))
#define mpi_mulm(w,u,v,m)      gcry_mpi_mulm ((w),(u),(v),(m))
#define mpi_powm(w,b,e,m)      gcry_mpi_powm ( (w), (b), (e), (m) )
#define mpi_tdiv(q,r,a,m)      gcry_mpi_div ( (q), (r), (a), (m), 0)
#define mpi_fdiv(q,r,a,m)      gcry_mpi_div ( (q), (r), (a), (m), -1)
#define mpi_mod(r,a,m)         gcry_mpi_mod ((r), (a), (m))
#define mpi_gcd(g,a,b)         gcry_mpi_gcd ( (g), (a), (b) )
#define mpi_invm(g,a,b)        gcry_mpi_invm ( (g), (a), (b) )

#define mpi_point_new(n)              gcry_mpi_point_new((n))
#define mpi_point_release(p)                    \
  do                                            \
    {                                           \
      gcry_mpi_point_release ((p));             \
      (p) = null;                               \
    }                                           \
  while (0)
#define mpi_point_get(x,y,z,p)        gcry_mpi_point_get((x),(y),(z),(p))
#define mpi_point_snatch_get(x,y,z,p) gcry_mpi_point_snatch_get((x),(y),(z),(p))
#define mpi_point_set(p,x,y,z)        gcry_mpi_point_set((p),(x),(y),(z))
#define mpi_point_snatch_set(p,x,y,z) gcry_mpi_point_snatch_set((p),(x),(y),(z))

#define mpi_get_nbits(a)       gcry_mpi_get_nbits ((a))
#define mpi_test_bit(a,b)      gcry_mpi_test_bit ((a),(b))
#define mpi_set_bit(a,b)       gcry_mpi_set_bit ((a),(b))
#define mpi_set_highbit(a,b)   gcry_mpi_set_highbit ((a),(b))
#define mpi_clear_bit(a,b)     gcry_mpi_clear_bit ((a),(b))
#define mpi_clear_highbit(a,b) gcry_mpi_clear_highbit ((a),(b))
#define mpi_rshift(a,b,c)      gcry_mpi_rshift ((a),(b),(c))
#define mpi_lshift(a,b,c)      gcry_mpi_lshift ((a),(b),(c))

#define mpi_set_opaque(a,b,c)  gcry_mpi_set_opaque( (a), (b), (c) )
#define mpi_get_opaque(a,b)    gcry_mpi_get_opaque( (a), (b) )
#endif /* GCRYPT_NO_MPI_MACROS */
+/


/************************************
 *                                  *
 *   Symmetric Cipher Functions     *
 *                                  *
 ************************************/

/* The data object used to hold a handle to an encryption object.  */
struct gcry_cipher_handle {}
alias gcry_cipher_hd_t = gcry_cipher_handle*;

/*
#ifndef GCRYPT_NO_DEPRECATED
typedef struct gcry_cipher_handle *GCRY_CIPHER_HD _GCRY_GCC_ATTR_DEPRECATED;
typedef struct gcry_cipher_handle *GcryCipherHd _GCRY_GCC_ATTR_DEPRECATED;
#endif
*/

/* All symmetric encryption algorithms are identified by their IDs.
   More IDs may be registered at runtime. */
alias gcry_cipher_algos = int;
enum {
  GCRY_CIPHER_NONE        = 0,
  GCRY_CIPHER_IDEA        = 1,
  GCRY_CIPHER_3DES        = 2,
  GCRY_CIPHER_CAST5       = 3,
  GCRY_CIPHER_BLOWFISH    = 4,
  GCRY_CIPHER_SAFER_SK128 = 5,
  GCRY_CIPHER_DES_SK      = 6,
  GCRY_CIPHER_AES         = 7,
  GCRY_CIPHER_AES192      = 8,
  GCRY_CIPHER_AES256      = 9,
  GCRY_CIPHER_TWOFISH     = 10,

  /* Other cipher numbers are above 300 for OpenPGP reasons. */
  GCRY_CIPHER_ARCFOUR     = 301,  /* Fully compatible with RSA's RC4 (tm). */
  GCRY_CIPHER_DES         = 302,  /* Yes, this is single key 56 bit DES. */
  GCRY_CIPHER_TWOFISH128  = 303,
  GCRY_CIPHER_SERPENT128  = 304,
  GCRY_CIPHER_SERPENT192  = 305,
  GCRY_CIPHER_SERPENT256  = 306,
  GCRY_CIPHER_RFC2268_40  = 307,  /* Ron's Cipher 2 (40 bit). */
  GCRY_CIPHER_RFC2268_128 = 308,  /* Ron's Cipher 2 (128 bit). */
  GCRY_CIPHER_SEED        = 309,  /* 128 bit cipher described in RFC4269. */
  GCRY_CIPHER_CAMELLIA128 = 310,
  GCRY_CIPHER_CAMELLIA192 = 311,
  GCRY_CIPHER_CAMELLIA256 = 312,
  GCRY_CIPHER_SALSA20     = 313,
  GCRY_CIPHER_SALSA20R12  = 314,
  GCRY_CIPHER_GOST28147   = 315
}

/* The Rijndael algorithm is basically AES, so provide some macros. */
enum GCRY_CIPHER_AES128      = GCRY_CIPHER_AES;
enum GCRY_CIPHER_RIJNDAEL    = GCRY_CIPHER_AES;
enum GCRY_CIPHER_RIJNDAEL128 = GCRY_CIPHER_AES128;
enum GCRY_CIPHER_RIJNDAEL192 = GCRY_CIPHER_AES192;
enum GCRY_CIPHER_RIJNDAEL256 = GCRY_CIPHER_AES256;

/* The supported encryption modes.  Note that not all of them are
   supported for each algorithm. */
alias gcry_cipher_modes = int;
enum  {
  GCRY_CIPHER_MODE_NONE   = 0,  /* Not yet specified. */
  GCRY_CIPHER_MODE_ECB    = 1,  /* Electronic codebook. */
  GCRY_CIPHER_MODE_CFB    = 2,  /* Cipher feedback. */
  GCRY_CIPHER_MODE_CBC    = 3,  /* Cipher block chaining. */
  GCRY_CIPHER_MODE_STREAM = 4,  /* Used with stream ciphers. */
  GCRY_CIPHER_MODE_OFB    = 5,  /* Outer feedback. */
  GCRY_CIPHER_MODE_CTR    = 6,  /* Counter. */
  GCRY_CIPHER_MODE_AESWRAP= 7,  /* AES-WRAP algorithm.  */
  GCRY_CIPHER_MODE_CCM    = 8,  /* Counter with CBC-MAC.  */
  GCRY_CIPHER_MODE_GCM    = 9   /* Galois Counter Mode. */
}

/* Flags used with the open function. */
alias gcry_cipher_flags = int;
enum {
  GCRY_CIPHER_SECURE      = 1,  /* Allocate in secure memory. */
  GCRY_CIPHER_ENABLE_SYNC = 2,  /* Enable CFB sync mode. */
  GCRY_CIPHER_CBC_CTS     = 4,  /* Enable CBC cipher text stealing (CTS). */
  GCRY_CIPHER_CBC_MAC     = 8   /* Enable CBC message auth. code (MAC). */
}

/* GCM works only with blocks of 128 bits */
enum GCRY_GCM_BLOCK_LEN = (128 / 8);

/* CCM works only with blocks of 128 bits.  */
enum GCRY_CCM_BLOCK_LEN = (128 / 8);

/* Create a handle for algorithm ALGO to be used in MODE.  FLAGS may
   be given as an bitwise OR of the gcry_cipher_flags values. */
gcry_error_t gcry_cipher_open (gcry_cipher_hd_t *handle,
                              int algo, int mode, uint flags);

/* Close the cioher handle H and release all resource. */
void gcry_cipher_close (gcry_cipher_hd_t h);

/* Perform various operations on the cipher object H. */
gcry_error_t gcry_cipher_ctl (gcry_cipher_hd_t h, int cmd, void *buffer,
                             usize buflen);

/* Retrieve various information about the cipher object H. */
gcry_error_t gcry_cipher_info (gcry_cipher_hd_t h, int what, void *buffer,
                              usize *nbytes);

/* Retrieve various information about the cipher algorithm ALGO. */
gcry_error_t gcry_cipher_algo_info (int algo, int what, void *buffer,
                                   usize *nbytes);

/* Map the cipher algorithm whose ID is contained in ALGORITHM to a
   string representation of the algorithm name.  For unknown algorithm
   IDs this function returns "?".  */
const(char)* gcry_cipher_algo_name (int algorithm) /*_GCRY_GCC_ATTR_PURE*/;

/* Map the algorithm name NAME to an cipher algorithm ID.  Return 0 if
   the algorithm name is not known. */
int gcry_cipher_map_name (const(char)* name) /*_GCRY_GCC_ATTR_PURE*/;

/* Given an ASN.1 object identifier in standard IETF dotted decimal
   format in STRING, return the encryption mode associated with that
   OID or 0 if not known or applicable. */
int gcry_cipher_mode_from_oid (const(char)* string) /*_GCRY_GCC_ATTR_PURE*/;

/* Encrypt the plaintext of size INLEN in IN using the cipher handle H
   into the buffer OUT which has an allocated length of OUTSIZE.  For
   most algorithms it is possible to pass null for in and 0 for INLEN
   and do a in-place decryption of the data provided in OUT.  */
gcry_error_t gcry_cipher_encrypt (gcry_cipher_hd_t h,
                                  void *out_, usize outsize,
                                  const(void)* in_, usize inlen);

/* The counterpart to gcry_cipher_encrypt.  */
gcry_error_t gcry_cipher_decrypt (gcry_cipher_hd_t h,
                                  void *out_, usize outsize,
                                  const(void)* in_, usize inlen);

/* Set KEY of length KEYLEN bytes for the cipher handle HD.  */
gcry_error_t gcry_cipher_setkey (gcry_cipher_hd_t hd,
                                 const(void)* key, usize keylen);


/* Set initialization vector IV of length IVLEN for the cipher handle HD. */
gcry_error_t gcry_cipher_setiv (gcry_cipher_hd_t hd,
                                const(void)* iv, usize ivlen);

/* Provide additional authentication data for AEAD modes/ciphers.  */
gcry_error_t gcry_cipher_authenticate (gcry_cipher_hd_t hd, const(void)* abuf,
                                       usize abuflen);

/* Get authentication tag for AEAD modes/ciphers.  */
gcry_error_t gcry_cipher_gettag (gcry_cipher_hd_t hd, void *outtag,
                                 usize taglen);

/* Check authentication tag for AEAD modes/ciphers.  */
gcry_error_t gcry_cipher_checktag (gcry_cipher_hd_t hd, const(void)* intag,
                                   usize taglen);

/* Reset the handle to the state after open.  */
auto gcry_cipher_reset (gcry_cipher_hd_t h) { return gcry_cipher_ctl(h, GCRYCTL_RESET, null, 0); }

/* Perform the OpenPGP sync operation if this is enabled for the
   cipher handle H. */
auto gcry_cipher_sync (gcry_cipher_hd_t h) { return gcry_cipher_ctl(h, GCRYCTL_CFB_SYNC, null, 0); }

/* Enable or disable CTS in future calls to gcry_encrypt(). CBC mode only. */
auto gcry_cipher_cts (gcry_cipher_hd_t h, int on) { return gcry_cipher_ctl(h, GCRYCTL_SET_CBC_CTS, null, on); }

/* Set counter for CTR mode.  (CTR,CTRLEN) must denote a buffer of
   block size length, or (null,0) to set the CTR to the all-zero block. */
gpg_error_t gcry_cipher_setctr (gcry_cipher_hd_t hd,
                                const(void)* ctr, usize ctrlen);

/* Retrieve the key length in bytes used with algorithm A. */
usize gcry_cipher_get_algo_keylen (int algo);

/* Retrieve the block length in bytes used with algorithm A. */
usize gcry_cipher_get_algo_blklen (int algo);

/* Return 0 if the algorithm A is available for use. */
auto gcry_cipher_test_algo (int a) { return gcry_cipher_algo_info(a, GCRYCTL_TEST_ALGO, null, null); }


/************************************
 *                                  *
 *    Asymmetric Cipher Functions   *
 *                                  *
 ************************************/

/* The algorithms and their IDs we support.  */
alias gcry_pk_algos = int;
enum {
  GCRY_PK_RSA   = 1,      /* RSA */
  GCRY_PK_RSA_E = 2,      /* (deprecated: use 1).  */
  GCRY_PK_RSA_S = 3,      /* (deprecated: use 1).  */
  GCRY_PK_ELG_E = 16,     /* (deprecated: use 20). */
  GCRY_PK_DSA   = 17,     /* Digital Signature Algorithm.  */
  GCRY_PK_ECC   = 18,     /* Generic ECC.  */
  GCRY_PK_ELG   = 20,     /* Elgamal       */
  GCRY_PK_ECDSA = 301,    /* (deprecated: use 18).  */
  GCRY_PK_ECDH  = 302     /* (deprecated: use 18).  */
}

/* Flags describing usage capabilities of a PK algorithm. */
enum {
  GCRY_PK_USAGE_SIGN = 1,   /* Good for signatures. */
  GCRY_PK_USAGE_ENCR = 2,   /* Good for encryption. */
  GCRY_PK_USAGE_CERT = 4,   /* Good to certify other keys. */
  GCRY_PK_USAGE_AUTH = 8,   /* Good for authentication. */
  GCRY_PK_USAGE_UNKN = 128, /* Unknown usage flag. */
}

/* Modes used with gcry_pubkey_get_sexp.  */
enum {
  GCRY_PK_GET_PUBKEY = 1,
  GCRY_PK_GET_SECKEY = 2,
}

/* Encrypt the DATA using the public key PKEY and store the result as
   a newly created S-expression at RESULT. */
gcry_error_t gcry_pk_encrypt (gcry_sexp_t *result,
                              gcry_sexp_t data, gcry_sexp_t pkey);

/* Decrypt the DATA using the private key SKEY and store the result as
   a newly created S-expression at RESULT. */
gcry_error_t gcry_pk_decrypt (gcry_sexp_t *result,
                              gcry_sexp_t data, gcry_sexp_t skey);

/* Sign the DATA using the private key SKEY and store the result as
   a newly created S-expression at RESULT. */
gcry_error_t gcry_pk_sign (gcry_sexp_t *result,
                           gcry_sexp_t data, gcry_sexp_t skey);

/* Check the signature SIGVAL on DATA using the public key PKEY. */
gcry_error_t gcry_pk_verify (gcry_sexp_t sigval,
                             gcry_sexp_t data, gcry_sexp_t pkey);

/* Check that private KEY is sane. */
gcry_error_t gcry_pk_testkey (gcry_sexp_t key);

/* Generate a new key pair according to the parameters given in
   S_PARMS.  The new key pair is returned in as an S-expression in
   R_KEY. */
gcry_error_t gcry_pk_genkey (gcry_sexp_t *r_key, gcry_sexp_t s_parms);

/* Catch all function for miscellaneous operations. */
gcry_error_t gcry_pk_ctl (int cmd, void *buffer, usize buflen);

/* Retrieve information about the public key algorithm ALGO. */
gcry_error_t gcry_pk_algo_info (int algo, int what,
                                void *buffer, usize *nbytes);

/* Map the public key algorithm whose ID is contained in ALGORITHM to
   a string representation of the algorithm name.  For unknown
   algorithm IDs this functions returns "?". */
const(char)* gcry_pk_algo_name (int algorithm) /*_GCRY_GCC_ATTR_PURE*/;

/* Map the algorithm NAME to a public key algorithm Id.  Return 0 if
   the algorithm name is not known. */
int gcry_pk_map_name (const(char)* name) /*_GCRY_GCC_ATTR_PURE*/;

/* Return what is commonly referred as the key length for the given
   public or private KEY.  */
uint gcry_pk_get_nbits (gcry_sexp_t key) /*_GCRY_GCC_ATTR_PURE*/;

/* Return the so called KEYGRIP which is the SHA-1 hash of the public
   key parameters expressed in a way depending on the algorithm.  */
ubyte *gcry_pk_get_keygrip (gcry_sexp_t key, ubyte *array);

/* Return the name of the curve matching KEY.  */
const(char)* gcry_pk_get_curve (gcry_sexp_t key, int iterator,
                               uint *r_nbits);

/* Return an S-expression with the parameters of the named ECC curve
   NAME.  ALGO must be set to an ECC algorithm.  */
gcry_sexp_t gcry_pk_get_param (int algo, const(char)* name);

/* Return 0 if the public key algorithm A is available for use. */
auto gcry_pk_test_algo (int a) { return gcry_pk_algo_info(a, GCRYCTL_TEST_ALGO, null, null); }

/* Return an S-expression representing the context CTX.  */
gcry_error_t gcry_pubkey_get_sexp (gcry_sexp_t *r_sexp,
                                   int mode, gcry_ctx_t ctx);



/************************************
 *                                  *
 *   Cryptograhic Hash Functions    *
 *                                  *
 ************************************/

/* Algorithm IDs for the hash functions we know about. Not all of them
   are implemnted. */
alias gcry_md_algos = int;
enum {
  GCRY_MD_NONE    = 0,
  GCRY_MD_MD5     = 1,
  GCRY_MD_SHA1    = 2,
  GCRY_MD_RMD160  = 3,
  GCRY_MD_MD2     = 5,
  GCRY_MD_TIGER   = 6,   /* TIGER/192 as used by gpg <= 1.3.2. */
  GCRY_MD_HAVAL   = 7,   /* HAVAL, 5 pass, 160 bit. */
  GCRY_MD_SHA256  = 8,
  GCRY_MD_SHA384  = 9,
  GCRY_MD_SHA512  = 10,
  GCRY_MD_SHA224  = 11,
  GCRY_MD_MD4     = 301,
  GCRY_MD_CRC32         = 302,
  GCRY_MD_CRC32_RFC1510 = 303,
  GCRY_MD_CRC24_RFC2440 = 304,
  GCRY_MD_WHIRLPOOL     = 305,
  GCRY_MD_TIGER1        = 306, /* TIGER fixed.  */
  GCRY_MD_TIGER2        = 307, /* TIGER2 variant.   */
  GCRY_MD_GOSTR3411_94  = 308, /* GOST R 34.11-94.  */
  GCRY_MD_STRIBOG256    = 309, /* GOST R 34.11-2012, 256 bit.  */
  GCRY_MD_STRIBOG512    = 310  /* GOST R 34.11-2012, 512 bit.  */
}

/* Flags used with the open function.  */
alias gcry_md_flags = int;
enum {
  GCRY_MD_FLAG_SECURE = 1,  /* Allocate all buffers in "secure" memory.  */
  GCRY_MD_FLAG_HMAC   = 2,  /* Make an HMAC out of this algorithm.  */
  GCRY_MD_FLAG_BUGEMU1 = 0x0100
}

/* (Forward declaration.)  */
struct gcry_md_context;

/* This object is used to hold a handle to a message digest object.
   This structure is private - only to be used by the public gcry_md_*
   macros.  */
struct gcry_md_handle {
  /* Actual context.  */
  gcry_md_context* ctx;

  /* Buffer management.  */
  int  bufpos;
  int  bufsize;
  ubyte[1] buf;
}
alias gcry_md_hd_t = gcry_md_handle*;

/* Compatibility types, do not use them.  */
/*
#ifndef GCRYPT_NO_DEPRECATED
typedef struct gcry_md_handle *GCRY_MD_HD _GCRY_GCC_ATTR_DEPRECATED;
typedef struct gcry_md_handle *GcryMDHd _GCRY_GCC_ATTR_DEPRECATED;
#endif
*/

/* Create a message digest object for algorithm ALGO.  FLAGS may be
   given as an bitwise OR of the gcry_md_flags values.  ALGO may be
   given as 0 if the algorithms to be used are later set using
   gcry_md_enable.  */
gcry_error_t gcry_md_open (gcry_md_hd_t *h, int algo, uint flags);

/* Release the message digest object HD.  */
void gcry_md_close (gcry_md_hd_t hd);

/* Add the message digest algorithm ALGO to the digest object HD.  */
gcry_error_t gcry_md_enable (gcry_md_hd_t hd, int algo);

/* Create a new digest object as an exact copy of the object HD.  */
gcry_error_t gcry_md_copy (gcry_md_hd_t *bhd, gcry_md_hd_t ahd);

/* Reset the digest object HD to its initial state.  */
void gcry_md_reset (gcry_md_hd_t hd);

/* Perform various operations on the digest object HD. */
gcry_error_t gcry_md_ctl (gcry_md_hd_t hd, int cmd,
                          void *buffer, usize buflen);

/* Pass LENGTH bytes of data in BUFFER to the digest object HD so that
   it can update the digest values.  This is the actual hash
   function. */
void gcry_md_write (gcry_md_hd_t hd, const(void)* buffer, usize length);

/* Read out the final digest from HD return the digest value for
   algorithm ALGO. */
ubyte *gcry_md_read (gcry_md_hd_t hd, int algo);

/* Convenience function to calculate the hash from the data in BUFFER
   of size LENGTH using the algorithm ALGO avoiding the creating of a
   hash object.  The hash is returned in the caller provided buffer
   DIGEST which must be large enough to hold the digest of the given
   algorithm. */
void gcry_md_hash_buffer (int algo, void *digest,
                          const(void)* buffer, usize length);

/* Convenience function to hash multiple buffers.  */
gpg_error_t gcry_md_hash_buffers (int algo, uint flags, void *digest,
                                  const gcry_buffer_t *iov, int iovcnt);

/* Retrieve the algorithm used with HD.  This does not work reliable
   if more than one algorithm is enabled in HD. */
int gcry_md_get_algo (gcry_md_hd_t hd);

/* Retrieve the length in bytes of the digest yielded by algorithm
   ALGO. */
uint gcry_md_get_algo_dlen (int algo);

/* Return true if the the algorithm ALGO is enabled in the digest
   object A. */
int gcry_md_is_enabled (gcry_md_hd_t a, int algo);

/* Return true if the digest object A is allocated in "secure" memory. */
int gcry_md_is_secure (gcry_md_hd_t a);

/* Retrieve various information about the object H.  */
gcry_error_t gcry_md_info (gcry_md_hd_t h, int what, void *buffer,
                          usize *nbytes);

/* Retrieve various information about the algorithm ALGO.  */
gcry_error_t gcry_md_algo_info (int algo, int what, void *buffer,
                               usize *nbytes);

/* Map the digest algorithm id ALGO to a string representation of the
   algorithm name.  For unknown algorithms this function returns
   "?". */
const(char)* gcry_md_algo_name (int algo) /*_GCRY_GCC_ATTR_PURE*/;

/* Map the algorithm NAME to a digest algorithm Id.  Return 0 if
   the algorithm name is not known. */
int gcry_md_map_name (const(char)* name) /*_GCRY_GCC_ATTR_PURE*/;

/* For use with the HMAC feature, the set MAC key to the KEY of
   KEYLEN bytes. */
gcry_error_t gcry_md_setkey (gcry_md_hd_t hd, const(void)* key, usize keylen);

/* Start or stop debugging for digest handle HD; i.e. create a file
   named dbgmd-<n>.<suffix> while hashing.  If SUFFIX is null,
   debugging stops and the file will be closed. */
void gcry_md_debug (gcry_md_hd_t hd, const(char)* suffix);


/* Update the hash(s) of H with the character C.  This is a buffered
   version of the gcry_md_write function. */
/+
#define gcry_md_putc(h,c)  \
            do {                                          \
                gcry_md_hd_t h__ = (h);                   \
                if( (h__)->bufpos == (h__)->bufsize )     \
                    gcry_md_write( (h__), null, 0 );      \
                (h__)->buf[(h__)->bufpos++] = (c) & 0xff; \
            } while(0)

/* Finalize the digest calculation.  This is not really needed because
   gcry_md_read() does this implicitly. */
#define gcry_md_final(a) \
            gcry_md_ctl ((a), GCRYCTL_FINALIZE, null, 0)

/* Return 0 if the algorithm A is available for use. */
#define gcry_md_test_algo(a) \
            gcry_md_algo_info( (a), GCRYCTL_TEST_ALGO, null, null )

/* Return an DER encoded ASN.1 OID for the algorithm A in buffer B. N
   must point to usize variable with the available size of buffer B.
   After return it will receive the actual size of the returned
   OID. */
#define gcry_md_get_asnoid(a,b,n) \
            gcry_md_algo_info((a), GCRYCTL_GET_ASNOID, (b), (n))
+/


/**********************************************
 *                                            *
 *   Message Authentication Code Functions    *
 *                                            *
 **********************************************/

/* The data object used to hold a handle to an encryption object.  */
struct gcry_mac_handle {}
alias gcry_mac_hd_t = gcry_mac_handle*;

/* Algorithm IDs for the hash functions we know about. Not all of them
   are implemented. */
alias gcry_mac_algos = int;
enum {
  GCRY_MAC_NONE               = 0,

  GCRY_MAC_HMAC_SHA256        = 101,
  GCRY_MAC_HMAC_SHA224        = 102,
  GCRY_MAC_HMAC_SHA512        = 103,
  GCRY_MAC_HMAC_SHA384        = 104,
  GCRY_MAC_HMAC_SHA1          = 105,
  GCRY_MAC_HMAC_MD5           = 106,
  GCRY_MAC_HMAC_MD4           = 107,
  GCRY_MAC_HMAC_RMD160        = 108,
  GCRY_MAC_HMAC_TIGER1        = 109, /* The fixed TIGER variant */
  GCRY_MAC_HMAC_WHIRLPOOL     = 110,
  GCRY_MAC_HMAC_GOSTR3411_94  = 111,
  GCRY_MAC_HMAC_STRIBOG256    = 112,
  GCRY_MAC_HMAC_STRIBOG512    = 113,

  GCRY_MAC_CMAC_AES           = 201,
  GCRY_MAC_CMAC_3DES          = 202,
  GCRY_MAC_CMAC_CAMELLIA      = 203,
  GCRY_MAC_CMAC_CAST5         = 204,
  GCRY_MAC_CMAC_BLOWFISH      = 205,
  GCRY_MAC_CMAC_TWOFISH       = 206,
  GCRY_MAC_CMAC_SERPENT       = 207,
  GCRY_MAC_CMAC_SEED          = 208,
  GCRY_MAC_CMAC_RFC2268       = 209,
  GCRY_MAC_CMAC_IDEA          = 210,
  GCRY_MAC_CMAC_GOST28147     = 211,

  GCRY_MAC_GMAC_AES           = 401,
  GCRY_MAC_GMAC_CAMELLIA      = 402,
  GCRY_MAC_GMAC_TWOFISH       = 403,
  GCRY_MAC_GMAC_SERPENT       = 404,
  GCRY_MAC_GMAC_SEED          = 405
}

/* Flags used with the open function.  */
alias gcry_mac_flags = int;
enum {
  GCRY_MAC_FLAG_SECURE = 1,  /* Allocate all buffers in "secure" memory.  */
}

/* Create a MAC handle for algorithm ALGO.  FLAGS may be given as an bitwise OR
   of the gcry_mac_flags values.  CTX maybe null or gcry_ctx_t object to be
   associated with HANDLE.  */
gcry_error_t gcry_mac_open (gcry_mac_hd_t *handle, int algo,
                            uint flags, gcry_ctx_t ctx);

/* Close the MAC handle H and release all resource. */
void gcry_mac_close (gcry_mac_hd_t h);

/* Perform various operations on the MAC object H. */
gcry_error_t gcry_mac_ctl (gcry_mac_hd_t h, int cmd, void *buffer,
                           usize buflen);

/* Retrieve various information about the MAC algorithm ALGO. */
gcry_error_t gcry_mac_algo_info (int algo, int what, void *buffer,
                                 usize *nbytes);

/* Set KEY of length KEYLEN bytes for the MAC handle HD.  */
gcry_error_t gcry_mac_setkey (gcry_mac_hd_t hd, const(void)* key,
                              usize keylen);

/* Set initialization vector IV of length IVLEN for the MAC handle HD. */
gcry_error_t gcry_mac_setiv (gcry_mac_hd_t hd, const(void)* iv,
                             usize ivlen);

/* Pass LENGTH bytes of data in BUFFER to the MAC object HD so that
   it can update the MAC values.  */
gcry_error_t gcry_mac_write (gcry_mac_hd_t hd, const(void)* buffer,
                             usize length);

/* Read out the final authentication code from the MAC object HD to BUFFER. */
gcry_error_t gcry_mac_read (gcry_mac_hd_t hd, void *buffer, usize *buflen);

/* Verify the final authentication code from the MAC object HD with BUFFER. */
gcry_error_t gcry_mac_verify (gcry_mac_hd_t hd, const(void)* buffer,
                              usize buflen);

/* Retrieve the length in bytes of the MAC yielded by algorithm ALGO. */
uint gcry_mac_get_algo_maclen (int algo);

/* Retrieve the default key length in bytes used with algorithm A. */
uint gcry_mac_get_algo_keylen (int algo);

/* Map the MAC algorithm whose ID is contained in ALGORITHM to a
   string representation of the algorithm name.  For unknown algorithm
   IDs this function returns "?".  */
const(char)* gcry_mac_algo_name (int algorithm) /*_GCRY_GCC_ATTR_PURE*/;

/* Map the algorithm name NAME to an MAC algorithm ID.  Return 0 if
   the algorithm name is not known. */
int gcry_mac_map_name (const(char)* name) /*_GCRY_GCC_ATTR_PURE*/;

/* Reset the handle to the state after open/setkey.  */
auto gcry_mac_reset(gcry_mac_hd_t h) { return gcry_mac_ctl(h, GCRYCTL_RESET, null, 0); }

/* Return 0 if the algorithm A is available for use. */
auto gcry_mac_test_algo (int a) { return gcry_mac_algo_info(a, GCRYCTL_TEST_ALGO, null, null); }


/******************************
 *                            *
 *  Key Derivation Functions  *
 *                            *
 ******************************/

/* Algorithm IDs for the KDFs.  */
alias gcry_kdf_algos = int;
enum  {
  GCRY_KDF_NONE = 0,
  GCRY_KDF_SIMPLE_S2K = 16,
  GCRY_KDF_SALTED_S2K = 17,
  GCRY_KDF_ITERSALTED_S2K = 19,
  GCRY_KDF_PBKDF1 = 33,
  GCRY_KDF_PBKDF2 = 34,
  GCRY_KDF_SCRYPT = 48
}

/* Derive a key from a passphrase.  */
gpg_error_t gcry_kdf_derive (const(void)* passphrase, usize passphraselen,
                             int algo, int subalgo,
                             const(void)* salt, usize saltlen,
                             /*unsigned long*/uint iterations,
                             usize keysize, void *keybuffer);




/************************************
 *                                  *
 *   Random Generating Functions    *
 *                                  *
 ************************************/

/* The type of the random number generator.  */
alias gcry_rng_types = int;
enum  {
  GCRY_RNG_TYPE_STANDARD   = 1, /* The default CSPRNG generator.  */
  GCRY_RNG_TYPE_FIPS       = 2, /* The FIPS X9.31 AES generator.  */
  GCRY_RNG_TYPE_SYSTEM     = 3  /* The system's native generator. */
}

/* The possible values for the random quality.  The rule of thumb is
   to use STRONG for session keys and VERY_STRONG for key material.
   WEAK is usually an alias for STRONG and should not be used anymore
   (except with gcry_mpi_randomize); use gcry_create_nonce instead. */
alias gcry_random_level = int;
alias gcry_random_level_t = gcry_random_level;
enum {
  GCRY_WEAK_RANDOM = 0,
  GCRY_STRONG_RANDOM = 1,
  GCRY_VERY_STRONG_RANDOM = 2
}

/* Fill BUFFER with LENGTH bytes of random, using random numbers of
   quality LEVEL. */
void gcry_randomize (void *buffer, usize length,
                     gcry_random_level level);

/* Add the external random from BUFFER with LENGTH bytes into the
   pool. QUALITY should either be -1 for unknown or in the range of 0
   to 100 */
gcry_error_t gcry_random_add_bytes (const(void)* buffer, usize length,
                                    int quality);

/* If random numbers are used in an application, this macro should be
   called from time to time so that new stuff gets added to the
   internal pool of the RNG.  */
auto gcry_fast_random_poll () { return gcry_control(GCRYCTL_FAST_POLL, null); }


/* Return NBYTES of allocated random using a random numbers of quality
   LEVEL. */
void *gcry_random_bytes (usize nbytes, gcry_random_level level)
                         /*_GCRY_GCC_ATTR_MALLOC*/;

/* Return NBYTES of allocated random using a random numbers of quality
   LEVEL.  The random numbers are created returned in "secure"
   memory. */
void *gcry_random_bytes_secure (usize nbytes, gcry_random_level level)
                                /*_GCRY_GCC_ATTR_MALLOC*/;


/* Set the big integer W to a random value of NBITS using a random
   generator with quality LEVEL.  Note that by using a level of
   GCRY_WEAK_RANDOM gcry_create_nonce is used internally. */
void gcry_mpi_randomize (gcry_mpi_t w,
                         uint nbits, gcry_random_level level);


/* Create an unpredicable nonce of LENGTH bytes in BUFFER. */
void gcry_create_nonce (void *buffer, usize length);





/*******************************/
/*                             */
/*    Prime Number Functions   */
/*                             */
/*******************************/

/* Mode values passed to a gcry_prime_check_func_t. */
enum {
  GCRY_PRIME_CHECK_AT_FINISH      = 0,
  GCRY_PRIME_CHECK_AT_GOT_PRIME   = 1,
  GCRY_PRIME_CHECK_AT_MAYBE_PRIME = 2,
}

/* The function should return 1 if the operation shall continue, 0 to
   reject the prime candidate. */
alias gcry_prime_check_func_t = int function  (void *arg, int mode, gcry_mpi_t candidate);

/* Flags for gcry_prime_generate():  */

/* Allocate prime numbers and factors in secure memory.  */
enum GCRY_PRIME_FLAG_SECRET = (1 << 0);

/* Make sure that at least one prime factor is of size
   `FACTOR_BITS'.  */
enum GCRY_PRIME_FLAG_SPECIAL_FACTOR = (1 << 1);

/* Generate a new prime number of PRIME_BITS bits and store it in
   PRIME.  If FACTOR_BITS is non-zero, one of the prime factors of
   (prime - 1) / 2 must be FACTOR_BITS bits long.  If FACTORS is
   non-zero, allocate a new, null-terminated array holding the prime
   factors and store it in FACTORS.  FLAGS might be used to influence
   the prime number generation process.  */
gcry_error_t gcry_prime_generate (gcry_mpi_t *prime,
                                  uint prime_bits,
                                  uint factor_bits,
                                  gcry_mpi_t **factors,
                                  gcry_prime_check_func_t cb_func,
                                  void *cb_arg,
                                  gcry_random_level_t random_level,
                                  uint flags);

/* Find a generator for PRIME where the factorization of (prime-1) is
   in the null terminated array FACTORS. Return the generator as a
   newly allocated MPI in R_G.  If START_G is not null, use this as
   teh start for the search. */
gcry_error_t gcry_prime_group_generator (gcry_mpi_t *r_g,
                                         gcry_mpi_t prime,
                                         gcry_mpi_t *factors,
                                         gcry_mpi_t start_g);


/* Convenience function to release the FACTORS array. */
void gcry_prime_release_factors (gcry_mpi_t *factors);


/* Check wether the number X is prime.  */
gcry_error_t gcry_prime_check (gcry_mpi_t x, uint flags);



/************************************
 *                                  *
 *     Miscellaneous Stuff          *
 *                                  *
 ************************************/

/* Release the context object CTX.  */
void gcry_ctx_release (gcry_ctx_t ctx);

/* Log data using Libgcrypt's own log interface.  */
void gcry_log_debug (const(char)* fmt, ...) /*_GCRY_GCC_ATTR_PRINTF(1,2)*/;
void gcry_log_debughex (const(char)* text, const(void)* buffer, usize length);
void gcry_log_debugmpi (const(char)* text, gcry_mpi_t mpi);
void gcry_log_debugpnt (const(char)* text,
                        gcry_mpi_point_t point, gcry_ctx_t ctx);
void gcry_log_debugsxp (const(char)* text, gcry_sexp_t sexp);


/* Log levels used by the internal logging facility. */
alias gcry_log_levels = int;
enum {
  GCRY_LOG_CONT   = 0,    /* (Continue the last log line.) */
  GCRY_LOG_INFO   = 10,
  GCRY_LOG_WARN   = 20,
  GCRY_LOG_ERROR  = 30,
  GCRY_LOG_FATAL  = 40,
  GCRY_LOG_BUG    = 50,
  GCRY_LOG_DEBUG  = 100
}

/* Type for progress handlers.  */
alias gcry_handler_progress_t= void function (void *, const(char)* , int, int, int);

/* Type for memory allocation handlers.  */
alias gcry_handler_alloc_t = void* function (usize n);

/* Type for secure memory check handlers.  */
alias gcry_handler_secure_check_t = int function (const(void)* );

/* Type for memory reallocation handlers.  */
alias gcry_handler_realloc_t = void* function (void *p, usize n);

/* Type for memory free handlers.  */
alias gcry_handler_free_t = void function (void *);

/* Type for out-of-memory handlers.  */
alias gcry_handler_no_mem_t = int function (void *, usize, uint);

/* Type for fatal error handlers.  */
alias gcry_handler_error_t = void function (void *, int, const(char)* );

/* Type for logging handlers.  */
alias gcry_handler_log_t = void function (void *, int, const(char)*, va_list);

/* Certain operations can provide progress information.  This function
   is used to register a handler for retrieving these information. */
void gcry_set_progress_handler (gcry_handler_progress_t cb, void *cb_data);


/* Register a custom memory allocation functions. */
void gcry_set_allocation_handler (
                             gcry_handler_alloc_t func_alloc,
                             gcry_handler_alloc_t func_alloc_secure,
                             gcry_handler_secure_check_t func_secure_check,
                             gcry_handler_realloc_t func_realloc,
                             gcry_handler_free_t func_free);

/* Register a function used instead of the internal out of memory
   handler. */
void gcry_set_outofcore_handler (gcry_handler_no_mem_t h, void *opaque);

/* Register a function used instead of the internal fatal error
   handler. */
void gcry_set_fatalerror_handler (gcry_handler_error_t fnc, void *opaque);

/* Register a function used instead of the internal logging
   facility. */
void gcry_set_log_handler (gcry_handler_log_t f, void *opaque);

/* Reserved for future use. */
void gcry_set_gettext_handler (const(char)* function (const(char)*) f);

/* Libgcrypt uses its own memory allocation.  It is important to use
   gcry_free () to release memory allocated by libgcrypt. */
void *gcry_malloc (usize n) /*_GCRY_GCC_ATTR_MALLOC*/;
void *gcry_calloc (usize n, usize m) /*_GCRY_GCC_ATTR_MALLOC*/;
void *gcry_malloc_secure (usize n) /*_GCRY_GCC_ATTR_MALLOC*/;
void *gcry_calloc_secure (usize n, usize m) /*_GCRY_GCC_ATTR_MALLOC*/;
void *gcry_realloc (void *a, usize n);
char *gcry_strdup (const(char)* string) /*_GCRY_GCC_ATTR_MALLOC*/;
void *gcry_xmalloc (usize n) /*_GCRY_GCC_ATTR_MALLOC*/;
void *gcry_xcalloc (usize n, usize m) /*_GCRY_GCC_ATTR_MALLOC*/;
void *gcry_xmalloc_secure (usize n) /*_GCRY_GCC_ATTR_MALLOC*/;
void *gcry_xcalloc_secure (usize n, usize m) /*_GCRY_GCC_ATTR_MALLOC*/;
void *gcry_xrealloc (void *a, usize n);
char *gcry_xstrdup (const(char)* a) /*_GCRY_GCC_ATTR_MALLOC*/;
void  gcry_free (void *a);

/* Return true if A is allocated in "secure" memory. */
int gcry_is_secure (const(void)* a) /*_GCRY_GCC_ATTR_PURE*/;

/* Return true if Libgcrypt is in FIPS mode.  */
auto gcry_fips_mode_active () { return !!gcry_control(GCRYCTL_FIPS_MODE_P, 0); }