Skip to content

Commit 1af66bb

Browse files
nickthetaitmspncp
authored andcommitted
Create troubleshooting subsection in INSTALL file
Fixes: #5130 Reviewed-by: Rich Salz <rsalz@openssl.org> Reviewed-by: Matthias St. Pierre <Matthias.St.Pierre@ncp-e.com> (Merged from #5178)
1 parent 0f5a775 commit 1af66bb

File tree

1 file changed

+20
-8
lines changed

1 file changed

+20
-8
lines changed

INSTALL

Lines changed: 20 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -736,22 +736,34 @@
736736
("openssl"). The libraries will be built in the top-level directory,
737737
and the binary will be in the "apps" subdirectory.
738738

739+
Troubleshooting:
740+
739741
If the build fails, look at the output. There may be reasons
740742
for the failure that aren't problems in OpenSSL itself (like
741-
missing standard headers). If you are having problems you can
742-
get help by sending an email to the openssl-users email list (see
743+
missing standard headers).
744+
745+
If the build succeeded previously, but fails after a source or
746+
configuration change, it might be helpful to clean the build tree
747+
before attempting another build. Use this command:
748+
749+
$ make clean # Unix
750+
$ mms clean ! (or mmk) OpenVMS
751+
$ nmake clean # Windows
752+
753+
Assembler error messages can sometimes be sidestepped by using the
754+
"no-asm" configuration option.
755+
756+
Compiling parts of OpenSSL with gcc and others with the system
757+
compiler will result in unresolved symbols on some systems.
758+
759+
If you are still having problems you can get help by sending an email
760+
to the openssl-users email list (see
743761
https://www.openssl.org/community/mailinglists.html for details). If
744762
it is a bug with OpenSSL itself, please open an issue on GitHub, at
745763
https://github.com/openssl/openssl/issues. Please review the existing
746764
ones first; maybe the bug was already reported or has already been
747765
fixed.
748766

749-
(If you encounter assembler error messages, try the "no-asm"
750-
configuration option as an immediate fix.)
751-
752-
Compiling parts of OpenSSL with gcc and others with the system
753-
compiler will result in unresolved symbols on some systems.
754-
755767
3. After a successful build, the libraries should be tested. Run:
756768

757769
$ make test # Unix

0 commit comments

Comments
 (0)