|  |  |  | libseahorse Reference Manual |  | 
|---|---|---|---|---|
| Top | Description | ||||
| SeahorseContextSeahorseContext — This is where all the action in a Seahorse process comes together. | 
#include <libseahorse/seahorse-context.h>
                    SeahorseContextPrivate;
                    SeahorseContext;
void                (*SeahorseObjectFunc)               (struct _SeahorseObject *obj,
                                                         gpointer user_data);
#define             SCTX_APP                            ()
SeahorseContext*    seahorse_context_for_app            (void);
SeahorseContext*    seahorse_context_new                (guint flags);
void                seahorse_context_destroy            (SeahorseContext *sctx);
#define             seahorse_context_is_daemon          (ctx)
void                seahorse_context_add_source         (SeahorseContext *sctx,
                                                         SeahorseSource *sksrc);
void                seahorse_context_take_source        (SeahorseContext *sctx,
                                                         SeahorseSource *sksrc);
void                seahorse_context_remove_source      (SeahorseContext *sctx,
                                                         SeahorseSource *sksrc);
SeahorseSource*     seahorse_context_find_source        (SeahorseContext *sctx,
                                                         GQuark ktype,
                                                         SeahorseLocation location);
GSList*             seahorse_context_find_sources       (SeahorseContext *sctx,
                                                         GQuark ktype,
                                                         SeahorseLocation location);
SeahorseSource*     seahorse_context_remote_source      (SeahorseContext *sctx,
                                                         const gchar *uri);
void                seahorse_context_add_object         (SeahorseContext *sctx,
                                                         struct _SeahorseObject *sobj);
void                seahorse_context_take_object        (SeahorseContext *sctx,
                                                         struct _SeahorseObject *sobj);
guint               seahorse_context_get_count          (SeahorseContext *sctx);
struct _SeahorseObject* seahorse_context_get_object     (SeahorseContext *sctx,
                                                         SeahorseSource *sksrc,
                                                         GQuark id);
GList*              seahorse_context_get_objects        (SeahorseContext *sctx,
                                                         SeahorseSource *sksrc);
struct _SeahorseObject* seahorse_context_find_object    (SeahorseContext *sctx,
                                                         GQuark id,
                                                         SeahorseLocation location);
GList*              seahorse_context_find_objects       (SeahorseContext *sctx,
                                                         GQuark ktype,
                                                         SeahorseUsage usage,
                                                         SeahorseLocation location);
GList*              seahorse_context_find_objects_full  (SeahorseContext *self,
                                                         struct _SeahorseObjectPredicate *skpred);
void                seahorse_context_for_objects_full   (SeahorseContext *self,
                                                         struct _SeahorseObjectPredicate *skpred,
                                                         SeahorseObjectFunc func,
                                                         gpointer user_data);
void                seahorse_context_verify_objects     (SeahorseContext *self);
void                seahorse_context_remove_object      (SeahorseContext *sctx,
                                                         struct _SeahorseObject *sobj);
SeahorseServiceDiscovery * seahorse_context_get_discovery
                                                        (SeahorseContext *sctx);
struct _SeahorseObject * seahorse_context_get_default_key
                                                        (SeahorseContext *sctx);
void                seahorse_context_refresh_auto       (SeahorseContext *sctx);
SeahorseOperation*  seahorse_context_search_remote      (SeahorseContext *sctx,
                                                         const gchar *search);
SeahorseOperation*  seahorse_context_transfer_objects   (SeahorseContext *sctx,
                                                         GList *objs,
                                                         SeahorseSource *to);
SeahorseOperation*  seahorse_context_retrieve_objects   (SeahorseContext *sctx,
                                                         GQuark ktype,
                                                         GSList *ids,
                                                         SeahorseSource *to);
GList*              seahorse_context_discover_objects   (SeahorseContext *sctx,
                                                         GQuark ktype,
                                                         GSList *ids);
struct _SeahorseObject* seahorse_context_object_from_dbus
                                                        (SeahorseContext *sctx,
                                                         const gchar *dbusid);
gchar*              seahorse_context_object_to_dbus     (SeahorseContext *sctx,
                                                         struct _SeahorseObject *sobj);
gchar*              seahorse_context_id_to_dbus         (SeahorseContext *sctx,
                                                         GQuark id);
GQuark              (*SeahorseCanonizeFunc)             (const gchar *id);
GQuark              seahorse_context_canonize_id        (GQuark ktype,
                                                         const gchar *id);
typedef struct {
    GtkObject               parent;
    
    gboolean                is_daemon;
} SeahorseContext;
This is where all the action in a Seahorse process comes together.
- Usually there's only one SeahorseContext per process created by passing
  SEAHORSE_CONTEXT_APP to seahorse_context_new(), and accessed via
  the SCTX_APP macro.
- Retains the list of all valid struct _SeahorseObject objects.
- Has a collection of SeahorseSource objects which add objects to the
  SeahorseContext.
Signals: added: A object was added to the context. removed: A object was removed from the context. changed: A object changed. destroy: The context was destroyed.
void                (*SeahorseObjectFunc)               (struct _SeahorseObject *obj,
                                                         gpointer user_data);
