Schema

Represents a set of attributes that are stored with an item. These schemas are used for interoperability between various services storing the same types of items.

Each schema has a name like "org.gnome.keyring.NetworkPassword", and defines a set of attributes, and types (string, integer, boolean) for those attributes.

Attributes are stored as strings in the Secret Service, and the attribute types simply define standard ways to store integer and boolean values as strings. Attributes are represented in libsecret via a #GHashTable with string keys and values. Even for values that defined as an integer or boolean in the schema, the attribute values in the #GHashTable are strings. Boolean values are stored as the strings 'true' and 'false'. Integer values are stored in decimal, with a preceding negative sign for negative integers.

Schemas are handled entirely on the client side by this library. The name of the schema is automatically stored as an attribute on the item.

Normally when looking up passwords only those with matching schema names are returned. If the schema @flags contain the %SECRET_SCHEMA_DONT_MATCH_NAME flag, then lookups will not check that the schema name matches that on the item, only the schema's attributes are matched. This is useful when you are looking up items that are not stored by the libsecret library. Other libraries such as libgnome-keyring don't store the schema name.

class Schema {

protected

SecretSchema* secretSchema;

protected

bool ownedRef;

SecretSchema* getSchemaStruct(bool transferOwnership);

void* getStruct();

this(SecretSchema* secretSchema, bool ownedRef);

~this();

static GType getType();

this(string name, SecretSchemaFlags flags, HashTable attributeNamesAndTypes);

Schema doref();

void unref();

}

Constructors

this this(SecretSchema* secretSchema, bool ownedRef): Sets our main struct and passes it to the parent class.
this this(string name, SecretSchemaFlags flags, HashTable attributeNamesAndTypes): Using this function is not normally necessary from C code. This is useful for constructing #SecretSchema structures in bindings.

Destructor

~this ~this(): Undocumented in source.

Members

Functions

doref Schema doref(): Adds a reference to the #SecretSchema.
getSchemaStruct SecretSchema* getSchemaStruct(bool transferOwnership): Get the main Gtk struct
getStruct void* getStruct(): the main Gtk struct as a void*
unref void unref(): Releases a reference to the #SecretSchema. If the last reference is released then the schema will be freed.

Static functions

getType GType getType()

Variables

ownedRef bool ownedRef;: Undocumented in source.
secretSchema SecretSchema* secretSchema;: the main Gtk struct