OPTIONS

-c, --copyright

Display copyright information and then exit. All other options will be ignored.

-h, -?, --help

Display usage message and then exit. All other options will be ignored.

-v, --version

Display version information and then exit. All other options will be ignored.

-S, --stdin

Display the MD5 hash of standard input on standard output.

--cleanup

Totally remove all cit work and database files. Suitable for use when you want a totally new database or want to release the disk resources that cit is using. Use with caution!

--no-dangerfile

This option will not check for danger files.

-db databasename, --database-name databasename

Use databasename as the base name for the database. The database itself would be named databasename.db, the report file, databasename.rpt

--dbpath databasepath

Use databasepath as the directory in which the database is located. Default: $VSTK_HOME/data/cit.

-d, --dupcontents

Reports (usually in Cit.rpt) all of the files that have duplicate hash values.

-do, --dupcontents-only

Duplicate contents only: cit only creates a cit.dup file based on the existing Cit database listing all files that have duplicate hash values.

-f, --filechanged

Hash the file and compare the hash value with the value found in the Cit database. Report whether the file has changed or not.

-nb, --no-backup

Don't retain the old database after the run (typically kept in cit.db0).

-nc, --no-cleanup

Cit will not remove any tmp files.

-nr, --no-report

Do not generate the cit.rpt report file.

-nu, --no-update

Report changes in the file system, but don't update the database.

-t tmp, --tmpdir tmp

Temp Directory: cit will create tmp files in tmp. If this option is not specified, cit will use the appropriate temp location for your system.

-uo, --uniqcontents-only

Unique contents only: cit only creates a cit.uniq file based on the existing Cit database listing all files that have unique hash values.

--

End of Options: Tells cit that all remaining arguments are to be treated as filenames, even if they start with a dash.

LICENSES

• /LICENSE
• /etc/LICENSE
• The current working directory.
• The VSTK library directory configured during installation.

INPUT

1. cit with a filename argument. In this mode cit will generate a MD5 signature for that file and write it to stdout. No database is created or updated.

   Example:

       cit HelloWorld.java
   

2. cit reading a data stream from the standard input. In this mode cit will generate a MD5 signature for the data stream and write it to stdout. No database is created or updated.

   Example:

       cat BigFile.tar | cit -S
   

3. cit reading a list of filenames from the standard input. This is the default mode of operation. In this mode, it accepts a list of filenames on standard input. A MD5 signature (i.e., a cryptographic hash code) is generated for each file and compared to a previous signature for that file stored in a database (by default, cit.db; this can be overridden with the -db option). A list of new and modified files is written to standard output. A report of new, modified and deleted files is placed in cit.rpt (by default; again, see the -db option).

   Example:

       find / -type f -print | cit
   

LICENSE, cit.db, cit.rpt, cit.db0.