1tracker-status(1)                User Commands               tracker-status(1)
2
3
4

NAME

6       tracker-status - Report the state of all data miners
7
8

SYNOPSIS

10       tracker-status [OPTION...]
11
12

DESCRIPTION

14       tracker-status  shows the status of all miners and the store which min‐
15       ers push information into. To do this, you can run tracker-status  with
16       no command line arguments. For tracker-store, the status is always Idle
17       unless it is replaying a journal (regardless of load from  applications
18       or miners). For a list of common statuses, see --list-common-statuses.
19
20       The miners can be paused or resumed using this command and you can list
21       miners running and available.
22
23       To start or stop miners, you need to use tracker-control.  The store is
24       started automatically by the D-Bus calls from the miners.
25

OPTIONS

27       -?, --help
28              Show summary of options.
29
30       -f, --follow
31              Follow  status  changes  as they happen. This requires Ctrl+C to
32              stop and return to the command line. Each new status is put on a
33              new  line.  To get more information, you can use --detailed with
34              this.
35
36       -d, --detailed
37              For the most part, this purely provides a  timestamp  with  each
38              status update to follow WHEN changes happened.
39
40       -s, --list-common-statuses
41              This will list statuses most commonly produced by miners and the
42              store. These statuses are not translated when  sent  over  D-Bus
43              and should be translated by each application. These are not con‐
44              sidered static and are subject to change at any point.
45
46              Additionally, these statuses are not the only ones which may  be
47              reported by a miner. There may be other states pertaining to the
48              specific roles of the miner in question.
49
50       -l, --list-miners-running
51              This will list all miners which have responded to a D-Bus  call.
52              Sometimes it is helpfult to use this command with --list-miners-
53              available.
54
55       -a, --list-miners-available
56              This will list all miners which are available even if  they  are
57              not running at the moment.
58
59       -i, --pause-details
60              For  listing  all  miners  which  are paused and the reasons for
61              being paused, you can use this. It will also display the  appli‐
62              cation that requested the pause too.
63
64       -m, --miner=MINER
65              This  argument  is  used  with --pause and --resume to say which
66              miner you want to pause or resume. You can use  the  full  D-Bus
67              name,  e.g.  org.freedesktop.Tracker1.Miner.Files OR you can use
68              the suffix, e.g.  Files
69
70       -p, --pause=REASON
71              The REASON here is useful  to  know  WHY  the  miner  should  be
72              paused.  A  miner  can be paused many times by multiple applica‐
73              tions. Only when all pauses have been resumed will it  continue.
74              If  successful,  a cookie will be given to uniquely identify the
75              request. This cookie is used to resume  the  pause  at  a  later
76              stage.
77
78       -r, --resume=COOKIE
79              The  COOKIE  is  given  by a successful --pause command. It is a
80              number which identifies each pause request. When all pauses have
81              been resumed, the miner will resume working.
82
83       -V, --version
84              Print version.
85
86

SEE ALSO

88       tracker-store(1), tracker-stats(1), tracker-control(1)
89
90
91
92GNU                                July 2009                 tracker-status(1)
Impressum