kbx/
[gnupg.git] / kbx / keybox.h
1 /* keybox.h - Keybox operations
2  *      Copyright (C) 2001, 2003 Free Software Foundation, Inc.
3  *
4  * This file is part of GnuPG.
5  *
6  * GnuPG is free software; you can redistribute it and/or modify
7  * it under the terms of the GNU General Public License as published by
8  * the Free Software Foundation; either version 2 of the License, or
9  * (at your option) any later version.
10  *
11  * GnuPG is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14  * GNU General Public License for more details.
15  *
16  * You should have received a copy of the GNU General Public License
17  * along with this program; if not, write to the Free Software
18  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301,
19  * USA.
20  */
21
22 #ifndef KEYBOX_H
23 #define KEYBOX_H 1
24 #ifdef __cplusplus
25 extern "C" { 
26 #if 0
27  }
28 #endif
29 #endif
30
31 #include "keybox-search-desc.h"
32
33 #define KEYBOX_WITH_OPENPGP 1 
34 #define KEYBOX_WITH_X509 1
35
36
37 #ifdef KEYBOX_WITH_OPENPGP
38 #  undef KEYBOX_WITH_OPENPGP
39 /*#include <lib-to-handle-gpg-data-structs.h>*/
40 #endif
41
42 #ifdef KEYBOX_WITH_X509
43 # include <ksba.h>
44 #endif
45
46 typedef struct keybox_handle *KEYBOX_HANDLE;
47
48
49 typedef enum
50   {
51     KEYBOX_FLAG_BLOB,       /* The blob flags. */
52     KEYBOX_FLAG_VALIDITY,   /* The validity of the entire key. */
53     KEYBOX_FLAG_OWNERTRUST, /* The assigned ownertrust. */
54     KEYBOX_FLAG_KEY,        /* The key flags; requires a key index. */
55     KEYBOX_FLAG_UID,        /* The user ID flags; requires an uid index. */
56     KEYBOX_FLAG_UID_VALIDITY,/* The validity of a specific uid, requires
57                                an uid index. */
58     KEYBOX_FLAG_CREATED_AT  /* The date the block was created. */
59   } keybox_flag_t;
60
61 /* Flag values used with KEYBOX_FLAG_BLOB.  */
62 #define KEYBOX_FLAG_BLOB_SECRET     1
63 #define KEYBOX_FLAG_BLOB_EPHEMERAL  2
64
65
66
67 /*-- keybox-init.c --*/
68 void *keybox_register_file (const char *fname, int secret);
69 int keybox_is_writable (void *token);
70
71 KEYBOX_HANDLE keybox_new (void *token, int secret);
72 void keybox_release (KEYBOX_HANDLE hd);
73 const char *keybox_get_resource_name (KEYBOX_HANDLE hd);
74 int keybox_set_ephemeral (KEYBOX_HANDLE hd, int yes);
75
76
77 /*-- keybox-search.c --*/
78 #ifdef KEYBOX_WITH_X509 
79 int keybox_get_cert (KEYBOX_HANDLE hd, ksba_cert_t *ret_cert);
80 #endif /*KEYBOX_WITH_X509*/
81 int keybox_get_flags (KEYBOX_HANDLE hd, int what, int idx, unsigned int *value);
82
83 int keybox_search_reset (KEYBOX_HANDLE hd);
84 int keybox_search (KEYBOX_HANDLE hd, KEYBOX_SEARCH_DESC *desc, size_t ndesc);
85
86
87 /*-- keybox-update.c --*/
88 #ifdef KEYBOX_WITH_X509 
89 int keybox_insert_cert (KEYBOX_HANDLE hd, ksba_cert_t cert,
90                         unsigned char *sha1_digest);
91 int keybox_update_cert (KEYBOX_HANDLE hd, ksba_cert_t cert,
92                         unsigned char *sha1_digest);
93 #endif /*KEYBOX_WITH_X509*/
94 int keybox_set_flags (KEYBOX_HANDLE hd, int what, int idx, unsigned int value);
95
96 int keybox_delete (KEYBOX_HANDLE hd);
97 int keybox_compress (KEYBOX_HANDLE hd);
98
99
100 /*--  --*/
101
102 #if 0
103 int keybox_lock (KEYBOX_HANDLE hd, int yes);
104 int keybox_get_keyblock (KEYBOX_HANDLE hd, KBNODE *ret_kb);
105 int keybox_locate_writable (KEYBOX_HANDLE hd);
106 int keybox_search_reset (KEYBOX_HANDLE hd);
107 int keybox_search (KEYBOX_HANDLE hd, KEYDB_SEARCH_DESC *desc, size_t ndesc);
108 int keybox_rebuild_cache (void *);
109 #endif
110
111
112 /*-- keybox-util.c --*/
113 void keybox_set_malloc_hooks ( void *(*new_alloc_func)(size_t n),
114                                void *(*new_realloc_func)(void *p, size_t n),
115                                void (*new_free_func)(void*) );
116
117
118 #ifdef __cplusplus
119 }
120 #endif
121 #endif /*KEYBOX_H*/