Item Information

Item Information — Keyring Item Info

Synopsis

enum                GnomeKeyringItemType;
typedef             GnomeKeyringItemInfo;
void                gnome_keyring_item_info_free        (GnomeKeyringItemInfo *item_info);
GnomeKeyringItemInfo * gnome_keyring_item_info_new      (void);
GnomeKeyringItemInfo * gnome_keyring_item_info_copy     (GnomeKeyringItemInfo *item_info);
GnomeKeyringItemType gnome_keyring_item_info_get_type   (GnomeKeyringItemInfo *item_info);
void                gnome_keyring_item_info_set_type    (GnomeKeyringItemInfo *item_info,
                                                         GnomeKeyringItemType type);
char *              gnome_keyring_item_info_get_secret  (GnomeKeyringItemInfo *item_info);
void                gnome_keyring_item_info_set_secret  (GnomeKeyringItemInfo *item_info,
                                                         const char *value);
char *              gnome_keyring_item_info_get_display_name
                                                        (GnomeKeyringItemInfo *item_info);
void                gnome_keyring_item_info_set_display_name
                                                        (GnomeKeyringItemInfo *item_info,
                                                         const char *value);
time_t              gnome_keyring_item_info_get_mtime   (GnomeKeyringItemInfo *item_info);
time_t              gnome_keyring_item_info_get_ctime   (GnomeKeyringItemInfo *item_info);

Description

Warning

All of these APIs are deprecated. Use libsecret instead.

GnomeKeyringItemInfo represents the basic information about a keyring item. Use gnome_keyring_item_get_info() or gnome_keyring_item_set_info().

Details

enum GnomeKeyringItemType

typedef enum {
	/* The item types */
	GNOME_KEYRING_ITEM_GENERIC_SECRET = 0,
	GNOME_KEYRING_ITEM_NETWORK_PASSWORD,
	GNOME_KEYRING_ITEM_NOTE,
	GNOME_KEYRING_ITEM_CHAINED_KEYRING_PASSWORD,
	GNOME_KEYRING_ITEM_ENCRYPTION_KEY_PASSWORD,

	GNOME_KEYRING_ITEM_PK_STORAGE = 0x100,

	/* Not used, remains here only for compatibility */
	GNOME_KEYRING_ITEM_LAST_TYPE,
} GnomeKeyringItemType;

Warning

GnomeKeyringItemType is deprecated and should not be used in newly-written code. Use SecretSchema instead.

The types of items.

GNOME_KEYRING_ITEM_GENERIC_SECRET

Generic secret

GNOME_KEYRING_ITEM_NETWORK_PASSWORD

Network password

GNOME_KEYRING_ITEM_NOTE

Note

GNOME_KEYRING_ITEM_CHAINED_KEYRING_PASSWORD

Keyring password

GNOME_KEYRING_ITEM_ENCRYPTION_KEY_PASSWORD

Password for encryption key

GNOME_KEYRING_ITEM_PK_STORAGE

Key storage password

GNOME_KEYRING_ITEM_LAST_TYPE

Not used

GnomeKeyringItemInfo

typedef struct GnomeKeyringItemInfo GnomeKeyringItemInfo;

Warning

GnomeKeyringItemInfo is deprecated and should not be used in newly-written code.


gnome_keyring_item_info_free ()

void                gnome_keyring_item_info_free        (GnomeKeyringItemInfo *item_info);

Warning

gnome_keyring_item_info_free is deprecated and should not be used in newly-written code. Use SecretItem objects instead.

Free the GnomeKeyringItemInfo object.

A NULL pointer may be passed, in which case it will be ignored.

item_info :

The keyring item info pointer.

gnome_keyring_item_info_new ()

GnomeKeyringItemInfo * gnome_keyring_item_info_new      (void);

Warning

gnome_keyring_item_info_new is deprecated and should not be used in newly-written code. Use SecretItem objects instead.

Create a new GnomeKeyringItemInfo object. Free the GnomeKeyringItemInfo object.

Returns :

A keyring item info pointer.

gnome_keyring_item_info_copy ()

GnomeKeyringItemInfo * gnome_keyring_item_info_copy     (GnomeKeyringItemInfo *item_info);

Warning

gnome_keyring_item_info_copy is deprecated and should not be used in newly-written code. Use SecretItem objects instead.

Copy a GnomeKeyringItemInfo object.

item_info :

A keyring item info pointer.

Returns :

A keyring item info pointer.

gnome_keyring_item_info_get_type ()

GnomeKeyringItemType gnome_keyring_item_info_get_type   (GnomeKeyringItemInfo *item_info);

Warning

gnome_keyring_item_info_get_type is deprecated and should not be used in newly-written code. Use secret_item_get_schema_name() instead.

Get the item type.

item_info :

A keyring item info pointer.

Returns :

The item type

gnome_keyring_item_info_set_type ()

void                gnome_keyring_item_info_set_type    (GnomeKeyringItemInfo *item_info,
                                                         GnomeKeyringItemType type);

Warning

gnome_keyring_item_info_set_type is deprecated and should not be used in newly-written code. Use secret_item_set_attributes() instead.

Set the type on an item info.

item_info :

A keyring item info pointer.

type :

The new item type

gnome_keyring_item_info_get_secret ()

char *              gnome_keyring_item_info_get_secret  (GnomeKeyringItemInfo *item_info);

Warning

gnome_keyring_item_info_get_secret is deprecated and should not be used in newly-written code. Use secret_item_get_secret() instead.

Get the item secret.

item_info :

A keyring item info pointer.

Returns :

The newly allocated string containing the item secret.

gnome_keyring_item_info_set_secret ()

void                gnome_keyring_item_info_set_secret  (GnomeKeyringItemInfo *item_info,
                                                         const char *value);

Warning

gnome_keyring_item_info_set_secret is deprecated and should not be used in newly-written code. Use secret_item_set_secret() instead.

Set the secret on an item info.

item_info :

A keyring item info pointer.

value :

The new item secret

gnome_keyring_item_info_get_display_name ()

char *              gnome_keyring_item_info_get_display_name
                                                        (GnomeKeyringItemInfo *item_info);

Warning

gnome_keyring_item_info_get_display_name is deprecated and should not be used in newly-written code. Use secret_item_get_label() instead.

Get the item display name.

item_info :

A keyring item info pointer.

Returns :

The newly allocated string containing the item display name.

gnome_keyring_item_info_set_display_name ()

void                gnome_keyring_item_info_set_display_name
                                                        (GnomeKeyringItemInfo *item_info,
                                                         const char *value);

Warning

gnome_keyring_item_info_set_display_name is deprecated and should not be used in newly-written code. Use secret_item_set_label() instead.

Set the display name on an item info.

item_info :

A keyring item info pointer.

value :

The new display name.

gnome_keyring_item_info_get_mtime ()

time_t              gnome_keyring_item_info_get_mtime   (GnomeKeyringItemInfo *item_info);

Warning

gnome_keyring_item_info_get_mtime is deprecated and should not be used in newly-written code. Use secret_item_get_modified() instead.

Get the item last modified time.

item_info :

A keyring item info pointer.

Returns :

The item last modified time.

gnome_keyring_item_info_get_ctime ()

time_t              gnome_keyring_item_info_get_ctime   (GnomeKeyringItemInfo *item_info);

Warning

gnome_keyring_item_info_get_ctime is deprecated and should not be used in newly-written code. Use secret_item_get_created() instead.

Get the item created time.

item_info :

A keyring item info pointer.

Returns :

The item created time.


Home ⌂Doc Index ◂Up ▴