/***********************************************************************
 * 
 *  Copyright (C) 2005-2006 Novell, Inc. All Rights Reserved.
 *
 *  This library 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; version 2.1
 *  of the License.
 *
 *  This library 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
 *  Library Lesser General Public License for more details.
 *
 *  You should have received a copy of the GNU Lesser General Public
 *  License along with this library; if not, Novell, Inc.
 * 
 *  To contact Novell about this file by physical or electronic mail, 
 *  you may find current contact information at www.novell.com.
 * 
 ***********************************************************************/

#ifndef _CASA_GNOME_KEYRING_H
#define _CASA_GNOME_KEYRING_H

#include <glib.h>
#include <time.h>

typedef enum 
{
	CASA_GNOME_KEYRING_RESULT_OK,
	CASA_GNOME_KEYRING_RESULT_DENIED,
	CASA_GNOME_KEYRING_RESULT_NO_KEYRING_DAEMON,
	CASA_GNOME_KEYRING_RESULT_ALREADY_UNLOCKED,
	CASA_GNOME_KEYRING_RESULT_NO_SUCH_KEYRING,
	CASA_GNOME_KEYRING_RESULT_BAD_ARGUMENTS,
	CASA_GNOME_KEYRING_RESULT_IO_ERROR,
	CASA_GNOME_KEYRING_RESULT_CANCELLED,
	CASA_GNOME_KEYRING_RESULT_ALREADY_EXISTS
} CASA_GnomeKeyringResult;

#define	GNOME_KEYRING_RESULT_OK	                CASA_GNOME_KEYRING_RESULT_OK              
#define	GNOME_KEYRING_RESULT_DENIED	            CASA_GNOME_KEYRING_RESULT_DENIED    
#define	GNOME_KEYRING_RESULT_NO_KEYRING_DAEMON	CASA_GNOME_KEYRING_RESULT_NO_KEYRING_DAEMON  
#define	GNOME_KEYRING_RESULT_ALREADY_UNLOCKED	CASA_GNOME_KEYRING_RESULT_ALREADY_UNLOCKED   
#define	GNOME_KEYRING_RESULT_NO_SUCH_KEYRING	CASA_GNOME_KEYRING_RESULT_NO_SUCH_KEYRING    
#define	GNOME_KEYRING_RESULT_BAD_ARGUMENTS		CASA_GNOME_KEYRING_RESULT_BAD_ARGUMENTS      
#define	GNOME_KEYRING_RESULT_IO_ERROR			CASA_GNOME_KEYRING_RESULT_IO_ERROR           
#define	GNOME_KEYRING_RESULT_CANCELLED			CASA_GNOME_KEYRING_RESULT_CANCELLED
#define	GNOME_KEYRING_RESULT_ALREADY_EXISTS     CASA_GNOME_KEYRING_RESULT_ALREADY_EXISTS      

#define	GnomeKeyringResult						CASA_GnomeKeyringResult                     

typedef enum 
{
	CASA_GNOME_KEYRING_ITEM_GENERIC_SECRET,
	CASA_GNOME_KEYRING_ITEM_NETWORK_PASSWORD,
	CASA_GNOME_KEYRING_ITEM_NOTE,
    CASA_GNOME_KEYRING_ITEM_LAST_TYPE,
    CASA_GNOME_KEYRING_ITEM_NO_TYPE = 0xffffffff,
} CASA_GnomeKeyringItemType;

#define	GNOME_KEYRING_ITEM_GENERIC_SECRET		CASA_GNOME_KEYRING_ITEM_GENERIC_SECRET   
#define	GNOME_KEYRING_ITEM_NETWORK_PASSWORD     CASA_GNOME_KEYRING_ITEM_NETWORK_PASSWORD 
#define	GNOME_KEYRING_ITEM_NOTE                 CASA_GNOME_KEYRING_ITEM_NOTE             
#define	GNOME_KEYRING_ITEM_LAST_TYPE            CASA_GNOME_KEYRING_ITEM_LAST_TYPE        
#define	GNOME_KEYRING_ITEM_NO_TYPE              CASA_GNOME_KEYRING_ITEM_NO_TYPE          

#define 	GnomeKeyringItemType				CASA_GnomeKeyringItemType

typedef enum 
{
	CASA_GNOME_KEYRING_ACCESS_ASK,
	CASA_GNOME_KEYRING_ACCESS_DENY,
	CASA_GNOME_KEYRING_ACCESS_ALLOW
} CASA_GnomeKeyringAccessRestriction;

