@database md5sum2.guide @$VER: md5sum2.guide 1.01 (18.7.99) This is a document in the AmigaGuide format. To read it, use either AmigaGuide, MultiView, or any other AmigaGuide compatible hypertext browser. @node main "md5sum2 Documentation - Contents" ********************************************************************** ** ** ** @{b}md5sum2@{ub} 1.01 ** ** ** ** ** ** Copyright © 1999 Stephan Fuhrmann ** ** ** ********************************************************************** @{" Introduction " link Introduction} Why @{b}md5sum2@{ub}? @{" Copyright " link Copyright } Most important information. @{" System Requirements " link Requirements} Read this before usage. @{" Usage " link Usage } How to use it. @{" History " link History } What happened to these programs. @{" Author " link Author } How to contact me. @{" PGP Signatures (.asc) " link PGP } How to verify the components. @endnode @node History "md5sum2 Documentation - History" @{b}v1.01@{ub}: improved handling of non md5sum lines in text files. @{b}v1.0@{ub}: first internal version. @endnode @node PGP "md5sum2 Documentation - PGP Signatures" To ensure that you get an unmodified version of md5sum2, I've included PGP signatures for every important file (all files ending with '.asc' are signatures). The PGP signatures have been created using PGP 5.0 Amiga. Since I'm using a @{i}Diffie-Hellman@{ui} key you will only be able to verify the PGP signatures with PGP 5.0 or above. My public key can be found @{" here " link PUBKEY}, but it's not needed for verifying signatures. You can verify the files with the following command: pgpv @{i}filename.asc@{ui} where @{i}filename.asc@{ui} is the name of the signature file. @endnode @node PUBKEY "md5sum2 Documentation - Author's PGP Public Key" -----BEGIN PGP PUBLIC KEY BLOCK----- Version: PGPfreeware 5.0i for non-commercial use Comment: PGP 5i Amiga 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 =EVf5 -----END PGP PUBLIC KEY BLOCK----- @endnode @node Requirements "md5sum2 Documentation - Requirements" @{u}Hardware@{uu} Amiga @{u}Software@{uu} OS 2.0 or higher exec.library dos.library @endnode @node Copyright "md5sum2 Documentation - Copyright" @{b}md5sum2@{ub} is a program package that should improve the usability of the Amiga. The safe function of any program in this package can't be granted. Usage is at your own risk! @{b}md5sum2@{ub} may be included in Fred Fish's AmigaLib, on the AmiNet and on Meeting Pearls. @{b}IT IS STRICTLY PROHIBITED TO SELL THIS SOFTWARE ON MEDIA OTHER THAN THOSE COMING DIRECTLY FROM THE SOURCES DESCRIBED ABOVE. THIRD PARTIES NEED THE WRITTEN PERMISSION OF THE AUTHOR.@{ub} @{b}IT IS ALSO STRICTLY PROHIBITED TO COMMERCIALLY USE, REUSE AND/OR ALTER PARTS OR ROUTINES OF THE PROGRAM AND DOCUMENTATION WITHOUT THE WRITTEN PERMISSION OF THE AUTHOR. @{ub} @endnode @node Introduction "md5sum2 Documentation - Introduction" md5sum2 is an implementation of the md5 checksum algorithm. It is not based on RSA's MD5 routines, but it is fully compatible to them. The main motivation for this utility was that the 'original' md5sum distributed with PGP was only a poor UNIX port. md5sum2 does asynchronous i/o, can recursively scan directories, understands AMIGADOS patterns, and has a native AMIGA shell interface. These are all features the original (PGP)-md5sum is lacking. The name @{i}md5sum2@{ui} has been used to avoid confusion when having the PGP version and this version of md5sum2 on your machine. It's not command line compatible, but command lines are easily adaptable. Checksums are compatible. Created using SAS/C 6.58. @endnode @node Usage "md5sum2 Documentation - md5sum2 usage" @{u}md5sum2@{uu} md5sum2 supports the following command line arguments: FILES/M,CHECK/S,BINARY/S,VERBOSE/S,STATS/S,ALL/S,NOASYNC/S @{b}· FILES/M@{ub} - one or more files to process. You can specify multiple files with an AMIGADOS pattern and/or directories in combination with 'ALL'. If there are no files given md5sum2 expects a file at stdin. @{b}· CHECK/S@{ub} - the files specified are checksums, check them. Be sure that all files to be checked are in the path relative to the current directory. It is possible to have non checksum lines in the output, md5sum2 will be clever enough not to process them. This way you can have a document with some md5-sums and feed the whole document to md5sum2. @{b}· BINARY/S@{ub} - treat files as binaries. This option has no effect in this version of md5sum2. @{b}· VERBOSE/S@{ub} - verbose output of the current action. If you don't specify @{i}VERBOSE@{ui}, only errors will be reported. @{b}· STATS/S@{ub} - print some statistics at the end of the operation. @{b}· ALL/S@{ub} - enter directories. Note: md5sum2 will include only subdirectory entered by itself in the path of the checksum lines. @{b}· NOASYNC/S@{ub} - md5sum2 uses the asyncio.lib linker library routines. If you experience problems with these routines, you can try it again with this option and look whether the problem gets fixed. Please report me any problems. Examples: md5sum2 #?.md5 CHECK (test the checksums of all files having a md5 checksum file (i.e. the files in this package)) md5sum2 #? all (recursively compute md5 checksums) md5sum2 ram:CHKSUM.md5 CHECK (test the checksums in the file ram:CHKSUM.md5) md5sum2 ram:#? CHECK (treat all files in the ram disk as checksums and try to check them) md5sum2 < s:Startup-Sequence (compute md5 checksum of s:startup-sequence. will use standard synchronous i/o because of the redirection.) md5sum2 s:Startup-Sequence (compute md5 checksum of s:startup-sequence. will use async i/o.) @endnode @node Author "md5sum2 Documentation - Author" @{u}email:@{uu} Stephan.Fuhrmann@gmx.de @{u}PGP:@{uu} My public key can be found @{" here " link PUBKEY}. It's a Diffie-Hellman key, so ensure that you're using PGP 5.0 or above. My key is also available on PGP key servers. @endnode