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

       In addition to all this,	there are ways to follow or watch what is
       happening 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
	   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=
	   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
       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:

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

  3.8.2				  05/13/2025		 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+14.3.quarterly>

home | help