#define	GNOME_KEYRING_ACCESS_ASK				CASA_GNOME_KEYRING_ACCESS_ASK      
#define	GNOME_KEYRING_ACCESS_DENY           	CASA_GNOME_KEYRING_ACCESS_DENY     
#define	GNOME_KEYRING_ACCESS_ALLOW          	CASA_GNOME_KEYRING_ACCESS_ALLOW    
																			  
#define	GnomeKeyringAccessRestriction       	CASA_GnomeKeyringAccessRestriction 


typedef enum 
{
	CASA_GNOME_KEYRING_ATTRIBUTE_TYPE_STRING,
	CASA_GNOME_KEYRING_ATTRIBUTE_TYPE_UINT32
} CASAGnomeKeyringAttributeType;

#define	GNOME_KEYRING_ATTRIBUTE_TYPE_STRING		CASA_GNOME_KEYRING_ATTRIBUTE_TYPE_STRING
#define	GNOME_KEYRING_ATTRIBUTE_TYPE_UINT32     CASA_GNOME_KEYRING_ATTRIBUTE_TYPE_UINT32
																				   
#define	GnomeKeyringAttributeType               CASA_GnomeKeyringAttributeType          

typedef struct	GnomeKeyringAccessControl		CASA_GnomeKeyringAccessControl;
typedef struct	GnomeKeyringApplicationRef		CASA_GnomeKeyringApplicationRef;
typedef 		GArray 							CASA_GnomeKeyringAttributeList;

#define GnomeKeyringAccessControl				CASA_GnomeKeyringAccessControl  
#define GnomeKeyringApplicationRef      		CASA_GnomeKeyringApplicationRef 
#define GnomeKeyringAttributeList       		CASA_GnomeKeyringAttributeList  

typedef enum 
{
	CASA_GNOME_KEYRING_ACCESS_READ = 1<<0,
	CASA_GNOME_KEYRING_ACCESS_WRITE = 1<<1,
	CASA_GNOME_KEYRING_ACCESS_REMOVE = 1<<2
} CASA_GnomeKeyringAccessType;

#define GNOME_KEYRING_ACCESS_READ				CASA_GNOME_KEYRING_ACCESS_READ  
#define GNOME_KEYRING_ACCESS_WRITE              CASA_GNOME_KEYRING_ACCESS_WRITE 
#define GNOME_KEYRING_ACCESS_REMOVE             CASA_GNOME_KEYRING_ACCESS_REMOVE
																		   
#define	GnomeKeyringAccessType                  CASA_GnomeKeyringAccessType


typedef struct GnomeKeyringInfo 				CASA_GnomeKeyringInfo;
typedef struct GnomeKeyringItemInfo 			CASA_GnomeKeyringItemInfo;

#define GnomeKeyringInfo						CASA_GnomeKeyringInfo        
#define GnomeKeyringItemInfo                    CASA_GnomeKeyringItemInfo 

typedef struct 
{
	char 							*name;
	CASA_GnomeKeyringAttributeType 	type;
	union 
	{
		char 	*string;
		guint32 integer;
	} value;
} CASA_GnomeKeyringAttribute;

#define	GnomeKeyringAttribute					CASA_GnomeKeyringAttribute

typedef struct 
{
	char 							*keyring;
	guint 							item_id;
	CASA_GnomeKeyringAttributeList	*attributes;
	char							*secret;
} CASA_GnomeKeyringFound;

#define	GnomeKeyringFound						CASA_GnomeKeyringFound	

typedef void (*CASA_GnomeKeyringOperationDoneCallback)           
	(
		CASA_GnomeKeyringResult result, 
		gpointer           data
	 );

#define GnomeKeyringOperationDoneCallback			CASA_GnomeKeyringOperationDoneCallback

typedef void (*CASA_GnomeKeyringOperationGetStringCallback)      
	(
				CASA_GnomeKeyringResult	result,
		const	char        		*string,
				gpointer           data
	);

#define	GnomeKeyringOperationGetStringCallback		CASA_GnomeKeyringOperationGetStringCallback

typedef void (*CASA_GnomeKeyringOperationGetIntCallback)
	(
		CASA_GnomeKeyringResult result,
		guint32            val,
		gpointer           data
	);

#define	GnomeKeyringOperationGetIntCallback			CASA_GnomeKeyringOperationGetIntCallback

typedef void (*CASA_GnomeKeyringOperationGetListCallback)        
	(
		CASA_GnomeKeyringResult result,
		GList             *list,
		gpointer           data
	);

#define	GnomeKeyringOperationGetListCallback		CASA_GnomeKeyringOperationGetListCallback

typedef void (*CASA_GnomeKeyringOperationGetKeyringInfoCallback) 
	(
		CASA_GnomeKeyringResult result,
		CASA_GnomeKeyringInfo  *info,
		gpointer           data
	);

