summaryrefslogtreecommitdiff
path: root/src/lib/libcrypto/man/PKCS7_new.3
diff options
context:
space:
mode:
Diffstat (limited to 'src/lib/libcrypto/man/PKCS7_new.3')
-rw-r--r--src/lib/libcrypto/man/PKCS7_new.3269
1 files changed, 0 insertions, 269 deletions
diff --git a/src/lib/libcrypto/man/PKCS7_new.3 b/src/lib/libcrypto/man/PKCS7_new.3
deleted file mode 100644
index 151261a312..0000000000
--- a/src/lib/libcrypto/man/PKCS7_new.3
+++ /dev/null
@@ -1,269 +0,0 @@
1.\" $OpenBSD: PKCS7_new.3,v 1.12 2020/06/10 11:43:08 schwarze Exp $
2.\"
3.\" Copyright (c) 2016 Ingo Schwarze <schwarze@openbsd.org>
4.\"
5.\" Permission to use, copy, modify, and distribute this software for any
6.\" purpose with or without fee is hereby granted, provided that the above
7.\" copyright notice and this permission notice appear in all copies.
8.\"
9.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
10.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
11.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
12.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
13.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
14.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
15.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
16.\"
17.Dd $Mdocdate: June 10 2020 $
18.Dt PKCS7_NEW 3
19.Os
20.Sh NAME
21.Nm PKCS7_new ,
22.Nm PKCS7_free ,
23.Nm PKCS7_SIGNED_new ,
24.Nm PKCS7_SIGNED_free ,
25.Nm PKCS7_ENVELOPE_new ,
26.Nm PKCS7_ENVELOPE_free ,
27.Nm PKCS7_SIGN_ENVELOPE_new ,
28.Nm PKCS7_SIGN_ENVELOPE_free ,
29.Nm PKCS7_DIGEST_new ,
30.Nm PKCS7_DIGEST_free ,
31.Nm PKCS7_ENCRYPT_new ,
32.Nm PKCS7_ENCRYPT_free ,
33.Nm PKCS7_ENC_CONTENT_new ,
34.Nm PKCS7_ENC_CONTENT_free ,
35.Nm PKCS7_SIGNER_INFO_new ,
36.Nm PKCS7_SIGNER_INFO_free ,
37.Nm PKCS7_RECIP_INFO_new ,
38.Nm PKCS7_RECIP_INFO_free ,
39.Nm PKCS7_ISSUER_AND_SERIAL_new ,
40.Nm PKCS7_ISSUER_AND_SERIAL_free
41.Nd PKCS#7 data structures
42.Sh SYNOPSIS
43.In openssl/pkcs7.h
44.Ft PKCS7 *
45.Fn PKCS7_new void
46.Ft void
47.Fn PKCS7_free "PKCS7 *p7"
48.Ft PKCS7_SIGNED *
49.Fn PKCS7_SIGNED_new void
50.Ft void
51.Fn PKCS7_SIGNED_free "PKCS7_SIGNED *signed"
52.Ft PKCS7_ENVELOPE *
53.Fn PKCS7_ENVELOPE_new void
54.Ft void
55.Fn PKCS7_ENVELOPE_free "PKCS7_ENVELOPE *envelope"
56.Ft PKCS7_SIGN_ENVELOPE *
57.Fn PKCS7_SIGN_ENVELOPE_new void
58.Ft void
59.Fn PKCS7_SIGN_ENVELOPE_free "PKCS7_SIGN_ENVELOPE *signed_envelope"
60.Ft PKCS7_DIGEST *
61.Fn PKCS7_DIGEST_new void
62.Ft void
63.Fn PKCS7_DIGEST_free "PKCS7_DIGEST *digested"
64.Ft PKCS7_ENCRYPT *
65.Fn PKCS7_ENCRYPT_new void
66.Ft void
67.Fn PKCS7_ENCRYPT_free "PKCS7_ENCRYPT *encrypted"
68.Ft PKCS7_ENC_CONTENT *
69.Fn PKCS7_ENC_CONTENT_new void
70.Ft void
71.Fn PKCS7_ENC_CONTENT_free "PKCS7_ENC_CONTENT *content"
72.Ft PKCS7_SIGNER_INFO *
73.Fn PKCS7_SIGNER_INFO_new void
74.Ft void
75.Fn PKCS7_SIGNER_INFO_free "PKCS7_SIGNER_INFO *signer"
76.Ft PKCS7_RECIP_INFO *
77.Fn PKCS7_RECIP_INFO_new void
78.Ft void
79.Fn PKCS7_RECIP_INFO_free "PKCS7_RECIP_INFO *recip"
80.Ft PKCS7_ISSUER_AND_SERIAL *
81.Fn PKCS7_ISSUER_AND_SERIAL_new void
82.Ft void
83.Fn PKCS7_ISSUER_AND_SERIAL_free "PKCS7_ISSUER_AND_SERIAL *cert"
84.Sh DESCRIPTION
85PKCS#7 is an ASN.1-based format for transmitting data that has
86cryptography applied to it, in particular signed and encrypted data.
87.Pp
88.Fn PKCS7_new
89allocates and initializes an empty
90.Vt PKCS7
91object, representing an ASN.1
92.Vt ContentInfo
93structure defined in RFC 2315 section 7.
94It is the top-level data structure able to hold any kind of content
95that can be transmitted using PKCS#7.
96It can be used recursively in
97.Vt PKCS7_SIGNED
98and
99.Vt PKCS7_DIGEST
100objects.
101.Fn PKCS7_free
102frees
103.Fa p7 .
104.Pp
105.Fn PKCS7_SIGNED_new
106allocates and initializes an empty
107.Vt PKCS7_SIGNED
108object, representing an ASN.1
109.Vt SignedData
110structure defined in RFC 2315 section 9.
111It can be used inside
112.Vt PKCS7
113objects and holds any kind of content together with signatures by
114zero or more signers and information about the signing algorithm
115and certificates used.
116.Fn PKCS7_SIGNED_free
117frees
118.Fa signed .
119.Pp
120.Fn PKCS7_ENVELOPE_new
121allocates and initializes an empty
122.Vt PKCS7_ENVELOPE
123object, representing an ASN.1
124.Vt EnvelopedData
125structure defined in RFC 2315 section 10.
126It can be used inside
127.Vt PKCS7
128objects and holds any kind of encrypted content together with
129content-encryption keys for one or more recipients.
130.Fn PKCS7_ENVELOPE_free
131frees
132.Fa envelope .
133.Pp
134.Fn PKCS7_SIGN_ENVELOPE_new
135allocates and initializes an empty
136.Vt PKCS7_SIGN_ENVELOPE
137object, representing an ASN.1
138.Vt SignedAndEnvelopedData
139structure defined in RFC 2315 section 11.
140It can be used inside
141.Vt PKCS7
142objects and holds any kind of encrypted content together with
143signatures by one or more signers, information about the signing
144algorithm and certificates used, and content-encryption keys for
145one or more recipients.
146.Fn PKCS7_SIGN_ENVELOPE_free
147frees
148.Fa signed_envelope .
149.Pp
150.Fn PKCS7_DIGEST_new
151allocates and initializes an empty
152.Vt PKCS7_DIGEST
153object, representing an ASN.1
154.Vt DigestedData
155structure defined in RFC 2315 section 12.
156It can be used inside
157.Vt PKCS7
158objects and holds any kind of content together with a message digest
159for checking its integrity and information about the algorithm used.
160.Fn PKCS7_DIGEST_free
161frees
162.Fa digested .
163.Pp
164.Fn PKCS7_ENCRYPT_new
165allocates and initializes an empty
166.Vt PKCS7_ENCRYPT
167object, representing an ASN.1
168.Vt EncryptedData
169structure defined in RFC 2315 section 13.
170It can be used inside
171.Vt PKCS7
172objects and holds any kind of encrypted content.
173Keys are not included and need to be communicated separately.
174.Fn PKCS7_ENCRYPT_free
175frees
176.Fa encrypted .
177.Pp
178.Fn PKCS7_ENC_CONTENT_new
179allocates and initializes an empty
180.Vt PKCS7_ENC_CONTENT
181object, representing an ASN.1
182.Vt EncryptedContentInfo
183structure defined in RFC 2315 section 10.1.
184It can be used inside
185.Vt PKCS7_ENVELOPE ,
186.Vt PKCS7_SIGN_ENVELOPE ,
187and
188.Vt PKCS7_ENCRYPT
189objects and holds encrypted content together with information about
190the encryption algorithm used.
191.Fn PKCS7_ENC_CONTENT_free
192frees
193.Fa content .
194.Pp
195.Fn PKCS7_SIGNER_INFO_new
196allocates and initializes an empty
197.Vt PKCS7_SIGNER_INFO
198object, representing an ASN.1
199.Vt SignerInfo
200structure defined in RFC 2315 section 9.2.
201It can be used inside
202.Vt PKCS7_SIGNED
203and
204.Vt PKCS7_SIGN_ENVELOPE
205objects and holds a signature together with information about the
206signer and the algorithms used.
207.Fn PKCS7_SIGNER_INFO_free
208frees
209.Fa signer .
210.Pp
211.Fn PKCS7_RECIP_INFO_new
212allocates and initializes an empty
213.Vt PKCS7_RECIP_INFO
214object, representing an ASN.1
215.Vt RecipientInfo
216structure defined in RFC 2315 section 10.2.
217It can be used inside
218.Vt PKCS7_ENVELOPE
219and
220.Vt PKCS7_SIGN_ENVELOPE
221objects and holds a content-encryption key together with information
222about the intended recipient and the key encryption algorithm used.
223.Fn PKCS7_RECIP_INFO_free
224frees
225.Fa recip .
226.Pp
227.Fn PKCS7_ISSUER_AND_SERIAL_new
228allocates and initializes an empty
229.Vt PKCS7_ISSUER_AND_SERIAL
230object, representing an ASN.1
231.Vt IssuerAndSerialNumber
232structure defined in RFC 2315 section 6.7.
233It can be used inside
234.Vt PKCS7_SIGNER_INFO
235and
236.Vt PKCS7_RECIP_INFO
237objects and identifies a certificate by holding the distinguished
238name of the certificate issuer and an issuer-specific certificate
239serial number.
240.Fn PKCS7_ISSUER_AND_SERIAL_free
241frees
242.Fa cert .
243.Sh SEE ALSO
244.Xr crypto 3 ,
245.Xr d2i_PKCS7 3 ,
246.Xr i2d_PKCS7_bio_stream 3 ,
247.Xr PEM_read_PKCS7 3 ,
248.Xr PEM_write_bio_PKCS7_stream 3 ,
249.Xr PKCS7_add_attribute 3 ,
250.Xr PKCS7_dataFinal 3 ,
251.Xr PKCS7_dataInit 3 ,
252.Xr PKCS7_decrypt 3 ,
253.Xr PKCS7_encrypt 3 ,
254.Xr PKCS7_final 3 ,
255.Xr PKCS7_get_signer_info 3 ,
256.Xr PKCS7_ISSUER_AND_SERIAL_digest 3 ,
257.Xr PKCS7_set_content 3 ,
258.Xr PKCS7_set_type 3 ,
259.Xr PKCS7_sign 3 ,
260.Xr PKCS7_sign_add_signer 3 ,
261.Xr PKCS7_verify 3 ,
262.Xr SMIME_read_PKCS7 3 ,
263.Xr SMIME_write_PKCS7 3
264.Sh STANDARDS
265RFC 2315: PKCS #7: Cryptographic Message Syntax Version 1.5
266.Sh HISTORY
267These functions first appeared in SSLeay 0.5.1
268and have been available since
269.Ox 2.4 .
generated by cgit v1.2.3-55-g6feb (git 2.39.1) at 2025-05-06 16:51:52 +0000