scrollkeeper-update - identify new, modified, or removed OMF files and update the scroll-
scrollkeeper-update [ -v ] [ -q ] [ -p database-directory ] [ -o omf-directories ]
This synchronizes the scrollkeeper database with the OMF directory. It searches the
scrollkeeper OMF directory to identify if any files were added, removed, or modified and
updates its internal database files to reflect any changes.
This utility is generally executed as the last step of installation, after the OMF file is
copied into place. It is also typically the last step of uninstallation, after the OMF
file is removed. Using this, an administrator can easily manually install and uninstall
documents into the database. It can also be run to guarantee the database is fully up-to-
Note that because scrollkeeper-update is normally run during installation and its output
is typically seen by users, non-critical warnings and errors such as those caused by
invalid metadata are written to the log file instead of to the terminal. Developers should
use the log file to identify any problems.
-v Be verbose: Say which scrollkeeper-install and scrollkeeper-uninstall commands are
being run to bring the database up to date.
-q Run in quiet mode, suppressing output of all but the most serious warning and error
messages to STDOUT. Note that most output to the log file will be unchanged.
Use database-directory as the directory for the scrollkeeper database rather than
the usual one obtained by running omf-config --pkglocalstatedir.
Examine the directories named in omf-directories rather than the one usual one
obtained by running scrollkeeper-config --omfdir (or specified in the OMF_DIR envi-
ronment variable if set). The omf-directories should be a colon-separated list of
If no -o option is specified, this variable overrides the scrollkeeper-config-pro-
vided OMF directory. It should be a colon-separated list of directories.
Laszlo Kovacs <email@example.com>
Dan Mueth <firstname.lastname@example.org>
scrollkeeper-config(1), scrollkeeper-gen-seriesid(1), scrollkeeper.conf(5), scroll-
keeper(7), scrollkeeper-preinstall(8), scrollkeeper-rebuilddb(8)
scrollkeeper Dec 5, 2001 SCROLLKEEPER-UPDATE(8)