2003-05-18 Marcus Brinkmann <marcus@g10code.de>
[gpgme.git] / gpgme / trust-item.c
1 /* trust-item.c - Trust item objects.
2    Copyright (C) 2000 Werner Koch (dd9jn)
3    Copyright (C) 2001, 2002, 2003 g10 Code GmbH
4
5    This file is part of GPGME.
6  
7    GPGME is free software; you can redistribute it and/or modify it
8    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    GPGME is distributed in the hope that it will be useful, but
13    WITHOUT ANY WARRANTY; without even the implied warranty of
14    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
15    General Public License for more details.
16  
17    You should have received a copy of the GNU General Public License
18    along with GPGME; if not, write to the Free Software Foundation,
19    Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.  */
20
21 #if HAVE_CONFIG_H
22 #include <config.h>
23 #endif
24 #include <stdlib.h>
25 #include <string.h>
26 #include <assert.h>
27
28 #include "util.h"
29 #include "ops.h"
30 #include "sema.h"
31
32
33 /* Protects all reference counters in trust items.  All other accesses
34    to a trust item are either read only or happen before the trust
35    item is available to the user.  */
36 DEFINE_STATIC_LOCK (trust_item_ref_lock);
37
38 \f
39 /* Create a new trust item.  */
40 gpgme_error_t
41 _gpgme_trust_item_new (gpgme_trust_item_t *r_item)
42 {
43   gpgme_trust_item_t item;
44
45   item = calloc (1, sizeof *item);
46   if (!item)
47     return GPGME_Out_Of_Core;
48   item->_refs = 1;
49   item->keyid = item->_keyid;
50   item->_keyid[16] = '\0';
51   item->owner_trust = item->_owner_trust;
52   item->_owner_trust[1] = '\0';
53   item->validity = item->_validity;
54   item->_validity[1] = '\0';
55   *r_item = item;
56   return 0;
57 }
58
59 \f
60 /* Acquire a reference to ITEM.  */
61 void
62 gpgme_trust_item_ref (gpgme_trust_item_t item)
63 {
64   LOCK (trust_item_ref_lock);
65   item->_refs++;
66   UNLOCK (trust_item_ref_lock);
67 }
68
69
70 /* gpgme_trust_item_unref releases the trust item object. Note that
71    this function may not do an actual release if there are other
72    shallow copies of the object.  You have to call this function for
73    every newly created trust item object as well as for every
74    gpgme_trust_item_ref() done on the trust item object.  */
75 void
76 gpgme_trust_item_unref (gpgme_trust_item_t item)
77 {
78   LOCK (trust_item_ref_lock);
79   assert (item->_refs > 0);
80   if (--item->_refs)
81     {
82       UNLOCK (trust_item_ref_lock);
83       return;
84     }
85   UNLOCK (trust_item_ref_lock);
86
87   if (item->name)
88     free (item->name);
89   free (item);
90 }
91
92 \f
93 /* Compatibility interfaces.  */
94 void
95 gpgme_trust_item_release (gpgme_trust_item_t item)
96 {
97   gpgme_trust_item_unref (item);
98 }
99
100 /* Return the value of the attribute WHAT of ITEM, which has to be
101    representable by a string.  */
102 const char *gpgme_trust_item_get_string_attr (gpgme_trust_item_t item,
103                                               _gpgme_attr_t what,
104                                               const void *reserved, int idx)
105 {
106   const char *val = NULL;
107
108   if (!item)
109     return NULL;
110   if (reserved)
111     return NULL;
112   if (idx)
113     return NULL;
114
115   switch (what)
116     {
117     case GPGME_ATTR_KEYID:
118       val = item->keyid;
119       break;
120
121     case GPGME_ATTR_OTRUST:  
122       val = item->owner_trust;
123       break;
124
125     case GPGME_ATTR_VALIDITY:
126       val = item->validity;
127       break;
128
129     case GPGME_ATTR_USERID:  
130       val = item->name;
131       break;
132
133     default:
134       break;
135     }
136   return val;
137 }
138
139
140 /* Return the value of the attribute WHAT of KEY, which has to be
141    representable by an integer.  IDX specifies a running index if the
142    attribute appears more than once in the key.  */
143 int gpgme_trust_item_get_int_attr (gpgme_trust_item_t item, _gpgme_attr_t what,
144                                    const void *reserved, int idx)
145 {
146   int val = 0;
147
148   if (!item)
149     return 0;
150   if (reserved)
151     return 0;
152   if (idx)
153     return 0;
154
155   switch (what)
156     {
157     case GPGME_ATTR_LEVEL:    
158       val = item->level;
159       break;
160
161     case GPGME_ATTR_TYPE:    
162       val = item->type;
163       break;
164
165     default:
166       break;
167     }
168   return val;
169 }