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.