#define GnomeKeyringOperationGetKeyringInfoCallback	CASA_GnomeKeyringOperationGetKeyringInfoCallback

typedef void (*CASA_GnomeKeyringOperationGetItemInfoCallback)    
	(
		CASA_GnomeKeyringResult   result,
		CASA_GnomeKeyringItemInfo*info,
		gpointer             data
	);

#define GnomeKeyringOperationGetItemInfoCallback	CASA_GnomeKeyringOperationGetItemInfoCallback

typedef void (*CASA_GnomeKeyringOperationGetAttributesCallback)  
	(
		CASA_GnomeKeyringResult   		result,
		CASA_GnomeKeyringAttributeList	*attributes,
		gpointer             data
	);

#define	GnomeKeyringOperationGetAttributesCallback	CASA_GnomeKeyringOperationGetAttributesCallback

#define CASA_gnome_keyring_attribute_list_index(a, i) g_array_index ((a), GnomeKeyringAttribute, (i))
#define gnome_keyring_attribute_list_index		CASA_gnome_keyring_attribute_list_index

#define CASA_gnome_keyring_attribute_list_new() (g_array_new (FALSE, FALSE, sizeof (GnomeKeyringAttribute)))
#define gnome_keyring_attribute_list_new		CASA_gnome_keyring_attribute_list_new

void	CASA_gnome_keyring_attribute_list_append_string 
	(
		CASA_GnomeKeyringAttributeList *attributes,
		const char                *attribute,
		const char                *value
	);

#define	gnome_keyring_attribute_list_append_string	CASA_gnome_keyring_attribute_list_append_string

void	CASA_gnome_keyring_attribute_list_append_uint32 
	(
		CASA_GnomeKeyringAttributeList *attributes,
		const char                *attribute,
		guint32                    value
	);

#define	gnome_keyring_attribute_list_append_uint32	CASA_gnome_keyring_attribute_list_append_uint32 

void	CASA_gnome_keyring_attribute_list_free          
	(
		CASA_GnomeKeyringAttributeList *attributes
	);

#define	gnome_keyring_attribute_list_free           CASA_gnome_keyring_attribute_list_free           

GnomeKeyringAttributeList *CASA_gnome_keyring_attribute_list_copy
	(
		CASA_GnomeKeyringAttributeList *attributes
	);

#define	gnome_keyring_attribute_list_copy			CASA_gnome_keyring_attribute_list_copy 

gboolean CASA_gnome_keyring_is_available (void);

#define	gnome_keyring_is_available					CASA_gnome_keyring_is_available 

void CASA_gnome_keyring_free_password (char *password);

#define	gnome_keyring_free_password					CASA_gnome_keyring_free_password

void CASA_gnome_keyring_found_free (GnomeKeyringFound *found);

#define gnome_keyring_found_free	CASA_gnome_keyring_found_free

void CASA_gnome_keyring_found_list_free (GList *found_list);

#define	gnome_keyring_found_list_free				CASA_gnome_keyring_found_list_free

void CASA_gnome_keyring_cancel_request (gpointer request);

#define gnome_keyring_cancel_request				CASA_gnome_keyring_cancel_request

gpointer	CASA_gnome_keyring_set_default_keyring      
	(
		const char									*keyring,
		CASA_GnomeKeyringOperationDoneCallback		callback,
		gpointer                                 	data,
		GDestroyNotify                           	destroy_data
	);

#define	gnome_keyring_set_default_keyring			CASA_gnome_keyring_set_default_keyring  


CASA_GnomeKeyringResult CASA_gnome_keyring_set_default_keyring_sync 
	(
		const char                              	*keyring
	);

#define	gnome_keyring_set_default_keyring_sync		CASA_gnome_keyring_set_default_keyring_sync


gpointer	CASA_gnome_keyring_get_default_keyring      
	(
		CASA_GnomeKeyringOperationGetStringCallback	callback,
		gpointer                                 	data,
		GDestroyNotify                           	destroy_data
	);

#define	gnome_keyring_get_default_keyring			CASA_gnome_keyring_get_default_keyring  


CASA_GnomeKeyringResult CASA_gnome_keyring_get_default_keyring_sync 
	(
		char                                   		**keyring
	);

#define	gnome_keyring_get_default_keyring_sync		CASA_gnome_keyring_get_default_keyring_sync


gpointer	CASA_gnome_keyring_list_keyring_names       
	(
		CASA_GnomeKeyringOperationGetListCallback	callback,
		gpointer									data,
		GDestroyNotify								destroy_data
	);

