home *** CD-ROM | disk | FTP | other *** search
/ Chip 2004 November / CMCD1104.ISO / Software / Complet / Apache / apache_2.0.52-win32-x86-no_ssl.msi / Data.Cab / F277214_apr_md4.h < prev    next >
C/C++ Source or Header  |  2004-02-13  |  4KB  |  135 lines
  1. /* Copyright 2001-2004 The Apache Software Foundation
  2.  *
  3.  * Licensed under the Apache License, Version 2.0 (the "License");
  4.  * you may not use this file except in compliance with the License.
  5.  * You may obtain a copy of the License at
  6.  *
  7.  *     http://www.apache.org/licenses/LICENSE-2.0
  8.  *
  9.  * Unless required by applicable law or agreed to in writing, software
  10.  * distributed under the License is distributed on an "AS IS" BASIS,
  11.  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  12.  * See the License for the specific language governing permissions and
  13.  * limitations under the License.
  14.  */
  15. /* This is derived from material copyright RSA Data Security, Inc.
  16.  * Their notice is reproduced below in its entirety.
  17.  *
  18.  * Copyright (C) 1991-2, RSA Data Security, Inc. Created 1991. All
  19.  * rights reserved.
  20.  *
  21.  * License to copy and use this software is granted provided that it
  22.  * is identified as the "RSA Data Security, Inc. MD4 Message-Digest
  23.  * Algorithm" in all material mentioning or referencing this software
  24.  * or this function.
  25.  *
  26.  * License is also granted to make and use derivative works provided
  27.  * that such works are identified as "derived from the RSA Data
  28.  * Security, Inc. MD4 Message-Digest Algorithm" in all material
  29.  * mentioning or referencing the derived work.
  30.  *
  31.  * RSA Data Security, Inc. makes no representations concerning either
  32.  * the merchantability of this software or the suitability of this
  33.  * software for any particular purpose. It is provided "as is"
  34.  * without express or implied warranty of any kind.
  35.  *
  36.  * These notices must be retained in any copies of any part of this
  37.  * documentation and/or software.
  38.  */
  39.  
  40. #ifndef APR_MD4_H
  41. #define APR_MD4_H
  42.  
  43. #include "apu.h"
  44. #include "apr_xlate.h"
  45. /**
  46.  * @file apr_md4.h
  47.  * @brief APR-UTIL MD4 Library
  48.  */
  49. #ifdef __cplusplus
  50. extern "C" {
  51. #endif
  52.  
  53. /**
  54.  * @defgroup APR_Util_MD4 MD4 Library
  55.  * @ingroup APR_Util
  56.  * @{
  57.  */
  58.  
  59. /** The digestsize for MD4 */
  60. #define APR_MD4_DIGESTSIZE 16
  61.  
  62. /** @see apr_md4_ctx_t */
  63. typedef struct apr_md4_ctx_t apr_md4_ctx_t;
  64.  
  65. /** MD4 context. */
  66. struct apr_md4_ctx_t {
  67.     /** state (ABCD) */
  68.     apr_uint32_t state[4];
  69.     /** number of bits, modulo 2^64 (lsb first) */
  70.     apr_uint32_t count[2];
  71.     /** input buffer */
  72.     unsigned char buffer[64];
  73. #if APR_HAS_XLATE
  74.     /** translation handle */
  75.     apr_xlate_t *xlate;
  76. #endif
  77. };
  78.  
  79. /**
  80.  * MD4 Initialize.  Begins an MD4 operation, writing a new context.
  81.  * @param context The MD4 context to initialize.
  82.  */
  83. APU_DECLARE(apr_status_t) apr_md4_init(apr_md4_ctx_t *context);
  84.  
  85. #if APR_HAS_XLATE
  86. /**
  87.  * MDr4 translation setup.  Provides the APR translation handle to be used 
  88.  * for translating the content before calculating the digest.
  89.  * @param context The MD4 content to set the translation for.
  90.  * @param xlate The translation handle to use for this MD4 context 
  91.  */
  92. APU_DECLARE(apr_status_t) apr_md4_set_xlate(apr_md4_ctx_t *context,
  93.                                             apr_xlate_t *xlate);
  94. #else
  95. #define apr_md4_set_xlate(context, xlate) APR_ENOTIMPL
  96. #endif
  97.  
  98. /**
  99.  * MD4 block update operation.  Continue an MD4 message-digest operation, 
  100.  * processing another message block, and updating the context.
  101.  * @param context The MD4 content to update.
  102.  * @param input next message block to update
  103.  * @param inputLen The length of the next message block
  104.  */
  105. APU_DECLARE(apr_status_t) apr_md4_update(apr_md4_ctx_t *context,
  106.                                          const unsigned char *input,
  107.                                          apr_size_t inputLen);
  108.  
  109. /**
  110.  * MD4 finalization.  Ends an MD4 message-digest operation, writing the 
  111.  * message digest and zeroing the context
  112.  * @param digest The final MD4 digest
  113.  * @param context The MD4 content we are finalizing.
  114.  */
  115. APU_DECLARE(apr_status_t) apr_md4_final(
  116.                                     unsigned char digest[APR_MD4_DIGESTSIZE],
  117.                                     apr_md4_ctx_t *context);
  118.  
  119. /**
  120.  * MD4 digest computation
  121.  * @param digest The MD4 digest
  122.  * @param input message block to use
  123.  * @param inputLen The length of the message block
  124.  */
  125. APU_DECLARE(apr_status_t) apr_md4(unsigned char digest[APR_MD4_DIGESTSIZE],
  126.                                   const unsigned char *input,
  127.                                   apr_size_t inputLen);
  128.  
  129. /** @} */
  130. #ifdef __cplusplus
  131. }
  132. #endif
  133.  
  134. #endif /* !APR_MD4_H */
  135.