| 
 | |
| 
 | 
SeahorseContext* seahorse_context_for_app (void);
| Returns : | the application main context as SeahorseContext | 
void seahorse_context_destroy (SeahorseContext *sctx);
Emits the destroy signal for sctx.
| 
 | SeahorseContext to destroy | 
void seahorse_context_add_source (SeahorseContext *sctx, SeahorseSource *sksrc);
| 
 | |
| 
 | 
void seahorse_context_take_source (SeahorseContext *sctx, SeahorseSource *sksrc);
| 
 | |
| 
 | 
void seahorse_context_remove_source (SeahorseContext *sctx, SeahorseSource *sksrc);
| 
 | |
| 
 | 
SeahorseSource* seahorse_context_find_source (SeahorseContext *sctx, GQuark ktype, SeahorseLocation location);
| 
 | |
| 
 | |
| 
 | |
| Returns : | 
GSList* seahorse_context_find_sources (SeahorseContext *sctx, GQuark ktype, SeahorseLocation location);
| 
 | the context to work with | 
| 
 | the type of the key to match. Or SEAHORSE_TAG_INVALID | 
| 
 | the location to match. Or SEAHORSE_LOCATION_INVALID | 
| Returns : | A list of seahorse sources matching ktypeandlocationas GSList. Must
 be freed with g_slist_free | 
SeahorseSource* seahorse_context_remote_source (SeahorseContext *sctx, const gchar *uri);
| 
 | |
| 
 | |
| Returns : | 
void seahorse_context_add_object (SeahorseContext *sctx, struct _SeahorseObject *sobj);
| 
 | |
| 
 | 
void seahorse_context_take_object (SeahorseContext *sctx, struct _SeahorseObject *sobj);
| 
 | |
| 
 | 
guint seahorse_context_get_count (SeahorseContext *sctx);
| 
 | |
| Returns : | 
struct _SeahorseObject* seahorse_context_get_object (SeahorseContext *sctx, SeahorseSource *sksrc, GQuark id);
| 
 | |
| 
 | |
| 
 | |
| Returns : | 
GList* seahorse_context_get_objects (SeahorseContext *sctx, SeahorseSource *sksrc);
| 
 | |
| 
 | |
| Returns : | 
struct _SeahorseObject* seahorse_context_find_object (SeahorseContext *sctx, GQuark id, SeahorseLocation location);
| 
 | |
| 
 | |
| 
 | |
| Returns : | 
GList* seahorse_context_find_objects (SeahorseContext *sctx, GQuark ktype, SeahorseUsage usage, SeahorseLocation location);
| 
 | |
| 
 | |
| 
 | |
| 
 | |
| Returns : | 
GList* seahorse_context_find_objects_full (SeahorseContext *self, struct _SeahorseObjectPredicate *skpred);
| 
 | |
| 
 | |
| Returns : | 
void seahorse_context_for_objects_full (SeahorseContext *self, struct _SeahorseObjectPredicate *skpred, SeahorseObjectFunc func, gpointer user_data);
| 
 | |
| 
 | |
| 
 | |
| 
 | 
void seahorse_context_verify_objects (SeahorseContext *self);
| 
 | 
void seahorse_context_remove_object (SeahorseContext *sctx, struct _SeahorseObject *sobj);
| 
 | |
| 
 | 
SeahorseServiceDiscovery * seahorse_context_get_discovery (SeahorseContext *sctx);
seahorse_context_get_discovery is deprecated and should not be used in newly-written code. No replacement
Gets the Service Discovery object for this context.
| 
 | SeahorseContext object | 
| Returns : | The Service Discovery object. | 
struct _SeahorseObject * seahorse_context_get_default_key (SeahorseContext *sctx);
seahorse_context_get_default_key is deprecated and should not be used in newly-written code. No replacement
| 
 | Current SeahorseContext | 
| Returns : | the secret key that's the default key | 
SeahorseOperation* seahorse_context_search_remote (SeahorseContext *sctx, const gchar *search);
| 
 | |
| 
 | |
| Returns : | 
SeahorseOperation* seahorse_context_transfer_objects (SeahorseContext *sctx, GList *objs, SeahorseSource *to);
| 
 | |
| 
 | |
| 
 | |
| Returns : | 
SeahorseOperation* seahorse_context_retrieve_objects (SeahorseContext *sctx, GQuark ktype, GSList *ids, SeahorseSource *to);
| 
 | |
| 
 | |
| 
 | |
| 
 | |
| Returns : | 
GList* seahorse_context_discover_objects (SeahorseContext *sctx, GQuark ktype, GSList *ids);
| 
 | |
| 
 | |
| 
 | |
| Returns : | 
struct _SeahorseObject* seahorse_context_object_from_dbus (SeahorseContext *sctx, const gchar *dbusid);
| 
 | |
| 
 | |
| Returns : | 
gchar* seahorse_context_object_to_dbus (SeahorseContext *sctx, struct _SeahorseObject *sobj);
| 
 | |
| 
 | |
| Returns : | 
gchar* seahorse_context_id_to_dbus (SeahorseContext *sctx, GQuark id);
| 
 | |
| 
 | |
| Returns : |