Loop: libblockdev Reference Manual

Loop

Loop — plugin for operations with loop devices

#define	BD_LOOP_ERROR
enum	BDLoopError

#include <loop.h>

A plugin for operations with loop devices. All sizes passed in/out to/from the functions are in bytes.

GQuark
bd_loop_error_quark (void);

gchar *
bd_loop_get_backing_file (gchar *dev_name,
                          GError **error);

dev_name	name of the loop device to get backing file for (e.g. "loop0")
error	place to store error (if any).	[out]

path of the device's backing file or NULL if none is found.

[transfer full]

gchar *
bd_loop_get_loop_name (gchar *file,
                       GError **error);

file	path of the backing file to get loop name for
error	place to store error (if any).	[out]

name of the loop device associated with the given file or NULL if failed to determine.

[transfer full]

gboolean
bd_loop_setup (gchar *file,
               gchar **loop_name,
               GError **error);

file	file to setup as a loop device
loop_name	if not `NULL`, it is used to store the name of the loop device.	[out]
error	place to store error (if any).	[out]

whether the file was successfully setup as a loop device or not

gboolean
bd_loop_teardown (gchar *loop,
                  GError **error);

loop	path or name of the loop device to tear down
error	place to store error (if any).	[out]

whether the loop device was successfully torn down or not

#define BD_LOOP_ERROR bd_loop_error_quark ()

BD_LOOP_ERROR_DEVICE