• NAME
• SYNOPSIS
• DESCRIPTION
• OPTIONS
• CONFIG FILE
• FILES
• SEE ALSO
• LICENSE
• AUTHOR

NAME

  qdb-fsck - initialise or update CPAN's update history

SYNOPSIS

  Usage: qdb-fsck [-vqdTfhirsD] [-C [1⟧ [-m max] [-c conf]
  option v : be verbose
  option q : be quiet
  option d : show debug info
  option T : show trace info
  option f : action ; otherwise dry-run ; implies "-C 1"
  option h : show help ; exit
  option i : show meta data ; exit ;
  option r : get events from RECENT-files ; default : /path/to/cpan
  option s : send events to server instead of the database
  option m : use $max paralel finds ; default 10
  option D : delete all events ; increment meta.scheme ; exit
  option C : read/write the find-list cache /tmp/FIND.cpan
             -C   : read the cache
             -C 1 : write the cache
  option c : use config $conf ; default [ qdb.conf, /etc/qdb/conf ]

DESCRIPTION

With qdb, CPAN's update history is maintained in a database containing tuples (events) :

  ⟦ id, type, path, time ⟧

Program qdb-fsck initialises and/or updates the database.

To create/initialise a root database :

• Configure : db_init root

• Insert all events in all RECENT-files :

    % qdb-fsck -r -f

• Search /path/to/CPAN ; insert missing new/delete events :

    % qdb-fsck -f

  First qdb-fsck searches /path/to/CPAN ; a (new,$path)-event is inserted if the (last) $path-event is missing or a delete-event.

  Then, qdb-fsck searches the database ; a (delete,$path)-event is inserted if the (last) $path-event is missing or is a new-event.

To create/initialise a downstream database, just run

  % qdb-fsck -r -f

This will insert (only) the last event found in the RECENT-files.

OPTIONS

-q

be quiet ; only errors

-v

be verbose ; show all actions

-d

show debug info ; internals

-T

trace ; show all debug info

-h

show help ; exit

-i

show meta data ; exit

-r

get fresh events from RECENT-files ; default : search /path/to/cpan

-s

send events to the server instead of the database

-m $max

when inspecting path/to/CPAN, use $max paralel finds ; default 10

-c

use config file ; default : qdb.conf, /etc/qdb/conf

CONFIG FILE

See qdb.

FILES

  /etc/qdb/conf      qdb-configuration
  /var/qdb/data.lite sqlite database with event-history and meta-data

SEE ALSO

qdb, qdb-send

LICENSE

You may distribute under the terms of either the GNU General Public License or the Artistic License, as specified in the Perl 5.10.0 README file.

AUTHOR