crypto.h
上传用户:szlgq88
上传日期:2009-04-28
资源大小:48287k
文件大小:13k
源码类别:

嵌入式Linux

开发平台:

Unix_Linux

  1. /*
  2.  * Scatterlist Cryptographic API.
  3.  *
  4.  * Copyright (c) 2002 James Morris <jmorris@intercode.com.au>
  5.  * Copyright (c) 2002 David S. Miller (davem@redhat.com)
  6.  *
  7.  * Portions derived from Cryptoapi, by Alexander Kjeldaas <astor@fast.no>
  8.  * and Nettle, by Niels M鰈ler.
  9.  * 
  10.  * This program is free software; you can redistribute it and/or modify it
  11.  * under the terms of the GNU General Public License as published by the Free
  12.  * Software Foundation; either version 2 of the License, or (at your option) 
  13.  * any later version.
  14.  *
  15.  */
  16. #ifndef _LINUX_CRYPTO_H
  17. #define _LINUX_CRYPTO_H
  18. #include <linux/config.h>
  19. #include <linux/module.h>
  20. #include <linux/kernel.h>
  21. #include <linux/types.h>
  22. #include <linux/list.h>
  23. #include <linux/string.h>
  24. #include <asm/page.h>
  25. /*
  26.  * Algorithm masks and types.
  27.  */
  28. #define CRYPTO_ALG_TYPE_MASK 0x000000ff
  29. #define CRYPTO_ALG_TYPE_CIPHER 0x00000001
  30. #define CRYPTO_ALG_TYPE_DIGEST 0x00000002
  31. #define CRYPTO_ALG_TYPE_COMPRESS 0x00000004
  32. /*
  33.  * Transform masks and values (for crt_flags).
  34.  */
  35. #define CRYPTO_TFM_MODE_MASK 0x000000ff
  36. #define CRYPTO_TFM_REQ_MASK 0x000fff00
  37. #define CRYPTO_TFM_RES_MASK 0xfff00000
  38. #define CRYPTO_TFM_MODE_ECB 0x00000001
  39. #define CRYPTO_TFM_MODE_CBC 0x00000002
  40. #define CRYPTO_TFM_MODE_CFB 0x00000004
  41. #define CRYPTO_TFM_MODE_CTR 0x00000008
  42. #define CRYPTO_TFM_REQ_WEAK_KEY 0x00000100
  43. #define CRYPTO_TFM_REQ_MAY_SLEEP 0x00000200
  44. #define CRYPTO_TFM_RES_WEAK_KEY 0x00100000
  45. #define CRYPTO_TFM_RES_BAD_KEY_LEN    0x00200000
  46. #define CRYPTO_TFM_RES_BAD_KEY_SCHED  0x00400000
  47. #define CRYPTO_TFM_RES_BAD_BLOCK_LEN  0x00800000
  48. #define CRYPTO_TFM_RES_BAD_FLAGS  0x01000000
  49. /*
  50.  * Miscellaneous stuff.
  51.  */
  52. #define CRYPTO_UNSPEC 0
  53. #define CRYPTO_MAX_ALG_NAME 64
  54. #define CRYPTO_DIR_ENCRYPT 1
  55. #define CRYPTO_DIR_DECRYPT 0
  56. struct scatterlist;
  57. struct crypto_tfm;
  58. struct cipher_desc {
  59. struct crypto_tfm *tfm;
  60. void (*crfn)(void *ctx, u8 *dst, const u8 *src);
  61. unsigned int (*prfn)(const struct cipher_desc *desc, u8 *dst,
  62.      const u8 *src, unsigned int nbytes);
  63. void *info;
  64. };
  65. /*
  66.  * Algorithms: modular crypto algorithm implementations, managed
  67.  * via crypto_register_alg() and crypto_unregister_alg().
  68.  */
  69. struct cipher_alg {
  70. unsigned int cia_min_keysize;
  71. unsigned int cia_max_keysize;
  72. int (*cia_setkey)(void *ctx, const u8 *key,
  73.                   unsigned int keylen, u32 *flags);
  74. void (*cia_encrypt)(void *ctx, u8 *dst, const u8 *src);
  75. void (*cia_decrypt)(void *ctx, u8 *dst, const u8 *src);
  76. unsigned int (*cia_encrypt_ecb)(const struct cipher_desc *desc,
  77. u8 *dst, const u8 *src,
  78. unsigned int nbytes);
  79. unsigned int (*cia_decrypt_ecb)(const struct cipher_desc *desc,
  80. u8 *dst, const u8 *src,
  81. unsigned int nbytes);
  82. unsigned int (*cia_encrypt_cbc)(const struct cipher_desc *desc,
  83. u8 *dst, const u8 *src,
  84. unsigned int nbytes);
  85. unsigned int (*cia_decrypt_cbc)(const struct cipher_desc *desc,
  86. u8 *dst, const u8 *src,
  87. unsigned int nbytes);
  88. };
  89. struct digest_alg {
  90. unsigned int dia_digestsize;
  91. void (*dia_init)(void *ctx);
  92. void (*dia_update)(void *ctx, const u8 *data, unsigned int len);
  93. void (*dia_final)(void *ctx, u8 *out);
  94. int (*dia_setkey)(void *ctx, const u8 *key,
  95.                   unsigned int keylen, u32 *flags);
  96. };
  97. struct compress_alg {
  98. int (*coa_init)(void *ctx);
  99. void (*coa_exit)(void *ctx);
  100. int (*coa_compress)(void *ctx, const u8 *src, unsigned int slen,
  101.                     u8 *dst, unsigned int *dlen);
  102. int (*coa_decompress)(void *ctx, const u8 *src, unsigned int slen,
  103.                       u8 *dst, unsigned int *dlen);
  104. };
  105. #define cra_cipher cra_u.cipher
  106. #define cra_digest cra_u.digest
  107. #define cra_compress cra_u.compress
  108. struct crypto_alg {
  109. struct list_head cra_list;
  110. u32 cra_flags;
  111. unsigned int cra_blocksize;
  112. unsigned int cra_ctxsize;
  113. unsigned int cra_alignmask;
  114. const char cra_name[CRYPTO_MAX_ALG_NAME];
  115. union {
  116. struct cipher_alg cipher;
  117. struct digest_alg digest;
  118. struct compress_alg compress;
  119. } cra_u;
  120. struct module *cra_module;
  121. };
  122. /*
  123.  * Algorithm registration interface.
  124.  */
  125. int crypto_register_alg(struct crypto_alg *alg);
  126. int crypto_unregister_alg(struct crypto_alg *alg);
  127. /*
  128.  * Algorithm query interface.
  129.  */
  130. #ifdef CONFIG_CRYPTO
  131. int crypto_alg_available(const char *name, u32 flags);
  132. #else
  133. static inline int crypto_alg_available(const char *name, u32 flags)
  134. {
  135. return 0;
  136. }
  137. #endif
  138. /*
  139.  * Transforms: user-instantiated objects which encapsulate algorithms
  140.  * and core processing logic.  Managed via crypto_alloc_tfm() and
  141.  * crypto_free_tfm(), as well as the various helpers below.
  142.  */
  143. struct cipher_tfm {
  144. void *cit_iv;
  145. unsigned int cit_ivsize;
  146. u32 cit_mode;
  147. int (*cit_setkey)(struct crypto_tfm *tfm,
  148.                   const u8 *key, unsigned int keylen);
  149. int (*cit_encrypt)(struct crypto_tfm *tfm,
  150.    struct scatterlist *dst,
  151.    struct scatterlist *src,
  152.    unsigned int nbytes);
  153. int (*cit_encrypt_iv)(struct crypto_tfm *tfm,
  154.                       struct scatterlist *dst,
  155.                       struct scatterlist *src,
  156.                       unsigned int nbytes, u8 *iv);
  157. int (*cit_decrypt)(struct crypto_tfm *tfm,
  158.    struct scatterlist *dst,
  159.    struct scatterlist *src,
  160.    unsigned int nbytes);
  161. int (*cit_decrypt_iv)(struct crypto_tfm *tfm,
  162.    struct scatterlist *dst,
  163.    struct scatterlist *src,
  164.    unsigned int nbytes, u8 *iv);
  165. void (*cit_xor_block)(u8 *dst, const u8 *src);
  166. };
  167. struct digest_tfm {
  168. void (*dit_init)(struct crypto_tfm *tfm);
  169. void (*dit_update)(struct crypto_tfm *tfm,
  170.                    struct scatterlist *sg, unsigned int nsg);
  171. void (*dit_final)(struct crypto_tfm *tfm, u8 *out);
  172. void (*dit_digest)(struct crypto_tfm *tfm, struct scatterlist *sg,
  173.                    unsigned int nsg, u8 *out);
  174. int (*dit_setkey)(struct crypto_tfm *tfm,
  175.                   const u8 *key, unsigned int keylen);
  176. #ifdef CONFIG_CRYPTO_HMAC
  177. void *dit_hmac_block;
  178. #endif
  179. };
  180. struct compress_tfm {
  181. int (*cot_compress)(struct crypto_tfm *tfm,
  182.                     const u8 *src, unsigned int slen,
  183.                     u8 *dst, unsigned int *dlen);
  184. int (*cot_decompress)(struct crypto_tfm *tfm,
  185.                       const u8 *src, unsigned int slen,
  186.                       u8 *dst, unsigned int *dlen);
  187. };
  188. #define crt_cipher crt_u.cipher
  189. #define crt_digest crt_u.digest
  190. #define crt_compress crt_u.compress
  191. struct crypto_tfm {
  192. u32 crt_flags;
  193. union {
  194. struct cipher_tfm cipher;
  195. struct digest_tfm digest;
  196. struct compress_tfm compress;
  197. } crt_u;
  198. struct crypto_alg *__crt_alg;
  199. };
  200. /* 
  201.  * Transform user interface.
  202.  */
  203.  
  204. /*
  205.  * crypto_alloc_tfm() will first attempt to locate an already loaded algorithm.
  206.  * If that fails and the kernel supports dynamically loadable modules, it
  207.  * will then attempt to load a module of the same name or alias.  A refcount
  208.  * is grabbed on the algorithm which is then associated with the new transform.
  209.  *
  210.  * crypto_free_tfm() frees up the transform and any associated resources,
  211.  * then drops the refcount on the associated algorithm.
  212.  */
  213. struct crypto_tfm *crypto_alloc_tfm(const char *alg_name, u32 tfm_flags);
  214. void crypto_free_tfm(struct crypto_tfm *tfm);
  215. /*
  216.  * Transform helpers which query the underlying algorithm.
  217.  */
  218. static inline const char *crypto_tfm_alg_name(struct crypto_tfm *tfm)
  219. {
  220. return tfm->__crt_alg->cra_name;
  221. }
  222. static inline const char *crypto_tfm_alg_modname(struct crypto_tfm *tfm)
  223. {
  224. return module_name(tfm->__crt_alg->cra_module);
  225. }
  226. static inline u32 crypto_tfm_alg_type(struct crypto_tfm *tfm)
  227. {
  228. return tfm->__crt_alg->cra_flags & CRYPTO_ALG_TYPE_MASK;
  229. }
  230. static inline unsigned int crypto_tfm_alg_min_keysize(struct crypto_tfm *tfm)
  231. {
  232. BUG_ON(crypto_tfm_alg_type(tfm) != CRYPTO_ALG_TYPE_CIPHER);
  233. return tfm->__crt_alg->cra_cipher.cia_min_keysize;
  234. }
  235. static inline unsigned int crypto_tfm_alg_max_keysize(struct crypto_tfm *tfm)
  236. {
  237. BUG_ON(crypto_tfm_alg_type(tfm) != CRYPTO_ALG_TYPE_CIPHER);
  238. return tfm->__crt_alg->cra_cipher.cia_max_keysize;
  239. }
  240. static inline unsigned int crypto_tfm_alg_ivsize(struct crypto_tfm *tfm)
  241. {
  242. BUG_ON(crypto_tfm_alg_type(tfm) != CRYPTO_ALG_TYPE_CIPHER);
  243. return tfm->crt_cipher.cit_ivsize;
  244. }
  245. static inline unsigned int crypto_tfm_alg_blocksize(struct crypto_tfm *tfm)
  246. {
  247. return tfm->__crt_alg->cra_blocksize;
  248. }
  249. static inline unsigned int crypto_tfm_alg_digestsize(struct crypto_tfm *tfm)
  250. {
  251. BUG_ON(crypto_tfm_alg_type(tfm) != CRYPTO_ALG_TYPE_DIGEST);
  252. return tfm->__crt_alg->cra_digest.dia_digestsize;
  253. }
  254. static inline unsigned int crypto_tfm_alg_alignmask(struct crypto_tfm *tfm)
  255. {
  256. return tfm->__crt_alg->cra_alignmask;
  257. }
  258. static inline void *crypto_tfm_ctx(struct crypto_tfm *tfm)
  259. {
  260. return (void *)&tfm[1];
  261. }
  262. /*
  263.  * API wrappers.
  264.  */
  265. static inline void crypto_digest_init(struct crypto_tfm *tfm)
  266. {
  267. BUG_ON(crypto_tfm_alg_type(tfm) != CRYPTO_ALG_TYPE_DIGEST);
  268. tfm->crt_digest.dit_init(tfm);
  269. }
  270. static inline void crypto_digest_update(struct crypto_tfm *tfm,
  271.                                         struct scatterlist *sg,
  272.                                         unsigned int nsg)
  273. {
  274. BUG_ON(crypto_tfm_alg_type(tfm) != CRYPTO_ALG_TYPE_DIGEST);
  275. tfm->crt_digest.dit_update(tfm, sg, nsg);
  276. }
  277. static inline void crypto_digest_final(struct crypto_tfm *tfm, u8 *out)
  278. {
  279. BUG_ON(crypto_tfm_alg_type(tfm) != CRYPTO_ALG_TYPE_DIGEST);
  280. tfm->crt_digest.dit_final(tfm, out);
  281. }
  282. static inline void crypto_digest_digest(struct crypto_tfm *tfm,
  283.                                         struct scatterlist *sg,
  284.                                         unsigned int nsg, u8 *out)
  285. {
  286. BUG_ON(crypto_tfm_alg_type(tfm) != CRYPTO_ALG_TYPE_DIGEST);
  287. tfm->crt_digest.dit_digest(tfm, sg, nsg, out);
  288. }
  289. static inline int crypto_digest_setkey(struct crypto_tfm *tfm,
  290.                                        const u8 *key, unsigned int keylen)
  291. {
  292. BUG_ON(crypto_tfm_alg_type(tfm) != CRYPTO_ALG_TYPE_DIGEST);
  293. if (tfm->crt_digest.dit_setkey == NULL)
  294. return -ENOSYS;
  295. return tfm->crt_digest.dit_setkey(tfm, key, keylen);
  296. }
  297. static inline int crypto_cipher_setkey(struct crypto_tfm *tfm,
  298.                                        const u8 *key, unsigned int keylen)
  299. {
  300. BUG_ON(crypto_tfm_alg_type(tfm) != CRYPTO_ALG_TYPE_CIPHER);
  301. return tfm->crt_cipher.cit_setkey(tfm, key, keylen);
  302. }
  303. static inline int crypto_cipher_encrypt(struct crypto_tfm *tfm,
  304.                                         struct scatterlist *dst,
  305.                                         struct scatterlist *src,
  306.                                         unsigned int nbytes)
  307. {
  308. BUG_ON(crypto_tfm_alg_type(tfm) != CRYPTO_ALG_TYPE_CIPHER);
  309. return tfm->crt_cipher.cit_encrypt(tfm, dst, src, nbytes);
  310. }                                        
  311. static inline int crypto_cipher_encrypt_iv(struct crypto_tfm *tfm,
  312.                                            struct scatterlist *dst,
  313.                                            struct scatterlist *src,
  314.                                            unsigned int nbytes, u8 *iv)
  315. {
  316. BUG_ON(crypto_tfm_alg_type(tfm) != CRYPTO_ALG_TYPE_CIPHER);
  317. BUG_ON(tfm->crt_cipher.cit_mode == CRYPTO_TFM_MODE_ECB);
  318. return tfm->crt_cipher.cit_encrypt_iv(tfm, dst, src, nbytes, iv);
  319. }                                        
  320. static inline int crypto_cipher_decrypt(struct crypto_tfm *tfm,
  321.                                         struct scatterlist *dst,
  322.                                         struct scatterlist *src,
  323.                                         unsigned int nbytes)
  324. {
  325. BUG_ON(crypto_tfm_alg_type(tfm) != CRYPTO_ALG_TYPE_CIPHER);
  326. return tfm->crt_cipher.cit_decrypt(tfm, dst, src, nbytes);
  327. }
  328. static inline int crypto_cipher_decrypt_iv(struct crypto_tfm *tfm,
  329.                                            struct scatterlist *dst,
  330.                                            struct scatterlist *src,
  331.                                            unsigned int nbytes, u8 *iv)
  332. {
  333. BUG_ON(crypto_tfm_alg_type(tfm) != CRYPTO_ALG_TYPE_CIPHER);
  334. BUG_ON(tfm->crt_cipher.cit_mode == CRYPTO_TFM_MODE_ECB);
  335. return tfm->crt_cipher.cit_decrypt_iv(tfm, dst, src, nbytes, iv);
  336. }
  337. static inline void crypto_cipher_set_iv(struct crypto_tfm *tfm,
  338.                                         const u8 *src, unsigned int len)
  339. {
  340. BUG_ON(crypto_tfm_alg_type(tfm) != CRYPTO_ALG_TYPE_CIPHER);
  341. memcpy(tfm->crt_cipher.cit_iv, src, len);
  342. }
  343. static inline void crypto_cipher_get_iv(struct crypto_tfm *tfm,
  344.                                         u8 *dst, unsigned int len)
  345. {
  346. BUG_ON(crypto_tfm_alg_type(tfm) != CRYPTO_ALG_TYPE_CIPHER);
  347. memcpy(dst, tfm->crt_cipher.cit_iv, len);
  348. }
  349. static inline int crypto_comp_compress(struct crypto_tfm *tfm,
  350.                                        const u8 *src, unsigned int slen,
  351.                                        u8 *dst, unsigned int *dlen)
  352. {
  353. BUG_ON(crypto_tfm_alg_type(tfm) != CRYPTO_ALG_TYPE_COMPRESS);
  354. return tfm->crt_compress.cot_compress(tfm, src, slen, dst, dlen);
  355. }
  356. static inline int crypto_comp_decompress(struct crypto_tfm *tfm,
  357.                                          const u8 *src, unsigned int slen,
  358.                                          u8 *dst, unsigned int *dlen)
  359. {
  360. BUG_ON(crypto_tfm_alg_type(tfm) != CRYPTO_ALG_TYPE_COMPRESS);
  361. return tfm->crt_compress.cot_decompress(tfm, src, slen, dst, dlen);
  362. }
  363. /*
  364.  * HMAC support.
  365.  */
  366. #ifdef CONFIG_CRYPTO_HMAC
  367. void crypto_hmac_init(struct crypto_tfm *tfm, u8 *key, unsigned int *keylen);
  368. void crypto_hmac_update(struct crypto_tfm *tfm,
  369.                         struct scatterlist *sg, unsigned int nsg);
  370. void crypto_hmac_final(struct crypto_tfm *tfm, u8 *key,
  371.                        unsigned int *keylen, u8 *out);
  372. void crypto_hmac(struct crypto_tfm *tfm, u8 *key, unsigned int *keylen,
  373.                  struct scatterlist *sg, unsigned int nsg, u8 *out);
  374. #endif /* CONFIG_CRYPTO_HMAC */
  375. #endif /* _LINUX_CRYPTO_H */