| 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 |