cit(1) CyberSoft VFind Security Toolkit cit(1)

NAME

CIT - Cryptographic Integrity Tool

SYNOPSIS

cit [-c, --copyright] [-h, -?, --help] [-v, --version]
cit [--cleanup] [-d, --dirty] [-db databasename, --database-name databasename] [--dbpath databasepath] [-nb, --no-backup] [-nr, --no-report] [-nu, --no-update] [-fc, --file-changed] [-dc, --dupcontents] [-df, --dangerfile] [-S, --stdin] [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.

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

--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!

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

-nb, --no-backup
Don't retain the old database after the run (typically kept in cit.db0).

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

-fc, --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.
-dc, --dupcontents
Reports (usually in Cit.rpt) all of the files that have duplicate hash values.
-df, --dangerfile
Reports (usually in Cit.rpt) all of the files/hashes that are found in the Danger file database.
-S, --stdin
Display the MD5 hash of standard input on standard output.

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 configured during installation.

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

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

© 1996-2001 by CyberSoft, Inc. All rights reserved.


cit(1) CyberSoft VFind Security Toolkit cit(1)