Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
LOCALSEARCH-DAEMON(1)	       LocalSearch manual	   LOCALSEARCH-DAEMON(1)

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

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

DESCRIPTION
     Tracker indexes content with daemon processes that run in	the  background.
     The localsearch daemon command allows for control of these components. This
     ranges  from starting, stopping and killing processes to pausing and resum-
     ing them.

     In addition to all this, there are ways to follow or watch what is  happen-
     ing  in  real time from a top level and right down where the SPARQL commits
     are happening too.

     If no arguments are provided this command will show the current  status  of
     all Tracker data miners.

     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
	 This uses SIGKILL to stop all Tracker processes found matching the  pa-
	 rameter,  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=
	 This  uses  SIGTERM  to stop all Tracker processes. This is recommended
	 over --kill because it gives the processes time to shutdown cleanly.

     -s, --start
	 Starts all miners.

     -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  sta-
     tus 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 ex-
     ample:

	     $ localsearch daemon -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://tracker.api.gnome.org/ontology/v3/tracker#extractor-data-source'
		'nie:mimeType' = 'text/plain'
		'nie:url' = 'file:///home/martyn/.bash_aliases'
	     'nfo:Document'
		'nie:dataSource' = 'http://tracker.api.gnome.org/ontology/v3/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 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.

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

     --list-miners-available
	 This will list all miners which are available even if they are not run-
	 ning 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 application that re-
	 quested 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.Tracker3.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  re-
	 sume 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.

  3.8.2 			   08/04/2026		   LOCALSEARCH-DAEMON(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=localsearch-daemon&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help