← Back to branch summary

~sbeattie/ubuntu/oneiric/openssl/lp850608

« back to all changes in this revision

Viewing changes to doc/apps/openssl.pod

  • Committer: Bazaar Package Importer
  • Author(s): Colin Watson
  • Date: 2011-05-01 23:51:53 UTC
  • mfrom: (11.1.20 sid)
  • Revision ID: james.westby@ubuntu.com-20110501235153-bjcxitndquaezb68
Tags: 1.0.0d-2ubuntu1
https://launchpad.net/bugs/675566
* Resynchronise with Debian (LP: #675566).  Remaining changes:
  - debian/libssl1.0.0.postinst:
    + Display a system restart required notification bubble on libssl1.0.0
      upgrade.
    + Use a different priority for libssl1.0.0/restart-services depending
      on whether a desktop, or server dist-upgrade is being performed.
  - debian/{libssl1.0.0-udeb.dirs, control, rules}: Create
    libssl1.0.0-udeb, for the benefit of wget-udeb (no wget-udeb package
    in Debian).
  - debian/{libcrypto1.0.0-udeb.dirs, libssl1.0.0.dirs, libssl1.0.0.files,
    rules}: Move runtime libraries to /lib, for the benefit of
    wpasupplicant.
  - debian/patches/aesni.patch: Backport Intel AES-NI support, now from
    http://rt.openssl.org/Ticket/Display.html?id=2065 rather than the
    0.9.8 variant.
  - debian/patches/Bsymbolic-functions.patch: Link using
    -Bsymbolic-functions.
  - debian/patches/perlpath-quilt.patch: Don't change perl #! paths under
    .pc.
  - debian/rules:
    + Don't run 'make test' when cross-building.
    + Use host compiler when cross-building.  Patch from Neil Williams.
    + Don't build for processors no longer supported: i486, i586 (on
      i386), v8 (on sparc).
    + Fix Makefile to properly clean up libs/ dirs in clean target.
    + Replace duplicate files in the doc directory with symlinks.
* Update architectures affected by Bsymbolic-functions.patch.
* Drop debian/patches/no-sslv2.patch; Debian now adds the 'no-ssl2'
  configure option, which compiles out SSLv2 support entirely, so this is
  no longer needed.
* Drop openssl-doc in favour of the libssl-doc package introduced by
  Debian.  Add Conflicts/Replaces until the next LTS release.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/apps/openssl.pod
12
12
[ I<command_opts> ]
13
13
[ I<command_args> ]
14
14
 
15
 
B<openssl> [ B<list-standard-commands> | B<list-message-digest-commands> | B<list-cipher-commands> ]
 
15
B<openssl> [ B<list-standard-commands> | B<list-message-digest-commands> | B<list-cipher-commands> | B<list-cipher-algorithms> | B<list-message-digest-algorithms> | B<list-public-key-algorithms>]
16
16
 
17
17
B<openssl> B<no->I<XXX> [ I<arbitrary options> ]
18
18
 
26
26
cryptography functions of OpenSSL's B<crypto> library from the shell. 
27
27
It can be used for 
28
28
 
29
 
 o  Creation of RSA, DH and DSA key parameters
 
29
 o  Creation and management of private keys, public keys and parameters
 
30
 o  Public key cryptographic operations
30
31
 o  Creation of X.509 certificates, CSRs and CRLs 
31
32
 o  Calculation of Message Digests
32
33
 o  Encryption and Decryption with Ciphers
33
34
 o  SSL/TLS Client and Server Tests
34
35
 o  Handling of S/MIME signed or encrypted mail
 
36
 o  Time Stamp requests, generation and verification
35
37
 
36
38
=head1 COMMAND SUMMARY
37
39
 
44
46
of all standard commands, message digest commands, or cipher commands,
45
47
respectively, that are available in the present B<openssl> utility.
46
48
 
 
49
The pseudo-commands B<list-cipher-algorithms> and
 
50
B<list-message-digest-algorithms> list all cipher and message digest names, one entry per line. Aliases are listed as:
 
