StoragedMountMonitor: Storaged Reference Manual

StoragedMountMonitor

StoragedMountMonitor — Monitors mounted filesystems or in-use swap devices

Functions

dev_t	storaged_mount_get_dev ()
StoragedMountType	storaged_mount_get_mount_type ()
const gchar *	storaged_mount_get_mount_path ()
gint	storaged_mount_compare ()
StoragedMountMonitor *	storaged_mount_monitor_new ()
GList *	storaged_mount_monitor_get_mounts_for_dev ()
gboolean	storaged_mount_monitor_is_dev_in_use ()

Signals

void	mount-added	Has Details
void	mount-removed	Has Details

Types and Values

	StoragedMount
enum	StoragedMountType
	StoragedMountMonitor

Object Hierarchy

    GObject
    ├── StoragedMount
    ╰── StoragedMountMonitor

Description

This type is used for monitoring mounted devices and swap devices in use. On Linux, this is done by inspecting and monitoring the /proc/self/mountinfo and /proc/swaps files.

Functions

storaged_mount_get_dev ()

dev_t
storaged_mount_get_dev (StoragedMount *mount);

Gets the device number for mount .

Parameters

mount

A StoragedMount.

Returns

A dev_t.

storaged_mount_get_mount_type ()

StoragedMountType
storaged_mount_get_mount_type (StoragedMount *mount);

Gets the StoragedMountType for mount .

Parameters

mount

A StoragedMount.

Returns

A value from the StoragedMountType enumeration.

storaged_mount_get_mount_path ()

const gchar *
storaged_mount_get_mount_path (StoragedMount *mount);

Gets the mount path for a STORAGED_MOUNT_TYPE_FILESYSTEM-type mount.

It is a programming error to call this on any other type of StoragedMount.

Parameters

mount

A StoragedMount

Returns

A string owned by mount . Do not free.

storaged_mount_compare ()

gint
storaged_mount_compare (StoragedMount *mount,
                        StoragedMount *other_mount);

Comparison function for comparing two StoragedMount objects.

Parameters

mount	A StoragedMount
other_mount	Another StoragedMount.

Returns

Negative value if mount < other_mount ; zero if mount = other_mount ; positive value if mount > other_mount .

storaged_mount_monitor_new ()

StoragedMountMonitor *
storaged_mount_monitor_new (void);

Creates a new StoragedMountMonitor object.

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

Returns

A StoragedMountMonitor. Free with g_object_unref().

storaged_mount_monitor_get_mounts_for_dev ()

GList *
storaged_mount_monitor_get_mounts_for_dev
                               (StoragedMountMonitor *monitor,
                                dev_t dev);

Gets all StoragedMount objects for dev .

Parameters

monitor	A StoragedMountMonitor.
dev	A dev_t device number.

Returns

A GList of StoragedMount objects. The returned list must be freed with g_list_free() after each element has been freed with g_object_unref().

storaged_mount_monitor_is_dev_in_use ()

gboolean
storaged_mount_monitor_is_dev_in_use (StoragedMountMonitor *monitor,
                                      dev_t dev,
                                      StoragedMountType *out_type);

Checks if dev is in use (e.g. mounted or swap-area in-use).

Parameters

monitor	A StoragedMountMonitor.
dev	A dev_t device number.
out_type	Return location for mount type, if in use or `NULL`.	[out allow-none]

Returns

TRUE if in use, FALSE otherwise.

Types and Values

StoragedMount

typedef struct _StoragedMount StoragedMount;

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

enum StoragedMountType

Types of a mount.

Members

STORAGED_MOUNT_TYPE_FILESYSTEM	Object correspond to a mounted filesystem.
STORAGED_MOUNT_TYPE_SWAP	Object correspond to an in-use swap device.