cleandb(8)

NAME
cleandb - perl based tool to clean RIPE like databases

SYNOPSIS

cleandb [ -V ] [ -p ] [ -c ] databasefile

DESCRIPTION

cleandb is part of the RIPE database software package. It will read the named databasefile, and will skip all objects that have been deleted, but are still left in the file. After doing so, it will re-index the newly generated database file, and replace the old database file and indexes with the new ones. The old database file will be locked during the whole operation, to ensure that no updates to that database are lost. Read-Only clients of that database (specifically whoisd(8)) will still function correctly during the complete procedure. For generating new indexes, cleandb will create a temporary directory databasefile.new in which the new and clean database is build, and where all indexes are made. Once it is finished ,cleandb will remove all old indexes and the old database and replace it by the new database and its indexes.

OPTIONS

-c  index this database classless. Databases that contain objects that have IP network numbers (in range format, classful or prefix/length format) as (part of) their key need to be indexed classless. This option will cause cleandb to to do a normal database index and a classless index afterwards. The classless index could generate a reasonable amount of index files depending on the database file. NB Any IP number lookups in databases that are not indexed using this option will fail.

-p  prime the database. When generating classless indexing in some cases it improves index and lookup performance is a certain set of dummy entries is inserted into the index. These entries are only inserted when this option is present. These dummy entries will never be shown in lookups. This option should only be used when you have a database that needs classless indexing (ie in combination with -c) and you have a reasonable size database. It will slow down indexing for databases with up to 4000 entries, and speed up any bigger database. It will insert some 4000 dummy entries. DO NOT USE THIS OPTION ON DATABASES THAT CAN BE UPDATED USING dbupdate(8).

-V  be verbose. cleandb will show what it is doing and will report every 100 objects in the database file it has processed and indexed.

SEE ALSO
dbm(3X) netdbm(8) whoisd(8) dbupdate(8)

CONFIGURATION OPTIONS

cleandb needs the following configurations options from the config file (dbconfig(5)): ATTR, OBJ, and CLEANLOCK

BUGS

The whole process can be fairly slow depending on database size The guarded field procedure as per ripe-81 is performed in this program as well, but will be obsoleted shortly and will thus not be discussed.

AUTHOR

Marten Terpstra, RIPE Network Coordination Centre <marten@ripe.net>