---
name: "beagle-query"
section: "1"
platform: "linux"
package: "beagle"
version: "0.3.8-1"
release: "Debian 5.0 (Lenny)"
platforms: ["linux"]
url: "https://new.carta.tech/beagle-query"
---

# beagle-query(1)

search your personal information space

## NAME

beagle-query - search your personal information space

## SYNOPSIS

**beagle-query** \[*options*\] *query*

## DESCRIPTION

**beagle-query** is used to search your personal information space via Beagle, on the command line.  It is a command-line form of the beagle-search GNOME program.

## OPTIONS

### Search options

- **--max-hits**

  Reduce the number of search results returned per backend. The default is 100. Increasing this will slow down overall search speed.

- **--verbose**

  Print detailed information about each hit.

- **--cache**

  Show the entire cached text for each result. Only works with *--verbose*.\
   Note that for large documents this will produce extremely large output, so use this with uri queries or queries returning only a few results Not recommended for live-queries or stats-only queries.

- **--live-query**

  Enable live queries. This argument keeps beagle-query running, continuously feeding new matching hits as the system gets aware of them.

- **--stats-only**

  Show only statistics on the number of search results and how long it took to get them, and not the results themselves.

### Other options

- **--keywords**

  Lists the keywords allowed in *query*. Keyword queries can be specified as *keywordname:value e.g. ext:jpg*

- **--help**

  Print the usage message.

- **--version**

  Print the version information.

## QUERY

You can query for a word, several words or a quoted phrase. When several words are searched, only documents which contain all the words are matched. To specify a phrase, enclose it in shell-escaped quotes (\\"search term\\").

Besides these beagle supports an advanced query syntax. See http://beagle-project.org/Searching\_Data#Search\_Syntax for more information.

## AUTHOR

Novell, Inc.

## REPORTING BUGS

Report bugs to \<dashboard-hackers@gnome.org\>.

## COPYRIGHT

Copyright © 2005 Novell, Inc., © 2008 D Bera

This is free software; see the source for copying conditions.  There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

## SEE ALSO

[**beagled**(1)](/beagled/1.md), [**beagle-shutdown**(1)](/beagle-shutdown/1.md), [**beagle-status**(1)](/beagle-status/1.md),