UDisksCrypttabMonitor

## UDisksCrypttabMonitor UDisksCrypttabMonitor — Monitors entries in the crypttab file |

## Synopsis

                        UDisksCrypttabEntry;
    const gchar *       udisks_crypttab_entry_get_name      (UDisksCrypttabEntry *entry);
    const gchar *       udisks_crypttab_entry_get_device    (UDisksCrypttabEntry *entry);
    const gchar *       udisks_crypttab_entry_get_passphrase_path
                                                            (UDisksCrypttabEntry *entry);
    const gchar *       udisks_crypttab_entry_get_options   (UDisksCrypttabEntry *entry);
    gint                udisks_crypttab_entry_compare       (UDisksCrypttabEntry *entry,
                                                             UDisksCrypttabEntry *other_entry);
                        UDisksCrypttabMonitor;
    UDisksCrypttabMonitor * udisks_crypttab_monitor_new     (void);
    GList *             udisks_crypttab_monitor_get_entries (UDisksCrypttabMonitor *monitor);

## Object Hierarchy

      GObject
       +----UDisksCrypttabEntry

      GObject
       +----UDisksCrypttabMonitor

## Signals

      "entry-added"                                    : Has Details
      "entry-removed"                                  : Has Details

## Description

This type is used for monitoring entries in the `/etc/crypttab` file.

## Details

### UDisksCrypttabEntry

    typedef struct _UDisksCrypttabEntry UDisksCrypttabEntry;

The UDisksCrypttabEntry structure contains only private data and should only be accessed using the provided API.

### udisks_crypttab_entry_get_name ()

    const gchar *       udisks_crypttab_entry_get_name      (UDisksCrypttabEntry *entry);

Gets the name field of `entry`.

`entry` : | A UDisksCrypttabEntry.
Returns : | The name field.

### udisks_crypttab_entry_get_device ()

    const gchar *       udisks_crypttab_entry_get_device    (UDisksCrypttabEntry *entry);

Gets the device field of `entry`.

`entry` : | A UDisksCrypttabEntry.
Returns : | The device field.

### udisks_crypttab_entry_get_passphrase_path ()

    const gchar *       udisks_crypttab_entry_get_passphrase_path
                                                            (UDisksCrypttabEntry *entry);

Gets the passphrase path field of `entry`.

`entry` : | A UDisksCrypttabEntry.
Returns : | The passphrase path field.

### udisks_crypttab_entry_get_options ()

    const gchar *       udisks_crypttab_entry_get_options   (UDisksCrypttabEntry *entry);

Gets the options field of `entry`.

`entry` : | A UDisksCrypttabEntry.
Returns : | The options field.

### udisks_crypttab_entry_compare ()

    gint                udisks_crypttab_entry_compare       (UDisksCrypttabEntry *entry,
                                                             UDisksCrypttabEntry *other_entry);

Comparison function for comparing two UDisksCrypttabEntry objects.

`entry` : | A UDisksCrypttabEntry
`other_entry` : | Another UDisksCrypttabEntry.
Returns : | Negative value if `entry` < `other_entry`; zero if `entry` = `other_entry`; positive value if `entry` > `other_entry`.

### UDisksCrypttabMonitor

    typedef struct _UDisksCrypttabMonitor UDisksCrypttabMonitor;

The UDisksCrypttabMonitor structure contains only private data and should only be accessed using the provided API.

### udisks_crypttab_monitor_new ()

    UDisksCrypttabMonitor * udisks_crypttab_monitor_new     (void);

Creates a new UDisksCrypttabMonitor object.

Signals are emitted in the thread-default main loop that this function is called from.

Returns : | A UDisksCrypttabMonitor. Free with `g_object_unref()`.

### udisks_crypttab_monitor_get_entries ()

    GList *             udisks_crypttab_monitor_get_entries (UDisksCrypttabMonitor *monitor);

Gets all /etc/crypttab entries

`monitor` : | A UDisksCrypttabMonitor.
Returns : | A list of UDisksCrypttabEntry objects that must be freed with `g_list_free()` after each element has been freed with `g_object_unref()`. [transfer full][element-type UDisksCrypttabEntry]

## Signal Details

### The `"entry-added"` signal

    void                user_function                      (UDisksCrypttabMonitor *monitor,
                                                            UDisksCrypttabEntry   *entry,
                                                            gpointer               user_data)      : Has Details

Emitted when a crypttab entry is added.

This signal is emitted in the thread-default main loop that `monitor` was created in.

`monitor` : | A UDisksCrypttabMonitor.
`entry` : | The UDisksCrypttabEntry that was added.
`user_data` : | user data set when the signal handler was connected.

### The `"entry-removed"` signal

    void                user_function                      (UDisksCrypttabMonitor *monitor,
                                                            UDisksCrypttabEntry   *entry,
                                                            gpointer               user_data)      : Has Details

Emitted when a crypttab entry is removed.

This signal is emitted in the thread-default main loop that `monitor` was created in.

`monitor` : | A UDisksCrypttabMonitor.
`entry` : | The UDisksCrypttabEntry that was removed.
`user_data` : | user data set when the signal handler was connected.