1 # hash.cif

     2 # 

     3 # Copyright (c) 2010 Accenture. All rights reserved.

     4 # This component and the accompanying materials are made available

     5 # under the terms of the "Eclipse Public License v1.0"

     6 # which accompanies this distribution, and is available

     7 # at the URL "http://www.eclipse.org/legal/epl-v10.html".

     8 # 

     9 # Initial Contributors:

    10 # Accenture - Initial contribution

    11 #

    12 

    13 ==name hash

    14 

    15 ==short-description

    16 

    17 Calculate cryptographic hashes.

    18 

    19 ==long-description

    20 

    21 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.

    22 

    23 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.

    24 

    25 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:

    26 

    27   hash -i <executable_file_name> -o c:\sys\hash\<executable_file_name>

    28 

    29 ==option bool v verbose

    30 

    31 Verbose output.

    32 

    33 ==option filename i input

    34 

    35 The name of the file whose data is to be hashed. If not specified, data is read from STDIN.

    36 

    37 ==option filename o output

    38 

    39 The name of the file to write the hash to. If not specified, the hash is ASCII / hex dumped to STDOUT.

    40 

    41 ==option enum a algorithm

    42 

    43 ==enum-value SHA1

    44 

    45 ==enum-value MD2

    46 

    47 ==enum-value MD4

    48 

    49 ==enum-value MD5

    50 

    51 ==enum-value SHA224

    52 

    53 ==enum-value SHA256

    54 

    55 ==enum-value SHA384

    56 

    57 ==enum-value SHA512

    58 

    59 

    60 ==copyright

    61 

    62 Copyright (c) 2009-2010 Accenture. All rights reserved.

    63