Beagle

Beagle comes with a number of tools and services. This section lists some of them and some of their commonly used options.

• beagled: beagled is the command to start the beagle service. It is responsible for indexing data and returning query results. Options:
  • --fg or --foreground: Run beagled in foreground.
  • --bg or --background: Run beagled in background.
  • --indexing-delay x: By default there is a 5 minute delay after beagled starts before it starts crawling and indexing files. Use this option to set the delay to x seconds.
  • --indexing-delay -1: Do not start the backends in the indexing mode. Use this to start beagled in query-only mode.
  • --list-backends: Lists the backends beagled supports.
  • --backend b: Start beagled with only the backend b. (The name of the backend is as reported by --list-backends).
  • --backend +b: Start beagled with the enabled backends as configured (via beagle-config or beagle-settings) and also start backend b.
  • --backend -b: Start beagled with the enabled backends as configured (via beagle-config or beagle-settings) except backend b.
  • --add-static-backend /path/to/index: Start beagled as configured and also add a static index to it.
  • --indexing-test-mode: Stop beagled once initial indexing is finished. Not really useful unless you want to only create/update the index.
  • --debug: Start beagled in the debug mode.

• beagle-build-index: This is the tool to create static indexes. See Static Indexes.

• beagle-crawl-system: Manages system-wide static indexes. See Beagle Crawl System.

• beagle-query: This is a basic command line tool to query beagle. See Searching Data.

• beagle-search: GNOME-based GUI for searching beagle data. See Searching Data.

• beagle-settings: A GUI for beagle-config. There is also an analogous command line tool beagle-config.

• beagle-info: This command can be used to gather information about beagle. Options:
  • --daemon-version: Prints the version of the currently running beagled.
  • --status: Current status of beagled.
  • --index-info: Details of the indexes (currently running) beagled is serving. Requires running beagled.
  • --list-backends: Lists the backends beagled supports.
  • --list-filters: Lists the filters beagled supports.
  • --list-static-indexes: Lists the static indexes added to beagled.

• beagle-shutdown: Shutdown currently running beagled. This is the recommended way to stop beagled.

• blocate: Search static indexes created by beagle-build-index. For details, see here.