INSTALL revision 63360950109af2ce85a962ca61f40b8782f11100
2N/ACheck the CC and CFLAGS lines in the makefile
2N/A
2N/AIf your C library does not support the times(3) function, change the
2N/A#define TIMES to
2N/A#undef TIMES in speed.c
2N/AIf it does, check the HZ value for the times(3) function.
2N/AIf your system does not define CLK_TCK it will be assumed to
2N/Abe 100.0.
2N/A
2N/AIf possible use gcc v 2.7.?
2N/ATurn on the maximum optimising (normally '-O3 -fomit-frame-pointer' for gcc)
2N/AIn recent times, some system compilers give better performace.
2N/A
2N/Atype 'make'
2N/A
2N/Arun './destest' to check things are ok.
2N/Arun './rpw' to check the tty code for reading passwords works.
2N/Arun './speed' to see how fast those optimisations make the library run :-)
2N/Arun './des_opts' to determin the best compile time options.
2N/A
2N/AThe output from des_opts should be put in the makefile options and des_enc.c
2N/Ashould be rebuilt. For 64 bit computers, do not use the DES_PTR option.
2N/AFor the DEC Alpha, edit des.h and change DES_LONG to 'unsigned int'
2N/Aand then you can use the 'DES_PTR' option.
2N/A
2N/AThe file options.txt has the options listed for best speed on quite a
2N/Afew systems. Look and the options (UNROLL, PTR, RISC2 etc) and then
2N/Aturn on the relevant option in the Makefile
2N/A
2N/AThere are some special Makefile targets that make life easier.
2N/Amake cc - standard cc build
2N/Amake gcc - standard gcc build
2N/Amake x86-elf - x86 assembler (elf), linux-elf.
2N/Amake x86-out - x86 assembler (a.out), FreeBSD
2N/Amake x86-solaris- x86 assembler
2N/Amake x86-bsdi - x86 assembler (a.out with primative assembler).
2N/A
2N/AIf at all possible use the assembler (for Windows NT/95, use
2N/Aasm/win32.obj to link with). The x86 assembler is very very fast.
2N/A
2N/AA make install will by default install
2N/Alibdes.a in /usr/local/lib/libdes.a
2N/Ades in /usr/local/bin/des
2N/Ades_crypt.man in /usr/local/man/man3/des_crypt.3
2N/Ades.man in /usr/local/man/man1/des.1
2N/Ades.h in /usr/include/des.h
2N/A
2N/Ades(1) should be compatible with sunOS's but I have been unable to
2N/Atest it.
2N/A
2N/AThese routines should compile on MSDOS, most 32bit and 64bit version
2N/Aof Unix (BSD and SYSV) and VMS, without modification.
2N/AThe only problems should be #include files that are in the wrong places.
2N/A
2N/AThese routines can be compiled under MSDOS.
2N/AI have successfully encrypted files using des(1) under MSDOS and then
2N/Adecrypted the files on a SparcStation.
2N/AI have been able to compile and test the routines with
2N/AMicrosoft C v 5.1 and Turbo C v 2.0.
2N/AThe code in this library is in no way optimised for the 16bit
2N/Aoperation of MSDOS.
2N/A
2N/AWhen building for glibc, ignore all of the above and just unpack into
2N/Aglibc-1.??/des and then gmake as per normal.
2N/A
2N/AAs a final note on performace. Certain CPUs like sparcs and Alpha often give
2N/Aa %10 speed difference depending on the link order. It is rather anoying
2N/Awhen one program reports 'x' DES encrypts a second and another reports
2N/A'x*0.9' the speed.
2N/A