commands/hash/hash.cif
changeset 0 7f656887cf89
--- /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 <executable_file_name> -o c:\sys\hash\<executable_file_name>
+
+==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.
+