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