xref: /titanic_44/usr/src/common/net/wanboot/p12access.h (revision 9dd0f810214fdc8e1af881a9a5c4b6927629ff9e)
1 /*
2  * CDDL HEADER START
3  *
4  * The contents of this file are subject to the terms of the
5  * Common Development and Distribution License, Version 1.0 only
6  * (the "License").  You may not use this file except in compliance
7  * with the License.
8  *
9  * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
10  * or http://www.opensolaris.org/os/licensing.
11  * See the License for the specific language governing permissions
12  * and limitations under the License.
13  *
14  * When distributing Covered Code, include this CDDL HEADER in each
15  * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
16  * If applicable, add the following below this CDDL HEADER, with the
17  * fields enclosed by brackets "[]" replaced with your own identifying
18  * information: Portions Copyright [yyyy] [name of copyright owner]
19  *
20  * CDDL HEADER END
21  */
22 /*
23  * Copyright 2002, 2003 Sun Microsystems, Inc.  All rights reserved.
24  * Use is subject to license terms.
25  */
26 
27 #ifndef	_P12ACCESS_H
28 #define	_P12ACCESS_H
29 
30 #pragma ident	"%Z%%M%	%I%	%E% SMI"
31 
32 #ifdef	__cplusplus
33 extern "C" {
34 #endif
35 
36 #include <p12aux.h>
37 #include <openssl/ssl.h>
38 
39 /*
40  * sunw_p12_use_certfile - read a client certificate from a pkcs12 file and
41  *              pass it in to SSL.
42  *
43  * Read in the certificate in pkcs12-formated file.  If there is a pass phrase
44  * use that to decrypt; if no pass phrase was given and there is a callback
45  * routine, call it.  Pass the cert to SSL.
46  *
47  * Arguments:
48  *   ctx        - SSL's context structure
49  *   filename	- Name of file with the client certificate.
50  *   passwd     - Pass phrase for pkcs12 data.
51  *
52  * Returns:
53  *   -1 	- Error occurred.  Check the error stack for specifics.
54  *   0          - Success.  Cert was successfully added.
55  */
56 int sunw_p12_use_certfile(SSL_CTX *, char *, char *);
57 
58 /*
59  * sunw_p12_use_keyfile - read a RSA private key from a pkcs12 file and pass
60  *              it in to SSL.
61  *
62  * Read in the RSA private key in pkcs12 format.  If there is a pass phrase
63  * use it to decrypt; if no pass phrase was given and there is a callback
64  * given, call it.  Pass the key to SSL.
65  *
66  * Arguments:
67  *   ctx        - SSL's context structure
68  *   filename	- Name of file with private key.
69  *   passwd     - Pass phrase for pkcs12 data.
70  *
71  * Returns:
72  *   -1 	- Error occurred.  Check the error stack for specifics.
73  *   0          - Success.
74  */
75 int sunw_p12_use_keyfile(SSL_CTX *, char *, char *);
76 
77 /*
78  * sunw_p12_use_trustfile - read a list of trustanchors from a pkcs12 file and
79  *              pass the stack in to SSL.
80  *
81  * Read in the trust anchors from pkcs12-formated file.  If there is a pass
82  * phrase use that to decrypt; if no pass phrase was given and there is a
83  * callback routine, call it.  Pass the stack of certs to SSL.
84  *
85  * Arguments:
86  *   ctx        - SSL's context structure
87  *   filename	- Name of file with the certificates.
88  *   passwd     - Pass phrase for pkcs12 data.
89  *
90  * Returns:
91  *   -1 	- Error occurred.  Check the error stack for specifics.
92  *   0          - Success.  Trust anchors were successfully added.
93  */
94 int sunw_p12_use_trustfile(SSL_CTX *, char *, char *);
95 
96 
97 #ifdef	__cplusplus
98 }
99 #endif
100 
101 #endif	/* _P12ACCESS_H */
102