alghmac.h
上传用户:lyxiangda
上传日期:2007-01-12
资源大小:3042k
文件大小:3k
源码类别:

CA认证

开发平台:

WINDOWS

  1. /*
  2.  * The contents of this file are subject to the Mozilla Public
  3.  * License Version 1.1 (the "License"); you may not use this file
  4.  * except in compliance with the License. You may obtain a copy of
  5.  * the License at http://www.mozilla.org/MPL/
  6.  * 
  7.  * Software distributed under the License is distributed on an "AS
  8.  * IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or
  9.  * implied. See the License for the specific language governing
  10.  * rights and limitations under the License.
  11.  * 
  12.  * The Original Code is the Netscape security libraries.
  13.  * 
  14.  * The Initial Developer of the Original Code is Netscape
  15.  * Communications Corporation.  Portions created by Netscape are 
  16.  * Copyright (C) 1994-2000 Netscape Communications Corporation.  All
  17.  * Rights Reserved.
  18.  * 
  19.  * Contributor(s):
  20.  * 
  21.  * Alternatively, the contents of this file may be used under the
  22.  * terms of the GNU General Public License Version 2 or later (the
  23.  * "GPL"), in which case the provisions of the GPL are applicable 
  24.  * instead of those above.  If you wish to allow use of your 
  25.  * version of this file only under the terms of the GPL and not to
  26.  * allow others to use your version of this file under the MPL,
  27.  * indicate your decision by deleting the provisions above and
  28.  * replace them with the notice and other provisions required by
  29.  * the GPL.  If you do not delete the provisions above, a recipient
  30.  * may use your version of this file under either the MPL or the
  31.  * GPL.
  32.  */
  33. #ifndef _ALGHMAC_H_
  34. #define _ALGHMAC_H_
  35. #include "secoid.h"
  36. typedef struct HMACContextStr HMACContext;
  37. SEC_BEGIN_PROTOS
  38. /* destroy HMAC context */
  39. extern void
  40. HMAC_Destroy(HMACContext *cx);
  41. /* create HMAC context
  42.  *  hash_alg the algorithm with which the HMAC is performed.  This 
  43.  * should be, SEC_OID_MD5, SEC_OID_SHA1, or SEC_OID_MD2.
  44.  *  secret the secret with which the HMAC is performed.
  45.  *  secret_len the length of the secret, limited to at most 64 bytes.
  46.  *
  47.  * NULL is returned if an error occurs or the secret is > 64 bytes.
  48.  */
  49. extern HMACContext *
  50. HMAC_Create(SECOidTag hash_alg, const unsigned char *secret, 
  51.     unsigned int secret_len);
  52. /* reset HMAC for a fresh round */
  53. extern void
  54. HMAC_Begin(HMACContext *cx);
  55. /* update HMAC 
  56.  *  cx HMAC Context
  57.  *  data the data to perform HMAC on
  58.  *  data_len the length of the data to process
  59.  */
  60. extern void 
  61. HMAC_Update(HMACContext *cx, const unsigned char *data, unsigned int data_len);
  62. /* Finish HMAC -- place the results within result
  63.  *  cx HMAC context
  64.  *  result buffer for resulting hmac'd data
  65.  *  result_len where the resultant hmac length is stored
  66.  *  max_result_len  maximum possible length that can be stored in result
  67.  */
  68. extern SECStatus
  69. HMAC_Finish(HMACContext *cx, unsigned char *result, unsigned int *result_len,
  70.     unsigned int max_result_len);
  71. /* clone a copy of the HMAC state.  this is usefult when you would
  72.  * need to keep a running hmac but also need to extract portions 
  73.  * partway through the process.
  74.  */
  75. extern HMACContext *
  76. HMAC_Clone(HMACContext *cx);
  77. SEC_END_PROTOS
  78. #endif