Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Wednesday, February 10, 2021
 
 

tracker-daemon (1)

Name

tracker-daemon - Start, stop, restart and list daemons responsible for indexing content

Synopsis

tracker daemon [options...]
tracker daemon -s | -t [daemons] | -k [daemons] | -l
tracker daemon -f | -w [ontology]
tracker daemon --miner <miner> --pause[-for-process] <reason>
tracker daemon --miner <miner> --resume <cookie>

Description

tracker-daemon(1)                User Commands               tracker-daemon(1)



NAME
       tracker-daemon  - Start, stop, restart and list daemons responsible for
       indexing content


SYNOPSIS
       tracker daemon [options...]
       tracker daemon -s | -t [daemons] | -k [daemons] | -l
       tracker daemon -f | -w [ontology]
       tracker daemon --miner <miner> --pause[-for-process] <reason>
       tracker daemon --miner <miner> --resume <cookie>



DESCRIPTION
       Tracker has many components to it including a "store" for handling data
       set  updates  and "miners" for handling data mining in their respective
       areas.

       The tracker daemon command allows  for  control  of  these  components.
       This  ranges  from  starting, stopping and killing processes to pausing
       and resuming them.

       In addition to all this, there are ways to change the log verbsity  for
       all processes that generate logs and to follow or watch what is happen-
       ing in real time from a top level and right down where the SPARQL  com-
       mits are happening too.

       If  no arguments are provided this command will show the current status
       of all Tracker entities (store and all available data miners).

       For tracker-store, the status is always "Idle" unless it is restoring a
       backup  and/or replaying a journal (see also tracker reset --soft). For
       a list of common statuses, see --list-common-statuses.

       The data miners can be paused or resumed using this command and you can
       also list miners running and available.


OPTIONS
       -p, --list-processes
              This lists all Tracker processes in the system.

       -k, --kill=[daemons]
              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.

              The possible daemons options are:

               o   all - All daemons.

               o   store - Only the tracker-store.

               o   miners - Only data miners.



       -t, --terminate=[daemons]
              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.

              For a list of possible daemons, see --kill.

       -s, --start
              Starts  all  miners.  This  indirectly  starts tracker-store too
              because it is needed for miners to operate properly.  The  store
              is started from D-Bus.

       --get-log-verbosity
              This  displays  the log verbosity for ALL components using GSet-
              tings  for  this  configuration.  For   possible   values,   see
              --set-log-verbosity.

       --set-log-verbosity=<verbosity>
              This  sets  the log verbosity for ALL daemons using GSettings to
              store their "verbosity" configuration.

              The possible verbosity options are:

               o   debug - Show EVERYTHING, from  debug  messages  to  errors.
                   This often includes actual SQL being executed.

               o   detailed - Show enough detail to understand what is happen-
                   ing.

               o   minimal - Show an overview of what is going on, e.g.  stats
                   and when things start or stop.

               o   errors  -  Show  only  warnings, criticals, errors or fatal
                   events.


       -f, --follow
              Follow status changes to daemons as they happen. This is  a  top
              level  view of what is happening. You will see the name for each
              daemon and a state with the progress in that state.

              This requires Ctrl+C to stop and return  to  the  command  line.
              Each new status is put on a new line.


       -w, --watch=[ontology]
              Watch  changes  that  happen  to the database in real time. This
              requires Ctrl+C to stop and return to the command line.

              If ontology is unspecified, all updates are shown. The  ontology
              can be a comma separated list of shorthand or long hand ontology
              properties. For example:

                  $ tracker-control -w nie:url,nie:mimeType,nfo:fileSize,nie:dataSource
                  Now listening for resource updates to the database
                  All nie:plainTextContent properties are omitted

                  Press Ctrl+C to stop

                  'nfo:Document'
                     'nfo:fileSize' = '1770'
                     'nie:dataSource' = 'http://www.tracker-project.org/ontologies/tracker#extractor-data-source'
                     'nie:mimeType' = 'text/plain'
                     'nie:url' = 'file:///home/martyn/.bash_aliases'
                  'nfo:Document'
                     'nie:dataSource' = 'http://www.tracker-project.org/ontologies/tracker#extractor-data-source'

                  ...


       --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 con-
              sidered 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.

       --list-miners-running
              This  will list all miners which have responded to a D-Bus call.
              Sometimes it is helpful to use  this  command  with  --list-min-
              ers-available.

       --list-miners-available
              This  will  list all miners which are available even if they are
              not running at the moment.

       --pause-details
              For listing all miners which are  paused  and  the  reasons  for
              being  paused, you can use this. It will also display the appli-
              cation 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  applica-
              tions.  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 automat-
              ically.

       --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.


ENVIRONMENT
       TRACKER_MINERS_DIR
              Miners  that  are  installed  should  have  a  .desktop  file in
              /usr/share/tracker/miners/, this is  how  tracker-control  knows
              about miners which exist but may not have not been started. This
              environment variable allows the  location  that  miner  .desktop
              files  are  loaded  from to be overridden by setting it to a new
              path.

       TRACKER_MINERS_DIR_DISABLED
              If you don't have .desktop files for miners, you  can  use  this
              environment variable to get status information from RUNNING pro-
              cesses. This doesn't give any indication for miners NOT running.
              This  uses  registered  miners  on  DBus  to know about existing
              Tracker based data miners.



ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+--------------------------------+
       |ATTRIBUTE TYPE |        ATTRIBUTE VALUE         |
       +---------------+--------------------------------+
       |Availability   | library/desktop/search/tracker |
       +---------------+--------------------------------+
       |Stability      | Pass-through volatile          |
       +---------------+--------------------------------+
SEE ALSO
       tracker-store(1).



NOTES
       This    software    was    built    from    source     available     at
       https://github.com/oracle/solaris-userland.    The  original  community
       source        was        downloaded         from          https://down-
       load.gnome.org/sources/tracker/1.6/tracker-1.6.0.tar.xz

       Further information about this software can be found on the open source
       community website at https://wiki.gnome.org/Projects/Tracker.



GNU                             September 2014               tracker-daemon(1)