gpg: Remove unused arg from a function.
[gnupg.git] / g10 / trustdb.h
1 /* trustdb.h - Trust database
2  * Copyright (C) 1998, 1999, 2000, 2001, 2002, 2003, 2004,
3  *               2005, 2012 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 3 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, see <https://www.gnu.org/licenses/>.
19  */
20
21 #ifndef G10_TRUSTDB_H
22 #define G10_TRUSTDB_H
23
24 /* Trust values must be sorted in ascending order! */
25 #define TRUST_MASK       15
26 #define TRUST_UNKNOWN     0  /* o: not yet calculated/assigned */
27 #define TRUST_EXPIRED     1  /* e: calculation may be invalid */
28 #define TRUST_UNDEFINED   2  /* q: not enough information for calculation */
29 #define TRUST_NEVER       3  /* n: never trust this pubkey */
30 #define TRUST_MARGINAL    4  /* m: marginally trusted */
31 #define TRUST_FULLY       5  /* f: fully trusted      */
32 #define TRUST_ULTIMATE    6  /* u: ultimately trusted */
33 /* Trust values not covered by the mask. */
34 #define TRUST_FLAG_REVOKED        32 /* r: revoked */
35 #define TRUST_FLAG_SUB_REVOKED    64 /* r: revoked but for subkeys */
36 #define TRUST_FLAG_DISABLED      128 /* d: key/uid disabled */
37 #define TRUST_FLAG_PENDING_CHECK 256 /* a check-trustdb is pending */
38 #define TRUST_FLAG_TOFU_BASED    512 /* The trust value is based on
39                                       * the TOFU information.  */
40
41 /* Private value used in tofu.c - must be different from the trust
42    values.  */
43 #define _tofu_GET_TRUST_ERROR 100
44
45 /* Length of the hash used to select UIDs in keyedit.c.  */
46 #define NAMEHASH_LEN  20
47
48
49 /*-- trust.c --*/
50 int cache_disabled_value (ctrl_t ctrl, PKT_public_key *pk);
51 void register_trusted_keyid (u32 *keyid);
52 void register_trusted_key (const char *string);
53
54 const char *trust_value_to_string (unsigned int value);
55 int string_to_trust_value (const char *str);
56 const char *uid_trust_string_fixed (ctrl_t ctrl,
57                                     PKT_public_key *key, PKT_user_id *uid);
58
59 unsigned int get_ownertrust (ctrl_t ctrl, PKT_public_key *pk);
60 void update_ownertrust (ctrl_t ctrl,
61                         PKT_public_key *pk, unsigned int new_trust);
62 int clear_ownertrusts (ctrl_t ctrl, PKT_public_key *pk);
63
64 void revalidation_mark (ctrl_t ctrl);
65 void check_trustdb_stale (ctrl_t ctrl);
66 void check_or_update_trustdb (ctrl_t ctrl);
67
68 unsigned int get_validity (ctrl_t ctrl, kbnode_t kb, PKT_public_key *pk,
69                            PKT_user_id *uid,
70                            PKT_signature *sig, int may_ask);
71 int get_validity_info (ctrl_t ctrl, kbnode_t kb, PKT_public_key *pk,
72                        PKT_user_id *uid);
73 const char *get_validity_string (ctrl_t ctrl,
74                                  PKT_public_key *pk, PKT_user_id *uid);
75
76
77 /*-- trustdb.c --*/
78 void tdb_register_trusted_keyid (u32 *keyid);
79 void tdb_register_trusted_key (const char *string);
80 /* Returns whether KID is on the list of ultimately trusted keys.  */
81 int tdb_keyid_is_utk (u32 *kid);
82 /* Return the list of ultimately trusted keys.  The caller must not
83  * modify this list nor must it free the list.  */
84 struct key_item *tdb_utks (void);
85 void check_trustdb (ctrl_t ctrl);
86 void update_trustdb (ctrl_t ctrl);
87 int setup_trustdb( int level, const char *dbname );
88 void how_to_fix_the_trustdb (void);
89 const char *trust_model_string (int model);
90 gpg_error_t init_trustdb (ctrl_t ctrl, int no_create);
91 int have_trustdb (ctrl_t ctrl);
92 void tdb_check_trustdb_stale (ctrl_t ctrl);
93 void tdb_revalidation_mark (ctrl_t ctrl);
94 int trustdb_pending_check(void);
95 void tdb_check_or_update (ctrl_t ctrl);
96
97 int tdb_cache_disabled_value (ctrl_t ctrl, PKT_public_key *pk);
98
99 unsigned int tdb_get_validity_core (ctrl_t ctrl, kbnode_t kb,
100                                     PKT_public_key *pk, PKT_user_id *uid,
101                                     PKT_public_key *main_pk,
102                                     PKT_signature *sig, int may_ask);
103
104 void list_trust_path( const char *username );
105 int enum_cert_paths( void **context, ulong *lid,
106                      unsigned *ownertrust, unsigned *validity );
107 void enum_cert_paths_print( void **context, FILE *fp,
108                                            int refresh, ulong selected_lid );
109
110 void read_trust_options (ctrl_t ctrl, byte *trust_model,
111                          ulong *created, ulong *nextcheck,
112                          byte *marginals, byte *completes, byte *cert_depth,
113                          byte *min_cert_level);
114
115 unsigned int tdb_get_ownertrust (ctrl_t ctrl, PKT_public_key *pk,
116                                  int no_create);
117 unsigned int tdb_get_min_ownertrust (ctrl_t ctrl, PKT_public_key *pk,
118                                      int no_create);
119 int get_ownertrust_info (ctrl_t ctrl, PKT_public_key *pk, int no_create);
120 const char *get_ownertrust_string (ctrl_t ctrl,
121                                    PKT_public_key *pk, int no_create);
122
123 void tdb_update_ownertrust (ctrl_t ctrl, PKT_public_key *pk,
124                             unsigned int new_trust);
125 int tdb_clear_ownertrusts (ctrl_t ctrl, PKT_public_key *pk);
126
127 /*-- tdbdump.c --*/
128 void list_trustdb (ctrl_t ctrl, estream_t fp, const char *username);
129 void export_ownertrust (ctrl_t ctrl);
130 void import_ownertrust (ctrl_t ctrl, const char *fname);
131
132 /*-- pkclist.c --*/
133 int edit_ownertrust (ctrl_t ctrl, PKT_public_key *pk, int mode);
134
135 #endif /*G10_TRUSTDB_H*/