---

Manual Reference Pages  - cit (1)

---

Cit - Cryptographic Integrity Tool

CONTENT

Synopsis
Description
     Options
Usage
     Licenses
     Input
Files
See Also
Bugs
Copyright

cit	[ -c, --copyright ] [ -h, -?, --help ] [ -v, --version ]
cit	[ -S, --stdin ] [ --cleanup ] [ --no-dangerfile ] [ -db databasename, --database-name databasename ] [ --dbpath databasepath ] [ -d, --dupcontents ] [ -do, --dupcontents-only ] [ -f, --file-changed ] [ -nb, --no-backup ] [ -nc, --no-cleanup ] [ -nr, --no-report ] [ -nu, --no-update ] [ -t tmp, --tmpdir tmp ] [ -uo, --uniqcontents-only ] [ -- ] [ filename ]

CyberSoft, Inc.’s Cryptographic Integrity Tool is part of the VFind Security ToolKit. An 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).

-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: Current directory.
-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, --file-changed
	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.

CIT requires a LICENSE file to run. This LICENSE file is host specific, therefore cit will only run on the licensed machine. Additional licenses may be purchased by contacting:

CyberSoft, Inc.
1508 Butler Pike
Conshohocken, PA 19428.
Phone: +1.610.825.4748
Fax: +1.610.825.6785

At start-up, cit searches for the LICENSE file in these locations:

* /LICENSE
* /etc/LICENSE
* The current working directory.
* The VSTK library directory set at installation.

CIT can take input in three ways.

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 filename list 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.

vfind(1), thd(1), bhead(1), jdis(1), uad(1), find(1).

Please report all bugs to support@cyber.com Make sure to include the version of cit, the platform and OS, the script or command used, the complete output showing the bug, a short description of the problem, and contact information.

Copyright 1996-2002 by CyberSoft, Inc. All rights reserved.