#define	gnome_keyring_list_keyring_names			CASA_gnome_keyring_list_keyring_names 

GASA_GnomeKeyringResult CASA_gnome_keyring_list_keyring_names_sync  
	(
		GList                                  		**keyrings
	);

#define	gnome_keyring_list_keyring_names_sync		CASA_gnome_keyring_list_keyring_names_sync 

gpointer	CASA_gnome_keyring_lock_all
	(
		CASA_GnomeKeyringOperationDoneCallback		callback,
		gpointer                                 	data,
		GDestroyNotify                           	destroy_data
	);

#define	gnome_keyring_lock_all 						CASA_gnome_keyring_lock_all 

CASA_GnomeKeyringResult CASA_gnome_keyring_lock_all_sync(void);

#define	gnome_keyring_lock_all_sync					CASA_gnome_keyring_lock_all_sync

/* NULL password means ask user */
gpointer	CASA_gnome_keyring_create             
	(
		const char                                  *keyring_name,
		const char                                  *password,
		CASA_GnomeKeyringOperationDoneCallback		callback,
		gpointer                                    data,
		GDestroyNotify                              destroy_data
	);

#define	gnome_keyring_create						CASA_gnome_keyring_create

CASA_GnomeKeyringResult CASA_gnome_keyring_create_sync
	(
		const char                                  *keyring_name,
		const char                                  *password
	);

#define	gnome_keyring_create_sync 					CASA_gnome_keyring_create_sync 

gpointer	CASA_gnome_keyring_unlock
	(
		const char                                  *keyring,
		const char                                  *password,
		CASA_GnomeKeyringOperationDoneCallback      callback,
		gpointer                                    data,
		GDestroyNotify                              destroy_data
	);

#define	gnome_keyring_unlock						CASA_gnome_keyring_unlock 

CASA_GnomeKeyringResult CASA_gnome_keyring_unlock_sync
	(
		const char                                  *keyring,
		const char                                  *password
	);

#define	gnome_keyring_unlock_sync					CASA_gnome_keyring_unlock_sync

gpointer	CASA_gnome_keyring_lock
	(
		const char                                  *keyring,
		CASA_GnomeKeyringOperationDoneCallback      callback,
		gpointer                                    data,
		GDestroyNotify                              destroy_data
	);

#define	gnome_keyring_lock							CASA_gnome_keyring_lock  

CASA_GnomeKeyringResult CASA_gnome_keyring_lock_sync
    (
		const char                                  *keyring
	);

#define	gnome_keyring_lock_sync						CASA_gnome_keyring_lock_sync

gpointer	CASA_gnome_keyring_delete
	(
		const char                                  *keyring,
		CASA_GnomeKeyringOperationDoneCallback      callback,
		gpointer                                    data,
		GDestroyNotify                              destroy_data
	);

#define	gnome_keyring_delete						CASA_gnome_keyring_delete

CASA_GnomeKeyringResult CASA_gnome_keyring_delete_sync
	(
		const char                                  *keyring
	);

#define	gnome_keyring_delete_sync					CASA_gnome_keyring_delete_sync

gpointer	CASA_gnome_keyring_get_info
    (
		const char                                   *keyring,
		CASA_GnomeKeyringOperationGetKeyringInfoCallback   callback,
		gpointer                                    data,
		GDestroyNotify                              destroy_data
	);

#define	gnome_keyring_get_info						CASA_gnome_keyring_get_info

CASA_GnomeKeyringResult CASA_gnome_keyring_get_info_sync
	(
		const char                                  *keyring,
		CASA_GnomeKeyringInfo                       **info
	);

#define	gnome_keyring_get_info_sync					CASA_gnome_keyring_get_info_sync 

gpointer	CASA_gnome_keyring_set_info
	(
		const char                                  *keyring,
		CASA_GnomeKeyringInfo                       *info,
		CASA_GnomeKeyringOperationDoneCallback      callback,
		gpointer                                    data,
		GDestroyNotify                              destroy_data
	);

#define	gnome_keyring_set_info						CASA_gnome_keyring_set_info

CASA_GnomeKeyringResult CASA_gnome_keyring_set_info_sync
	(
		const char                                  *keyring,
		GnomeKeyringInfo                            *info

	);

#define	gnome_keyring_set_info_sync					CASA_gnome_keyring_set_info_sync

gpointer           CASA_gnome_keyring_list_item_ids      
	(
		const char                                  *keyring,
		CASA_GnomeKeyringOperationGetListCallback   callback,
		gpointer                                    data,
		GDestroyNotify                              destroy_data
	);

