cit 1

"June 2002"

"CyberSoft, Inc."

"VFind Security Toolkit"

NAME

Cit \- Cryptographic Integrity Tool

SYNOPSIS

cit

"[ " "-c" ", " "--copyright" " ] [ "

"-h" ", "

"-?" ", " "--help" " ] [ "

"-v" ", " "--version" " ] " .TP .B cit .RB "[ " "-S" ", " "--stdin" " ] [ "

"--cleanup" " ] [ "

"--dangerfile" " ] [ "

"-db" .IR "databasename" ", " .B "--database-name" .IR "databasename" " ] [ "

"--dbpath" .IR "databasepath" " ] [ "

"-d" ", " "--dupcontents" " ] [ "

"-do" ", " "--dupcontents-only" " ] [ "

"-f" ", " "--file-changed" " ] [ "

"-nb" ", " "--no-backup" " ] [ "

"-nc" ", " "--no-cleanup" " ] [ "

"-nr" ", " "--no-report" " ] [ "

"-nu" ", " "--no-update" " ] [ "

"-t" .IR "tmp" ", " .B "--tmpdir" .IR "tmp" " ] [ "

"--" " ] [ " .IR "filename" " ]"

DESCRIPTION

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)." .

OPTIONS

"-c" ", " "--copyright" Display copyright information and then exit. All other options will be ignored. .TP

"-h" ", " "-?" ", " "--help" Display usage message and then exit. All other options will be ignored. .TP

"-v" ", " "--version" Display version information and then exit. All other options will be ignored. .TP

"-S" ", " "--stdin" Display the MD5 hash of standard input on standard output. .TP .B --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! .TP

"--dangerfile" Reports (usually in Cit.rpt) all of the files/hashes that are found in the Danger file database. .TP \fB-db \fIdatabasename\fR, \fB--database-name \fIdatabasename\fR Use databasename as the base name for the database. The database itself would be named databasename.db, the report file, databasename.rpt .TP .BI "--dbpath " "databasepath" Use databasepath as the directory in which the database is located. Default: Current directory. .TP

"-d" ", " "--dupcontents" Reports (usually in Cit.rpt) all of the files that have duplicate hash values. .TP

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

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

USAGE

LICENSES 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. .RE .SS INPUT 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

FILES LICENSE

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

SEE ALSO

"vfind" "(1), " "thd" "(1), "

"bhead" "(1), " "jdis" "(1), "

"uad" "(1), " "find" "(1)."

BUGS

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 Copyright 1996-2002 by CyberSoft, Inc. All rights reserved.