Commit e8fd2a4c authored by Richard Levitte's avatar Richard Levitte
Browse files

Add a note about a perl issue on VMS and how to work around it 



I bug in perl's File::Spec->canonpath() was uncovered.  There's
nothing we can do about it (except re-implementing canonpath()),
except working around the problem (a directory rename) and reporting
the issue to the perl module developers.

Reviewed-by: default avatarRich Salz <rsalz@openssl.org>
parent ca1cb0d4

INSTALL

+2 −2
Original line number Diff line number Diff line
@@ -15,8 +15,8 @@ 
    header files

  * a supported operating system



 For additional platform specific requirements and other details,

 please read one of these:

 For additional platform specific requirements, solutions to specific

 issues and other details, please read one of these:



  * NOTES.VMS (OpenVMS)

  * NOTES.WIN (any supported Windows)

NOTES.VMS

+18 −0
Original line number Diff line number Diff line
@@ -27,6 +27,24 @@ 
 running the tests, as they affect the Perl interpreter.





 About ODS-5 directory names and Perl

 ------------------------------------



 It seems that the perl function canonpath() in the File::Spec module

 doesn't treat file specifications where the last directory name

 contains periods very well.  Unfortunately, some versions of VMS tar

 will keep the periods in the OpenSSL source directory instead of

 converting them to underscore, thereby leaving your source in

 something like [.openssl-1^.1^.0].  This will lead to issues when

 configuring and building OpenSSL.



 We have no replacement for Perl's canonpath(), so the best workaround

 for now is to rename the OpenSSL source directory, as follows (please

 adjust for the actual source directory name you have):



    $ rename openssl-1^.1^.0.DIR openssl-1_1_0.DIR 





 About MMS and DCL

 -----------------