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