mirror of
git://git.gnupg.org/gnupg.git
synced 2024-12-23 10:29:58 +01:00
915297705a
* common/util.h (UBID_LEN): New. Use it at all places. * kbx/keybox-blob.c (create_blob_finish): Do not write the UBID item. * kbx/keybox-dump.c (print_ubib): Remove. (_keybox_dump_blob): Do not print the now removed ubid flag. * kbx/keybox-search-desc.h (struct keydb_search_desc): Use constants for the size of the ubid and grip. * kbx/keybox-search.c (blob_cmp_ubid): New. (has_ubid): Make it a simple wrapper around blob_cmp_ubid. (keybox_get_data): Add arg 'r_ubid'. * kbx/frontend.h (enum kbxd_store_modes): New. * kbx/kbxserver.c (cmd_store): Add new option --insert. * kbx/backend-cache.c (be_cache_initialize): New. (be_cache_add_resource): Call it here. * kbx/backend-kbx.c (be_kbx_seek): Remove args 'fpr' and 'fprlen'. (be_kbx_search): Get the UBID from keybox_get_data. * kbx/backend-support.c (be_fingerprint_from_blob): Replace by ... (be_ubid_from_blob): new. Change all callers. * kbx/frontend.c (kbxd_add_resource): Temporary disable the cache but use the new cache init function. (kbxd_store): Replace arg 'only_update' by 'mode'. Seek using the ubid. Take care of the mode. -- It turned out that using the hash of the entire blob was not helpful. Thus we redefine the Unique-Blob-ID (UBID) as the primary fingerprint of the blob. In case this is a v5 OpenPGP key a left truncated version of the SHA-256 hash is used; in all other cases the full SHA-1 hash. Using a SHA-256 hash does not make sense because v4 keys are and will for some time be the majority of keys and thus padding them with zeroes won't make any difference. Even if fingerprint collisions can eventually be created we will assume that the keys are bogus and that it does not make sense to store its twin also in our key storage. We can also easily extend the update code to detect a collision and reject the update. Signed-off-by: Werner Koch <wk@gnupg.org>
143 lines
4.7 KiB
C
143 lines
4.7 KiB
C
/* keybox.h - Keybox operations
|
|
* Copyright (C) 2001, 2003, 2012 Free Software Foundation, Inc.
|
|
*
|
|
* This file is part of GnuPG.
|
|
*
|
|
* GnuPG is free software; you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation; either version 3 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* GnuPG is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License
|
|
* along with this program; if not, see <https://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
#ifndef KEYBOX_H
|
|
#define KEYBOX_H 1
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#if 0
|
|
}
|
|
#endif
|
|
#endif
|
|
|
|
#include "../common/iobuf.h"
|
|
#include "keybox-search-desc.h"
|
|
|
|
#ifdef KEYBOX_WITH_X509
|
|
# include <ksba.h>
|
|
#endif
|
|
|
|
typedef struct keybox_handle *KEYBOX_HANDLE;
|
|
|
|
|
|
typedef enum
|
|
{
|
|
KEYBOX_FLAG_BLOB, /* The blob flags. */
|
|
KEYBOX_FLAG_VALIDITY, /* The validity of the entire key. */
|
|
KEYBOX_FLAG_OWNERTRUST, /* The assigned ownertrust. */
|
|
KEYBOX_FLAG_KEY, /* The key flags; requires a key index. */
|
|
KEYBOX_FLAG_UID, /* The user ID flags; requires an uid index. */
|
|
KEYBOX_FLAG_UID_VALIDITY,/* The validity of a specific uid, requires
|
|
an uid index. */
|
|
KEYBOX_FLAG_CREATED_AT, /* The date the block was created. */
|
|
KEYBOX_FLAG_SIG_INFO, /* The signature info block. */
|
|
} keybox_flag_t;
|
|
|
|
/* Flag values used with KEYBOX_FLAG_BLOB. */
|
|
#define KEYBOX_FLAG_BLOB_SECRET 1
|
|
#define KEYBOX_FLAG_BLOB_EPHEMERAL 2
|
|
|
|
/* The keybox blob types. */
|
|
typedef enum
|
|
{
|
|
KEYBOX_BLOBTYPE_EMPTY = 0,
|
|
KEYBOX_BLOBTYPE_HEADER = 1,
|
|
KEYBOX_BLOBTYPE_PGP = 2,
|
|
KEYBOX_BLOBTYPE_X509 = 3
|
|
} keybox_blobtype_t;
|
|
|
|
|
|
/*-- keybox-init.c --*/
|
|
gpg_error_t keybox_register_file (const char *fname, int secret,
|
|
void **r_token);
|
|
int keybox_is_writable (void *token);
|
|
|
|
KEYBOX_HANDLE keybox_new_openpgp (void *token, int secret);
|
|
KEYBOX_HANDLE keybox_new_x509 (void *token, int secret);
|
|
void keybox_release (KEYBOX_HANDLE hd);
|
|
void keybox_push_found_state (KEYBOX_HANDLE hd);
|
|
void keybox_pop_found_state (KEYBOX_HANDLE hd);
|
|
const char *keybox_get_resource_name (KEYBOX_HANDLE hd);
|
|
int keybox_set_ephemeral (KEYBOX_HANDLE hd, int yes);
|
|
|
|
gpg_error_t keybox_lock (KEYBOX_HANDLE hd, int yes, long timeout);
|
|
|
|
/*-- keybox-file.c --*/
|
|
/* Fixme: This function does not belong here: Provide a better
|
|
interface to create a new keybox file. */
|
|
gpg_error_t _keybox_write_header_blob (FILE *fp, estream_t stream,
|
|
int openpgp_flag);
|
|
|
|
/*-- keybox-search.c --*/
|
|
gpg_error_t keybox_get_data (KEYBOX_HANDLE hd,
|
|
void **r_buffer, size_t *r_length,
|
|
enum pubkey_types *r_pubkey_type,
|
|
unsigned char *r_ubid);
|
|
gpg_error_t keybox_get_keyblock (KEYBOX_HANDLE hd, iobuf_t *r_iobuf,
|
|
int *r_pk_no, int *r_uid_no);
|
|
#ifdef KEYBOX_WITH_X509
|
|
int keybox_get_cert (KEYBOX_HANDLE hd, ksba_cert_t *ret_cert);
|
|
#endif /*KEYBOX_WITH_X509*/
|
|
int keybox_get_flags (KEYBOX_HANDLE hd, int what, int idx, unsigned int *value);
|
|
|
|
gpg_error_t keybox_search_reset (KEYBOX_HANDLE hd);
|
|
gpg_error_t keybox_search (KEYBOX_HANDLE hd,
|
|
KEYBOX_SEARCH_DESC *desc, size_t ndesc,
|
|
keybox_blobtype_t want_blobtype,
|
|
size_t *r_descindex, unsigned long *r_skipped);
|
|
|
|
off_t keybox_offset (KEYBOX_HANDLE hd);
|
|
gpg_error_t keybox_seek (KEYBOX_HANDLE hd, off_t offset);
|
|
|
|
/*-- keybox-update.c --*/
|
|
gpg_error_t keybox_insert_keyblock (KEYBOX_HANDLE hd,
|
|
const void *image, size_t imagelen);
|
|
gpg_error_t keybox_update_keyblock (KEYBOX_HANDLE hd,
|
|
const void *image, size_t imagelen);
|
|
|
|
#ifdef KEYBOX_WITH_X509
|
|
int keybox_insert_cert (KEYBOX_HANDLE hd, ksba_cert_t cert,
|
|
unsigned char *sha1_digest);
|
|
int keybox_update_cert (KEYBOX_HANDLE hd, ksba_cert_t cert,
|
|
unsigned char *sha1_digest);
|
|
#endif /*KEYBOX_WITH_X509*/
|
|
int keybox_set_flags (KEYBOX_HANDLE hd, int what, int idx, unsigned int value);
|
|
|
|
int keybox_delete (KEYBOX_HANDLE hd);
|
|
int keybox_compress (KEYBOX_HANDLE hd);
|
|
|
|
|
|
/*-- --*/
|
|
|
|
#if 0
|
|
int keybox_locate_writable (KEYBOX_HANDLE hd);
|
|
int keybox_rebuild_cache (void *);
|
|
#endif
|
|
|
|
|
|
/*-- keybox-util.c --*/
|
|
gpg_error_t keybox_tmp_names (const char *filename, int for_keyring,
|
|
char **r_bakname, char **r_tmpname);
|
|
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
#endif /*KEYBOX_H*/
|