Struct devicemapper::ThinPoolDev

pub struct ThinPoolDev { /* fields omitted */ }

DM construct to contain thin provisioned devices

Methods

impl ThinPoolDev

Use DM to create a "thin-pool". A "thin-pool" is shared space for other thin provisioned devices to use.

See section "Setting up a fresh pool device": https://www.kernel.org/doc/Documentation/device-mapper/thin-provisioning.txt

fn new(
    dm: &DM,
    name: &DmName,
    uuid: Option<&DmUuid>,
    data_block_size: Sectors,
    low_water_mark: DataBlocks,
    meta: LinearDev,
    data: LinearDev
) -> DmResult<ThinPoolDev>

Construct a new ThinPoolDev with the given data and meta devs. Returns an error if the device is already known to the kernel. Precondition: the metadata device does not contain any pool metadata.

fn meta_dev(&self) -> &LinearDev

Obtain the meta device that backs this thin pool device.

fn data_dev(&self) -> &LinearDev

Obtain the data device that backs this thin pool device.

fn data_block_size(&self) -> Sectors

Obtain the data block size for this thin pool device.

fn setup(
    dm: &DM,
    name: &DmName,
    uuid: Option<&DmUuid>,
    data_block_size: Sectors,
    low_water_mark: DataBlocks,
    meta: LinearDev,
    data: LinearDev
) -> DmResult<ThinPoolDev>

Set up a thin pool from the given metadata and data device. Precondition: There is existing metadata for this thinpool device on the metadata device. If the metadata is corrupted, subsequent errors will result, so it is expected that the metadata is well-formed and consistent with the data on the data device.

fn message(&self, dm: &DM, message: &str) -> DmResult<()>

send a message to DM thin pool

fn status(&self, dm: &DM) -> DmResult<ThinPoolStatus>

Get the current status of the thinpool. Returns an error if there was an error getting the status value. Panics if there is an error parsing the status value.

fn set_meta_segments(&mut self, dm: &DM, segments: &[Segment]) -> DmResult<()>

Set the segments for the existing metadata device. Warning: It is the client's responsibility to make sure the designated segments are compatible with the device's existing segments. If they are not, this function will still succeed, but some kind of data corruption will be the inevitable result.

fn set_data_segments(&mut self, dm: &DM, segments: &[Segment]) -> DmResult<()>

Set the data device's existing segments. Warning: It is the client's responsibility to make sure the designated segments are compatible with the device's existing segments. If they are not, this function will still succeed, but some kind of data corruption will be the inevitable result.

Trait Implementations

impl Debug for ThinPoolDev

fn fmt(&self, __arg_0: &mut Formatter) -> Result

Formats the value using the given formatter.

impl DmDevice for ThinPoolDev

fn device(&self) -> Device

The device.

fn devnode(&self) -> PathBuf

The device's device node.

fn name(&self) -> &DmName

The device's name.

fn size(&self) -> Sectors

The number of sectors available for user data.

fn teardown(self, dm: &DM) -> DmResult<()>

Erase the kernel's memory of this device.