PgreetDButil - Manipulate Penguin Greetings Berkeley DB files
PgreetDButil -e DateLimit [-p path_to_database_files] \
[NameList.db NamePass.db CardData.db]
or
PgreetDButil -c destination_path [-p path_to_database_files] \
[NameList.db NamePass.db CardData.db]
PgreetDButil is the beginnings of a tool to
perform various operations on the Berkeley DB databases used by
the Penguin Greetings. The first incarnation of this utility
(0.9.7), performs two operations: expunging ecards that are
older than DateLimit number of days, and using
Berkeley DB to copy the contents of a database thereby
compacting the copy of any deleted records. Both capacities are
actually performed by routines in the Pgreet module library:
Pgreet::DaemonUtils.
PgreetDButil requires either the
-c or the -e option. This is how the
application sorts out what action it will perform. In order to
expunge old records, the only required argument is the number
of days that a card can remain in the database. Records older
than the specified number of days will be removed. Before
removing these records in place, a backup of the database files
will be created with the suffix .bak. The
-p option can be used to specify another directory
than the current working directory to find the database files.
PgreetDButil will assume three database files
named: NameList.db, NamePass.db, and
CardData.db. If you have chosen other names for
the three database files used by Penguin Greetings you need to
supply them as arguments in the order listed above.
To compact databases, use the -c option. The
-c expects an argument which is a destination path
to some other directory on your system. Since it is likely that
you'll want to substitute the database files back into your
system with the same name, PgreetDButil creates
compacted databases with the same names but in a new location
for convenience and simplicity. As above,
PgreetDButil expects to find the three database
files in the current working directory with the standard names
used by Penguin Greetings. You may override this by using the
-p flag and supplying the filenames explicitly in
the manner noted for the -e option.
Copyright (c) 2004 Edouard Lagache
This software is released under the GNU General Public License, Version 2. For more information, see the COPYING file included with this software or visit: http://www.gnu.org/copyleft/gpl.html
The user interface is thrown together and clumsy. It will be replaced by a rational scheme to select among the increasing number of functions this utility will eventually be able to perform.
Edouard Lagache <pgreetdev@canebas.org>
1.0.0