HISSQLITE-UTIL(8)

NAME
hissqlite-util - History manipulation utility for hissqlite

SYNOPSIS
hissqlite-util [-AcdhV] [-p path]

DESCRIPTION
hissqlite-util is an administrative interface to the hissqlite history method for INN. It only works on hissqlite history databases, not on any other type of INN history. It allows the administrator to audit the database for problems, dump its contents, and report entry counts and the schema version.

All of its actions are read-only, so it is safe to run while INN is running. hissqlite-util opens the database directly; because innd holds the write lock for only a single statement at a time, it waits at most briefly for any in-progress write.

REQUIREMENTS
The "DBI" Perl module with the "DBD::SQLite" driver must be installed for this program to work. They are present in most distributions as a package named like "libdbd-sqlite3-perl", "perl-DBD-SQLite" or "p5-DBD-SQLite". They can also be directly installed from CPAN ("DBI" and "DBD-SQLite" distributions available at <https://metacpan.org/dist/DBI> and <https://metacpan.org/dist/DBD-SQLite>).

Naturally, a hissqlite history database also needs being in use, as detailed in the hissqlite(5) manual page.

OPTIONS
Only one action may be given at a time. With no action, -A is assumed.

-A  Audit the history database for problems and report them to standard error, without trying to fix them. This reports the schema version and entry counts, checks for rows with a missing arrival time, and runs SQLite's "integrity_check". This is the default action.

-c  Print the total, real (token-bearing), and remembered (token-less) entry counts.

-d  Dump all history records as text, one per line: the hash in hexadecimal, the arrival, posting, and expiration timestamps (in seconds since epoch), and the storage API token in its usual textual form, hexadecimal surrounded with "@" (or "remembered" for a token-less entry).

-h  Print a usage message and exit.

-p path
    Act on the history.sqlite database in path instead of the default pathhistory directory from inn.conf.

-V  Print the version of this tool and the database schema version.

EXAMPLES
Audit the history database for problems:

    hissqlite-util -A

Print entry counts for a database in /news/db:

    hissqlite-util -c -p /news/db

HISTORY
Written by Kevin Bowling for InterNetNews.

SEE ALSO
hissqlite(5), inn.conf(5).