reference/openssl/functions/openssl-pkcs7-verify.xml
497c40ac164d5873fd87f622dfdeb5206392b446
497c40ac164d5873fd87f622dfdeb5206392b446
...
...
@@ -1,6 +1,6 @@
1
1
<?xml version="1.0" encoding="utf-8"?>
2
2
<!-- $Revision$ -->
3
-
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.openssl-pkcs7-verify">
3
+
<refentry xml:id="function.openssl-pkcs7-verify" xmlns="http://docbook.org/ns/docbook">
4
4
<refnamediv>
5
5
<refname>openssl_pkcs7_verify</refname>
6
6
<refpurpose>Verifies the signature of an S/MIME signed message</refpurpose>
...
...
@@ -9,14 +9,14 @@
9
9
<refsect1 role="description">
10
10
&reftitle.description;
11
11
<methodsynopsis>
12
-
<type>mixed</type><methodname>openssl_pkcs7_verify</methodname>
13
-
<methodparam><type>string</type><parameter>filename</parameter></methodparam>
12
+
<type class="union"><type>bool</type><type>int</type></type><methodname>openssl_pkcs7_verify</methodname>
13
+
<methodparam><type>string</type><parameter>input_filename</parameter></methodparam>
14
14
<methodparam><type>int</type><parameter>flags</parameter></methodparam>
15
-
<methodparam choice="opt"><type>string</type><parameter>outfilename</parameter></methodparam>
16
-
<methodparam choice="opt"><type>array</type><parameter>cainfo</parameter></methodparam>
17
-
<methodparam choice="opt"><type>string</type><parameter>extracerts</parameter></methodparam>
18
-
<methodparam choice="opt"><type>string</type><parameter>content</parameter></methodparam>
19
-
<methodparam choice="opt"><type>string</type><parameter>p7bfilename</parameter></methodparam>
15
+
<methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>signers_certificates_filename</parameter><initializer>&null;</initializer></methodparam>
16
+
<methodparam choice="opt"><type>array</type><parameter>ca_info</parameter><initializer>[]</initializer></methodparam>
17
+
<methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>untrusted_certificates_filename</parameter><initializer>&null;</initializer></methodparam>
18
+
<methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>content</parameter><initializer>&null;</initializer></methodparam>
19
+
<methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>output_filename</parameter><initializer>&null;</initializer></methodparam>
20
20
</methodsynopsis>
21
21
<para>
22
22
<function>openssl_pkcs7_verify</function> reads the S/MIME message
...
...
@@ -29,7 +29,7 @@
29
29
<para>
30
30
<variablelist>
31
31
<varlistentry>
32
-
<term><parameter>filename</parameter></term>
32
+
<term><parameter>input_filename</parameter></term>
33
33
<listitem>
34
34
<para>
35
35
Path to the message.
...
...
@@ -47,20 +47,20 @@
47
47
</listitem>
48
48
</varlistentry>
49
49
<varlistentry>
50
-
<term><parameter>outfilename</parameter></term>
50
+
<term><parameter>signers_certificates_filename</parameter></term>
51
51
<listitem>
52
52
<para>
53
-
If the <parameter>outfilename</parameter> is specified, it should be a
53
+
If the <parameter>signers_certificates_filename</parameter> is specified, it should be a
54
54
string holding the name of a file into which the certificates of the
55
-
persons that signed the messages will be stored in PEM format.
55
+
persons that signed the messages will be stored in <acronym>PEM</acronym> format.
56
56
</para>
57
57
</listitem>
58
58
</varlistentry>
59
59
<varlistentry>
60
-
<term><parameter>cainfo</parameter></term>
60
+
<term><parameter>ca_info</parameter></term>
61
61
<listitem>
62
62
<para>
63
-
If the <parameter>cainfo</parameter> is specified, it should hold
63
+
If the <parameter>ca_info</parameter> is specified, it should hold
64
64
information about the trusted CA certificates to use in the verification
65
65
process - see <link linkend="openssl.cert.verification">certificate
66
66
verification</link> for more information about this parameter.
...
...
@@ -68,10 +68,10 @@
68
68
</listitem>
69
69
</varlistentry>
70
70
<varlistentry>
71
-
<term><parameter>extracerts</parameter></term>
71
+
<term><parameter>untrusted_certificates_filename</parameter></term>
72
72
<listitem>
73
73
<para>
74
-
If the <parameter>extracerts</parameter> is specified, it is the filename
74
+
If the <parameter>untrusted_certificates_filename</parameter> is specified, it is the filename
75
75
of a file containing a bunch of certificates to use as untrusted CAs.
76
76
</para>
77
77
</listitem>
...
...
@@ -87,7 +87,7 @@
87
87
</listitem>
88
88
</varlistentry>
89
89
<varlistentry>
90
-
<term><parameter>p7bfilename</parameter></term>
90
+
<term><parameter>output_filename</parameter></term>
91
91
<listitem>
92
92
<para>
93
93
...
...
@@ -109,26 +109,31 @@
109
109
110
110
<refsect1 role="changelog">
111
111
&reftitle.changelog;
112
-
<para>
113
-
<informaltable>
114
-
<tgroup cols="2">
115
-
<thead>
116
-
<row>
117
-
<entry>&Version;</entry>
118
-
<entry>&Description;</entry>
119
-
</row>
120
-
</thead>
121
-
<tbody>
122
-
<row>
123
-
<entry>7.2.0</entry>
124
-
<entry>
125
-
The <parameter>p7bfilename</parameter> parameter was added.
126
-
</entry>
127
-
</row>
128
-
</tbody>
129
-
</tgroup>
130
-
</informaltable>
131
-
</para>
112
+
<informaltable>
113
+
<tgroup cols="2">
114
+
<thead>
115
+
<row>
116
+
<entry>&Version;</entry>
117
+
<entry>&Description;</entry>
118
+
</row>
119
+
</thead>
120
+
<tbody>
121
+
<row>
122
+
<entry>8.0.0</entry>
123
+
<entry>
124
+
<parameter>signers_certificates_filename</parameter>, <parameter>untrusted_certificates_filename</parameter>,
125
+
<parameter>content</parameter> and <parameter>output_filename</parameter> are nullable now.
126
+
</entry>
127
+
</row>
128
+
<row>
129
+
<entry>7.2.0</entry>
130
+
<entry>
131
+
The <parameter>output_filename</parameter> parameter was added.
132
+
</entry>
133
+
</row>
134
+
</tbody>
135
+
</tgroup>
136
+
</informaltable>
132
137
</refsect1>
133
138
134
139
<refsect1 role="notes">
...
...
@@ -136,13 +141,12 @@
136
141
<note>
137
142
<simpara>
138
143
As specified in RFC 2045, lines may not be longer than 76 characters
139
-
in the <parameter>filename</parameter> parameter.
144
+
in the <parameter>input_filename</parameter> parameter.
140
145
</simpara>
141
146
</note>
142
147
</refsect1>
143
148
144
149
</refentry>
145
-
146
150
<!-- Keep this comment at the end of the file
147
151
Local variables:
148
152
mode: sgml
149
153