1cleanup_digikamdb(1)                                      cleanup_digikamdb(1)
2
3
4

NAME

6       cleanup_digikamdb - Cleanup the digiKam databases to reduce their sizes
7       and increase access speed
8

SYNOPSIS

10       cleanup_digikamdb [-t] [-T] [-p] [-h]
11

OPTIONS

13       -t     Include thumbnail databases.
14
15       -T     Only cleanup thumbnail databases.
16
17       -p path
18              Specify a different database path.  If this option is not set or
19              the  specified path is invalid, the entry from the configuration
20              file will be used.
21
22       -h     Show command line options.
23

DESCRIPTION

25       cleanup_digikamdb will cleanup and optimize the digiKam database  file.
26       This  will,  in most cases, lead to a smaller database file size and an
27       increased access speed, because unneeded elements are removed from  the
28       database and data is optimized.
29
30       The  program will make sure that no instance of digiKam is running, be‐
31       cause it is more safe to have no database access during  the  optimiza‐
32       tion  process. It then will read the digiKam configuration file and de‐
33       termine the database location.  In a final step the  database  will  be
34       optimized by invoking the sqlite command 'VACUUM;' on it.  If more then
35       one database is found in this location, cleanup_digikamdb will optimize
36       every database found in this path and below.
37
38       For  further  explanation,  see the following description of the VACUUM
39       command from the sqlite3 website:
40
41       When an object (table, index, or trigger) is dropped from the database,
42       it leaves behind empty space.  This empty space will be reused the next
43       time new information is added to the database.  But  in  the  meantime,
44       the  database file might be larger than strictly necessary.  Also, fre‐
45       quent inserts, updates, and deletes can cause the  information  in  the
46       database  to become fragmented - scrattered out all across the database
47       file rather than clustered together in one place.
48
49       The VACUUM command cleans the main database by copying its contents  to
50       a temporary database file and reloading the original database file from
51       the copy.  This eliminates free pages, aligns table data to be contigu‐
52       ous, and otherwise cleans up the database file structure.
53

AUTHOR

55       cleanup_digikamdb  was  written  by  Andi  Clemens <andi dot clemens at
56       gmail dot com>
57
58
59
60cleanup_digikamdb               24 October 2011           cleanup_digikamdb(1)
Impressum