## Keyring Info

Keyring Info — Keyring Information

## Synopsis

    typedef             MateKeyringInfo;
    void                mate_keyring_info_free             (MateKeyringInfo *keyring_info);
    MateKeyringInfo *  mate_keyring_info_copy             (MateKeyringInfo *keyring_info);
    void                mate_keyring_info_set_lock_on_idle (MateKeyringInfo *keyring_info,
                                                             gboolean value);
    gboolean            mate_keyring_info_get_lock_on_idle (MateKeyringInfo *keyring_info);
    void                mate_keyring_info_set_lock_timeout (MateKeyringInfo *keyring_info,
                                                             guint32 value);
    guint32             mate_keyring_info_get_lock_timeout (MateKeyringInfo *keyring_info);
    time_t              mate_keyring_info_get_mtime        (MateKeyringInfo *keyring_info);
    time_t              mate_keyring_info_get_ctime        (MateKeyringInfo *keyring_info);
    gboolean            mate_keyring_info_get_is_locked    (MateKeyringInfo *keyring_info);

## Description

Use `mate_keyring_get_info()` or `mate_keyring_get_info_sync()` to get a MateKeyringInfo pointer to use with these functions.

## Details

### MateKeyringInfo

    typedef struct MateKeyringInfo MateKeyringInfo;

### mate_keyring_info_free ()

    void                mate_keyring_info_free             (MateKeyringInfo *keyring_info);

Free a MateKeyringInfo object. If a `NULL` pointer is passed nothing occurs.

`keyring_info` : | The keyring info to free.

### mate_keyring_info_copy ()

    MateKeyringInfo *  mate_keyring_info_copy             (MateKeyringInfo *keyring_info);

Copy a MateKeyringInfo object.

`keyring_info` : | The keyring info to copy.
Returns : | The newly allocated MateKeyringInfo. This must be freed with `mate_keyring_info_free()`

### mate_keyring_info_set_lock_on_idle ()

    void                mate_keyring_info_set_lock_on_idle (MateKeyringInfo *keyring_info,
                                                             gboolean value);

Set whether or not to lock a keyring after a certain amount of idle time.

See also `mate_keyring_info_set_lock_timeout()`.

`keyring_info` : | The keyring info.
`value` : | Whether to lock or not.

### mate_keyring_info_get_lock_on_idle ()

    gboolean            mate_keyring_info_get_lock_on_idle (MateKeyringInfo *keyring_info);

Get whether or not to lock a keyring after a certain amount of idle time.

See also `mate_keyring_info_get_lock_timeout()`.

`keyring_info` : | The keyring info.
Returns : | Whether to lock or not.

### mate_keyring_info_set_lock_timeout ()

    void                mate_keyring_info_set_lock_timeout (MateKeyringInfo *keyring_info,
                                                             guint32 value);

Set the idle timeout, in seconds, after which to lock the keyring.

See also `mate_keyring_info_set_lock_on_idle()`.

`keyring_info` : | The keyring info.
`value` : | The lock timeout in seconds.

### mate_keyring_info_get_lock_timeout ()

    guint32             mate_keyring_info_get_lock_timeout (MateKeyringInfo *keyring_info);

Get the idle timeout, in seconds, after which to lock the keyring.

See also `mate_keyring_info_get_lock_on_idle()`.

`keyring_info` : | The keyring info.
Returns : | The idle timeout, in seconds.

### mate_keyring_info_get_mtime ()

    time_t              mate_keyring_info_get_mtime        (MateKeyringInfo *keyring_info);

Get the time at which the keyring was last modified.

`keyring_info` : | The keyring info.
Returns : | The last modified time.

### mate_keyring_info_get_ctime ()

    time_t              mate_keyring_info_get_ctime        (MateKeyringInfo *keyring_info);

Get the time at which the keyring was created.

`keyring_info` : | The keyring info.
Returns : | The created time.

### mate_keyring_info_get_is_locked ()

    gboolean            mate_keyring_info_get_is_locked    (MateKeyringInfo *keyring_info);

Get whether the keyring is locked or not.

`keyring_info` : | The keyring info.
Returns : | Whether the keyring is locked or not.