![]() |
![]() |
![]() |
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 |
SeahorseContext* seahorse_context_new (guint flags);
Creates a new SeahorseContext. Flags: SEAHORSE_CONTEXT_DAEMON: internal daemon flag will be set SEAHORSE_CONTEXT_APP: will support DNS-SD discovery and remote key sources
|
Flags define the type of the context to create. |
Returns : |
The new context |
void seahorse_context_destroy (SeahorseContext *sctx);
Emits the destroy signal for sctx
.
|
SeahorseContext to destroy |
void seahorse_context_add_source (SeahorseContext *sctx, SeahorseSource *sksrc);
Adds sksrc
to the sctx
. If sctx
is NULL it will use the application context.
It also adds a reference to the new added source.
|
A context to add a source to, can be NULL |
|
The source to add |
void seahorse_context_take_source (SeahorseContext *sctx, SeahorseSource *sksrc);
Adds sksrc
to the sctx
. If sctx
is NULL it will use the application context.
|
A context to add a source to, can be NULL |
|
The source to add |
void seahorse_context_remove_source (SeahorseContext *sctx, SeahorseSource *sksrc);
Remove all objects from source sksrc
from the SeahorseContext sctx
|
Context to remove objects from |
|
The source to remove |
SeahorseSource* seahorse_context_find_source (SeahorseContext *sctx, GQuark ktype, SeahorseLocation location);
Finds a context where ktype
and location
match
|
A SeahorseContext |
|
A seahorse tag (SEAHORSE_TAG_INVALID is wildcard) |
|
A location (SEAHORSE_LOCATION_INVALID is wildcard) |
Returns : |
The context |
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 ktype and location as GSList. Must
be freed with g_slist_free
|
SeahorseSource* seahorse_context_remote_source (SeahorseContext *sctx, const gchar *uri);
Add a remote source to the Context sctx
. If it already exists, the source
object will be returned.
|
the context to add the source to (can be NULL) |
|
An URI to add as remote source |
Returns : |
The SeahorseSource with this URI |
void seahorse_context_add_object (SeahorseContext *sctx, struct _SeahorseObject *sobj);
Adds sobj
to sctx
. References sobj
|
The context to add the object to |
|
The object to add |
void seahorse_context_take_object (SeahorseContext *sctx, struct _SeahorseObject *sobj);
Adds sobj
to sctx
. If a similar object exists, it will be overwritten.
Emits the "added" signal.
|
The SeahorseContext context to add an object to |
|
The SeahorseObject object to add |
guint seahorse_context_get_count (SeahorseContext *sctx);
|
The context. If NULL is passed it will take the application context |
Returns : |
The number of objects in this context |
struct _SeahorseObject* seahorse_context_get_object (SeahorseContext *sctx, SeahorseSource *sksrc, GQuark id);
Finds the object with the source sksrc
and id
in the context and returns it
|
The SeahorseContext to look in |
|
The source to match |
|
the id to match |
Returns : |
The matching object |
GList* seahorse_context_get_objects (SeahorseContext *sctx, SeahorseSource *sksrc);
|
|
|
|
Returns : |
A GList of objects from self that match the source source
|
struct _SeahorseObject* seahorse_context_find_object (SeahorseContext *sctx, GQuark id, SeahorseLocation location);
Finds the object with the id id
at location location
or better.
Local is better than remote...
|
The SeahorseContext to work with (can be NULL) |
|
The id to look for |
|
The location to look for (at least) |
Returns : |
the matching SeahorseObject or NULL if none is found |
GList* seahorse_context_find_objects (SeahorseContext *sctx, GQuark ktype, SeahorseUsage usage, SeahorseLocation location);
|
A SeahorseContext to look in (can be NULL) |
|
The tag to look for |
|
the usage (SeahorseUsage) |
|
the location to look for |
Returns : |
A list of matching objects |
GList* seahorse_context_find_objects_full (SeahorseContext *self, struct _SeahorseObjectPredicate *skpred);
Finds matching objects and adds them to the list
|
The SeahorseContext to match objects in |
|
|
Returns : |
a GList list containing the matching objects |
void seahorse_context_for_objects_full (SeahorseContext *self, struct _SeahorseObjectPredicate *skpred, SeahorseObjectFunc func, gpointer user_data);
Calls func
for every object in self
matching the criteria in pred
. user_data
is passed to this function
|
SeahorseContext to work with |
|
|
|
Function to call for matching objects |
|
Data to pass to this function |
void seahorse_context_verify_objects (SeahorseContext *self);
Verifies each key in the given context. An assertion handles failure.
|
A SeahorseContext to verify |
void seahorse_context_remove_object (SeahorseContext *sctx, struct _SeahorseObject *sobj);
Removes the object from the context
|
The SeahorseContext (can be NULL) |
|
The SeahorseObject to remove |
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 |
void seahorse_context_refresh_auto (SeahorseContext *sctx);
Starts a new refresh operation and emits the "refreshing" signal
|
A SeahorseContext (can be NULL) |
SeahorseOperation* seahorse_context_search_remote (SeahorseContext *sctx, const gchar *search);
Searches for the key matching search
o the remote servers
|
A SeahorseContext (can be NULL) |
|
a keyword (name, email address...) to search for |
Returns : |
The created search operation |
SeahorseOperation* seahorse_context_transfer_objects (SeahorseContext *sctx, GList *objs, SeahorseSource *to);
|
The SeahorseContext (can be NULL) |
|
|
|
a source to import to (can be NULL) |
Returns : |
A transfer operation |
SeahorseOperation* seahorse_context_retrieve_objects (SeahorseContext *sctx, GQuark ktype, GSList *ids, SeahorseSource *to);
Copies remote objects to a local source
|
A SeahorsecContext |
|
The type of the keys to transfer |
|
The key ids to transfer |
|
A SeahorseSource. If NULL, it will use ktype to find a source
|
Returns : |
A SeahorseOperation |
GList* seahorse_context_discover_objects (SeahorseContext *sctx, GQuark ktype, GSList *ids);
Downloads a list of keys from the keyserver
|
the context to work with (can be NULL) |
|
the type of key to discover |
|
|
Returns : |
The imported keys |
struct _SeahorseObject* seahorse_context_object_from_dbus (SeahorseContext *sctx, const gchar *dbusid);
Finds an object basing on the key
|
A SeahorseContext |
|
|
Returns : |
The SeahorseObject found. NULL on not found. |
gchar* seahorse_context_object_to_dbus (SeahorseContext *sctx, struct _SeahorseObject *sobj);
Translates an object to a string id
|
A seahorse context |
|
the object |
Returns : |
The string id of the object. Free with g_free |
gchar* seahorse_context_id_to_dbus (SeahorseContext *sctx, GQuark id);
Translates an id to a dbus compatible string
|
ignored |
|
the id to translate |
Returns : |
A string, free with g_free |