## TrackerClient

TrackerClient — A client library for querying and inserting data in Tracker.

## Synopsis

    #include <libtracker-client/tracker-client.h>

    #define             TRACKER_DBUS_SERVICE
    #define             TRACKER_DBUS_OBJECT
    #define             TRACKER_DBUS_INTERFACE_RESOURCES
    #define             TRACKER_DBUS_INTERFACE_STATISTICS
                        TrackerClient;
                        TrackerClientClass;
    enum                TrackerClientFlags;
    TrackerClient *     tracker_client_new                  (TrackerClientFlags flags,
                                                             gint timeout);

## Object Hierarchy

      GObject
       +----TrackerClient

## Properties

      "enable-warnings"          gboolean              : Read / Write / Construct
      "timeout"                  gint                  : Read / Write / Construct

## Description

This API is for applications which want to integrate with Tracker either by storing their data or by querying it. They are also not limited to their application's data. Other data mined by other applications is also available in some cases.

## Details

### TRACKER_DBUS_SERVICE

    #define TRACKER_DBUS_SERVICE              "org.freedesktop.Tracker1"

### TRACKER_DBUS_OBJECT

    #define TRACKER_DBUS_OBJECT               "/org/freedesktop/Tracker1"

### TRACKER_DBUS_INTERFACE_RESOURCES

    #define TRACKER_DBUS_INTERFACE_RESOURCES  "org.freedesktop.Tracker1.Resources"

### TRACKER_DBUS_INTERFACE_STATISTICS

    #define TRACKER_DBUS_INTERFACE_STATISTICS "org.freedesktop.Tracker1.Statistics"

### TrackerClient

    typedef struct _TrackerClient TrackerClient;

### TrackerClientClass

    typedef struct {
    	GObjectClass parent;
    } TrackerClientClass;

### enum TrackerClientFlags

    typedef enum {
    	TRACKER_CLIENT_ENABLE_WARNINGS      = 1 << 0
    } TrackerClientFlags;

`TRACKER_CLIENT_ENABLE_WARNINGS` | If supplied warnings will be produced upon erronous situations. This is usually turned off for applications that want to provide their own error reporting.

### tracker_client_new ()

    TrackerClient *     tracker_client_new                  (TrackerClientFlags flags,
                                                             gint timeout);

Creates a connection over D-Bus to the Tracker store for doing data querying and inserting.

The `timeout` is only used if it is > 0. If it is, then it is used with `dbus_g_proxy_set_default_timeout()`.

`flags` : | This can be one or more combinations of TrackerClientFlags
`timeout` : | a gint used for D-Bus call timeouts.
Returns : | the TrackerClient which should be freed with `g_object_unref()` when finished with.

## Property Details

### The `"enable-warnings"` property

      "enable-warnings"          gboolean              : Read / Write / Construct

Enable warnings.

Default value: TRUE

### The `"timeout"` property

      "timeout"                  gint                  : Read / Write / Construct

Timeout.

Allowed values: >= G_MAXULONG

Default value: -1