GypsyControl

GypsyControl — Control object for gypsy-daemon

Synopsis




                    GypsyControl;
#define             GYPSY_CONTROL_DBUS_SERVICE
#define             GYPSY_CONTROL_DBUS_PATH
#define             GYPSY_CONTROL_DBUS_INTERFACE
GypsyControl*       gypsy_control_get_default           (void);
char*               gypsy_control_create                (GypsyControl *control,
                                                         const char *device_name,
                                                         GError **error);


Object Hierarchy


  GObject
   +----GypsyControl

Description

GypsyControl is the object that controls the gypsy-daemon process. GypsyControl is used to start and stop the daemon.

Details

GypsyControl

typedef struct _GypsyControl GypsyControl;

There are no public fields in GypsyControl.


GYPSY_CONTROL_DBUS_SERVICE

#define GYPSY_CONTROL_DBUS_SERVICE "org.freedesktop.Gypsy"

A define containing the address of the control service


GYPSY_CONTROL_DBUS_PATH

#define GYPSY_CONTROL_DBUS_PATH "/org/freedesktop/Gypsy"

A define containing the path to the Gypsy object


GYPSY_CONTROL_DBUS_INTERFACE

#define GYPSY_CONTROL_DBUS_INTERFACE "org.freedesktop.Gypsy.Server"

A define containing the name of the Control interface


gypsy_control_get_default ()

GypsyControl*       gypsy_control_get_default           (void);

Retrieves the default GypsyControl object

Returns : A singleton GypsyControl

gypsy_control_create ()

char*               gypsy_control_create                (GypsyControl *control,
                                                         const char *device_name,
                                                         GError **error);

Creates a device on the server that refers to the gps device at device_name. When this object is finalized, the remote object on the server will be shutdown after which any calls to the object at the returned path are not guarenteed to work.

control : The GypsyControl device
device_name : The path to the device file
error : A GError to return errors in
Returns : The path to the created object.