diff options
Diffstat (limited to 'daemon/gnome-keyring-daemon.h')
| -rw-r--r-- | daemon/gnome-keyring-daemon.h | 192 |
1 files changed, 192 insertions, 0 deletions
diff --git a/daemon/gnome-keyring-daemon.h b/daemon/gnome-keyring-daemon.h new file mode 100644 index 00000000..6aff596a --- /dev/null +++ b/daemon/gnome-keyring-daemon.h @@ -0,0 +1,192 @@ +/* -*- Mode: C; indent-tabs-mode: t; c-basic-offset: 8; tab-width: 8 -*- */ +/* gnome-keyring-daemon.h - common includes for the keyring daemon code + + Copyright (C) 2003 Red Hat, Inc + + Gnome keyring is free software; you can redistribute it and/or + modify it under the terms of the GNU General Public License as + published by the Free Software Foundation; either version 2 of the + License, or (at your option) any later version. + + Gnome keyring 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 + General Public License for more details. + + You should have received a copy of the GNU General Public License + along with this program; if not, write to the Free Software + Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. + + Author: Alexander Larsson <alexl@redhat.com> +*/ + +#ifndef GNOME_KEYRING_DAEMON_H +#define GNOME_KEYRING_DAEMON_H + +#include <time.h> +#include <sys/types.h> +#include <glib.h> + +#include "gnome-keyring.h" +#include "gnome-keyring-private.h" + +#define KEYRING_FILE_HEADER "GnomeKeyring\n\r\0\n" +#define KEYRING_FILE_HEADER_LEN 16 + +typedef struct { + /* NULL if memory only */ + char *file; + time_t file_mtime; + + /* If known: */ + char *password; + gboolean locked; + gboolean asking_password; + + /* On disk data: */ + guchar salt[8]; + guint32 hash_iterations; + + char *keyring_name; + GList *items; + + time_t ctime; + time_t mtime; + + gboolean lock_on_idle; + guint lock_timeout; +} GnomeKeyring; + +typedef struct { + GnomeKeyring *keyring; + + guint32 id; + + GnomeKeyringItemType type; + + gboolean locked; + + /* These are hashed if locked, normal if unlocked, encrypted on file: */ + + GArray *attributes; + + /* Below is encrypted in file, invalid in memory if locked: */ + + char *display_name; + char *secret; + GList *acl; + time_t ctime; + time_t mtime; +} GnomeKeyringItem; + +typedef enum { + /* Access a keyring at all */ + GNOME_KEYRING_ACCESS_REQUEST_KEYRING, + + /* Access basic info about an item, without secret (always read access) */ + GNOME_KEYRING_ACCESS_REQUEST_ITEM, + + /* Access, change or delete, all info for item, including a secret */ + GNOME_KEYRING_ACCESS_REQUEST_ITEM_SECRET, + + /* Set various passwords for keyrings */ + GNOME_KEYRING_ACCESS_REQUEST_NEW_KEYRING_PASSWORD, + GNOME_KEYRING_ACCESS_REQUEST_ORIGINAL_CHANGE_KEYRING_PASSWORD, + GNOME_KEYRING_ACCESS_REQUEST_CHANGE_KEYRING_PASSWORD, + + /* Access to change the default keyring */ + GNOME_KEYRING_ACCESS_REQUEST_DEFAULT_KEYRING +} GnomeKeyringAccessRequestType; + +typedef struct { + GnomeKeyringAccessRequestType request_type; + + GnomeKeyringAccessType access_type; + + /* Only one is non-NULL */ + GnomeKeyring *keyring; + GnomeKeyringItem *item; + + char *new_keyring; + /* filled out for password requests */ + char *original; + char *password; + + gboolean granted; +} GnomeKeyringAccessRequest; + +typedef struct { + gboolean (*collect_info) (GString *packet, + GList **access_requests); + gboolean (*execute_op) (GString *packet, + GString *result, + GnomeKeyringApplicationRef *app_ref, + GList *access_requests); +} GnomeKeyringOperationImplementation; + +extern GnomeKeyringOperationImplementation keyring_ops[]; + +typedef void (*GnomeKeyringRequestAccessCallback) (GList *access_requests, + gpointer data); + +gpointer gnome_keyring_ask (GList *access_requests, + GnomeKeyringApplicationRef *app_ref, + GnomeKeyringRequestAccessCallback callback, + gpointer data); +void gnome_keyring_cancel_ask (gpointer request); + +GList * gnome_keyring_access_request_list_copy (GList *list); +void gnome_keyring_access_request_list_free (GList *list); +void gnome_keyring_access_request_free (GnomeKeyringAccessRequest *access_request); +GnomeKeyringAccessRequest *gnome_keyring_access_request_copy (GnomeKeyringAccessRequest *access_request); + +GList * gnome_keyring_acl_copy (GList *list); + + +GnomeKeyringApplicationRef *gnome_keyring_application_ref_new_from_pid (pid_t pid); +GnomeKeyringApplicationRef *gnome_keyring_application_ref_copy (const GnomeKeyringApplicationRef *app); +void gnome_keyring_application_ref_free (GnomeKeyringApplicationRef *app); + +void gnome_keyring_access_control_free (GnomeKeyringAccessControl *ac); +void gnome_keyring_acl_free (GList *acl); + + +void cleanup_socket_dir (void); +gboolean create_master_socket (const char **path); + +void set_default_keyring (GnomeKeyring *keyring); +void update_keyrings_from_disk (void); +void save_keyring_to_disk (GnomeKeyring *keyring); +gboolean update_keyring_from_disk (GnomeKeyring *keyring, + gboolean force_reload); +gboolean remove_keyring_file_from_disk (GnomeKeyring *keyring); + +GnomeKeyringAttributeList *gnome_keyring_attributes_hash (GnomeKeyringAttributeList *attributes); +GnomeKeyringAccessControl *gnome_keyring_access_control_new (const GnomeKeyringApplicationRef *application, + GnomeKeyringAccessType types_allowed); + + +GnomeKeyringItem *find_item_in_list (GList *list, + guint32 id); +GnomeKeyring * find_keyring (const char *name); +void gnome_keyring_item_free (GnomeKeyringItem *item); +GnomeKeyring * gnome_keyring_new (const char *name, + const char *path); +GnomeKeyringItem *gnome_keyring_item_new (GnomeKeyring *keyring, + GnomeKeyringItemType type); +void gnome_keyring_free (GnomeKeyring *keyring); + +char *get_default_keyring_file_for_name (const char *keyring_name); +void gnome_keyring_client_fixup_for_deleted (GnomeKeyring *keyring, GnomeKeyringItem *item); + +extern GList *keyrings; +extern GnomeKeyring *session_keyring; +extern GnomeKeyring *default_keyring; + +/* Dbus Initialization/Cleanup */ +#ifdef WITH_DBUS +void gnome_keyring_daemon_dbus_setup (GMainLoop *loop, const gchar* socket); +void gnome_keyring_daemon_dbus_cleanup (void); +#endif + +#endif /* GNOME_KEYRING_DAEMON_H */ |