Archival Usage

Up until this point we have been concerned with the basic low-level operations of the fingerprint command. However, typical usage for long term archival is very simple.

Analysis

Given a directory of data that you would later like to verify for consistency, we first need to analyse the data to create a fingerprint. Depending on the amount of data this can take some time.

$ sudo fingerprint -a /etc

-- If you are repeating analysis, you need to use -f 
-- to force updating the existing fingerprint.
$ sudo fingerprint -a -f /etc

Once this is done, you will notice the file exists in the directory that was analysed: ._index.fingerprint. This file contains the fingerprint data. You can control the name of this file using the -n $name option.

Verification

After analysis is complete, data can be verified at any time.

$ sudo fingerprint -v /etc
S 
	error.count 0
Data verified, 0 errors found.

If files were modified or removed, you will receive some error messages:

$ sudo vim /etc/hosts
-- Made some changes ^_^'

$ sudo fingerprint -v /etc
W ./hosts
	changes.file.size.new 245
	changes.file.size.old 236
	changes.key.MD5.new e8db756a9ea5cba150a4056af7090d65
	changes.key.MD5.old cbe7e7eb6480e869bccfa284dc8bd732
	changes.key.SHA2.256.new c8a1c725a37564ae222fb5916cba645ed8074dcb5ee38a44dac5e2c1713f00c6
	changes.key.SHA2.256.old e4fe83dc983472b9507fc9dbc30721b6dbdf5ec014ec10b36afb92cef0ab2094
	error.code keys_different
	error.message Key SHA2.256 does not match
S 
	error.count 1
Data inconsistent, 1 errors found!