#define	gnome_keyring_list_item_ids					CASA_gnome_keyring_list_item_ids

CASA_GnomeKeyringResult CASA_gnome_keyring_list_item_ids_sync 
	(
		const char                                  *keyring,
		GList                                       **ids
	);

#define	gnome_keyring_list_item_ids_sync			CASA_gnome_keyring_list_item_ids_sync

void	CASA_gnome_keyring_info_free
	(
		CASA_GnomeKeyringInfo						*keyring_info
    );

#define	gnome_keyring_info_free						CASA_gnome_keyring_info_free

CASA_GnomeKeyringInfo *CASA_gnome_keyring_info_copy
	(
		CASA_GnomeKeyringInfo 						*keyring_info
	);


#define	gnome_keyring_info_copy						CASA_gnome_keyring_info_copy

void	CASA_gnome_keyring_info_set_lock_on_idle 
	(
		GnomeKeyringInfo 							*keyring_info,
		gboolean          							value
	);

gboolean	CASA_gnome_keyring_info_get_lock_on_idle
	(
		CASA_GnomeKeyringInfo 						*keyring_info
	);

#define	gnome_keyring_info_get_lock_on_idle

void	CASA_gnome_keyring_info_set_lock_timeout 
	(
		CASA_GnomeKeyringInfo 						*keyring_info,
		guint32           							value
	);

#define	gnome_keyring_info_set_lock_timeout			CASA_gnome_keyring_info_set_lock_timeout

guint32	CASA_gnome_keyring_info_get_lock_timeout 
	(
		CASA_GnomeKeyringInfo 						*keyring_info
	);

#define	gnome_keyring_info_get_lock_timeout			CASA_gnome_keyring_info_get_lock_timeout

time_t	CASA_gnome_keyring_info_get_mtime
	(
		GnomeKeyringInfo 							*keyring_info
	);

#define	gnome_keyring_info_get_mtime				CASA_gnome_keyring_info_get_mtime

time_t	CASA_gnome_keyring_info_get_ctime
	(	
		CASA_GnomeKeyringInfo						*keyring_info
	);

#define	gnome_keyring_info_get_ctime				CASA_gnome_keyring_info_get_ctime 


gboolean	CASA_gnome_keyring_info_get_is_locked
	(
		CASA_GnomeKeyringInfo *keyring_info
	);

#define	gnome_keyring_info_get_is_locked 			CASA_gnome_keyring_info_get_is_locked 

gpointer	CASA_gnome_keyring_find_items
	(
		CASA_GnomeKeyringItemType                  	type,
		CASA_GnomeKeyringAttributeList            	*attributes,
		CASA_GnomeKeyringOperationGetListCallback  	callback,
		gpointer                              		data,
		GDestroyNotify                        		destroy_data
	);

#define	gnome_keyring_find_items					CASA_gnome_keyring_find_items  

gpointer	CASA_gnome_keyring_find_itemsv 
	(
		CASA_GnomeKeyringItemType                  	type,
		CASA_GnomeKeyringOperationGetListCallback  	callback,
		gpointer                              		data,
		GDestroyNotify                        		destroy_data,
		...
	);

#define	gnome_keyring_find_itemsv 					CASA_gnome_keyring_find_itemsv 

CASA_GnomeKeyringResult	CASA_gnome_keyring_find_items_sync
	(
	  CASA_GnomeKeyringItemType        				type,
	  CASA_GnomeKeyringAttributeList  				*attributes,
	  GList                    						**found
	);

#define	gnome_keyring_find_items_sync 				CASA_gnome_keyring_find_items_sync 

CASA_GnomeKeyringResult CASA_gnome_keyring_find_itemsv_sync
	(
		CASA_GnomeKeyringItemType      				type,
		GList                     					**found,
		...
	);

#define	gnome_keyring_find_itemsv_sync				CASA_gnome_keyring_find_itemsv_sync 

gpointer	CASA_gnome_keyring_item_create
	(
		const char                                  *keyring,
		CASA_GnomeKeyringItemType                   type,
		const char                                  *display_name,
		CASA_GnomeKeyringAttributeList              *attributes,
		const char                                 	*secret,
		gboolean                                    update_if_exists,
		CASA_GnomeKeyringOperationGetIntCallback    callback,
		gpointer                                    data,
		GDestroyNotify                              destroy_data
	);

#define	gnome_keyring_item_create					CASA_gnome_keyring_item_create

CASA_GnomeKeyringResult	CASA_gnome_keyring_item_create_sync         
	(
		const char                                 *keyring,
		CASA_GnomeKeyringItemType                  type,
		const char                                 *display_name,
		CASA_GnomeKeyringAttributeList             *attributes,
		const char                                 *secret,
		gboolean                                   update_if_exists,
		guint32                                    *item_id
	);

