Index: libftpio/Makefile =================================================================== RCS file: /home/ncvs/src/lib/libftpio/Makefile,v retrieving revision 1.13 diff -u -r1.13 Makefile --- libftpio/Makefile 28 Sep 2002 00:25:29 -0000 1.13 +++ libftpio/Makefile 18 Sep 2003 08:51:54 -0000 @@ -10,6 +10,24 @@ MAN= ftpio.3 CLEANFILES= ftperr.c +MLINKS+=ftpio.3 ftpLogin.3 +MLINKS+=ftpio.3 ftpChdir.3 +MLINKS+=ftpio.3 ftpErrno.3 +MLINKS+=ftpio.3 ftpErrString.3 +MLINKS+=ftpio.3 ftpGetModtime.3 +MLINKS+=ftpio.3 ftpGetSize.3 +MLINKS+=ftpio.3 ftpGet.3 +MLINKS+=ftpio.3 ftpPut.3 +MLINKS+=ftpio.3 ftpAscii.3 +MLINKS+=ftpio.3 ftpBinary.3 +MLINKS+=ftpio.3 ftpPassive.3 +MLINKS+=ftpio.3 ftpVerbose.3 +MLINKS+=ftpio.3 ftpGetURL.3 +MLINKS+=ftpio.3 ftpPutURL.3 +MLINKS+=ftpio.3 ftpLoginAf.3 +MLINKS+=ftpio.3 ftpGetURLAf.3 +MLINKS+=ftpio.3 ftpPutURLAf.3 + ftperr.c: ftp.errors @echo '#include ' > ${.TARGET} @echo '#include "ftpio.h"' >> ${.TARGET} Index: libftpio/ftpio.3 =================================================================== RCS file: /home/ncvs/src/lib/libftpio/ftpio.3,v retrieving revision 1.32 diff -u -r1.32 ftpio.3 --- libftpio/ftpio.3 8 Jun 2003 10:29:28 -0000 1.32 +++ libftpio/ftpio.3 18 Sep 2003 08:51:54 -0000 @@ -93,7 +93,8 @@ .Fa ftp_port defaults to the standard ftp port of 21) and .Fa verbose -fields. If it is successful, a +fields. +If it is successful, a standard stream descriptor is returned which should be passed to subsequent FTP operations. On failure, NULL is returned and @@ -104,7 +105,8 @@ .Fn ftpChdir function attempts to issue a server CD command to the directory named in .Fa dir . -On success, zero is returned. On failure, the error code from the server. +On success, zero is returned. +On failure, the error code from the server. .Pp The .Fn ftpErrno @@ -121,15 +123,16 @@ argument (which is assumed to be relative to the FTP server's current directory, see .Fn ftpChdir ) -and returns a new FILE* pointer for the file or NULL on failure. If +and returns a new FILE* pointer for the file or NULL on failure. +If .Fa seekto is non-NULL, the contents of the integer it points to will be used as a restart point for the file, that is to say that the stream returned will point .Fa *seekto bytes into the file gotten (this is handy for restarting failed -transfers efficiently). If the seek operation fails, the value -of +transfers efficiently). +If the seek operation fails, the value of .Fa *seekto will be zero'd. .Pp @@ -137,13 +140,15 @@ .Fn ftpGetModtime function returns the last modification time of the file named by the .Fa file -argument. If the file could not be opened or stat'd, 0 is returned. +argument. +If the file could not be opened or stat'd, 0 is returned. .Pp The .Fn ftpGetSize function returns the size in bytes of the file named by the .Fa file -argument. If the file could not be opened or stat'd, -1 is returned. +argument. +If the file could not be opened or stat'd, -1 is returned. .Pp The .Fn ftpPut @@ -195,7 +200,8 @@ operations except that no server .Fa stream is ever returned - the connection to the server closes when -the file has been completely read. Use the lower-level routines +the file has been completely read. +Use the lower-level routines if multiple gets are required as it will be far more efficient. .Pp The @@ -208,7 +214,8 @@ and .Fn ftpPut operations except that no server stream is ever returned - the connection -to the server closes when the file has been completely written. Use the +to the server closes when the file has been completely written. +Use the lower-level routines if multiple puts are required as it will be far more efficient. .Pp @@ -231,7 +238,11 @@ connection. .It Ev FTP_PASSIVE_MODE If defined, forces the use of passive mode, unless equal -to ``NO'' or ``no'' in which case active mode is forced. +to +.Dq NO +or +.Dq no +in which case active mode is forced. If defined, the setting of this variable always overrides any calls to .Fn ftpPassive . .El @@ -242,7 +253,8 @@ .Sh HISTORY Started life as Poul-Henning Kamp's ftp driver for the system installation utility, later significantly mutated into a more general form as an -extension of stdio by Jordan Hubbard. Also incorporates some ideas and +extension of stdio by Jordan Hubbard. +Also incorporates some ideas and extensions from Jean-Marc Zucconi. .Sh AUTHORS .An Jordan Hubbard , Index: libmd/mdX.3 =================================================================== RCS file: /home/ncvs/src/lib/libmd/mdX.3,v retrieving revision 1.25 diff -u -r1.25 mdX.3 --- libmd/mdX.3 24 Mar 2003 15:57:41 -0000 1.25 +++ libmd/mdX.3 18 Sep 2003 08:51:54 -0000 @@ -44,19 +44,25 @@ .Fn MDXData "const unsigned char *data" "unsigned int len" "char *buf" .Sh DESCRIPTION The MDX functions calculate a 128-bit cryptographic checksum (digest) -for any number of input bytes. A cryptographic checksum is a one-way +for any number of input bytes. +A cryptographic checksum is a one-way hash-function, that is, you cannot find (except by exhaustive search) -the input corresponding to a particular output. This net result is -a ``fingerprint'' of the input-data, which doesn't disclose the actual -input. +the input corresponding to a particular output. +This net result is a +.Dq fingerprint +of the input-data, which doesn't disclose the actual input. .Pp MD2 is the slowest, MD4 is the fastest and MD5 is somewhere in the middle. MD2 can only be used for Privacy-Enhanced Mail. MD4 has now been broken; it should only be used where necessary for backward compatibility. MD5 has not yet (1999-02-11) been broken, but sufficient attacks have been -made that its security is in some doubt. The attacks on both MD4 and MD5 -are both in the nature of finding ``collisions'' \- that is, multiple +made that its security is in some doubt. +The attacks on both MD4 and MD5 +are both in the nature of finding +.Dq collisions +\- +that is, multiple inputs which hash to the same value; it is still unlikely for an attacker to be able to determine the exact original input given a hash value. .Pp @@ -65,7 +71,10 @@ .Fn MDXUpdate , and .Fn MDXFinal -functions are the core functions. Allocate an MDX_CTX, initialize it with +functions are the core functions. +Allocate an +.Vt MDX_CTX , +initialize it with .Fn MDXInit , run over the data with .Fn MDXUpdate , Index: libmd/ripemd.3 =================================================================== RCS file: /home/ncvs/src/lib/libmd/ripemd.3,v retrieving revision 1.11 diff -u -r1.11 ripemd.3 --- libmd/ripemd.3 24 Mar 2003 15:57:41 -0000 1.11 +++ libmd/ripemd.3 18 Sep 2003 08:51:54 -0000 @@ -44,18 +44,23 @@ The .Li RIPEMD160_ functions calculate a 160-bit cryptographic checksum (digest) -for any number of input bytes. A cryptographic checksum is a one-way +for any number of input bytes. +A cryptographic checksum is a one-way hash function; that is, it is computationally impractical to find -the input corresponding to a particular output. This net result is -a ``fingerprint'' of the input-data, which doesn't disclose the actual -input. +the input corresponding to a particular output. +This net result is a +.Dq fingerprint +of the input-data, which doesn't disclose the actual input. .Pp The .Fn RIPEMD160_Init , .Fn RIPEMD160_Update , and .Fn RIPEMD160_Final -functions are the core functions. Allocate an RIPEMD160_CTX, initialize it with +functions are the core functions. +Allocate an +.Vt RIPEMD160_CTX , +initialize it with .Fn RIPEMD160_Init , run over the data with .Fn RIPEMD160_Update , Index: libmd/sha.3 =================================================================== RCS file: /home/ncvs/src/lib/libmd/sha.3,v retrieving revision 1.13 diff -u -r1.13 sha.3 --- libmd/sha.3 25 Mar 2002 14:11:14 -0000 1.13 +++ libmd/sha.3 18 Sep 2003 08:51:54 -0000 @@ -67,18 +67,22 @@ and .Li SHA1_ functions calculate a 160-bit cryptographic checksum (digest) -for any number of input bytes. A cryptographic checksum is a one-way +for any number of input bytes. +A cryptographic checksum is a one-way hash function; that is, it is computationally impractical to find -the input corresponding to a particular output. This net result is -a ``fingerprint'' of the input-data, which doesn't disclose the actual -input. +the input corresponding to a particular output. +This net result is +a +.Dq fingerprint +of the input-data, which doesn't disclose the actual input. .Pp .Tn SHA (or .Tn SHA-0 ) is the original Secure Hash Algorithm specified in .Tn FIPS -160. It was quickly proven insecure, and has been superseded by +160. +It was quickly proven insecure, and has been superseded by .Tn SHA-1 . .Tn SHA-0 is included for compatibility purposes only. @@ -88,7 +92,10 @@ .Fn SHA1_Update , and .Fn SHA1_Final -functions are the core functions. Allocate an SHA_CTX, initialize it with +functions are the core functions. +Allocate an +.Vt SHA_CTX , +initialize it with .Fn SHA1_Init , run over the data with .Fn SHA1_Update , @@ -170,8 +177,8 @@ .Tn SHA-1 makes heavy use of the .Ql bswapl -instruction, which is not present on the original 80386. Attempts -to use +instruction, which is not present on the original 80386. +Attempts to use .Tn SHA-1 on those processors will cause an illegal instruction trap. (Arguably, the kernel should simply emulate this instruction.)