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

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 _PQGUTIL_H_
  34. #define _PQGUTIL_H_ 1
  35. #include "blapi.h"
  36. /**************************************************************************
  37.  *  Return a pointer to a new PQGParams struct that is a duplicate of     *
  38.  *  the one passed as an argument.                                        *
  39.  *  Return NULL on failure, or if NULL was passed in.                     *
  40.  **************************************************************************/
  41. extern PQGParams * PQG_DupParams(const PQGParams *src);
  42. /**************************************************************************
  43.  *  Return a pointer to a new PQGParams struct that is constructed from   *
  44.  *  copies of the arguments passed in.                                    *
  45.  *  Return NULL on failure.                                               *
  46.  **************************************************************************/
  47. extern PQGParams * PQG_NewParams(const SECItem * prime, 
  48.                                  const SECItem * subPrime, 
  49.                                  const SECItem * base);
  50. /**************************************************************************
  51.  * Fills in caller's "prime" SECItem with the prime value in params.
  52.  * Contents can be freed by calling SECITEM_FreeItem(prime, PR_FALSE);
  53.  **************************************************************************/
  54. extern SECStatus PQG_GetPrimeFromParams(const PQGParams *params, 
  55.                                         SECItem * prime);
  56. /**************************************************************************
  57.  * Fills in caller's "subPrime" SECItem with the prime value in params.
  58.  * Contents can be freed by calling SECITEM_FreeItem(subPrime, PR_FALSE);
  59.  **************************************************************************/
  60. extern SECStatus PQG_GetSubPrimeFromParams(const PQGParams *params, 
  61.                                            SECItem * subPrime);
  62. /**************************************************************************
  63.  * Fills in caller's "base" SECItem with the base value in params.
  64.  * Contents can be freed by calling SECITEM_FreeItem(base, PR_FALSE);
  65.  **************************************************************************/
  66. extern SECStatus PQG_GetBaseFromParams(const PQGParams *params, SECItem *base);
  67. /**************************************************************************
  68.  *  Free the PQGParams struct and the things it points to.                *
  69.  **************************************************************************/
  70. extern void PQG_DestroyParams(PQGParams *params);
  71. /**************************************************************************
  72.  *  Return a pointer to a new PQGVerify struct that is a duplicate of     *
  73.  *  the one passed as an argument.                                        *
  74.  *  Return NULL on failure, or if NULL was passed in.                     *
  75.  **************************************************************************/
  76. extern PQGVerify * PQG_DupVerify(const PQGVerify *src);
  77. /**************************************************************************
  78.  *  Return a pointer to a new PQGVerify struct that is constructed from   *
  79.  *  copies of the arguments passed in.                                    *
  80.  *  Return NULL on failure.                                               *
  81.  **************************************************************************/
  82. extern PQGVerify * PQG_NewVerify(unsigned int counter, const SECItem * seed, 
  83.                                  const SECItem * h);
  84. /**************************************************************************
  85.  * Returns "counter" value from the PQGVerify.
  86.  **************************************************************************/
  87. extern unsigned int PQG_GetCounterFromVerify(const PQGVerify *verify);
  88. /**************************************************************************
  89.  * Fills in caller's "seed" SECItem with the seed value in verify.
  90.  * Contents can be freed by calling SECITEM_FreeItem(seed, PR_FALSE);
  91.  **************************************************************************/
  92. extern SECStatus PQG_GetSeedFromVerify(const PQGVerify *verify, SECItem *seed);
  93. /**************************************************************************
  94.  * Fills in caller's "h" SECItem with the h value in verify.
  95.  * Contents can be freed by calling SECITEM_FreeItem(h, PR_FALSE);
  96.  **************************************************************************/
  97. extern SECStatus PQG_GetHFromVerify(const PQGVerify *verify, SECItem * h);
  98. /**************************************************************************
  99.  *  Free the PQGVerify struct and the things it points to.                *
  100.  **************************************************************************/
  101. extern void PQG_DestroyVerify(PQGVerify *vfy);
  102. #endif