#define	gnome_keyring_item_create_sync 				CASA_gnome_keyring_item_create_sync 

gpointer	CASA_gnome_keyring_item_delete
	(
		const char                                 *keyring,
		guint32                                     id,
		CASA_GnomeKeyringOperationDoneCallback      callback,
		gpointer                                    data,
		CASA_GDestroyNotify                         destroy_data
	);

#define	gnome_keyring_item_delete					CASA_gnome_keyring_item_delete

CASA_GnomeKeyringResult	CASA_gnome_keyring_item_delete_sync
	(
		const char                                 *keyring,
		guint32                                     id
	);

#define	gnome_keyring_item_delete_sync				CASA_gnome_keyring_item_delete_sync  

gpointer	CASA_gnome_keyring_item_get_info
	(
		const char                                 *keyring,
		guint32                                     id,
		CASA_GnomeKeyringOperationGetItemInfoCallback    callback,
		gpointer                                    data,
		GDestroyNotify                              destroy_data
	);

#define	gnome_keyring_item_get_info 				CASA_gnome_keyring_item_get_info 

CASA_GnomeKeyringResult	CASA_gnome_keyring_item_get_info_sync       
	(
		const char                                  *keyring,
		guint32                                     id,
		CASA_GnomeKeyringItemInfo                   **info
	);

#define	gnome_keyring_item_get_info_sync			CASA_gnome_keyring_item_get_info_sync

gpointer	CASA_gnome_keyring_item_set_info            
	(
		const char                                  *keyring,
		guint32                                     id,
		CASA_GnomeKeyringItemInfo                   *info,
		CASA_GnomeKeyringOperationDoneCallback      callback,
		gpointer                                    data,
		GDestroyNotify                              destroy_data
	);

#define	gnome_keyring_item_set_info					CASA_gnome_keyring_item_set_info

CASA_GnomeKeyringResult CASA_gnome_keyring_item_set_info_sync
	(
		const char                                  *keyring,
		guint32                                     id,
		CASA_GnomeKeyringItemInfo                   *info
	);

#define	gnome_keyring_item_set_info_sync			CASA_gnome_keyring_item_set_info_sync
														 
gpointer	CASA_gnome_keyring_item_get_attributes
	(
		const char                                 *keyring,
		guint32                                     id,
		CASA_GnomeKeyringOperationGetAttributesCallback  callback,
		gpointer                                    data,
		GDestroyNotify                              destroy_data
	);

#define	gnome_keyring_item_get_attributes			CASA_gnome_keyring_item_get_attributes

CASA_GnomeKeyringResult CASA_gnome_keyring_item_get_attributes_sync 
	(
		const char                                 *keyring,
		guint32                                     id,
		CASA_GnomeKeyringAttributeList             **attributes
	);

#define	gnome_keyring_item_get_attributes_sync		CASA_gnome_keyring_item_get_attributes_sync

gpointer	CASA_gnome_keyring_item_set_attributes
	(
		const char                                  *keyring,
		guint32                                     id,
		CASA_GnomeKeyringAttributeList              *attributes,
		CASA_GnomeKeyringOperationDoneCallback      callback,
		gpointer                                    data,
		GDestroyNotify                              destroy_data
	);

#define	gnome_keyring_item_set_attributes 			CASA_gnome_keyring_item_set_attributes 

CASA_GnomeKeyringResult	CASA_gnome_keyring_item_set_attributes_sync 
	(
		const char                                 *keyring,
		guint32                                     id,
		CASA_GnomeKeyringAttributeList                  *attributes
	);

#define	gnome_keyring_item_set_attributes_sync		CASA_gnome_keyring_item_set_attributes_sync

gpointer	CASA_gnome_keyring_item_get_acl
	(
		const char                                  *keyring,
		guint32                                     id,
		CASA_GnomeKeyringOperationGetListCallback   callback,
		gpointer                                    data,
		GDestroyNotify                              destroy_data
	);

#define	gnome_keyring_item_get_acl 					CASA_gnome_keyring_item_get_acl 

CASA_GnomeKeyringResult	CASA_gnome_keyring_item_get_acl_sync
	(
		const char                                  *keyring,
		guint32                                     id,
		GList                                     	**acl
	);

#define	gnome_keyring_item_get_acl_sync				CASA_gnome_keyring_item_get_acl_sync 

