* gpgv.c (check_trustdb_stale): Stub.
[gnupg.git] / g10 / trustdb.h
1 /* trustdb.h - Trust database
2  * Copyright (C) 1998, 1999, 2000, 2001, 2002, 2003
3  *                                             Free Software Foundation, Inc.
4  *
5  * This file is part of GnuPG.
6  *
7  * GnuPG is free software; you can redistribute it and/or modify
8  * it under the terms of the GNU General Public License as published by
9  * the Free Software Foundation; either version 2 of the License, or
10  * (at your option) any later version.
11  *
12  * GnuPG is distributed in the hope that it will be useful,
13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
15  * GNU General Public License for more details.
16  *
17  * You should have received a copy of the GNU General Public License
18  * along with this program; if not, write to the Free Software
19  * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA
20  */
21
22 #ifndef G10_TRUSTDB_H
23 #define G10_TRUSTDB_H
24
25
26 /* Trust values must be sorted in ascending order */
27 #define TRUST_MASK       15
28 #define TRUST_UNKNOWN     0  /* o: not yet calculated/assigned */
29 #define TRUST_EXPIRED     1  /* e: calculation may be invalid */
30 #define TRUST_UNDEFINED   2  /* q: not enough information for calculation */
31 #define TRUST_NEVER       3  /* n: never trust this pubkey */
32 #define TRUST_MARGINAL    4  /* m: marginally trusted */
33 #define TRUST_FULLY       5  /* f: fully trusted      */
34 #define TRUST_ULTIMATE    6  /* u: ultimately trusted */
35 /* trust values not covered by the mask */
36 #define TRUST_FLAG_REVOKED 32 /* r: revoked */
37 #define TRUST_FLAG_SUB_REVOKED 64 /* r: revoked but for subkeys */
38 #define TRUST_FLAG_DISABLED 128 /* d: key/uid disabled */
39 #define TRUST_FLAG_PENDING_CHECK 256 /* a check-trustdb is pending */
40
41 /*-- trustdb.c --*/
42 void register_trusted_key( const char *string );
43 void check_trustdb (void);
44 void update_trustdb (void);
45 int setup_trustdb( int level, const char *dbname );
46 void init_trustdb( void );
47 void check_trustdb_stale(void);
48 void sync_trustdb( void );
49
50 const char *trust_value_to_string (unsigned int value);
51 int string_to_trust_value (const char *str);
52
53 void revalidation_mark (void);
54 int trustdb_pending_check(void);
55
56 int cache_disabled_value(PKT_public_key *pk);
57
58 unsigned int get_validity (PKT_public_key *pk, PKT_user_id *uid);
59 int get_validity_info (PKT_public_key *pk, PKT_user_id *uid);
60 const char *get_validity_string (PKT_public_key *pk, PKT_user_id *uid);
61
62 void list_trust_path( const char *username );
63 int enum_cert_paths( void **context, ulong *lid,
64                      unsigned *ownertrust, unsigned *validity );
65 void enum_cert_paths_print( void **context, FILE *fp,
66                                            int refresh, ulong selected_lid );
67
68 void read_trust_options(byte *trust_model,ulong *created,ulong *nextcheck,
69                         byte *marginals,byte *completes,byte *cert_depth);
70
71 unsigned int get_ownertrust (PKT_public_key *pk);
72 unsigned int get_min_ownertrust (PKT_public_key *pk);
73 int get_ownertrust_info (PKT_public_key *pk);
74 const char *get_ownertrust_string (PKT_public_key *pk);
75
76 void update_ownertrust (PKT_public_key *pk, unsigned int new_trust );
77 int clear_ownertrusts (PKT_public_key *pk);
78
79 /*-- tdbdump.c --*/
80 void list_trustdb(const char *username);
81 void export_ownertrust(void);
82 void import_ownertrust(const char *fname);
83
84 /*-- pkclist.c --*/
85 int edit_ownertrust (PKT_public_key *pk, int mode );
86
87 #endif /*G10_TRUSTDB_H*/