secret_value_new ()

SecretValue *
secret_value_new (const gchar *secret,
                  gssize length,
                  const gchar *content_type);

Create a SecretValue for the secret data passed in. The secret data is copied into non-pageable 'secure' memory.

If the length is less than zero, then secret is assumed to be null-terminated.

secret_value_new_full ()

SecretValue *
secret_value_new_full (gchar *secret,
                       gssize length,
                       const gchar *content_type,
                       GDestroyNotify destroy);

Create a SecretValue for the secret data passed in. The secret data is not copied, and will later be freed with the destroy function.

If the length is less than zero, then secret is assumed to be null-terminated.

secret_value_get ()

const gchar *
secret_value_get (SecretValue *value,
                  gsize *length);

Get the secret data in the SecretValue. The value is not necessarily null-terminated unless it was created with secret_value_new() or a null-terminated string was passed to secret_value_new_full().

secret_value_get_text ()

const gchar *
secret_value_get_text (SecretValue *value);

Get the secret data in the SecretValue if it contains a textual value. The content type must be text/plain.

secret_value_get_content_type ()

const gchar *
secret_value_get_content_type (SecretValue *value);

Get the content type of the secret value, such as text/plain.

secret_value_ref ()

SecretValue *
secret_value_ref (SecretValue *value);

Add another reference to the SecretValue. For each reference secret_value_unref() should be called to unreference the value.

secret_value_unref ()

void
secret_value_unref (gpointer value);

Unreference a SecretValue. When the last reference is gone, then the value will be freed.

SecretValue

typedef struct _SecretValue SecretValue;

A secret value, like a password or other binary secret.