gpointer	CASA_gnome_keyring_item_set_acl
	(
		const char                                  *keyring,
		guint32                                     id,
		GList                                       *acl,
		CASA_GnomeKeyringOperationDoneCallback      callback,
		gpointer                                    data,
		GDestroyNotify                              destroy_data
	);

#define	gnome_keyring_item_set_acl					CASA_gnome_keyring_item_set_acl

CASA_GnomeKeyringResult	CASA_gnome_keyring_item_set_acl_sync
	(
		const char                                 *keyring,
		guint32                                     id,
		GList                                      *acl
	);

#define	gnome_keyring_item_set_acl_sync 			CASA_gnome_keyring_item_set_acl_sync 



void	CASA_gnome_keyring_item_info_free (CASA_GnomeKeyringItemInfo *item_info);
#define	gnome_keyring_item_info_free				CASA_gnome_keyring_item_info_free

CASA_GnomeKeyringItemInfo *CASA_gnome_keyring_item_info_new (void);
#define	gnome_keyring_item_info_new					CASA_gnome_keyring_item_info_new

CASA_GnomeKeyringItemInfo *CASA_gnome_keyring_item_info_copy (CASA_GnomeKeyringItemInfo *item_info);
#define	gnome_keyring_item_info_copy 				CASA_gnome_keyring_item_info_copy
 
CASA_GnomeKeyringItemType  CASA_gnome_keyring_item_info_get_type (CASA_GnomeKeyringItemInfo *item_info);
#define	gnome_keyring_item_info_get_type 			CASA_gnome_keyring_item_info_get_type 

void	CASA_gnome_keyring_item_info_set_type 
	(
		CASA_GnomeKeyringItemInfo *item_info,
		CASA_GnomeKeyringItemType  type
	);

#define	gnome_keyring_item_info_set_type			CASA_gnome_keyring_item_info_set_type

char	*CASA_gnome_keyring_item_info_get_secret (CASA_GnomeKeyringItemInfo *item_info);
#define	gnome_keyring_item_info_get_secret 			CASA_gnome_keyring_item_info_get_secret 

void	CASA_gnome_keyring_item_info_set_secret 
	(
		CASA_GnomeKeyringItemInfo 	*item_info,
		const char           		*value
	);

#define gnome_keyring_item_info_set_secret			CASA_gnome_keyring_item_info_set_secret

char	*CASA_gnome_keyring_item_info_get_display_name (CASA_GnomeKeyringItemInfo *item_info);
#define	gnome_keyring_item_info_get_display_name	CASA_gnome_keyring_item_info_get_display_name

void	CASA_gnome_keyring_item_info_set_display_name 
	(
		CASA_GnomeKeyringItemInfo 	*item_info,
		const char           		*value
	);

#define	gnome_keyring_item_info_set_display_name 	CASA_gnome_keyring_item_info_set_display_name 

time_t	CASA_gnome_keyring_item_info_get_mtime (CASA_GnomeKeyringItemInfo *item_info);
#define	gnome_keyring_item_info_get_mtime			CASA_gnome_keyring_item_info_get_mtime

time_t	CASA_gnome_keyring_item_info_get_ctime (CASA_GnomeKeyringItemInfo *item_info);
#define	gnome_keyring_item_info_get_ctime			CASA_gnome_keyring_item_info_get_ctime 


CASA_GnomeKeyringApplicationRef *CASA_gnome_keyring_application_ref_new (void);
#define	gnome_keyring_application_ref_new	CASA_gnome_keyring_application_ref_new 

CASA_GnomeKeyringApplicationRef *CASA_gnome_keyring_application_ref_copy (const CASA_GnomeKeyringApplicationRef *app);
#define	gnome_keyring_application_ref_copy			CASA_gnome_keyring_application_ref_copy 

void	CASA_gnome_keyring_application_ref_free (CASA_GnomeKeyringApplicationRef       *app);
#define	gnome_keyring_application_ref_free 			CASA_gnome_keyring_application_ref_free 

CASA_GnomeKeyringAccessControl *CASA_gnome_keyring_access_control_new  
	(
		const CASA_GnomeKeyringApplicationRef 	*application,
        CASA_GnomeKeyringAccessType             types_allowed
	);
#define	gnome_keyring_access_control_new			CASA_gnome_keyring_access_control_new


CASA_GnomeKeyringAccessControl *CASA_gnome_keyring_access_control_copy (GnomeKeyringAccessControl *ac);
#define	gnome_keyring_access_control_copy			CASA_gnome_keyring_access_control_copy 



void	CASA_gnome_keyring_access_control_free (CASA_GnomeKeyringAccessControl *ac);
#define	gnome_keyring_access_control_free 			CASA_gnome_keyring_access_control_free 

