LCOV - code coverage report
Current view: top level - kbx - keybox-defs.h (source / functions) Hit Total Coverage
Test: coverage.info Lines: 4 5 80.0 %
Date: 2015-11-05 17:10:59 Functions: 1 1 100.0 %

          Line data    Source code
       1             : /* keybox-defs.h - internal Keybox definitions
       2             :  *      Copyright (C) 2001, 2004 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 3 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, see <http://www.gnu.org/licenses/>.
      18             :  */
      19             : 
      20             : #ifndef KEYBOX_DEFS_H
      21             : #define KEYBOX_DEFS_H 1
      22             : 
      23             : #ifdef GPG_ERR_SOURCE_DEFAULT
      24             : # if GPG_ERR_SOURCE_DEFAULT != GPG_ERR_SOURCE_KEYBOX
      25             : #  error GPG_ERR_SOURCE_DEFAULT already defined
      26             : # endif
      27             : #else
      28             : # define GPG_ERR_SOURCE_DEFAULT  GPG_ERR_SOURCE_KEYBOX
      29             : #endif
      30             : #include <gpg-error.h>
      31             : #define map_assuan_err(a) \
      32             :         map_assuan_err_with_source (GPG_ERR_SOURCE_DEFAULT, (a))
      33             : 
      34             : #include <sys/types.h> /* off_t */
      35             : 
      36             : /* We include the type defintions from jnlib instead of defining our
      37             :    owns here.  This will not allow us build KBX in a standalone way
      38             :    but there is currently no need for it anyway.  Same goes for
      39             :    stringhelp.h which for example provides a replacement for stpcpy -
      40             :    fixme: Better use the LIBOBJ mechnism. */
      41             : #include "../common/types.h"
      42             : #include "../common/stringhelp.h"
      43             : 
      44             : #include "keybox.h"
      45             : 
      46             : 
      47             : typedef struct keyboxblob *KEYBOXBLOB;
      48             : 
      49             : 
      50             : typedef struct keybox_name *KB_NAME;
      51             : typedef struct keybox_name const *CONST_KB_NAME;
      52             : struct keybox_name
      53             : {
      54             :   /* Link to the next resources, so that we can walk all
      55             :      resources.  */
      56             :   KB_NAME next;
      57             : 
      58             :   /* True if this is a keybox with secret keys.  */
      59             :   int secret;
      60             : 
      61             :   /*DOTLOCK lockhd;*/
      62             : 
      63             :   /* A table with all the handles accessing this resources.
      64             :      HANDLE_TABLE_SIZE gives the allocated length of this table unused
      65             :      entrues are set to NULL.  HANDLE_TABLE may be NULL. */
      66             :   KEYBOX_HANDLE *handle_table;
      67             :   size_t handle_table_size;
      68             : 
      69             :   /* Not yet used.  */
      70             :   int is_locked;
      71             : 
      72             :   /* Not yet used.  */
      73             :   int did_full_scan;
      74             : 
      75             :   /* The name of the resource file. */
      76             :   char fname[1];
      77             : };
      78             : 
      79             : 
      80             : struct keybox_found_s
      81             : {
      82             :   KEYBOXBLOB blob;
      83             :   off_t offset;
      84             :   size_t pk_no;
      85             :   size_t uid_no;
      86             :   unsigned int n_packets; /*used for delete and update*/
      87             : };
      88             : 
      89             : struct keybox_handle {
      90             :   CONST_KB_NAME kb;
      91             :   int secret;             /* this is for a secret keybox */
      92             :   FILE *fp;
      93             :   int eof;
      94             :   int error;
      95             :   int ephemeral;
      96             :   int for_openpgp;        /* Used by gpg.  */
      97             :   struct keybox_found_s found;
      98             :   struct keybox_found_s saved_found;
      99             :   struct {
     100             :     char *name;
     101             :     char *pattern;
     102             :   } word_match;
     103             : };
     104             : 
     105             : 
     106             : /* Openpgp helper structures. */
     107             : struct _keybox_openpgp_key_info
     108             : {
     109             :   struct _keybox_openpgp_key_info *next;
     110             :   int algo;
     111             :   unsigned char keyid[8];
     112             :   int fprlen;  /* Either 16 or 20 */
     113             :   unsigned char fpr[20];
     114             : };
     115             : 
     116             : struct _keybox_openpgp_uid_info
     117             : {
     118             :   struct _keybox_openpgp_uid_info *next;
     119             :   size_t off;
     120             :   size_t len;
     121             : };
     122             : 
     123             : struct _keybox_openpgp_info
     124             : {
     125             :   int is_secret;        /* True if this is a secret key. */
     126             :   unsigned int nsubkeys;/* Total number of subkeys.  */
     127             :   unsigned int nuids;   /* Total number of user IDs in the keyblock. */
     128             :   unsigned int nsigs;   /* Total number of signatures in the keyblock. */
     129             : 
     130             :   /* Note, we use 2 structs here to better cope with the most common
     131             :      use of having one primary and one subkey - this allows us to
     132             :      statically allocate this structure and only malloc stuff for more
     133             :      than one subkey. */
     134             :   struct _keybox_openpgp_key_info primary;
     135             :   struct _keybox_openpgp_key_info subkeys;
     136             :   struct _keybox_openpgp_uid_info uids;
     137             : };
     138             : typedef struct _keybox_openpgp_info *keybox_openpgp_info_t;
     139             : 
     140             : 
     141             : /* Don't know whether this is needed: */
     142             : /*  static struct { */
     143             : /*    const char *homedir; */
     144             : /*    int dry_run; */
     145             : /*    int quiet; */
     146             : /*    int verbose; */
     147             : /*    int preserve_permissions; */
     148             : /*  } keybox_opt; */
     149             : 
     150             : /*-- keybox-init.c --*/
     151             : void _keybox_close_file (KEYBOX_HANDLE hd);
     152             : 
     153             : 
     154             : /*-- keybox-blob.c --*/
     155             : gpg_error_t _keybox_create_openpgp_blob (KEYBOXBLOB *r_blob,
     156             :                                          keybox_openpgp_info_t info,
     157             :                                          const unsigned char *image,
     158             :                                          size_t imagelen,
     159             :                                          u32 *sigstatus,
     160             :                                          int as_ephemeral);
     161             : #ifdef KEYBOX_WITH_X509
     162             : int _keybox_create_x509_blob (KEYBOXBLOB *r_blob, ksba_cert_t cert,
     163             :                               unsigned char *sha1_digest, int as_ephemeral);
     164             : #endif /*KEYBOX_WITH_X509*/
     165             : 
     166             : int  _keybox_new_blob (KEYBOXBLOB *r_blob,
     167             :                        unsigned char *image, size_t imagelen,
     168             :                        off_t off);
     169             : void _keybox_release_blob (KEYBOXBLOB blob);
     170             : const unsigned char *_keybox_get_blob_image (KEYBOXBLOB blob, size_t *n);
     171             : off_t _keybox_get_blob_fileoffset (KEYBOXBLOB blob);
     172             : void _keybox_update_header_blob (KEYBOXBLOB blob, int for_openpgp);
     173             : 
     174             : /*-- keybox-openpgp.c --*/
     175             : gpg_error_t _keybox_parse_openpgp (const unsigned char *image, size_t imagelen,
     176             :                                    size_t *nparsed,
     177             :                                    keybox_openpgp_info_t info);
     178             : void _keybox_destroy_openpgp_info (keybox_openpgp_info_t info);
     179             : 
     180             : 
     181             : /*-- keybox-file.c --*/
     182             : int _keybox_read_blob (KEYBOXBLOB *r_blob, FILE *fp);
     183             : int _keybox_read_blob2 (KEYBOXBLOB *r_blob, FILE *fp, int *skipped_deleted);
     184             : int _keybox_write_blob (KEYBOXBLOB blob, FILE *fp);
     185             : 
     186             : /*-- keybox-search.c --*/
     187             : gpg_err_code_t _keybox_get_flag_location (const unsigned char *buffer,
     188             :                                           size_t length,
     189             :                                           int what,
     190             :                                           size_t *flag_off, size_t *flag_size);
     191             : 
     192             : static inline int
     193       90505 : blob_get_type (KEYBOXBLOB blob)
     194             : {
     195             :   const unsigned char *buffer;
     196             :   size_t length;
     197             : 
     198       90505 :   buffer = _keybox_get_blob_image (blob, &length);
     199       90505 :   if (length < 32)
     200           0 :     return -1; /* blob too short */
     201             : 
     202       90505 :   return buffer[4];
     203             : }
     204             : 
     205             : 
     206             : /*-- keybox-dump.c --*/
     207             : int _keybox_dump_blob (KEYBOXBLOB blob, FILE *fp);
     208             : int _keybox_dump_file (const char *filename, int stats_only, FILE *outfp);
     209             : int _keybox_dump_find_dups (const char *filename, int print_them, FILE *outfp);
     210             : int _keybox_dump_cut_records (const char *filename, unsigned long from,
     211             :                               unsigned long to, FILE *outfp);
     212             : 
     213             : 
     214             : /*-- keybox-util.c --*/
     215             : void *_keybox_malloc (size_t n);
     216             : void *_keybox_calloc (size_t n, size_t m);
     217             : void *_keybox_realloc (void *p, size_t n);
     218             : void  _keybox_free (void *p);
     219             : 
     220             : #define xtrymalloc(a)    _keybox_malloc ((a))
     221             : #define xtrycalloc(a,b)  _keybox_calloc ((a),(b))
     222             : #define xtryrealloc(a,b) _keybox_realloc((a),(b))
     223             : #define xfree(a)         _keybox_free ((a))
     224             : 
     225             : 
     226             : #define DIM(v) (sizeof(v)/sizeof((v)[0]))
     227             : #define DIMof(type,member)   DIM(((type *)0)->member)
     228             : #ifndef STR
     229             : #  define STR(v) #v
     230             : #endif
     231             : #define STR2(v) STR(v)
     232             : 
     233             : /*
     234             :   a couple of handy macros
     235             : */
     236             : 
     237             : #define return_if_fail(expr) do {                        \
     238             :     if (!(expr)) {                                       \
     239             :         fprintf (stderr, "%s:%d: assertion '%s' failed\n", \
     240             :                  __FILE__, __LINE__, #expr );            \
     241             :         return;                                          \
     242             :     } } while (0)
     243             : #define return_null_if_fail(expr) do {                   \
     244             :     if (!(expr)) {                                       \
     245             :         fprintf (stderr, "%s:%d: assertion '%s' failed\n", \
     246             :                  __FILE__, __LINE__, #expr );            \
     247             :         return NULL;                                     \
     248             :     } } while (0)
     249             : #define return_val_if_fail(expr,val) do {                \
     250             :     if (!(expr)) {                                       \
     251             :         fprintf (stderr, "%s:%d: assertion '%s' failed\n", \
     252             :                  __FILE__, __LINE__, #expr );            \
     253             :         return (val);                                    \
     254             :     } } while (0)
     255             : #define never_reached() do {                                   \
     256             :         fprintf (stderr, "%s:%d: oops; should never get here\n", \
     257             :                  __FILE__, __LINE__ );                         \
     258             :     } while (0)
     259             : 
     260             : 
     261             : /* some macros to replace ctype ones and avoid locale problems */
     262             : #define digitp(p)   (*(p) >= '0' && *(p) <= '9')
     263             : #define hexdigitp(a) (digitp (a)                     \
     264             :                       || (*(a) >= 'A' && *(a) <= 'F')  \
     265             :                       || (*(a) >= 'a' && *(a) <= 'f'))
     266             : /* the atoi macros assume that the buffer has only valid digits */
     267             : #define atoi_1(p)   (*(p) - '0' )
     268             : #define atoi_2(p)   ((atoi_1(p) * 10) + atoi_1((p)+1))
     269             : #define atoi_4(p)   ((atoi_2(p) * 100) + atoi_2((p)+2))
     270             : #define xtoi_1(p)   (*(p) <= '9'? (*(p)- '0'): \
     271             :                      *(p) <= 'F'? (*(p)-'A'+10):(*(p)-'a'+10))
     272             : #define xtoi_2(p)   ((xtoi_1(p) * 16) + xtoi_1((p)+1))
     273             : 
     274             : 
     275             : #endif /*KEYBOX_DEFS_H*/

Generated by: LCOV version 1.11