51
 
 
52
 from => to
 
53
 
 
54
The pseudo-command B<list-public-key-algorithms> lists all supported public
 
55
key algorithms.
 
56
 
47
57
The pseudo-command B<no->I<XXX> tests whether a command of the
48
58
specified name is available.  If no command named I<XXX> exists, it
49
59
returns 0 (success) and prints B<no->I<XXX>; otherwise it returns 1
71
81
 
72
82
Cipher Suite Description Determination.
73
83
 
 
84
=item L<B<cms>|cms(1)>
 
85
 
 
86
CMS (Cryptographic Message Syntax) utility
 
87
 
74
88
=item L<B<crl>|crl(1)>
75
89
 
76
90
Certificate Revocation List (CRL) Management.
88
102
Diffie-Hellman Parameter Management.
89
103
Obsoleted by L<B<dhparam>|dhparam(1)>.
90
104
 
 
105
=item L<B<dhparam>|dhparam(1)>
 
106
 
 
107
Generation and Management of Diffie-Hellman Parameters. Superseded by 
 
108
L<B<genpkey>|genpkey(1)> and L<B<pkeyparam>|pkeyparam(1)>
 
109
 
 
110
 
91
111
=item L<B<dsa>|dsa(1)>
92
112
 
93
113
DSA Data Management.
94
114
 
95
115
=item L<B<dsaparam>|dsaparam(1)>
96
116
 
97
 
DSA Parameter Generation.
 
117
DSA Parameter Generation and Management. Superseded by 
 
118
L<B<genpkey>|genpkey(1)> and L<B<pkeyparam>|pkeyparam(1)>
 
119
 
 
120
=item L<B<ec>|ec(1)>
 
121
 
 
122
EC (Elliptic curve) key processing
 
123
 
 
124
=item L<B<ecparam>|ecparam(1)>
 
125
 
 
126
EC parameter manipulation and generation
98
127
 
99
128
=item L<B<enc>|enc(1)>
100
129
 
101
130
Encoding with Ciphers.
102
131
 
 
132
=item L<B<engine>|engine(1)>
 
133
 
 
134
Engine (loadble module) information and manipulation.
 
135
 
103
136
=item L<B<errstr>|errstr(1)>
104
137
 
105
138
Error Number to Error String Conversion.
106
139
 
107
 
=item L<B<dhparam>|dhparam(1)>
108
 
 
109
 
Generation and Management of Diffie-Hellman Parameters.
110
 
 
111
140
=item B<gendh>
112
141
 
113
142
Generation of Diffie-Hellman Parameters.
115
144
 
116
145
=item L<B<gendsa>|gendsa(1)>
117
146
 
118
 
Generation of DSA Parameters.
 
147
Generation of DSA Private Key from Parameters. Superseded by 
 
148
L<B<genpkey>|genpkey(1)> and L<B<pkey>|pkey(1)>
 
149
 
 
150
=item L<B<genpkey>|genpkey(1)>
 
151
 
 
152
Generation of Private Key or Parameters.
119
153
 
120
154
=item L<B<genrsa>|genrsa(1)>
121
155
 
122
 
Generation of RSA Parameters.
 
156
Generation of RSA Private Key. Superceded by L<B<genpkey>|genpkey(1)>.
 
157
 
 
158
=item L<B<nseq>|nseq(1)>
 
159
 
 
160
Create or examine a netscape certificate sequence
123
161
 
124
162
=item L<B<ocsp>|ocsp(1)>
125
163
 
137
175
 
138
176
PKCS#7 Data Management.
139
177
 
 
178
=item L<B<pkey>|pkey(1)>
 
179
 
 
180
Public and private key management.
 
181
 
 
182
=item L<B<pkeyparam>|pkeyparam(1)>
 
183
 
 
184
Public key algorithm parameter management.
 
185
 
 
186
=item L<B<pkeyutl>|pkeyutl(1)>
 
