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

FreeBSD Manual Pages


home | help
tracker-search(1)		 User Commands		     tracker-search(1)

       tracker-search -	Search for content by type or across all types

       tracker search [options...] [[expression1] ...]

       tracker	search	searches  all  indexed content for expression. The re-
       source in which expression matches must exist (see --all	for  more  in-
       formation).  All	results	are returned in	ascending order. In all	cases,
       if no expression	is given for an	argument (like --folders for  example)
       then ALL	items in that category are returned instead.

	      One  or more terms to search. The	default	operation is a logical
	      AND.  For	logical	OR operations, see -r.

       -f, --files
	      Search for files of any type matching expression (optional).

       -s, --folders
	      Search for folders matching expression (optional).

       -m, --music
	      Search for music files matching expression (optional).

	      Search for music albums matching expression (optional).

	      Search for music artists matching	expression (optional).

       -i, --images
	      Search for images	matching expression (optional).

       -v, --videos
	      Search for videos	matching expression (optional).

       -t, --documents
	      Search for documents matching expression (optional).

       -e, --emails
	      Search for emails	matching expression (optional).	Returns	a list
	      of subjects for emails found.

       -c, --contacts
	      Search  for  contacts  matching expression (optional). Returns a
	      list of names and	email addresses	found.

	      Search for software installed  matching  expression  (optional).
	      Returns a	list of	desktop	files and application titles found.

	      Search  for  software categories matching	expression (optional).
	      Returns a	list of	urns  and  their  categories  (e.g.  Settings,
	      Video, Utility, etc).

	      Search  through  RSS  feed  information matching expression (op-
	      tional). Returns a list of those found.

       -b, --bookmarks
	      Search through bookmarks matching	expression (optional). Returns
	      a	list titles and	links for each bookmark	found.

       -l, --limit=<limit>
	      Limit  search  to	 limit	results. The default is	10 or 512 with

       -o, --offset=<offset>
	      Offset the search	results	by offset. For example,	start at  item
	      number 10	in the results.	The default is 0.

       -r, --or-operator
	      Use OR for search	terms instead of AND (the default)

       -d, --detailed
	      Show  the	 unique	 URN  associated with each search result. This
	      does not apply to	--music-albums and --music-artists.

       -a, --all
	      Show results which might not be available. This might  bebecause
	      a	 removable  media is not mounted for example. Without this op-
	      tion, resources are only shown if	they exist.  This  option  ap-
	      plies to all command line	switches except

	      Results are shown	with snippets. Snippets	are context around the
	      word that	was searched for in the	first place. This  gives  some
	      idea of if the resource found is the right one. Snippets require
	      Full Text	Search to be compile time enabled AND to not  be  dis-
	      abled  with  --disable-fts.  Using --disable-snippets only shows
	      the resources which matched, no context is provided about	 where
	      the match	occurred.

	      If Full Text Search (FTS)	is available, this option allows it to
	      be disabled for one off searches.	This returns results  slightly
	      using  particular	 properties  to	 match	the search terms (like
	      "nie:title") instead of looking for the search terms amongst ALL
	      properties.  It  is  more	 limiting  to  do  this, but sometimes
	      searching	without	FTS can	yield better results if	the FTS	 rank-
	      ing is off.

	      This disables any	ANSI color use on the command line. By default
	      this is enabled to make it easier	to see results.

	      This option allows you to	choose which backend you use for  con-
	      necting  to the database.	This choice can	limit your functional-
	      ity. There are three settings.

	      With "direct" the	connection to the database is made directly to
	      the  file	itself on the disk, there is no	intermediary daemon or
	      process. The "direct" approach is	purely read-only.

	      With "bus" the tracker-store process is used to liase  with  the
	      database	queuing	 all requests and managing the connections via
	      an IPC / D-Bus. This adds	a small	overhead BUT this is the  only
	      approach you can use if you want to write	to the database.

	      With  "auto"  the	backend	is decided for you, much like it would
	      be if this environment variable was undefined.

       tracker-store(1), tracker-stats(1), tracker-tag(1), tracker-info(1).

GNU				   July	2009		     tracker-search(1)


Want to link to this manual page? Use this URL:

home | help