mirror of
https://github.com/openssl/openssl.git
synced 2024-12-21 06:09:35 +08:00
7ed6de997f
Reviewed-by: Neil Horman <nhorman@openssl.org> Release: yes
120 lines
2.5 KiB
Plaintext
120 lines
2.5 KiB
Plaintext
=pod
|
|
{- OpenSSL::safe::output_do_not_edit_headers(); -}
|
|
|
|
=head1 NAME
|
|
|
|
openssl-version - print OpenSSL version information
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
B<openssl version>
|
|
[B<-help>]
|
|
[B<-a>]
|
|
[B<-v>]
|
|
[B<-b>]
|
|
[B<-o>]
|
|
[B<-f>]
|
|
[B<-p>]
|
|
[B<-d>]
|
|
[B<-e>]
|
|
[B<-m>]
|
|
[B<-r>]
|
|
[B<-c>]
|
|
[B<-w>]
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
This command is used to print out version information about OpenSSL.
|
|
|
|
=head1 OPTIONS
|
|
|
|
=over 4
|
|
|
|
=item B<-help>
|
|
|
|
Print out a usage message.
|
|
|
|
=item B<-a>
|
|
|
|
All information, this is the same as setting all the other flags.
|
|
|
|
=item B<-v>
|
|
|
|
The current OpenSSL version.
|
|
|
|
=item B<-b>
|
|
|
|
The date the current version of OpenSSL was built.
|
|
|
|
=item B<-o>
|
|
|
|
Option information: various options set when the library was built.
|
|
|
|
=item B<-f>
|
|
|
|
Compilation flags.
|
|
|
|
=item B<-p>
|
|
|
|
Platform setting.
|
|
|
|
=item B<-d>
|
|
|
|
OPENSSLDIR setting.
|
|
|
|
=item B<-e>
|
|
|
|
ENGINESDIR settings.
|
|
|
|
=item B<-m>
|
|
|
|
MODULESDIR settings.
|
|
|
|
=item B<-r>
|
|
|
|
The random number generator source settings.
|
|
|
|
=item B<-c>
|
|
|
|
The OpenSSL CPU settings info.
|
|
|
|
=item B<-w>
|
|
|
|
The OpenSSL B<OSSL_WINCTX> build time variable, if set.
|
|
Used for computing Windows registry key names. This option is unavailable on
|
|
non-Windows platforms.
|
|
|
|
=back
|
|
|
|
=head1 HISTORY
|
|
|
|
In OpenSSL versions prior to 3.4, OpenSSL had a limitation regarding the
|
|
B<OPENSSLDIR>, B<MODULESDIR> and B<ENGINESDIR> build time macros. These macros
|
|
were defined at build time, and represented filesystem paths. This is common
|
|
practice on unix like systems, as there was an expectation that a given build
|
|
would be installed to a pre-determined location. On Windows however, there is
|
|
no such expectation, as libraries can be installed to arbitrary locations.
|
|
B<OSSL_WINCTX> was introduced as a new build time variable to define a set of
|
|
registry keys identified by the name openssl-<version>-<ctx>, in which the
|
|
<version> value is derived from the version string in the openssl source, and
|
|
the <ctx> extension is derived from the B<OSSL_WINCTX> variable. The values of
|
|
B<OPENSSLDIR>, B<ENGINESDIR> and B<MODULESDIR> can be set to various paths
|
|
underneath this key to break the requirement to predict the installation path at
|
|
build time.
|
|
|
|
=head1 NOTES
|
|
|
|
The output of C<openssl version -a> would typically be used when sending
|
|
in a bug report.
|
|
|
|
=head1 COPYRIGHT
|
|
|
|
Copyright 2000-2024 The OpenSSL Project Authors. All Rights Reserved.
|
|
|
|
Licensed under the Apache License 2.0 (the "License"). You may not use
|
|
this file except in compliance with the License. You can obtain a copy
|
|
in the file LICENSE in the source distribution or at
|
|
L<https://www.openssl.org/source/license.html>.
|
|
|
|
=cut
|