1/*- 2 * Copyright (c) 2009 The NetBSD Foundation, Inc. 3 * All rights reserved. 4 * 5 * This code is derived from software contributed to The NetBSD Foundation 6 * by Alistair Crooks (agc@netbsd.org) 7 * 8 * Redistribution and use in source and binary forms, with or without 9 * modification, are permitted provided that the following conditions 10 * are met: 11 * 1. Redistributions of source code must retain the above copyright 12 * notice, this list of conditions and the following disclaimer. 13 * 2. Redistributions in binary form must reproduce the above copyright 14 * notice, this list of conditions and the following disclaimer in the 15 * documentation and/or other materials provided with the distribution. 16 * 17 * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS 18 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 19 * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 20 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS 21 * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 22 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 23 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 24 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 25 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 26 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 27 * POSSIBILITY OF SUCH DAMAGE. 28 */ 29#ifndef NETPGP_H_ 30#define NETPGP_H_ 31 32#ifndef __BEGIN_DECLS 33# if defined(__cplusplus) 34# define __BEGIN_DECLS extern "C" { 35# define __END_DECLS } 36# else 37# define __BEGIN_DECLS 38# define __END_DECLS 39# endif 40#endif 41 42__BEGIN_DECLS 43 44/* structure used to hold (key,value) pair information */ 45typedef struct netpgp_t { 46 unsigned c; /* # of elements used */ 47 unsigned size; /* size of array */ 48 char **name; /* key names */ 49 char **value; /* value information */ 50 void *pubring; /* public key ring */ 51 void *secring; /* s3kr1t key ring */ 52 void *io; /* the io struct for results/errs */ 53 void *passfp; /* file pointer for password input */ 54} netpgp_t; 55 56/* begin and end */ 57int netpgp_init(netpgp_t *); 58int netpgp_end(netpgp_t *); 59 60/* debugging, reflection and information */ 61int netpgp_set_debug(const char *); 62int netpgp_get_debug(const char *); 63const char *netpgp_get_info(const char *); 64int netpgp_list_packets(netpgp_t *, char *, int, char *); 65 66/* variables */ 67int netpgp_setvar(netpgp_t *, const char *, const char *); 68char *netpgp_getvar(netpgp_t *, const char *); 69int netpgp_incvar(netpgp_t *, const char *, const int); 70int netpgp_unsetvar(netpgp_t *, const char *); 71 72/* set home directory information */ 73int netpgp_set_homedir(netpgp_t *, char *, const char *, const int); 74 75/* key management */ 76int netpgp_list_keys(netpgp_t *, const int); 77int netpgp_find_key(netpgp_t *, char *); 78char *netpgp_get_key(netpgp_t *, const char *, const char *); 79char *netpgp_export_key(netpgp_t *, char *); 80int netpgp_import_key(netpgp_t *, char *); 81int netpgp_generate_key(netpgp_t *, char *, int); 82 83/* file management */ 84int netpgp_encrypt_file(netpgp_t *, const char *, const char *, char *, int); 85int netpgp_decrypt_file(netpgp_t *, const char *, char *, int); 86int netpgp_sign_file(netpgp_t *, const char *, const char *, char *, int, int, int); 87int netpgp_verify_file(netpgp_t *, const char *, const char *, int); 88 89/* memory signing and encryption */ 90int netpgp_sign_memory(netpgp_t *, const char *, char *, size_t, char *, size_t, const unsigned, const unsigned); 91int netpgp_verify_memory(netpgp_t *, const void *, const size_t, void *, size_t, const int); 92int netpgp_encrypt_memory(netpgp_t *, const char *, void *, const size_t, char *, size_t, int); 93int netpgp_decrypt_memory(netpgp_t *, const void *, const size_t, char *, size_t, const int); 94 95/* match and hkp-related functions */ 96int netpgp_match_keys(netpgp_t *, char *, const char *, void *, const int); 97int netpgp_match_pubkeys(netpgp_t *, char *, void *); 98 99int netpgp_validate_sigs(netpgp_t *); 100 101__END_DECLS 102 103#endif /* !NETPGP_H_ */ 104