ckdbm.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. #ifdef DEBUG
  34. static const char CKDBM_CVS_ID[] = "@(#) $RCSfile: ckdbm.h,v $ $Revision: 1.1 $ $Date: 2000/05/15 20:39:54 $ $Name: NSS_3_1_1_RTM $";
  35. #endif /* DEBUG */
  36. #ifndef CKDBM_H
  37. #define CKDBM_H
  38. #include "nssckmdt.h"
  39. #include "nssckfw.h"
  40. /*
  41.  * I'm including this for access to the arena functions.
  42.  * Looks like we should publish that API.
  43.  */
  44. #ifndef BASE_H
  45. #include "base.h"
  46. #endif /* BASE_H */
  47. /*
  48.  * This is where the Netscape extensions live, at least for now.
  49.  */
  50. #ifndef CKT_H
  51. #include "ckt.h"
  52. #endif /* CKT_H */
  53. #include "mcom_db.h"
  54. NSS_EXTERN_DATA NSSCKMDInstance nss_dbm_mdInstance;
  55. typedef struct nss_dbm_db_struct nss_dbm_db_t;
  56. struct nss_dbm_db_struct {
  57.   DB *db;
  58.   NSSCKFWMutex *crustylock;
  59. };
  60. typedef struct nss_dbm_dbt_struct nss_dbm_dbt_t;
  61. struct nss_dbm_dbt_struct {
  62.   DBT dbt;
  63.   nss_dbm_db_t *my_db;
  64. };
  65. typedef struct nss_dbm_instance_struct nss_dbm_instance_t;
  66. struct nss_dbm_instance_struct {
  67.   NSSArena *arena;
  68.   CK_ULONG nSlots;
  69.   char **filenames;
  70.   int *flags; /* e.g. O_RDONLY, O_RDWR */
  71. };
  72. typedef struct nss_dbm_slot_struct nss_dbm_slot_t;
  73. struct nss_dbm_slot_struct {
  74.   nss_dbm_instance_t *instance;
  75.   char *filename;
  76.   int flags;
  77.   nss_dbm_db_t *token_db;
  78. };
  79. typedef struct nss_dbm_token_struct nss_dbm_token_t;
  80. struct nss_dbm_token_struct {
  81.   NSSArena *arena;
  82.   nss_dbm_slot_t *slot;
  83.   nss_dbm_db_t *session_db;
  84.   NSSUTF8 *label;
  85. };
  86. struct nss_dbm_dbt_node {
  87.   struct nss_dbm_dbt_node *next;
  88.   nss_dbm_dbt_t *dbt;
  89. };
  90. typedef struct nss_dbm_session_struct nss_dbm_session_t;
  91. struct nss_dbm_session_struct {
  92.   NSSArena *arena;
  93.   nss_dbm_token_t *token;
  94.   CK_ULONG deviceError;
  95.   struct nss_dbm_dbt_node *session_objects;
  96.   NSSCKFWMutex *list_lock;
  97. };
  98. typedef struct nss_dbm_object_struct nss_dbm_object_t;
  99. struct nss_dbm_object_struct {
  100.   NSSArena *arena; /* token or session */
  101.   nss_dbm_dbt_t *handle;
  102. };
  103. typedef struct nss_dbm_find_struct nss_dbm_find_t;
  104. struct nss_dbm_find_struct {
  105.   NSSArena *arena;
  106.   struct nss_dbm_dbt_node *found;
  107.   NSSCKFWMutex *list_lock;
  108. };
  109. NSS_EXTERN NSSCKMDSlot *
  110. nss_dbm_mdSlot_factory
  111. (
  112.   nss_dbm_instance_t *instance,
  113.   char *filename,
  114.   int flags,
  115.   CK_RV *pError
  116. );
  117. NSS_EXTERN NSSCKMDToken *
  118. nss_dbm_mdToken_factory
  119. (
  120.   nss_dbm_slot_t *slot,
  121.   CK_RV *pError
  122. );
  123. NSS_EXTERN NSSCKMDSession *
  124. nss_dbm_mdSession_factory
  125. (
  126.   nss_dbm_token_t *token,
  127.   NSSCKFWSession *fwSession,
  128.   NSSCKFWInstance *fwInstance,
  129.   CK_BBOOL rw,
  130.   CK_RV *pError
  131. );
  132. NSS_EXTERN NSSCKMDObject *
  133. nss_dbm_mdObject_factory
  134. (
  135.   nss_dbm_object_t *object,
  136.   CK_RV *pError
  137. );
  138. NSS_EXTERN NSSCKMDFindObjects *
  139. nss_dbm_mdFindObjects_factory
  140. (
  141.   nss_dbm_find_t *find,
  142.   CK_RV *pError
  143. );
  144. NSS_EXTERN nss_dbm_db_t *
  145. nss_dbm_db_open
  146. (
  147.   NSSArena *arena,
  148.   NSSCKFWInstance *fwInstance,
  149.   char *filename,
  150.   int flags,
  151.   CK_RV *pError
  152. );
  153. NSS_EXTERN void
  154. nss_dbm_db_close
  155. (
  156.   nss_dbm_db_t *db
  157. );
  158. NSS_EXTERN CK_VERSION
  159. nss_dbm_db_get_format_version
  160. (
  161.   nss_dbm_db_t *db
  162. );
  163. NSS_EXTERN CK_RV
  164. nss_dbm_db_set_label
  165. (
  166.   nss_dbm_db_t *db,
  167.   NSSUTF8 *label
  168. );
  169. NSS_EXTERN NSSUTF8 *
  170. nss_dbm_db_get_label
  171. (
  172.   nss_dbm_db_t *db,
  173.   NSSArena *arena,
  174.   CK_RV *pError
  175. );
  176. NSS_EXTERN CK_RV
  177. nss_dbm_db_delete_object
  178. (
  179.   nss_dbm_dbt_t *dbt
  180. );
  181. NSS_EXTERN nss_dbm_dbt_t *
  182. nss_dbm_db_create_object
  183. (
  184.   NSSArena *arena,
  185.   nss_dbm_db_t *db,
  186.   CK_ATTRIBUTE_PTR pTemplate,
  187.   CK_ULONG ulAttributeCount,
  188.   CK_RV *pError,
  189.   CK_ULONG *pdbrv
  190. );
  191. NSS_EXTERN CK_RV
  192. nss_dbm_db_find_objects
  193. (
  194.   nss_dbm_find_t *find,
  195.   nss_dbm_db_t *db,
  196.   CK_ATTRIBUTE_PTR pTemplate,
  197.   CK_ULONG ulAttributeCount,
  198.   CK_ULONG *pdbrv
  199. );
  200. NSS_EXTERN CK_BBOOL
  201. nss_dbm_db_object_still_exists
  202. (
  203.   nss_dbm_dbt_t *dbt
  204. );
  205. NSS_EXTERN CK_ULONG
  206. nss_dbm_db_get_object_attribute_count
  207. (
  208.   nss_dbm_dbt_t *dbt,
  209.   CK_RV *pError,
  210.   CK_ULONG *pdbrv
  211. );
  212. NSS_EXTERN CK_RV
  213. nss_dbm_db_get_object_attribute_types
  214. (
  215.   nss_dbm_dbt_t *dbt,
  216.   CK_ATTRIBUTE_TYPE_PTR typeArray,
  217.   CK_ULONG ulCount,
  218.   CK_ULONG *pdbrv
  219. );
  220. NSS_EXTERN CK_ULONG
  221. nss_dbm_db_get_object_attribute_size
  222. (
  223.   nss_dbm_dbt_t *dbt,
  224.   CK_ATTRIBUTE_TYPE type,
  225.   CK_RV *pError,
  226.   CK_ULONG *pdbrv
  227. );
  228. NSS_EXTERN NSSItem *
  229. nss_dbm_db_get_object_attribute
  230. (
  231.   nss_dbm_dbt_t *dbt,
  232.   NSSArena *arena,
  233.   CK_ATTRIBUTE_TYPE type,
  234.   CK_RV *pError,
  235.   CK_ULONG *pdbrv
  236. );
  237. NSS_EXTERN CK_RV
  238. nss_dbm_db_set_object_attribute
  239. (
  240.   nss_dbm_dbt_t *dbt,
  241.   CK_ATTRIBUTE_TYPE type,
  242.   NSSItem *value,
  243.   CK_ULONG *pdbrv
  244. );
  245. #endif /* CKDBM_H */