TrackerEndpoint: Tracker SPARQL Library Reference Manual

## TrackerEndpoint TrackerEndpoint — Expose a database to other processes |

## Stability Level

Stable, unless otherwise indicated

## Functions

TrackerEndpointDBus * | tracker_endpoint_dbus_new ()
TrackerSparqlConnection * | tracker_endpoint_get_sparql_connection ()

## Properties

TrackerSparqlConnection * | sparql-connection | Read / Write / Construct Only
GDBusConnection * | dbus-connection | Read / Write / Construct Only
gchar * | object-path | Read / Write / Construct Only

## Types and Values

| TrackerEndpoint
| TrackerEndpointDBus

## Object Hierarchy

        GObject
        ╰── TrackerEndpoint
            ╰── TrackerEndpointDBus

## Implemented Interfaces

TrackerEndpointDBus implements GInitable.

## Includes

    #include <tracker-endpoint.h>

## Description

TrackerEndpoint allows sharing data with other processes on the system, using a Tracker-specific D-Bus API.

When it is shared in this way, processes can connect to your database using `tracker_sparql_connection_bus_new()` and can also fetch data directly from SPARQL queries using the `SELECT { SERVICE ... }` syntax.

## Functions

### tracker_endpoint_dbus_new ()

    TrackerEndpointDBus *
    tracker_endpoint_dbus_new (TrackerSparqlConnection *sparql_connection,
                               GDBusConnection *dbus_connection,
                               const gchar *object_path,
                               GCancellable *cancellable,
                               GError **error);

Registers a Tracker endpoint object at `object_path` on `dbus_connection` . The default object path is "/org/freedesktop/Tracker3/Endpoint".

#### Parameters

sparql_connection | a TrackerSparqlConnection |
dbus_connection | a GDBusConnection |
object_path | the object path to use, or `NULL` for the default. | [nullable]
cancellable | a GCancellable, or `NULL`. | [nullable]
error | pointer to a GError |

#### Returns

a TrackerEndpointDBus object.

[transfer full]

### tracker_endpoint_get_sparql_connection ()

    TrackerSparqlConnection *
    tracker_endpoint_get_sparql_connection
                                   (TrackerEndpoint *endpoint);

Returns the TrackerSparqlConnection that this endpoint proxies.

#### Parameters

endpoint | a TrackerEndpoint |

#### Returns

The proxied SPARQL connection.

[transfer none]

## Types and Values

### TrackerEndpoint

    typedef struct _TrackerEndpoint TrackerEndpoint;

The TrackerEndpoint object represents a public connection to a TrackerSparqlConnection.

### TrackerEndpointDBus

    typedef struct _TrackerEndpointDBus TrackerEndpointDBus;

The TrackerEndpointDBus object represents a public connection to a TrackerSparqlConnection on a DBus object path.

## Property Details

### The `“sparql-connection”` property

      “sparql-connection”        TrackerSparqlConnection *

Sparql connection.

Owner: TrackerEndpoint

Flags: Read / Write / Construct Only

### The `“dbus-connection”` property

      “dbus-connection”          GDBusConnection *

DBus connection.

Owner: TrackerEndpointDBus

Flags: Read / Write / Construct Only

### The `“object-path”` property

      “object-path”              gchar *

DBus object path.

Owner: TrackerEndpointDBus

Flags: Read / Write / Construct Only

Default value: NULL