![]() |
![]() |
![]() |
libblockdev Reference Manual | ![]() |
---|---|---|---|---|
Top | Description |
#include <loop.h> gboolean bd_loop_check_deps (); gboolean bd_loop_init (); void bd_loop_close (); GQuark bd_loop_error_quark (void
); #define BD_LOOP_ERROR enum BDLoopError; gchar * bd_loop_get_backing_file (const gchar *dev_name
,GError **error
); gchar * bd_loop_get_loop_name (const gchar *file
,GError **error
); gboolean bd_loop_setup (const gchar *file
,guint64 offset
,guint64 size
,gboolean read_only
,gboolean part_scan
,const gchar **loop_name
,GError **error
); gboolean bd_loop_setup_from_fd (gint fd
,guint64 offset
,guint64 size
,gboolean read_only
,gboolean part_scan
,const gchar **loop_name
,GError **error
); gboolean bd_loop_teardown (const gchar *loop
,GError **error
); gboolean bd_loop_get_autoclear (const gchar *loop
,GError **error
); gboolean bd_loop_set_autoclear (const gchar *loop
,gboolean autoclear
,GError **error
);
A plugin for operations with loop devices. All sizes passed in/out to/from the functions are in bytes.
gboolean bd_loop_check_deps ();
Returns : |
whether the plugin's runtime dependencies are satisfied or not Function checking plugin's runtime dependencies. |
gboolean bd_loop_init ();
Initializes the plugin. **This function is called automatically by the library's initialization functions.**
void bd_loop_close ();
Cleans up after the plugin. **This function is called automatically by the library's functions that unload it.**
gchar * bd_loop_get_backing_file (const gchar *dev_name
,GError **error
);
|
name of the loop device to get backing file for (e.g. "loop0") |
|
place to store error (if any). [out] |
Returns : |
path of the device's backing file or NULL if none
is found. [transfer full]
|
gchar * bd_loop_get_loop_name (const gchar *file
,GError **error
);
|
path of the backing file to get loop name for |
|
place to store error (if any). [out] |
Returns : |
name of the loop device associated with the given file . [transfer full]
|
gboolean bd_loop_setup (const gchar *file
,guint64 offset
,guint64 size
,gboolean read_only
,gboolean part_scan
,const gchar **loop_name
,GError **error
);
|
file to setup as a loop device |
|
offset of the start of the device (in file ) |
|
maximum size of the device (or 0 to leave unspecified) |
|
whether to setup as read-only (TRUE ) or read-write (FALSE ) |
|
whether to enforce partition scan on the newly created device or not |
|
if not NULL , it is used to store the name of the loop device. [allow-none][out]
|
|
place to store error (if any). [out] |
Returns : |
whether the file was successfully setup as a loop device or not |
gboolean bd_loop_setup_from_fd (gint fd
,guint64 offset
,guint64 size
,gboolean read_only
,gboolean part_scan
,const gchar **loop_name
,GError **error
);
|
file descriptor for a file to setup as a new loop device |
|
offset of the start of the device (in file given by fd ) |
|
maximum size of the device (or 0 to leave unspecified) |
|
whether to setup as read-only (TRUE ) or read-write (FALSE ) |
|
whether to enforce partition scan on the newly created device or not |
|
if not NULL , it is used to store the name of the loop device. [allow-none][out]
|
|
place to store error (if any). [out] |
Returns : |
whether an new loop device was successfully setup for fd or not |
gboolean bd_loop_teardown (const gchar *loop
,GError **error
);
|
path or name of the loop device to tear down |
|
place to store error (if any). [out] |
Returns : |
whether the loop device was successfully torn down or not |
gboolean bd_loop_get_autoclear (const gchar *loop
,GError **error
);
|
path or name of the loop device |
|
place to store error (if any). [out] |
Returns : |
whether the autoclear flag is set on the loop device or not (if FALSE , error may be set) |
gboolean bd_loop_set_autoclear (const gchar *loop
,gboolean autoclear
,GError **error
);
|
path or name of the loop device |
|
whether to set or unset the autoclear flag |
|
place to store error (if any). [out] |
Returns : |
whether the autoclear flag was successfully set on the loop device or not |