1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
|
.TH tracker-search 1 "July 2009" GNU "User Commands"
.SH NAME
tracker-search \- Search all content for keywords
.SH SYNOPSIS
\fBtracker-search\fR [\fIOPTION\fR...] \fIEXPRESSION\fR [\fIEXPRESSION\fR...]
.SH DESCRIPTION
.B tracker-search
searches all indexed content for \fIEXPRESSION\fR. The resource in
which \fIEXPRESSION\fR matches must exist (see
.B \-\-all
for more information). All results are returned in ascending order. In
all cases, if no \fIEXPRESSION\fR is given for an argument (like
.B \-\-folders
for example) then ALL items in that category are returned instead.
.TP
\fIEXPRESSION\fR
One or more terms to search. The default operation is a logical AND.
For logical OR operations, see -r.
.SH OPTIONS
.TP
.B \-?, \-\-help-all
Display all help options available.
.TP
.B \-l, \-\-limit=N
Limit search to N results. The default is 10 or 512 with \-\-disable\-snippets.
.TP
.B \-o, \-\-offset=N
Offset the search results by N. For example, start at item number 10
in the results. The default is 0.
.TP
.B \-r, \-\-or-operator
Use OR for search terms instead of AND (the default)
.TP
.B \-d, \-\-detailed
Show the unique URN associated with each search result. This does not
apply to \-\-music\-albums and \-\-music\-artists.
.TP
.B \-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
.TP
.B \-\-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.
.TP
.B \-\-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.
.TP
.B \-\-disable-color
This disables any ANSI color use on the command line. By default this
is enabled to make it easier to see results.
.B \-\-music-albums
and
.B \-\-music-artists.
.TP
.B \-f, \-\-files
Search for files of any type matching \fIEXPRESSION\fR (optional).
.TP
.B \-e, \-\-folders
Search for folders matching \fIEXPRESSION\fR (optional).
.TP
.B \-m, \-\-music
Search for music files matching \fIEXPRESSION\fR (optional).
.TP
.B \-\-music\-albums
Search for music albums matching \fIEXPRESSION\fR (optional).
.TP
.B \-\-music\-artists
Search for music artists matching \fIEXPRESSION\fR (optional).
.TP
.B \-l, \-\-images
Search for images matching \fIEXPRESSION\fR (optional).
.TP
.B \-v, \-\-videos
Search for videos matching \fIEXPRESSION\fR (optional).
.TP
.B \-t, \-\-documents
Search for documents matching \fIEXPRESSION\fR (optional).
.TP
.B \-e, \-\-emails
Search for emails matching \fIEXPRESSION\fR (optional). Returns a list
of subjects for emails found.
.TP
.B \-c, \-\-contacts
Search for contacts matching \fIEXPRESSION\fR (optional). Returns a list
of names and email addresses found.
.TP
.B \-\-software
Search for software installed matching \fIEXPRESSION\fR (optional). Returns a list
of desktop files and application titles found.
.TP
.B \-\-software-categories
Search for software categories matching \fIEXPRESSION\fR (optional). Returns a list
of urns and their categories (e.g. Settings, Video, Utility, etc).
.TP
.B \-\-feeds
Search through RSS feed information matching \fIEXPRESSION\fR (optional). Returns a list
of those found.
.TP
.B \-b, \-\-bookmarks
Search through bookmarks matching \fIEXPRESSION\fR (optional). Returns a list
titles and links for each bookmark found.
.TP
.B \-V, \-\-version
Print version.
.SH SEE ALSO
.BR tracker-store (1),
.BR tracker-stats (1),
.BR tracker-tag (1),
.BR tracker-info (1).
|
