GalagoContext

GalagoContext — Context data

Synopsis

                    GalagoContext;
GalagoContext *     galago_context_new                  (void);
void                galago_context_push                 (GalagoContext *context);
void                galago_context_pop                  (void);
GalagoContext *     galago_context_get                  (void);
void                galago_context_set_obj_path_prefix  (const char *prefix);
const char *        galago_context_get_obj_path_prefix  (void);
GalagoService *     galago_context_get_service          (const char *id,
                                                         GalagoOrigin origin);
GList *             galago_context_get_services         (GalagoOrigin origin);
GalagoPerson *      galago_context_get_person           (const char *id,
                                                         GalagoOrigin origin);
GalagoPerson *      galago_context_get_person_with_session_id
                                                        (const char *session_id,
                                                         GalagoOrigin origin);
GList *             galago_context_get_people           (GalagoOrigin origin);
GalagoObject *      galago_context_get_object           (const char *path);

Object Hierarchy

  GObject
   +----GalagoObject
         +----GalagoContext

Description

GalagoContext stores per-context data, such as a list of people and services. It basically holds the top-level objects that otherwise don't have a parent. Developers should almost never need this. It's used in galago-daemon.

Details

GalagoContext

typedef struct _GalagoContext GalagoContext;

This is an opaque structure representing a context. This should not be used directly. Use the accessor functions below.

galago_context_new ()

GalagoContext *     galago_context_new                  (void);

Creates a new context.

Returns :

The new context.

galago_context_push ()

void                galago_context_push                 (GalagoContext *context);

Pushes a context onto the stack.

context :

The context to push.

galago_context_pop ()

void                galago_context_pop                  (void);

Pops a context off the stack.

galago_context_get ()

GalagoContext *     galago_context_get                  (void);

Returns the current context.

Returns :

The current context.

galago_context_set_obj_path_prefix ()

void                galago_context_set_obj_path_prefix  (const char *prefix);

Sets the base object path prefix for this context.

prefix :

The object path prefix.

galago_context_get_obj_path_prefix ()

const char *        galago_context_get_obj_path_prefix  (void);

Returns the base object path prefix for this context.

Returns :

The object path prefix.

galago_context_get_service ()

GalagoService *     galago_context_get_service          (const char *id,
                                                         GalagoOrigin origin);

Returns the service with the specified ID.

`id` :	The service ID.
`origin` :	The object's origin.
Returns :	The service, if found, or `NULL`.

galago_context_get_services ()

GList *             galago_context_get_services         (GalagoOrigin origin);

Returns a list of all services.

`origin` :	The object's origin.
Returns :	The list of services, if found, or `NULL`.

galago_context_get_person ()

GalagoPerson *      galago_context_get_person           (const char *id,
                                                         GalagoOrigin origin);

Returns the person with the specified ID.

`id` :	The person ID.
`origin` :	The object's origin.
Returns :	The person, if found, or `NULL`.

galago_context_get_person_with_session_id ()

GalagoPerson *      galago_context_get_person_with_session_id
                                                        (const char *session_id,
                                                         GalagoOrigin origin);

Returns the person with the specified session ID.

`session_id` :	The person's session ID.
`origin` :	The object's origin.
Returns :	The person, if found, or `NULL`.

galago_context_get_people ()

GList *             galago_context_get_people           (GalagoOrigin origin);

Returns a list of all people.

`origin` :	The object's origin.
Returns :	The list of people, if found, or `NULL`.

galago_context_get_object ()

GalagoObject *      galago_context_get_object           (const char *path);

Finds an object with the specified path.

`path` :	The D-BUS object path.
Returns :	The object if found, or NULL.

			libgalago Reference Manual
Top \| Description \| Object Hierarchy