DJGPP documentation note update.
[openssl.git] / INSTALL.DJGPP
1
2  
3  INSTALLATION ON THE DOS PLATFORM WITH DJGPP
4  -------------------------------------------
5
6  OpenSSL has been ported to DJGPP, a 32-bit run-time environment for
7  16-bit DOS, but only with long filename support. If you wish to
8  compile on native DOS with 8+3 filenames, you will have to tweak the
9  installation yourself, including renaming files with illegal
10  or duplicate names.
11
12  You should have a full DJGPP environment installed, including the
13  latest versions of DJGPP, GCC, BINUTILS, BASH, etc. This package
14  requires that PERL and BC also be installed.
15
16  All of these can be obtained from the usual DJGPP mirror sites, such
17  as "ftp://ftp.simtel.net/pub/simtelnet/gnu/djgpp". You also need to
18  have the WATT-32 networking package installed before you try to compile
19  openssl. This can be obtained from "http://www.bgnett.no/~giva/".
20  The Makefile assumes that the WATT-32 code is in the directory
21  specified by the environment variable WATT_ROOT. If you have watt-32
22  in directory "watt32" under your main DJGPP directory, specify
23  WATT_ROOT="/dev/env/DJDIR/watt32".
24
25  To compile openssl, start your BASH shell. Then configure for DOS by
26  running "./Configure" with appropriate arguments. The basic syntax for
27  DOS is:
28  ./Configure no-threads --prefix=/dev/env/DJDIR DJGPP
29  
30  You may run out of DPMI selectors when running in a DOS box under
31  Windows. If so, just close the BASH shell, go back to Windows, and
32  restart BASH. Then run "make" again.
33
34  Building openssl under DJGPP has been tested with DJGPP 2.03,
35  GCC 2.952, GCC 2.953, perl 5.005_02 and perl 5.006_01.
36
37  RUN-TIME CAVEAT LECTOR
38  --------------
39
40  Quoting FAQ:
41
42   "Cryptographic software needs a source of unpredictable data to work
43    correctly.  Many open source operating systems provide a "randomness
44    device" (/dev/urandom or /dev/random) that serves this purpose."
45
46  As of version 0.9.7f OpenSSL checks upon /dev/urandom$ for a 3rd party DOS
47  driver. One such driver implemented by Robert Rothenberg "Walking-Owl"
48  can be obtained from "http://www.funet.fi/pub/crypt/random/noise063.zip."