GeoclueMaster

GeoclueMaster — Geoclue Master API

Synopsis

#define             GEOCLUE_MASTER_DBUS_SERVICE
#define             GEOCLUE_MASTER_DBUS_PATH
#define             GEOCLUE_MASTER_DBUS_INTERFACE
                    GeoclueMaster;
GeoclueMaster*      geoclue_master_get_default          (void);
GeoclueMasterClient* geoclue_master_create_client       (GeoclueMaster *master,
                                                         char **object_path,
                                                         GError **error);

Object Hierarchy

  GObject
   +----GeoclueMaster

Description

GeoclueMaster is part of the Geoclue public C client API. It uses D-Bus to communicate with the actual Master service.

GeoclueMaster is a singleton service, so it should not be created explicitly: instead one should use geoclue_master_get_default() to get a reference to it. It can be used to create a GeoclueMasterClient object.

Details

GEOCLUE_MASTER_DBUS_SERVICE

#define GEOCLUE_MASTER_DBUS_SERVICE "org.freedesktop.Geoclue.Master"


GEOCLUE_MASTER_DBUS_PATH

#define GEOCLUE_MASTER_DBUS_PATH "/org/freedesktop/Geoclue/Master"


GEOCLUE_MASTER_DBUS_INTERFACE

#define GEOCLUE_MASTER_DBUS_INTERFACE "org.freedesktop.Geoclue.Master"


GeoclueMaster

typedef struct _GeoclueMaster GeoclueMaster;


geoclue_master_get_default ()

GeoclueMaster*      geoclue_master_get_default          (void);

Returns the default GeoclueMaster object. Should be unreferenced once the client is finished with it.

Returns :

A reference to the default GeoclueMaster object

geoclue_master_create_client ()

GeoclueMasterClient* geoclue_master_create_client       (GeoclueMaster *master,
                                                         char **object_path,
                                                         GError **error);

Creates a GeoclueMasterClient and puts the D-Bus object path in object_path.

master :

A GeoclueMaster object

object_path :

Pointer to returned GeoclueMasterClient D-Bus object path or NULL

error :

Pointer to returned GError or NULL

Returns :

A new GeoclueMasterClient or NULL on error.

See Also

GeoclueMasterClient