GList * CASA_gnome_keyring_acl_copy (GList                     *list);
#define	gnome_keyring_acl_copy 						CASA_gnome_keyring_acl_copy 

void    CASA_gnome_keyring_acl_free (GList                     *acl);
#define	gnome_keyring_acl_free 						CASA_gnome_keyring_acl_free 


char *CASA_gnome_keyring_item_ac_get_display_name (CASA_GnomeKeyringAccessControl *ac);
#define	gnome_keyring_item_ac_get_display_name		CASA_gnome_keyring_item_ac_get_display_name

void CASA_gnome_keyring_item_ac_set_display_name 
	(
		CASA_GnomeKeyringAccessControl *ac,
		const char           *value
	);
#define	gnome_keyring_item_ac_set_display_name		CASA_gnome_keyring_item_ac_set_display_name

char	*CASA_gnome_keyring_item_ac_get_path_name (CASA_GnomeKeyringAccessControl *ac);
#define	gnome_keyring_item_ac_get_path_name			CASA_gnome_keyring_item_ac_get_path_name

void	CASA_gnome_keyring_item_ac_set_path_name 
	(
		CASA_GnomeKeyringAccessControl *ac,
		const char           *value
	);

#define	gnome_keyring_item_ac_set_path_name			CASA_gnome_keyring_item_ac_set_path_name


CASA_GnomeKeyringAccessType CASA_gnome_keyring_item_ac_get_access_type (CASA_GnomeKeyringAccessControl *ac);
#define	gnome_keyring_item_ac_get_access_type		CASA_gnome_keyring_item_ac_get_access_type

void	CASA_gnome_keyring_item_ac_set_access_type 
	(
		CASA_GnomeKeyringAccessControl *ac,
		const CASA_GnomeKeyringAccessType value
	);

#define	gnome_keyring_item_ac_set_access_type	CASA_gnome_keyring_item_ac_set_access_type 

/* Specialized Helpers for network passwords items */

typedef struct 
{
	char 	*keyring;
	guint32 item_id;

	char 	*protocol;
	char 	*server;
	char 	*object;
	char 	*authtype;
	guint32 	port;

	char 	*user;
	char 	*domain;
	char 	*password;
} CASA_GnomeKeyringNetworkPasswordData;

#define	GnomeKeyringNetworkPasswordData	CASA_GnomeKeyringNetworkPasswordData

void	CASA_gnome_keyring_network_password_free (CASA_GnomeKeyringNetworkPasswordData *data);
#define	gnome_keyring_network_password_free			CASA_gnome_keyring_network_password_free

void	CASA_gnome_keyring_network_password_list_free (GList *list);
#define	gnome_keyring_network_password_list_free 	CASA_gnome_keyring_network_password_list_free 

gpointer	CASA_gnome_keyring_find_network_password
	(
		const char                            *user,
		const char                            *domain,
		const char                            *server,
		const char                            *object,
		const char                            *protocol,
		const char                            *authtype,
		guint32                                port,
		CASA_GnomeKeyringOperationGetListCallback   callback,
		gpointer                               data,
		GDestroyNotify                         destroy_data
	);

#define	gnome_keyring_find_network_password			CASA_gnome_keyring_find_network_password 


CASA_GnomeKeyringResult CASA_gnome_keyring_find_network_password_sync 
	(
		const char                            *user,
		const char                            *domain,
		const char                            *server,
		const char                            *object,
		const char                            *protocol,
		const char                            *authtype,
		guint32                                port,
		GList                                **result
	);

#define gnome_keyring_find_network_password_sync		CASA_gnome_keyring_find_network_password_sync 

gpointer	CASA_gnome_keyring_set_network_password
	(
		const char                            *keyring,
		const char                            *user,
		const char                            *domain,
		const char                            *server,
		const char                            *object,
		const char                            *protocol,
		const char                            *authtype,
		guint32                                port,
		const char                            *password,
		CASA_GnomeKeyringOperationGetIntCallback    callback,
		gpointer                               data,
		GDestroyNotify                         destroy_data
	);

#define	gnome_keyring_set_network_password			CASA_gnome_keyring_set_network_password 

CASA_GnomeKeyringResult CASA_gnome_keyring_set_network_password_sync  
	(
		const char                            *keyring,
		const char                            *user,
		const char                            *domain,
		const char                            *server,
		const char                            *object,
		const char                            *protocol,
		const char                            *authtype,
		guint32                                port,
		const char                            *password,
		guint32                               *item_id
	);

#define	gnome_keyring_set_network_password_sync		CASA_gnome_keyring_set_network_password_sync


#endif /* _CASA_GNOME_KEYRING_H */