dbfp_pub/docs
JohnE b22b34a1d7 MOD: updated to reflect the new options added (-dd) (-idx) 2015-12-14 15:27:07 -08:00
..
FINGERPRINT_FORMAT MOD: moved documents out of the root 2015-10-21 19:00:19 -07:00
README MOD: updated the readme 2015-10-28 16:02:44 -07:00
README_DEV MOD: moved documents out of the root 2015-10-21 19:00:19 -07:00
RELEASE_NOTES MOD: updated to reflect the new options added (-dd) (-idx) 2015-12-14 15:27:07 -08:00
devnotes NEW: added developer notes 2015-12-14 15:27:07 -08:00

README

      ==================
        DB Fingerprint
      ==================


-------------
  INTRO
-------------
[D]ata[B]ase [F]inger[P]rint

dbfp is a tool that will scan a sqlite database and generate a fingerprint.
The fingerprint will uniquely identify the database.
The fingerprint consists of the database schema, the sql table create statements, 
  md5 calculations, and file meta-data.
The fingerprint is stored to disk in JSON format.

The fingerprint can be used to identify unknown databases from random paths or recovered from deleted space.
The fingerprint can be used for historical comparisons to see what has changed in a new version of an application.


-------------
  FEATURES
-------------
1. Generate a fingerprint in JSON format.
2. Compare a sqlite database with a fingerprint.
3. Rip all apps from a phone and create fingerprints for all SQLite databases


-------------
  USAGE
-------------

***** ***** ***** *****
   DB Fingerprint
***** ***** ***** *****

usage: dbfp.py [-h] [-f FILE] [-fd FPDIR] [-fp FP] [-an APP_NAME]
               [-av APP_VERSION] [-n NOTES] [-pull] [-v]

Fingerprint a sqlite database based on its schema

optional arguments:
  -h, --help            show this help message and exit
  -f FILE, --file FILE
  -fd FPDIR, --fpdir FPDIR
                        path to dirctory of fingerprint files
  -fp FP, --fp FP       fingerprint file to use in comparison
  -an APP_NAME, --app_name APP_NAME
  -av APP_VERSION, --app_version APP_VERSION
  -n NOTES, --notes NOTES
  -pull, --pull
  -v, --verbose