GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  TRACKER-SEARCH (1)

NAME

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

CONTENTS

Synopsis
Description
Options
Environment
See Also

SYNOPSIS

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

DESCRIPTION

tracker search searches all indexed content for expression. The resource in which expression matches must exist (see --all for more information). 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.
expression
  One or more terms to search. The default operation is a logical AND. For logical OR operations, see -r.

OPTIONS

-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).
--music-albums
  Search for music albums matching expression (optional).
--music-artists
  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.
--software
  Search for software installed matching expression (optional). Returns a list of desktop files and application titles found.
--software-categories
  Search for software categories matching expression (optional). Returns a list of urns and their categories (e.g. Settings, Video, Utility, etc).
--feeds Search through RSS feed information matching expression (optional). 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 --disable-snippets.
-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 option, resources are only shown if they exist. This option applies to all command line switches except
--disable-snippets
  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 disabled with --disable-fts. Using --disable-snippets only shows the resources which matched, no context is provided about where the match occurred.
--disable-fts
  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 ranking is off.
--disable-color
  This disables any ANSI color use on the command line. By default this is enabled to make it easier to see results.

ENVIRONMENT

TRACKER_SPARQL_BACKEND
  This option allows you to choose which backend you use for connecting to the database. This choice can limit your functionality. 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_PRAGMAS_FILE
  Tracker has a fixed set of PRAGMA settings for creating its SQLite connection. With this environment variable pointing to a text file you can override these settings. The file is a \n separated list of SQLite queries to execute on any newly created SQLite connection in tracker-store.

SEE ALSO

tracker-store(1), tracker-stats(1), tracker-tag(1), tracker-info(1).
Search for    or go to Top of page |  Section 1 |  Main Index


GNU TRACKER-SEARCH (1) July 2009

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.