gnupg/g10/main.h

245 lines
8.1 KiB
C
Raw Normal View History

1997-11-18 15:06:00 +01:00
/* main.h
2002-06-29 15:46:34 +02:00
* Copyright (C) 1998, 1999, 2000, 2001, 2002 Free Software Foundation, Inc.
1997-11-18 15:06:00 +01:00
*
* This file is part of GnuPG.
1997-11-18 15:06:00 +01:00
*
* GnuPG is free software; you can redistribute it and/or modify
1997-11-18 15:06:00 +01:00
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* GnuPG is distributed in the hope that it will be useful,
1997-11-18 15:06:00 +01:00
* 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, write to the Free Software
* Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA
*/
2002-06-29 15:46:34 +02:00
#ifndef G10_MAIN_H
#define G10_MAIN_H
#include "types.h"
1997-11-24 12:04:11 +01:00
#include "iobuf.h"
2002-06-29 15:46:34 +02:00
#include "mpi.h"
#include "cipher.h"
1997-12-16 20:15:09 +01:00
#include "keydb.h"
1997-11-24 23:24:04 +01:00
/* It could be argued that the default cipher should be 3DES rather
than CAST5, and the default compression should be 0
(i.e. uncompressed) rather than 1 (zip). */
2002-06-29 15:46:34 +02:00
#define DEFAULT_CIPHER_ALGO CIPHER_ALGO_CAST5
#define DEFAULT_DIGEST_ALGO DIGEST_ALGO_SHA1
#define DEFAULT_COMPRESS_ALGO 1
1998-01-02 21:40:10 +01:00
2002-06-29 15:46:34 +02:00
typedef struct {
int header_okay;
PK_LIST pk_list;
cipher_filter_context_t cfx;
} encrypt_filter_context_t;
2002-06-29 15:46:34 +02:00
struct groupitem
{
char *name;
STRLIST values;
struct groupitem *next;
};
1998-01-02 21:40:10 +01:00
2002-06-29 15:46:34 +02:00
/*-- g10.c --*/
extern int g10_errors_seen;
1998-11-10 13:59:59 +01:00
1998-01-28 17:09:43 +01:00
#if __GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 5 )
2002-06-29 15:46:34 +02:00
void g10_exit(int rc) __attribute__ ((noreturn));
1998-01-28 17:09:43 +01:00
#else
2002-06-29 15:46:34 +02:00
void g10_exit(int rc);
1998-01-28 17:09:43 +01:00
#endif
void print_pubkey_algo_note( int algo );
void print_cipher_algo_note( int algo );
void print_digest_algo_note( int algo );
1998-01-28 17:09:43 +01:00
/*-- armor.c --*/
char *make_radix64_string( const byte *data, size_t len );
1998-04-07 20:16:10 +02:00
/*-- misc.c --*/
1998-05-15 20:49:19 +02:00
void trap_unaligned(void);
int disable_core_dumps(void);
1998-04-07 20:16:10 +02:00
u16 checksum_u16( unsigned n );
u16 checksum( byte *p, unsigned n );
u16 checksum_mpi( MPI a );
1998-06-25 12:19:08 +02:00
u32 buffer_to_u32( const byte *buffer );
2002-06-29 15:46:34 +02:00
const byte *get_session_marker( size_t *rlen );
int openpgp_cipher_test_algo( int algo );
int openpgp_pk_test_algo( int algo, unsigned int usage_flags );
int openpgp_pk_algo_usage ( int algo );
int openpgp_md_test_algo( int algo );
#ifdef USE_IDEA
2002-06-29 15:46:34 +02:00
void idea_cipher_warn( int show );
#else
#define idea_cipher_warn(a)
#endif
2002-06-29 15:46:34 +02:00
struct expando_args
{
PKT_public_key *pk;
PKT_secret_key *sk;
byte imagetype;
};
char *pct_expando(const char *string,struct expando_args *args);
int hextobyte( const char *s );
void deprecated_warning(const char *configname,unsigned int configlineno,
const char *option,const char *repl1,const char *repl2);
const char *compress_algo_to_string(int algo);
int string_to_compress_algo(const char *string);
2002-06-29 15:46:34 +02:00
int check_compress_algo(int algo);
int default_cipher_algo(void);
int default_compress_algo(void);
* packet.h, build-packet.c (build_sig_subpkt), export.c (do_export_stream), import.c (remove_bad_stuff, import), parse-packet.c (dump_sig_subpkt, parse_one_sig_subpkt): Remove vestigal code for the old sig cache subpacket. This wasn't completely harmless as it caused subpacket 101 to disappear on import and export. * options.h, armor.c, cipher.c, g10.c, keyedit.c, pkclist.c, sign.c, encode.c, getkey.c, revoke.c: The current flags for different levels of PGP-ness are massively complex. This is step one in simplifying them. No functional change yet, just use a macro to check for compliance level. * sign.c (sign_file): Fix bug that causes spurious compression preference warning. * sign.c (clearsign_file): Fix bug that prevents proper warning message from appearing when clearsigning in --pgp2 mode with a non-v3 RSA key. * main.h, misc.c (compliance_option_string, compliance_string, compliance_failure), pkclist.c (build_pk_list), sign.c (sign_file, clearsign_file), encode.c (encode_crypt, write_pubkey_enc_from_list): New functions to put the "this message may not be usable...." warning in one place. * options.h, g10.c (main): Part two of the simplification. Use a single enum to indicate what we are compliant to (1991, 2440, PGPx, etc.) * g10.c (main): Show errors for failure in export, send-keys, recv-keys, and refresh-keys. * options.h, g10.c (main): Give algorithm warnings for algorithms chosen against the --pgpX and --openpgp rules. * keydb.h, pkclist.c (algo_available): Make TIGER192 invalid in --openpgp mode. * sign.c (sign_file), pkclist.c (algo_available): Allow passing a hint of 0.
2003-05-03 06:07:45 +02:00
const char *compliance_option_string(void);
void compliance_failure(void);
struct parse_options
{
char *name;
unsigned int bit;
};
int parse_options(char *str,unsigned int *options,struct parse_options *opts);
/*-- helptext.c --*/
void display_online_help( const char *keyword );
1997-11-18 15:06:00 +01:00
/*-- encode.c --*/
int encode_symmetric( const char *filename );
int encode_store( const char *filename );
int encode_crypt( const char *filename, STRLIST remusr );
2002-06-29 15:46:34 +02:00
void encode_crypt_files(int nfiles, char **files, STRLIST remusr);
1998-01-02 21:40:10 +01:00
int encrypt_filter( void *opaque, int control,
IOBUF a, byte *buf, size_t *ret_len);
1997-11-18 15:06:00 +01:00
1997-11-24 12:04:11 +01:00
/*-- sign.c --*/
2002-06-29 15:46:34 +02:00
int complete_sig( PKT_signature *sig, PKT_secret_key *sk, MD_HANDLE md );
1998-01-13 20:04:23 +01:00
int sign_file( STRLIST filenames, int detached, STRLIST locusr,
int do_encrypt, STRLIST remusr, const char *outfile );
1998-02-04 19:54:31 +01:00
int clearsign_file( const char *fname, STRLIST locusr, const char *outfile );
2002-06-29 15:46:34 +02:00
int sign_symencrypt_file (const char *fname, STRLIST locusr);
1998-04-09 13:19:09 +02:00
/*-- sig-check.c --*/
int check_revocation_keys (PKT_public_key *pk, PKT_signature *sig);
1998-04-09 13:19:09 +02:00
int check_key_signature( KBNODE root, KBNODE node, int *is_selfsig );
int check_key_signature2( KBNODE root, KBNODE node, PKT_public_key *check_pk,
PKT_public_key *ret_pk, int *is_selfsig,
u32 *r_expiredate, int *r_expired );
1998-04-09 13:19:09 +02:00
1998-09-11 07:47:32 +02:00
/*-- delkey.c --*/
2002-06-29 15:46:34 +02:00
int delete_keys( STRLIST names, int secret, int allow_both );
1998-09-11 07:47:32 +02:00
/*-- keyedit.c --*/
void keyedit_menu( const char *username, STRLIST locusr, STRLIST cmds,
int sign_mode );
void show_basic_key_info (KBNODE keyblock);
1997-11-24 12:04:11 +01:00
1997-11-18 15:06:00 +01:00
/*-- keygen.c --*/
2002-06-29 15:46:34 +02:00
u32 ask_expire_interval(int object);
1998-10-18 17:21:22 +02:00
u32 ask_expiredate(void);
void generate_keypair( const char *fname );
2002-06-29 15:46:34 +02:00
int keygen_set_std_prefs (const char *string,int personal);
PKT_user_id *keygen_get_std_prefs (void);
int keygen_add_key_expire( PKT_signature *sig, void *opaque );
1998-07-29 21:35:05 +02:00
int keygen_add_std_prefs( PKT_signature *sig, void *opaque );
2002-06-29 15:46:34 +02:00
int keygen_upd_std_prefs( PKT_signature *sig, void *opaque );
int keygen_add_keyserver_url(PKT_signature *sig, void *opaque);
2002-06-29 15:46:34 +02:00
int keygen_add_revkey(PKT_signature *sig, void *opaque);
1998-07-29 21:35:05 +02:00
int generate_subkeypair( KBNODE pub_keyblock, KBNODE sec_keyblock );
1997-11-18 15:06:00 +01:00
1997-11-24 12:04:11 +01:00
/*-- openfile.c --*/
1997-11-18 15:06:00 +01:00
int overwrite_filep( const char *fname );
char *make_outfile_name( const char *iname );
char *ask_outfile_name( const char *name, size_t namelen );
1998-08-11 19:29:34 +02:00
int open_outfile( const char *iname, int mode, IOBUF *a );
IOBUF open_sigfile( const char *iname, progress_filter_context_t *pfx );
void try_make_homedir( const char *fname );
1997-11-18 15:06:00 +01:00
1997-11-24 23:24:04 +01:00
/*-- seskey.c --*/
void make_session_key( DEK *dek );
MPI encode_session_key( DEK *dek, unsigned nbits );
2002-06-29 15:46:34 +02:00
MPI encode_md_value( int pubkey_algo, MD_HANDLE md,
int hash_algo, unsigned nbits, int v3compathack );
1997-11-24 23:24:04 +01:00
1997-12-16 20:15:09 +01:00
/*-- comment.c --*/
KBNODE make_comment_node( const char *s );
2002-06-29 15:46:34 +02:00
KBNODE make_mpi_comment_node( const char *s, MPI a );
1997-11-24 23:24:04 +01:00
1998-01-16 22:15:24 +01:00
/*-- import.c --*/
int parse_import_options(char *str,unsigned int *options);
2002-09-23 15:03:52 +02:00
void import_keys( char **fnames, int nnames,
void *stats_hd, unsigned int options );
2002-09-23 15:03:52 +02:00
int import_keys_stream( IOBUF inp,
void *stats_hd, unsigned int options );
2002-06-29 15:46:34 +02:00
void *import_new_stats_handle (void);
void import_release_stats_handle (void *p);
void import_print_stats (void *hd);
int collapse_uids( KBNODE *keyblock );
1998-01-26 23:09:01 +01:00
/*-- export.c --*/
int parse_export_options(char *str,unsigned int *options);
int export_pubkeys( STRLIST users, unsigned int options );
int export_pubkeys_stream( IOBUF out, STRLIST users,
KBNODE *keyblock_out, unsigned int options );
1998-06-29 14:30:57 +02:00
int export_seckeys( STRLIST users );
int export_secsubkeys( STRLIST users );
1998-06-29 14:30:57 +02:00
1998-02-16 21:05:02 +01:00
/* dearmor.c --*/
int dearmor_file( const char *fname );
1998-02-17 21:48:52 +01:00
int enarmor_file( const char *fname );
1998-01-16 22:15:24 +01:00
1998-02-16 21:05:02 +01:00
/*-- revoke.c --*/
struct revocation_reason_info;
1998-02-16 21:05:02 +01:00
int gen_revoke( const char *uname );
2002-06-29 15:46:34 +02:00
int gen_desig_revoke( const char *uname );
int revocation_reason_build_cb( PKT_signature *sig, void *opaque );
struct revocation_reason_info *
ask_revocation_reason( int key_rev, int cert_rev, int hint );
void release_revocation_reason_info( struct revocation_reason_info *reason );
1997-12-31 13:32:54 +01:00
1998-03-05 10:22:13 +01:00
/*-- keylist.c --*/
void public_key_list( STRLIST list );
void secret_key_list( STRLIST list );
void reorder_keyblock (KBNODE keyblock);
2002-06-29 15:46:34 +02:00
void list_keyblock( KBNODE keyblock, int secret, int fpr, void *opaque );
void print_fingerprint (PKT_public_key *pk, PKT_secret_key *sk, int mode);
void show_policy_url(PKT_signature *sig,int indent,int mode);
void show_keyserver_url(PKT_signature *sig,int indent,int mode);
void show_notation(PKT_signature *sig,int indent,int mode);
* trustdb.h, trustdb.c (is_disabled), gpgv.c (is_disabled): Rename is_disabled to cache_disabled_value, which now takes a pk and not just the keyid. This is for speed since there is no need to re-fetch a key when we already have that key handy. Cache the result of the check so we don't need to hit the trustdb more than once. * getkey.c (skip_disabled): New function to get a pk and call is_disabled on it. (key_byname): Use it here. * packet.h, getkey.c (skip_disabled), keylist.c (print_capabilities): New "pk_is_disabled" macro to retrieve the cached disabled value if available, and fill it in via cache_disabled_value if not available. * trustdb.c (get_validity): Cache the disabled value since we have it handy and it might be useful later. * parse-packet.c (parse_key): Clear disabled flag when parsing a new key. Just in case someone forgets to clear the whole key. * getkey.c (merge_selfsigs_main): Add an "if all else fails" path for setting a single user ID primary when there are multiple set primaries all at the same second, or no primaries set and the most recent user IDs are at the same second, or no signed user IDs at all. This is arbitrary, but deterministic. * exec.h, photoid.h: Add copyright message. * keylist.c (list_keyblock_print): Don't dump attribs for revoked/expired/etc uids for non-colon key listings. This is for consistency with --show-photos. * main.h, keylist.c (dump_attribs), mainproc.c (check_sig_and_print): Dump attribs if --attrib-fd is set when verifying signatures. * g10.c (main): New --gnupg option to disable the various --openpgp, --pgpX, etc. options. This is the same as --no-XXXX for those options. * revoke.c (ask_revocation_reason): Clear old reason if user elects to repeat question. This is bug 153. * keyedit.c (sign_uids): Show keyid of the key making the signature.
2003-05-21 18:42:22 +02:00
void dump_attribs(const PKT_user_id *uid,
PKT_public_key *pk,PKT_secret_key *sk);
2002-06-29 15:46:34 +02:00
void set_attrib_fd(int fd);
void print_seckey_info (PKT_secret_key *sk);
void print_pubkey_info (FILE *fp, PKT_public_key *pk);
1998-03-09 22:44:06 +01:00
/*-- verify.c --*/
2002-06-29 15:46:34 +02:00
void print_file_status( int status, const char *name, int what );
1998-03-09 22:44:06 +01:00
int verify_signatures( int nfiles, char **files );
int verify_files( int nfiles, char **files );
1998-03-09 22:44:06 +01:00
/*-- decrypt.c --*/
int decrypt_message( const char *filename );
2002-06-29 15:46:34 +02:00
void decrypt_messages(int nfiles, char **files);
1998-03-09 22:44:06 +01:00
/*-- plaintext.c --*/
2002-06-29 15:46:34 +02:00
int hash_datafiles( MD_HANDLE md, MD_HANDLE md2,
STRLIST files, const char *sigfilename, int textmode );
1998-03-05 10:22:13 +01:00
2002-06-29 15:46:34 +02:00
/*-- pipemode.c --*/
void run_in_pipemode (void);
1998-03-19 16:27:29 +01:00
/*-- signal.c --*/
void init_signals(void);
1998-08-11 19:29:34 +02:00
void pause_on_sigusr( int which );
1998-11-08 18:23:14 +01:00
void block_all_signals(void);
void unblock_all_signals(void);
1998-03-19 16:27:29 +01:00
2002-06-29 15:46:34 +02:00
#endif /*G10_MAIN_H*/