diff -r 000000000000 -r 7f656887cf89 commands/hash/hash.cif --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/commands/hash/hash.cif Wed Jun 23 15:52:26 2010 +0100 @@ -0,0 +1,63 @@ +# hash.cif +# +# Copyright (c) 2010 Accenture. All rights reserved. +# This component and the accompanying materials are made available +# under the terms of the "Eclipse Public License v1.0" +# which accompanies this distribution, and is available +# at the URL "http://www.eclipse.org/legal/epl-v10.html". +# +# Initial Contributors: +# Accenture - Initial contribution +# + +==name hash + +==short-description + +Calculate cryptographic hashes. + +==long-description + +Given some input data, caculates a corresponding number using one of several supported hashing algorithms. Hashing algorithms are designed to have a high likelihood of producing a significantly different number for even small differences in input data. As such, they are useful gaining a degree of certainly about whether a particular data set has changed without having to store the whole data set. + +Reads data to be hashed either from a file or from STDIN. Writes the corresponding hash either to a file or to STDOUT. Supports a variety of different hashing algorithms. + +Defaults to using the SHA1 algorithm if the '-a' option is not specified. This means that to create an hash file of an executable file stored on removable media (such that F32 will allow it to be loaded), run: + + hash -i -o c:\sys\hash\ + +==option bool v verbose + +Verbose output. + +==option filename i input + +The name of the file whose data is to be hashed. If not specified, data is read from STDIN. + +==option filename o output + +The name of the file to write the hash to. If not specified, the hash is ASCII / hex dumped to STDOUT. + +==option enum a algorithm + +==enum-value SHA1 + +==enum-value MD2 + +==enum-value MD4 + +==enum-value MD5 + +==enum-value SHA224 + +==enum-value SHA256 + +==enum-value SHA384 + +==enum-value SHA512 + + +==copyright + +Copyright (c) 2009-2010 Accenture. All rights reserved. +