/* * gnome-keyring * * Copyright (C) 2008 Stefan Walter * * This program is free software; you can redistribute it and/or modify * it under the terms of the GNU Lesser General Public License as * published by the Free Software Foundation; either version 2.1 of * the License, or (at your option) any later version. * * This program is distributed in the hope that it will be useful, but * WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this program; if not, see * . */ #ifndef __GKM_MANAGER_H__ #define __GKM_MANAGER_H__ #include #include #include "gkm-object.h" /* * GkmManager * * A GkmManager tracks a set of GkmObject objects. It does not own * those objects. Once an object is registered with the manager it gets * an identifier. * * An object will unregister itself from the manager when it is destroyed or * it can be done explicitely. * * A singleton GkmManager exists for token objects, those stored in * persistent storage. This manager lasts for the lifetime of the daemon. * * Other GkmManager objects can exist per client for session or * temporary objects. Multiple requests for a manager for the same client * will return the same manager. Once all references dissappear this * manager will go away. */ G_BEGIN_DECLS #include #include "gkm-types.h" #include "pkcs11/pkcs11.h" #define GKM_TYPE_MANAGER (gkm_manager_get_type ()) #define GKM_MANAGER(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), GKM_TYPE_MANAGER, GkmManager)) #define GKM_MANAGER_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), GKM_TYPE_MANAGER, GkmManager)) #define GKM_IS_MANAGER(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GKM_TYPE_MANAGER)) #define GKM_IS_MANAGER_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GKM_TYPE_MANAGER)) #define GKM_MANAGER_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), GKM_TYPE_MANAGER, GkmManagerClass)) typedef struct _GkmManagerClass GkmManagerClass; typedef struct _GkmManagerPrivate GkmManagerPrivate; struct _GkmManager { GObject parent; GkmManagerPrivate *pv; }; struct _GkmManagerClass { GObjectClass parent_class; /* signals */ void (*object_added) (GkmManager *self, GkmObject *object); void (*object_removed) (GkmManager *self, GkmObject *object); void (*attribute_changed) (GkmManager *self, GkmObject *object, CK_ATTRIBUTE_TYPE type); }; GType gkm_manager_get_type (void) G_GNUC_CONST; GkmManager* gkm_manager_for_template (CK_ATTRIBUTE_PTR attrs, CK_ULONG n_attrs, GkmSession *session); gboolean gkm_manager_get_for_token (GkmManager *self); void gkm_manager_add_attribute_index (GkmManager *self, CK_ATTRIBUTE_TYPE attr, gboolean unique); void gkm_manager_add_property_index (GkmManager *self, const gchar *property, gboolean unique); GkmObject* gkm_manager_find_by_handle (GkmManager *self, CK_OBJECT_HANDLE obj); GList* gkm_manager_find_by_number_property (GkmManager *self, const gchar *property, gulong value); GkmObject* gkm_manager_find_one_by_number_property (GkmManager *self, const gchar *property, gulong value); GList* gkm_manager_find_by_string_property (GkmManager *self, const gchar *property, const gchar *value); GkmObject* gkm_manager_find_one_by_string_property (GkmManager *self, const gchar *property, const gchar *value); GList* gkm_manager_find_by_attributes (GkmManager *self, GkmSession *session, CK_ATTRIBUTE_PTR template, CK_ULONG n_attrs); GList* gkm_manager_find_by_class (GkmManager *self, GkmSession *session, CK_OBJECT_CLASS klass); GkmObject* gkm_manager_find_one_by_attributes (GkmManager *self, GkmSession *session, CK_ATTRIBUTE_PTR template, CK_ULONG n_attrs); GkmObject* gkm_manager_find_related (GkmManager *self, GkmSession *session, CK_OBJECT_CLASS klass, GkmObject *related_to); CK_RV gkm_manager_find_handles (GkmManager *self, GkmSession *session, gboolean include_private, CK_ATTRIBUTE_PTR template, CK_ULONG count, GArray *found); G_END_DECLS #endif /* __GKM_MANAGER_H__ */