187
 
 
188
Public key algorithm cryptographic operation utility.
 
189
 
140
190
=item L<B<rand>|rand(1)>
141
191
 
142
192
Generate pseudo-random bytes.
143
193
 
144
194
=item L<B<req>|req(1)>
145
195
 
146
 
X.509 Certificate Signing Request (CSR) Management.
 
196
PKCS#10 X.509 Certificate Signing Request (CSR) Management.
147
197
 
148
198
=item L<B<rsa>|rsa(1)>
149
199
 
150
 
RSA Data Management.
 
200
RSA key management.
 
201
 
151
202
 
152
203
=item L<B<rsautl>|rsautl(1)>
153
204
 
154
 
RSA utility for signing, verification, encryption, and decryption.
 
205
RSA utility for signing, verification, encryption, and decryption. Superseded
 
206
by  L<B<pkeyutl>|pkeyutl(1)>
155
207
 
156
208
=item L<B<s_client>|s_client(1)>
157
209
 
185
237
 
186
238
Algorithm Speed Measurement.
187
239
 
 
240
=item L<B<spkac>|spkac(1)>
 
241
 
 
242
SPKAC printing and generating utility
 
243
 
 
244
=item L<B<ts>|ts(1)>
 
245
 
 
246
Time Stamping Authority tool (client/server)
 
247
 
188
248
=item L<B<verify>|verify(1)>
189
249
 
190
250
X.509 Certificate Verification.
227
287
 
228
288
SHA-1 Digest
229
289
 
 
290
=back
 
291
 
230
292
=item B<sha224>
231
293
 
232
294
SHA-224 Digest
243
305
 
244
306
SHA-512 Digest
245
307
 
246
 
=back
247
 
 
248
308
=head2 ENCODING AND CIPHER COMMANDS
249
309
 
250
310
=over 10
339
399
L<asn1parse(1)|asn1parse(1)>, L<ca(1)|ca(1)>, L<config(5)|config(5)>,
340
400
L<crl(1)|crl(1)>, L<crl2pkcs7(1)|crl2pkcs7(1)>, L<dgst(1)|dgst(1)>,
341
401
L<dhparam(1)|dhparam(1)>, L<dsa(1)|dsa(1)>, L<dsaparam(1)|dsaparam(1)>,
342
 
L<enc(1)|enc(1)>, L<gendsa(1)|gendsa(1)>,
 
402
L<enc(1)|enc(1)>, L<gendsa(1)|gendsa(1)>, L<genpkey(1)|genpkey(1)>,
343
403
L<genrsa(1)|genrsa(1)>, L<nseq(1)|nseq(1)>, L<openssl(1)|openssl(1)>,
344
404
L<passwd(1)|passwd(1)>,
345
405
L<pkcs12(1)|pkcs12(1)>, L<pkcs7(1)|pkcs7(1)>, L<pkcs8(1)|pkcs8(1)>,
348
408
L<s_server(1)|s_server(1)>, L<s_time(1)|s_time(1)>,
349
409
L<smime(1)|smime(1)>, L<spkac(1)|spkac(1)>,
350
410
L<verify(1)|verify(1)>, L<version(1)|version(1)>, L<x509(1)|x509(1)>,
351
 
L<crypto(3)|crypto(3)>, L<ssl(3)|ssl(3)> 
 
411
L<crypto(3)|crypto(3)>, L<ssl(3)|ssl(3)>, L<x509v3_config(5)|x509v3_config(5)> 
352
412
 
353
413
=head1 HISTORY
354
414
 
355
415
The openssl(1) document appeared in OpenSSL 0.9.2.
356
416
The B<list->I<XXX>B<-commands> pseudo-commands were added in OpenSSL 0.9.3;
 
417
The B<list->I<XXX>B<-algorithms> pseudo-commands were added in OpenSSL 1.0.0;
357
418
the B<no->I<XXX> pseudo-commands were added in OpenSSL 0.9.5a.
358
419
For notes on the availability of other commands, see their individual
359
420
manual pages.