NAME¶
tracker-control - Manage Tracker processes and data
SYNOPSIS¶
tracker-control [
OPTION...]
DESCRIPTION¶
tracker-control manages and checks status of all Tracker processes and
data.
Controls Tracker both at process level, and at entity level (store, miners).
To start or stop miners, you can use
--start. The store is started
automatically by the D-Bus calls from the miners.
It also allows checking the status of the Tracker store and all data miners. For
tracker-store , the status is always
Idle unless it is restoring
a backup and/or replaying a journal (regardless of load from applications or
miners). For a list of common statuses, see
--list-common-statuses.
The miners can be paused or resumed using this command and you can also list
miners running and available.
COMMON OPTIONS¶
- -?, --help
- Show summary of options by group.
- -?, --help-all
- Show all groups and options.
- -V, --version
- Returns the version of this program.
GENERAL OPTIONS¶
- -p, --list-processes
- This lists all Tracker processes in the system.
- -k, --kill=[all|store|miners]
- This uses SIGKILL to stop all Tracker processes found
matching the parameter, if no extra parameter is passed, all will
be assumed. This is not advised unless you are having problems stopping
Tracker in the first place. This GUARANTEES death.
- -t, --terminate=[all|store|miners]
- This uses SIGTERM to stop all Tracker processes found
matching the parameter, if no extra parameter is passed, all will
be assumed. This is recommended over --kill because it gives the processes
time to shutdown cleanly.
- -r, --hard-reset
- This kills all processes in the same way that --kill
does but it also removes all databases. Restarting tracker-store
re-creates the databases.
- -e, --soft-reset
- A soft reset works exactly the same way that
--hard-reset does, with the exception that the backup and journal
are not removed. These are restored when tracker-store is
restarted.
- -c, --remove-config
- This removes all config files in $HOME/.config/tracker. All
files listed are files which were found and successfully removed.
Restarting the respective processes re-creates the default configuration
files.
- --get-log-verbosity
- This displays the log verbosity for ALL components using
GSettings for this configuration. For possible values, see
--set-log-verbosity.
- --set-log-verbosity=[debug|detailed|minimal|errors]
- This sets the log verbosity for ALL components using
GSettings using this configuration option ('verbosity').
- -s, --start
- Starts all miners. This indirectly starts tracker-store too
because it is needed for miners to operate properly.
- -b, --backup=FILE
- Begins backing up the Tracker databases to the FILE
given.
- -o, --restore=FILE
- Begins restoring a previous backup (see --backup )
to the Tracker databases. The FILE points to the location of the
backup.
STATUS OPTIONS¶
- -S, --status
- Show the current status of all Tracker entities (store and
all available miners).
- -F, --follow
- Follow status changes as they happen. This requires Ctrl+C
to stop and return to the command line. Each new status is put on a new
line.
- -C, --list-common-statuses
- This will list statuses most commonly produced by miners
and the store. These statuses are not translated when sent over D-Bus and
should be translated by each application. These are not considered static
and are subject to change at any point.
Additionally, these statuses are not the only ones which may be reported by
a miner. There may be other states pertaining to the specific roles of the
miner in question.
MINER OPTIONS¶
- -m, --reindex-mime-type=MIME
- Re-index files which match the MIME type supplied.
This is usually used when installing new extractors which support
MIME types previously unsupported. This forces Tracker to re-index
those files. You can use --reindex-mime-type more than once per
MIME type.
- -f, --index-file=FILE
- (Re)index a file matching the FILE type
supplied.
- -l, --list-miners-running
- This will list all miners which have responded to a D-Bus
call. Sometimes it is helpfult to use this command with
--list-miners-available.
- -a, --list-miners-available
- This will list all miners which are available even if they
are not running at the moment.
- -i, --pause-details
- For listing all miners which are paused and the reasons for
being paused, you can use this. It will also display the application that
requested the pause too.
- --miner=MINER
- This argument is used with --pause or
--resume to say which miner you want to pause or resume. You can
use the full D-Bus name, e.g. org.freedesktop.Tracker1.Miner.Files
OR you can use the suffix, e.g. Files
- --pause=REASON
- The REASON here is useful to know WHY the miner should be
paused. A miner can be paused many times by multiple applications. Only
when all pauses have been resumed will it continue. If successful, a
cookie will be given to uniquely identify the request. This cookie is used
to resume the pause at a later stage.
- --pause-for-process=REASON
- This works exactly the same way as --pause with the
exception that it only keeps the pause active while the calling process is
alive. As soon as you press Ctrl+C the pause is resumed
automatically.
- --resume=COOKIE
- The COOKIE is given by a successful --pause command.
It is a number which identifies each pause request. When all pauses have
been resumed, the miner will resume working.
SEE ALSO¶
tracker-store(1).