snapm package

Module contents

Snapm top-level package.

class snapm.Selection(name=None, uuid=None, basename=None, index=None, timestamp=None, nr_snapshots=None, mount_points=None, origin=None, mount_point=None, snapshot_name=None, snapshot_uuid=None)[source]

Bases: object

Selection criteria for snapshot sets and snapshots.

__init__(name=None, uuid=None, basename=None, index=None, timestamp=None, nr_snapshots=None, mount_points=None, origin=None, mount_point=None, snapshot_name=None, snapshot_uuid=None)[source]

Initialize self. See help(type(self)) for accurate signature.

__repr__()[source]

Format this Selection object as a machine readable string.

The returned string may be passed to the Selection initialiser to duplicate the original Selection.

Returns

A machine readable string representation of this Selection object

Return type

string

__str__()[source]

Format this Selection object as a human readable string.

Returns

A human readable string representation of this Selection object

Return type

string

all_attrs = ['name', 'uuid', 'basename', 'index', 'timestamp', 'nr_snapshots', 'mount_points', 'origin', 'mount_point', 'snapshot_name', 'snapshot_uuid']
basename = None
check_valid_selection(snapshot_set=False, snapshot=False)[source]

Check a Selection for valid criteria.

Check this Selection object to ensure it contains only criteria that are valid for the specified object type(s).

Returns None if the object passes the check, or raise ValueError if invalid criteria exist.

Parameters
  • snapshot_setSelection may include SnapshotSet data

  • snapshotSelection may include Snapshot data

Returns

None on success

Return type

NoneType

Raises

ValueError if excluded criteria are present

classmethod from_cmd_args(cmd_args)[source]

Initialise Selection from command line arguments.

Construct a new Selection object from the command line arguments in cmd_args. Each set selection attribute from cmd_args is copied into the Selection. The resulting object may be passed to either the SnapshotSet or Snapshot search functions. (find_snapshot_sets, find_snapshots, as well as the snapm.command calls that accept a selection argument.

Parameters

cmd_args – The command line selection arguments.

Returns

A new Selection instance

Return type

Selection

index = None
is_null()[source]

Test this Selection object for null selection criteria.

Return True if this Selection object matches all objects, or False otherwise.

Returns

True if this Selection is null

Return type

bool

is_single()[source]

Test this Selection object for single item selction criteria.

Returns True if this Selection object matches a single object or False otherwise.

A Selection object matches a single object if either the name or uuid fields is specified.

Returns

True if this selection is single or False otherwise.

Return type

bool

mount_point = None
mount_points = None
name = None
nr_snapshots = None
origin = None
snapshot_attrs = ['origin', 'mount_point', 'snapshot_name', 'snapshot_uuid']
snapshot_name = None
snapshot_set_attrs = ['name', 'uuid', 'basename', 'index', 'timestamp', 'nr_snapshots', 'mount_points']
snapshot_uuid = None
timestamp = None
uuid = None
class snapm.SizePolicy(source, mount, free_space, fs_used, dev_size, policy)[source]

Bases: object

Class representing a configured instance of a size policy.

__init__(source, mount, free_space, fs_used, dev_size, policy)[source]

Initialise a new SizePolicy object using the supplied parameters.

Parameters
  • source – The source for this SizePolicy: a mount point or block device path.

  • mount – The mount point path if mounted.

  • free_space – The free space available to provision the snapshot in bytes.

  • fs_used – The current file system occupancy in bytes.

  • dev_size – The origin device size in bytes.

  • policy – A size policy string.

Returns

A SizePolicy object configured for the specified size.

property size

Return the backing store size for a snapshot based on the policy configuration.

class snapm.SizePolicyType(value)[source]

Bases: enum.Enum

Enum class representing the possible snapshot size policies.

FIXED = 'FIXED'
PERCENT_FREE = 'FREE'
PERCENT_SIZE = 'SIZE'
PERCENT_USED = 'USED'
class snapm.SnapStatus(value)[source]

Bases: enum.Enum

Enum class representing snapshot status: Active, Inactive, Invalid or Reverting.

ACTIVE = 1
INACTIVE = 2
INVALID = 3
REVERTING = 4
exception snapm.SnapmArgumentError[source]

Bases: snapm._snapm.SnapmError

An invalid argument was passed to a snapshot manager API call.

exception snapm.SnapmBusyError[source]

Bases: snapm._snapm.SnapmError

A resouce needed by the current command is already in use: for e.g. a snapshot merge is in progress for a previous snapshot set.

exception snapm.SnapmCalloutError[source]

Bases: snapm._snapm.SnapmError

An error calling out to an external program.

exception snapm.SnapmError[source]

Bases: Exception

Base class for snapshot manager errors.

exception snapm.SnapmExistsError[source]

Bases: snapm._snapm.SnapmError

The named snapshot set already exists.

exception snapm.SnapmInvalidIdentifierError[source]

Bases: snapm._snapm.SnapmError

An invalid identifier was given.

exception snapm.SnapmLimitError[source]

Bases: snapm._snapm.SnapmError

A configured resource limit would be exceeded.

class snapm.SnapmLogger(name, level=0)[source]

Bases: logging.Logger

Snapm logging wrapper class: wrap the Logger.debug() method to allow filtering of submodule debug messages by log mask.

debug_masked(msg, *args, **kwargs)[source]

Log a debug message if it passes the current debug mask.

Log the specified message if it passes the current logger debug mask.

Parameters

msg – the message to be logged

Return type

None

mask_bits = 0
set_debug_mask(mask_bits)[source]

Set the debug mask for this SnapmLogger.

This should normally be set to the SNAPM_DEBUG_* value corresponding to the snapm sub-module that this instance of SnapmLogger belongs to.

Parameters

mask_bits – The bits to set in this logger’s mask.

Return type

None

exception snapm.SnapmNoProviderError[source]

Bases: snapm._snapm.SnapmError

No snapshot provider plugin was found.

exception snapm.SnapmNoSpaceError[source]

Bases: snapm._snapm.SnapmError

Insufficient space is available for the requested operation.

exception snapm.SnapmNotFoundError[source]

Bases: snapm._snapm.SnapmError

The requested object does not exist.

exception snapm.SnapmParseError[source]

Bases: snapm._snapm.SnapmError

An error parsing user input.

exception snapm.SnapmPathError[source]

Bases: snapm._snapm.SnapmError

An invalid path was supplied, for example attempting to snapshot something that is not a mount point or block device.

exception snapm.SnapmPluginError[source]

Bases: snapm._snapm.SnapmError

An error performing an action via a plugin.

exception snapm.SnapmRecursionError[source]

Bases: snapm._snapm.SnapmError

A snapshot set source corresponds to a snapshot of another snapshot set.

exception snapm.SnapmSizePolicyError[source]

Bases: snapm._snapm.SnapmError

An invalid size policy was specified.

exception snapm.SnapmStateError[source]

Bases: snapm._snapm.SnapmError

The status of an object does not allow an operation to proceed.

exception snapm.SnapmTimerError[source]

Bases: snapm._snapm.SnapmError

An error manipulating systemd timers.

class snapm.Snapshot(name, snapset_name, origin, timestamp, mount_point, provider)[source]

Bases: object

Base class for individual snapshots. Each snapshot plugin should subclass Snapshot to provide a specific implementation.

__init__(name, snapset_name, origin, timestamp, mount_point, provider)[source]

Initialise a new Snapshot object.

Parameters
  • name – The name of the snapshot.

  • snapset_name – The name of the SnapshotSet this snapshot is a part of.

  • origin – The origin volume of the snapshot.

  • timestamp – The creation timestamp of the snapshot set.

  • mount_point – The mount point path this snapshot refers to.

  • provider – The plugin providing this snapshot.

__str__()[source]

Return a string representation of this Snapshot object.

Returns

A multi-line string describing this snapshot.

activate()[source]

Activate this snapshot.

as_dict()[source]

Return a representation of this snapshot as a dictionary.

property autoactivate

The autoactivation status of this snapshot. Returns True if the snapshot is automatically activated or False otherwise.

check_resize(size_policy)[source]

Check whether this snapshot can be resized or not by calling the provider plugin with the updated size_policy.

check_revert()[source]

Check whether this snapshot can be reverted or not by calling the provider plugin to verify the state of the snapshot.

deactivate()[source]

Deactivate this snapshot.

delete()[source]

Delete this snapshot.

property devpath

The device path for this snapshot.

property free

The space available to this snapshot in bytes. For snapshots with fixed-size backstores this reflects the space remaining in the current backstore. For snapshots that dynamically allocate space to the snapshot it indicates the pooled space available.

property index

The index of this snapshot, if set, or the special value snapm.SNAPSHOT_INDEX_NONE otherwise.

invalidate_cache()[source]

Invalidate any cached data describing this snapshot.

json(pretty=False)[source]

Return a string representation of this Snapshot in JSON notation.

property mount_point

The mount point of this snapshot.

property mounted

Test whether either the snapshot or origin volume for this Snapshot is currently mounted and in use.

Returns

True if this snapshot or its origin is currently mounted or False otherwise.

property name

The name of this snapshot.

property origin

The origin of this snapshot.

property origin_mounted

Test whether the origin volume for this Snapshot is currently mounted and in use.

Returns

True if this snaphot’s prigin is currently mounted or False otherwise.

property origin_options

File system options needed to specify the origin of this snapshot.

rename(new_name)[source]

Rename a snapshot within a snapshot set.

Parameters

new_name – The new name for the snapshot.

resize(size_policy)[source]

Attempt to resize this snapshot according to the updated size_policy.

revert()[source]

Request to revert a snapshot and revert the content of the origin volume to its state at the time of the snapshot.

This may be deferred until the next device activation or mount operation for the respective volume.

property size

The size of this snapshot in bytes. For snapshots with fixed-size backstores this reflects the size of the backstore. For snapshots that dynamically allocate space to the snapshot it reflects the device or volume size.

property snapset_basename

The basename of the snapshot set this snapshot belongs to, minus any index.

property snapset_name

The name of the snapshot set this snapshot belongs to.

property snapshot_mounted

Test whether the snapshot volume for this Snapshot is currently mounted and in use.

Returns

True if this snaphot is currently mounted or False otherwise.

property snapshot_set

The SnapshotSet this snapshot belongs to.

property source

The block device or mount point from which this Snapshot was created.

property status

The status of this snapshot. Returns a SnapStatus enum value representing the current state of the snapshot.

property time

The human readable timestamp of this snapshot.

property timestamp

The numerical timestamp of this snapshot.

property uuid

The UUID of this snapshot.

class snapm.SnapshotSet(name, timestamp, snapshots)[source]

Bases: object

Representation of a set of snapshots taken at the same point in time and managed as a group.

__init__(name, timestamp, snapshots)[source]

Initialise a new SnapshotSet object.

Parameters
  • name – The name of this SnapshotSet.

  • timestamp – The creation timestamp of this SnapshotSet.

  • snapshots – A list of Snapshot objects to be included in this set.

__str__()[source]

Return a string representation of this SnapshotSet.

Returns

A multi-line string describing this snapshot set.

activate()[source]

Attempt to activate all members of this SnapshotSet.

Raises

SnapmPluginError if a plugin fails to perform the requested operation.

as_dict(members=False)[source]

Return a representation of this snapshot as a dictionary.

property autoactivate

The overall autoactivation status of this snapshot set. Returns True if all snapshots within the set have autoactivate enabled or False otherwise.

property basename

The basename of this snapshot set, minus any index.

deactivate()[source]

Attempt to deactivate all members of this SnapshotSet.

Raises

SnapmPluginError if a plugin fails to perform the requested operation.

delete()[source]

Delete the on-disk representation of this SnapshotSet.

Raises

SnapmBusyError if the snapshot set is in use. SnapmPluginError if an error occurs deleting snapshot set members.

property devices

The list of block devices in this snapshot set.

property index

The index of this snapshot set, if set, or the special value snapm.SNAPSET_INDEX_NONE otherwise.

json(members=False, pretty=False)[source]

Return a string representation of this SnapshotSet in JSON notation.

property mount_points

The list of mount points in this snapshot set.

property mounted

Test whether the either the origin or snapshot volumes for this SnapshotSet are currently mounted and in use.

Returns

True if any of the snaphots belonging to this SnapshotSet are currently mounted, or False otherwise.

property name

The name of this snapshot set.

property nr_snapshots

The number of snapshots in this snapshot set.

property origin_mounted

Test whether the origin volumes for this SnapshotSet are currently mounted and in use.

Returns

True if any of the snaphots belonging to this SnapshotSet are currently mounted, or False otherwise.

rename(new_name)[source]

Rename this SnapshotSet to new_name.

Raises

SnapmError if a call to rename any member of the snapshot set fails.

resize(sources, size_policies)[source]

Attempt to resize the SnapshotSet according to the list of sources and corresponding size_policy strings.

Raises

SnapmNoSpaceError if there is insufficient space available for the requested operation.

revert()[source]

Initiate a revert operation on this SnapshotSet.

Raises

SnapmPluginError if a plugin fails to perform the requested operation.

snapshot_by_mount_point(mount_point)[source]

Return the snapshot corresponding to mount_point.

Parameters

mount_point – The mount point path to search for.

Returns

A Snapshot object for the given mount point.

Raises

SnapmNotFoundError if the specified mount point is not present in this SnapshotSet.

snapshot_by_source(source)[source]

Return the snapshot corresponding to source.

Parameters

source – The block device or mount point path to search for.

Returns

A Snapshot object for the given source path.

Raises

SnapmNotFoundError if the specified source path is not present in this SnapshotSet.

property snapshot_mounted

Test whether the snapshot volumes for this SnapshotSet are currently mounted and in use.

Returns

True if any of the snaphots belonging to this SnapshotSet are currently mounted, or False otherwise.

property snapshots

The list of snapshots in this snapshot set.

property sources

The list of souce mount points and block devices in this snapshot set.

property status

The overall status of this snapshot set. Returns SnapStatus.ACTIVE if all members of the set are valid and active, SnapStatus.INACTIVE if any members are inactive, or SnapStatus.INVALID if any member of the set is invalid.

property time

The human readable timestamp of this snapshot set.

property timestamp

The numerical timestamp of this snapshot set.

property uuid

The UUID of this snapshot set.

snapm.bool_to_yes_no(value)[source]

Convert boolean-like to yes/no string.

Return the string “yes” if value evaluates to True, or “no” otherwise.

Parameters

value – A boolean value to interpet.

Returns

A string value that is “yes” if value is True, or “no” otherwise.

snapm.get_debug_mask()[source]

Return the current debug mask for the snapm package.

Returns

The current debug mask value

Return type

int

snapm.is_size_policy(policy)[source]

Test whether a string is a valid size policy

Parameters

policy – A possible policy string to test.

Returns

True if policy is a valid size policy string or False otherwise.

snapm.parse_size_with_units(value)[source]

Parse a size string with optional unit suffix and return a value in bytes,

Parameters

size – The size string to parse.

Returns

an integer size in bytes.

Raises

ValueError if the string could not be parsed as a valid size vale.

snapm.set_debug_mask(mask)[source]

Set the debug mask for the snapm package.

Parameters

mask – the logical OR of the SNAPM_DEBUG_* values to log.

Return type

None

snapm.size_fmt(value)[source]

Format a size in bytes as a human readable string.

Parameters

value – The integer value to format.

Returns

A human readable string reflecting value.

Submodules

snapm.manager module

Top level interface to the snapshot manager.

class snapm.manager.Manager[source]

Bases: object

Snapshot Manager high level interface.

__init__()[source]

Initialize self. See help(type(self)) for accurate signature.

_check_recursion(origins)[source]

Verify that each entry in origins corresponds to a device that is not a snapshot belonging to another snapshot set.

Parameters

origins – A list of origin devices to check.

Raises

SnapmRecursionError if an origin device is a snapshot.

_find_and_verify_plugins(sources, size_policies, _requested_provider=None)[source]

Find snapshot provider plugins for each source in sources and verify that a provider exists for each source present.

Parameters
  • sources – A list of source mount point or block device paths.

  • size_policies – A dictionary mapping sources to size policies.

Returns

A dictionary mapping sources to plugins.

_find_next_index(basename)[source]

Find the next index value for the recurring snapset with basename basename.

Parameters

basename – The basename of the recurring snapset

Returns

An integer index value

_load_plugin_config(plugin_name: str) → configparser.ConfigParser[source]

Load optional configuration file for plugin plugin_name.

Parameters

plugin_name (str) – The name of the plugin to load config for.

Returns

A (possibly empty) ConfigParser instance.

Return type

ConfigParser

_set_autoactivate(snapset, auto=False)[source]

Set autoactivation for snapset.

Parameters
  • snapset – The SnapshotSet object to operate on.

  • autoTrue to enable autoactivation or False otherwise.

_snapset_from_name_or_uuid(name=None, uuid=None)[source]

Look a snapshot set up by name or uuid. Returns a SnapshotSet correponding to either name or uuid`, or raises ``SnapmError on error.

Parameters
  • name – The name of the snapshot set to look up.

  • uuid – The UUID of the snapshot set to look up.

Returns

A SnapshotSet corresponding to the given name or UUID.

Raises

SnapmNotFoundError is the name or UUID cannot be found. SnapmInvalidIdentifierError if the name and UUID do not match.

_validate_snapset_name(name)[source]

Validate a snapshot set name.

Returns if name is a valid snapshot set name or raises an appropriate exception otherwise.

Parameters

name – The snapshot set name to validate.

Raises

SnapmExistsError if the name is already in use, or SnapmInvalidIdentifierError if the name fails validation.

activate_snapshot_sets(selection)[source]

Activate snapshot sets matching selection criteria selection.

Parameters

selection – Selection criteria for snapshot sets to activate.

by_name = {}
by_uuid = {}
create_snapshot_set(name, source_specs, default_size_policy=None, boot=False, revert=False, autoindex=False)[source]

Create a snapshot set of the supplied mount points with the name name.

Parameters
  • name – The name of the snapshot set.

  • source_specs – A list of mount point and block device paths to include in the set.

  • default_size_policy – A default size policy to use for the set.

  • boot – Create a snapshot boot entry for this snapshot set.

  • revert – Create a revert boot entry for this snapshot set.

  • autoindex – Treat name as the basename of a recurring snapshot set and generate and append an appropriate index value.

Raises

SnapmExistsError if the name is already in use, or SnapmInvalidIdentifierError if the name fails validation.

create_snapshot_set_boot_entry(name=None, uuid=None)[source]

Create a snapshot boot entry for the specified snapshot set.

Parameters
  • name – The name of the snapshot set.

  • uuid – The UUID of the snapshot set.

create_snapshot_set_revert_entry(name=None, uuid=None)[source]

Create a revert boot entry for the specified snapshot set.

Parameters
  • name – The name of the snapshot set.

  • uuid – The UUID of the snapshot set.

deactivate_snapshot_sets(selection)[source]

Deactivate snapshot sets matching selection criteria selection.

Parameters

selection – Selection criteria for snapshot sets to deactivate.

delete_snapshot_sets(selection)[source]

Remove snapshot sets matching selection criteria selection.

Parameters

selection – Selection criteria for snapshot sets to remove.

discover_snapshot_sets()[source]

Discover snapshot sets by calling into each plugin to find individual snapshots and then aggregating them together into snapshot sets.

Initialises the snapshot_sets, by_name and by_uuid members with the discovered snapshot sets.

find_snapshot_sets(selection=None)[source]

Find snapshot sets matching selection criteria.

Parameters

selection – Selection criteria to apply.

Returns

A list of matching SnapshotSet objects.

find_snapshots(selection=None)[source]

Find snapshots matching selection criteria.

Parameters

selection – Selection criteria to apply.

Returns

A list of matching Snapshot objects.

plugins = []
rename_snapshot_set(old_name, new_name)[source]

Rename snapshot set old_name as new_name.

Parameters
  • old_name – The name of the snapshot set to be renamed.

  • new_name – The new name of the snapshot set.

Raises

SnapmExistsError if the name is already in use, or SnapmInvalidIdentifierError if the name fails validation.

resize_snapshot_set(source_specs, name=None, uuid=None, default_size_policy=None)[source]

Resize snapshot set named name or having UUID uuid.

Request to resize each snapshot included in source_specs according to the given size policy, or apply default_size_policy if set.

Parameters
  • name – The name of the snapshot set to resize.

  • uuid – The UUID of the snapshot set to resize.

  • source_specs – A list of mount points and optional size policies.

  • default_size_policy – A default size policy to apply to the resize.

revert_snapshot_set(name=None, uuid=None)[source]

Revert snapshot set named name or having UUID uuid.

Request to revert each snapshot origin within each snapshot set to the state at the time the snapshot was taken.

Parameters
  • name – The name of the snapshot set to revert.

  • uuid – The UUID of the snapshot set to revert.

revert_snapshot_sets(selection)[source]

Revert snapshot sets matching selection criteria selection.

Request to revert each snapshot origin within each snapshot set to the state at the time the snapshot was taken.

Parameters

selection – Selection criteria for snapshot sets to revert.

set_autoactivate(selection, auto=False)[source]

Set autoactivation state for snapshot sets matching selection criteria selection.

Parameters
  • selection – Selection criteria for snapshot sets to set autoactivation.

  • autoTrue to enable autoactivation or False otherwise.

snapshot_sets = []
split_snapshot_set(name, new_name, source_specs)[source]

Split the snapshot set named name into two snapshot sets, with new_name containing the listed sources and name containing all remaining snapshots.

If new_name is None the listed snapshot are removed from name and permanently deleted. This operation cannot be undone.

Parameters
  • name – The name of the snapshot set to split

  • new_name – The name of the newly split off snapshot set

  • sources – The list of sources to include in the new snapshot set

snapm.manager._boot module

Boot integration for snapshot manager

class snapm.manager._boot.BootCache[source]

Bases: object

Set of caches mapping snapshot sets to boot entries and revert entries.

__init__()[source]

Initialize self. See help(type(self)) for accurate signature.

refresh_cache()[source]

Refresh the cache of boot entry mappings held by this BootCache instance.

class snapm.manager._boot.BootEntryCache(entry_arg)[source]

Bases: dict

Cache mapping snapshot sets to boom BootEntry instances.

Boot entries in the cache are either snapshot set boot entries or revert entries depending on the value of entry_arg.

__init__(entry_arg)[source]

Initialize self. See help(type(self)) for accurate signature.

_parse_entry(boot_entry)[source]

Parse a boom BootEntry options string and return the value of the snapm.snapset argument if present.

Parameters

boot_entry – The boot entry to process.

Returns

The snapset name for the boot entry.

refresh_cache()[source]

Generate mappings from snapshot sets to boot entries.

snapm.manager._boot.REVERT_ARG = 'snapm.revert'

Snapshot set revert kernel command line argument

snapm.manager._boot.SNAPSET_ARG = 'snapm.snapset'

Snapshot set kernel command line argument

snapm.manager._boot._DBUS_MACHINE_ID = '/var/lib/dbus/machine-id'

Path to the legacy system machine-id file

snapm.manager._boot._DEV_PREFIX = '/dev/'

/dev path prefix

snapm.manager._boot._MACHINE_ID = '/etc/machine-id'

Path to the system machine-id file

snapm.manager._boot._OS_RELEASE = '/etc/os-release'

Path to the system os-release file

snapm.manager._boot._build_snapset_mount_list(snapset)[source]

Build a list of command line mount unit definitions for the snapshot set snapset. Mount points that are not part of the snapset are substituted from /etc/fstab.

Parameters

snapset – The snapshot set to build a mount list for.

snapm.manager._boot._create_boom_boot_entry(version, title, tag_arg, root_device, lvm_root_lv=None, mounts=None)[source]

Create a boom boot entry according to the passed arguments.

Parameters
  • version – The UTS release name for the boot entry

  • title – The title for the boot entry.

  • tag_arg – A tag argument to be added to the kernel command line and used to associate the entry with a snapshot set name or UUID.

  • root_device – The root device for the entry. Passed to root=…

  • lvm_root_lv – An optional LVM2 root logical volume.

  • mounts – An optional list of mount specifications to use for the boot entry. If defined fstab=no will be appended to the generated kernel command line.

snapm.manager._boot._create_default_os_profile()[source]

Create a default boom OsProfile for the running system. This uses the boom API to run the equivalent of: boom profile create --from-host.

snapm.manager._boot._delete_boot_entry(boot_id)[source]

Delete a boom boot entry by ID.

Parameters

boot_id – The boot identifier to delete.

snapm.manager._boot._find_snapset_root(snapset)[source]

Find the device that backs the root filesystem for snapshot set snapset.

If the snapset does not include the root volume look the device up via the fstab.

snapm.manager._boot._get_machine_id()[source]

Return the current host’s machine-id.

Get the machine-id value for the running system by reading from /etc/machine-id and return it as a string.

Returns

The machine_id as a string

Return type

str

snapm.manager._boot._get_uts_release()[source]

Return the UTS release (kernel version) of the running system.

Returns

A string representation of the UTS release value.

snapm.manager._boot.check_boom_config()[source]

Check for boom configuration and create the default config if not found.

snapm.manager._boot.create_snapset_boot_entry(snapset, title=None)[source]

Create a boom boot entry to boot into the snapshot set represented by snapset.

Parameters
  • snapset – The snapshot set for which to create a boot entry.

  • title – An optional title for the boot entry. If title is None the boot entry will be titled as “Snapshot snapset_name snapset_time”.

snapm.manager._boot.create_snapset_revert_entry(snapset, title=None)[source]

Create a boom boot entry to revert the snapshot set represented by snapset.

Parameters
  • snapset – The snapshot set for which to create a revert entry.

  • title – An optional title for the revert entry. If title is None the revert entry will be titled as “Revert snapset_name snapset_time”.

snapm.manager._boot.delete_snapset_boot_entry(snapset)[source]

Delete the boot entry corresponding to snapset.

Parameters

snapset – The snapshot set for which to remove a boot entry.

snapm.manager._boot.delete_snapset_revert_entry(snapset)[source]

Delete the revert entry corresponding to snapset.

Parameters

snapset – The snapshot set for which to remove a revert entry.

snapm.manager._calendar module

Calendar event abstraction for Snapshot Manager

class snapm.manager._calendar.CalendarSpec(calendarspec: str)[source]

Bases: object

Class representing systemd CalendarSpec expressions.

__init__(calendarspec: str)[source]

Validate and parse a systemd calendarspec expression into a CalendarSpec object.

Parameters

calendarspec – A string containing an calendarspec expression.

Raises

ValueError if calendarspec is not a valid calendarspec expression.

__repr__()[source]

Return a string representation of this CalendarSpec instance in the form of a call to the CalendarSpec initializer.

__str__()[source]

Return a string representation of this CalendarSpec instance.

_cond_refresh()[source]

Refresh this CalendarSpec object’s time-dependent properties if the current next_elapse value is in the past.

_refresh()[source]

Refresh this CalendarSpec object’s time-dependent properties.

property from_now

Return a string representation of the time remaining until this CalendarSpec next elapses.

Returns

The time remaining until the next elapse as a string.

Return type

str

property in_utc

Return the next elapse time for this CalendarSpec object as an instance of datetime.datetime in UTC.

Returns

The next elapse time as a UTC datetime object.

Return type

datetime.datetime

property next_elapse

Return the next elapse time for this CalendarSpec object as an instance of datetime.datetime.

Returns

The next elapse time as a datetime object.

Return type

datetime.datetime

property occurs

True if this CalendarSpec object’s calendar expression will occur in the future, or False otherwise.

property original

The original form of this CalendarSpec as a string.

snapm.manager._timers module

snapm.command module

The snapm.command module provides both the snapm command line interface infrastructure, and a simple procedural interface to the snapm library modules.

The procedural interface is used by the snapm command line tool, and may be used by application programs, or interactively in the Python shell by users who do not require all the features present in the snapm object API.

snapm.command.PR_PLUGIN = 4

Plugin report object type

snapm.command.PR_SNAPSET = 1

Snapshot set report object type

snapm.command.PR_SNAPSHOT = 2

Snapshot report object type

class snapm.command.ReportObj(snapset=None, snapshot=None, plugin=None)[source]

Bases: object

Common report object for snapm reports

__init__(snapset=None, snapshot=None, plugin=None)[source]

Initialize self. See help(type(self)) for accurate signature.

snapm.command._activate_cmd(cmd_args)[source]

Activate snapshot set command handler.

Attempt to activate the snapshot sets that match the given selection criteria.

Parameters

cmd_args – Command line arguments for the command

Returns

integer status code returned from main()

snapm.command._add_autoactivate_args(parser)[source]
snapm.command._add_identifier_args(parser, snapset=False, snapshot=False)[source]

Add snapshot set or snapshot identifier command line arguments.

snapm.command._add_json_arg(parser)[source]
snapm.command._add_plugin_subparser(type_subparser)[source]

Add subparser for ‘plugin’ commands.

Parameters

type_subparser – Command type subparser

snapm.command._add_report_args(parser)[source]

Add common reporting command line arguments.

snapm.command._add_snapset_subparser(type_subparser)[source]

Add subparser for ‘snapset’ commands.

Parameters

type_subparser – Command type subparser

snapm.command._add_snapshot_subparser(type_subparser)[source]

Add subparser for ‘snapshot’ commands.

Parameters

type_subparser – Command type subparser

snapm.command._autoactivate_cmd(cmd_args)[source]

Autoactivation status snapshot set command handler.

Attempt to set the autoactivation status for snapshot set that match the given selection criteria.

Parameters

cmd_args – Command line arguments for the command

Returns

integer status code returned from main()

snapm.command._create_cmd(cmd_args)[source]

Create snapshot set command handler. Attempt to create the specified snapshot set.

Parameters

cmd_args – Command line arguments for the command

Returns

integer status code returned from main()

snapm.command._deactivate_cmd(cmd_args)[source]

Deactivate snapshot set command handler.

Attempt to deactivate the snapshot sets that match the given selection criteria.

Parameters

cmd_args – Command line arguments for the command

Returns

integer status code returned from main()

snapm.command._delete_cmd(cmd_args)[source]

Delete snapshot set command handler.

Attempt to delete the specified snapshot set.

Parameters

cmd_args – Command line arguments for the command

Returns

integer status code returned from main()

snapm.command._do_print_type(report_fields, selected, output_fields=None, opts=None, sort_keys=None, title=None)[source]

Print an object type report (snapshot set, snapshot)

Helper for list function that generate reports.

Format a set of snapshot set or snapshot objects matching the given criteria and format them as a report, returning the output as a string.

Selection criteria may be expressed via a Selection object passed to the call using the selection parameter.

Parameters
  • selection – A Selection object giving selection criteria for the operation

  • output_fields – a comma-separated list of output fields

  • opts – output formatting and control options

  • sort_keys – a comma-separated list of sort keys

Return type

str

snapm.command._expand_fields(default_fields, output_fields)[source]

Expand output fields list from command line arguments.

snapm.command._generic_list_cmd(cmd_args, select, opts, manager, print_fn)[source]

Generic list command implementation.

Implements a simple list command that applies selection criteria and calls a print_*() API function to display results.

Callers should initialise identifier and select appropriately for the specific command arguments.

Parameters
  • cmd_args – the command arguments

  • select – selection criteria

  • opts – reporting options object

  • print_fn – the API call to display results. The function must accept the selection, output_fields, opts, and sort_keys keyword arguments

Returns

None

snapm.command._list_cmd(cmd_args)[source]

List snapshot sets command handler.

List the snapshot sets that match the given selection criteria as a tabular report, with one snapshot set per row.

Parameters

cmd_args – Command line arguments for the command

Returns

integer status code returned from main()

snapm.command._plugin_list_cmd(cmd_args)[source]

List available plugins.

Parameters

cmd_args – Command line arguments for the command

Returns

integer status code returned from main()

snapm.command._prune_cmd(cmd_args)[source]

Prune snapshot set command handler.

Attempt to prune the specified sources from the given snapshot set.

Parameters

cmd_args – Command line arguments for the command.

Returns

integer status code returned from main()

snapm.command._rename_cmd(cmd_args)[source]

Rename snapshot set command handler.

Attempt to rename the specified snapshot set.

Parameters

cmd_args – Command line arguments for the command

Returns

integer status code returned from main()

snapm.command._report_obj_types = [<snapm.report.ReportObjType object>, <snapm.report.ReportObjType object>, <snapm.report.ReportObjType object>]

Report object types table for snapm.command reports

snapm.command._report_opts_from_args(cmd_args)[source]
snapm.command._resize_cmd(cmd_args)[source]

Resize snapshot set command handler.

Attempt to resize the snapshots contained in the given snapshot set according to the corresponding size policy.

Parameters

cmd_args – Command line arguments for the command

Returns

integer status code returned from main()

snapm.command._revert_cmd(cmd_args)[source]

Delete snapshot set command handler.

Attempt to revert the specified snapshot set.

Parameters

cmd_args – Command line arguments for the command

Returns

integer status code returned from main()

snapm.command._show_cmd(cmd_args)[source]

Show snapshot set command handler.

Show the snapshot sets that match the given selection criteria as a multi-line report.

Parameters

cmd_args – Command line arguments for the command

Returns

integer status code returned from main()

snapm.command._snapshot_activate_cmd(cmd_args)[source]

Activate snapshot command handler.

Attempt to activate the snapshots that match the given selection criteria.

Parameters

cmd_args – Command line arguments for the command

Returns

integer status code returned from main()

snapm.command._snapshot_autoactivate_cmd(cmd_args)[source]

Autoactivate snapshot command handler.

Attempt to set autoactivation status for the snapshots that match the given selection criteria.

Parameters

cmd_args – Command line arguments for the command

Returns

integer status code returned from main()

snapm.command._snapshot_deactivate_cmd(cmd_args)[source]

Deactivate snapshot command handler.

Attempt to deactivate the snapshots that match the given selection criteria.

Parameters

cmd_args – Command line arguments for the command

Returns

integer status code returned from main()

snapm.command._snapshot_list_cmd(cmd_args)[source]

List snapshots command handler.

List the snapshot that match the given selection criteria as a tabular report, with one snapshot per row.

Parameters

cmd_args – Command line arguments for the command

Returns

integer status code returned from main()

snapm.command._snapshot_show_cmd(cmd_args)[source]

Show snapshots command handler.

Show the snapshots that match the given selection criteria as a multi-line report.

Parameters

cmd_args – Command line arguments for the command

Returns

integer status code returned from main()

snapm.command._split_cmd(cmd_args)[source]

Split snapshot set command handler.

Attempt to split the specified sources from the first snapshot set argument into the second.

Parameters

cmd_args – Command line arguments for the command.

Returns

integer status code returned from main()

snapm.command._str_indent(string, indent)[source]

Indent all lines of a multi-line string.

Indent each line of the multi line string string to the specified indentation level.

Parameters
  • string – The string to be indented

  • indent – The number of characters to indent by

Returns

str

snapm.command.create_snapset(manager, name, sources, size_policy=None, boot=False, revert=False, autoindex=False)[source]

Create a new snapshot set from a list of mount point and block device source paths.

Parameters
  • manager – The manager context to use

  • name – The name of the new snapshot set

  • sources – A list of mount point or block devices to snapshot

  • size_policy – The default size policy for this snapshot set.

  • boot – Create a boot entry for this snapshot set.

  • revert – Create a revert boot entry for this snapshot set.

  • autoindex – Treat name as the basename of a recurring snapshot set and generate and append an appropriate index value.

snapm.command.delete_snapset(manager, selection)[source]

Delete snapshot set matching selection criteria.

Parameters
  • manager – The manager context to use

  • selection – Selection criteria for the snapshot set to remove.

snapm.command.main(args)[source]

Main entry point for snapm.

snapm.command.print_plugins(manager, selection=None, output_fields=None, opts=None, sort_keys=None)[source]

Print plugins matching selection criteria.

Format a set of snapm.manager.Plugin objects matching the given criteria, and output them as a report to the file given in opts.report_file.

Selection criteria are currently ignored for plugin reports.

Parameters
  • selection – A Selection object giving selection criteria for the operation

  • output_fields – a comma-separated list of output fields

  • opts – output formatting and control options

  • sort_keys – a comma-separated list of sort keys

snapm.command.print_snapsets(manager, selection=None, output_fields=None, opts=None, sort_keys=None)[source]

Print snapshot sets matching selection criteria.

Format a set of snapm.manager.SnapshotSet objects matching the given criteria, and output them as a report to the file given in opts.report_file.

Selection criteria may be expressed via a Selection object passed to the call using the selection parameter.

Parameters
  • selection – A Selection object giving selection criteria for the operation

  • output_fields – a comma-separated list of output fields

  • opts – output formatting and control options

  • sort_keys – a comma-separated list of sort keys

snapm.command.print_snapshots(manager, selection=None, output_fields=None, opts=None, sort_keys=None)[source]

Print snapshots matching selection criteria.

Format a set of snapm.manager.Snapshot objects matching the given criteria, and output them as a report to the file given in opts.report_file.

Selection criteria may be expressed via a Selection object passed to the call using the selection parameter.

Parameters
  • selection – A Selection object giving selection criteria for the operation

  • output_fields – a comma-separated list of output fields

  • opts – output formatting and control options

  • sort_keys – a comma-separated list of sort keys

snapm.command.prune_snapset(manager, name, sources)[source]

Prune snapshots from an existing snapshot set.

Remove snapshots from an existing snapshot set named name. The snapshot sources listed in sources are pruned (deleted) from the named snapshot set.

Parameters
  • name – The name of the snapshot set to prune.

  • sources – The sources to prune from name.

Returns

A SnapshotSet object representing the pruned snapshot set

snapm.command.rename_snapset(manager, old_name, new_name)[source]

Rename a snapshot set from old_name to new_name.

snapm.command.resize_snapset(manager, sources, name=None, uuid=None, default_size_policy=None)[source]

Resize snapshot set by name or UUID.

Parameters
  • manager – The manager context to use

  • sources – A list of mount point or block devices to snapshot

  • name – The name of the snapshot set to resize.

  • uuid – The uuid of the snapshot set to resize.

  • default_size_policy – The default size policy for this snapshot set.

snapm.command.revert_snapset(manager, name=None, uuid=None)[source]

Revert snapshot set matching selection criteria.

Parameters
  • manager – The manager context to use

  • selection – Selection criteria for the snapshot set to revert.

snapm.command.set_debug(debug_arg)[source]

Set debugging mask from command line argument.

snapm.command.setup_logging(cmd_args)[source]

Set up snapm logging.

snapm.command.show_snapsets(manager, selection=None, members=False, json=False)[source]

Show snapshot sets matching selection criteria.

snapm.command.show_snapshots(manager, selection=None, json=False)[source]

Show snapshots matching selection criteria.

snapm.command.shutdown_logging()[source]

Shut down snapm logging.

snapm.command.split_snapset(manager, name, new_name, sources)[source]

Split an existing snapshot set.

Split the snapshot set named name into two snapshot sets, including all sources listed in sources in the newly created snapshot set with name new_name.

Parameters
  • name – The name of the snapshot set to split.

  • new_name – The name for the newly created snapshot set.

  • sources – The sources to split from name to new_name.

Returns

A SnapshotSet object representing the snapshot set named new_name.

snapm.report module

The snapm reporting module contains a set of classes for creating simple text based tabular reports for a user-defined set of object types and fields. No restrictions are placed on the types of object that can be reported: users of the Report classes may define additional object types outside the snapm package and include these types in reports generated by the module.

The fields displayed in a specific report may be selected from the available set of fields by specifying a simple comma-separated string list of field names (in display order). In addition, custom multi-column sorting is possible using a similar string notation.

The Report module is closely based on the device-mapper reporting engine and shares many features and behaviours with device mapper reports.

class snapm.report.Field[source]

Bases: object

A Field represents an instance of a FieldType including its associated data values.

__init__(report, props)[source]

Initialise a new Field object.

Initialise a Field object and configure the supplied report and props attributes.

Parameters
  • report – The Report that owns this field

  • props – The FieldProperties object for this field

report_idx(value)[source]

Report an index value for this Field object.

Set the value for this field to the supplied value.

Parameters

value – The index value to set

Return type

None

report_num(value)[source]

Report a numeric value for this Field object.

Set the value for this field to the supplied value.

Parameters

value – The numeric value to set

Return type

None

report_sha(value)[source]

Report a SHA value for this Field object.

Set the value for this field to the supplied value.

Parameters

value – The SHA value to set

Return type

None

report_size(value)[source]

Report a size value for this Field object.

Set the value for this field to the supplied value, converted to a human readable string.

Parameters

value – The size value to set in bytes.

Return type

None

report_str(value)[source]

Report a string value for this Field object.

Set the value for this field to the supplied value.

Parameters

value – The string value to set

Return type

None

report_str_list(value)[source]

Report a string list value for this Field object.

Set the value for this field to the strings contained in value.

Parameters

value – A list of strings

Return type

None

report_time(value)[source]

Report a time value for this Field object.

Set the value for this field to the supplied value.

Parameters

value – The time value to set

Return type

None

report_uuid(value)[source]

Report a uuid value for this Field object.

Set the value for this field to the supplied value.

Parameters

value – The uuid value to set

Return type

None

set_value(report_string, sort_value=None)[source]

Report an arbitrary value for this Field object.

Set the value for this field to the supplied value, and set the field’s sort_value to the supplied sort_value.

Parameters
  • report_string – The string value to set

  • sort_value – The sort value

Return type

None

class snapm.report.FieldProperties(field_num=None, initial_width=0, width=0, objtype=None, dtype=None, align=None, hidden=False, implicit=False, sort_key=False, sort_dir=None, compact_one=False, compacted=False, sort_posn=None)[source]

Bases: object

Properties of a field instance.

__init__(field_num=None, initial_width=0, width=0, objtype=None, dtype=None, align=None, hidden=False, implicit=False, sort_key=False, sort_dir=None, compact_one=False, compacted=False, sort_posn=None)[source]

Initialize self. See help(type(self)) for accurate signature.

class snapm.report.FieldType[source]

Bases: object

The FieldType class describes the properties of a field available in a Report instance.

__init__(objtype, name, head, desc, width, dtype, report_fn, align=None)[source]

Initialise new FieldType object.

Initialise a new FieldType object with the specified properties.

Parameters
  • objtype – The numeric object type ID (power of two)

  • name – The field name used to select display fields

  • desc – A human-readable description of the field

  • width – The default (initial) field width

  • dtype – The Report data type of the field

  • report_fn – The field reporting function

  • align – The field alignment value

Returns

A new ReportFieldType object

Return type

ReportFieldType

class snapm.report.Report[source]

Bases: object

A class representing a configurable text report with multiple caller-defined fields. An optional title may be provided and the fields argument must contain a list of Field objects describing the required report.

__init__(types, fields, output_fields, opts, sort_keys, title)[source]

Initialise Report.

Initialise a new Report object with the specified fields and output control options.

Parameters
  • types – List of ReportObjType used in this report.

  • fields – A list of Field field descriptions.

  • output_fields – An optional list of output fields to be rendered by this report.

  • opts – An instance of ReportOpts or None.

Returns

A new report object.

Return type

Report.

opts = None
report_object(obj)[source]

Report data for object.

Add a row of data to this Report. The data argument should be an object of the type understood by this report’s fields. It will be passed in turn to each field to obtain data for the current row.

Parameters

obj – the object to report on for this row.

report_output()[source]

Output report data.

Output this report’s data to the configured report file, using the configured output controls and fields.

On success the number of rows output is returned. On error an exception is raised.

Returns

the number of rows of output written.

Return type

int

class snapm.report.ReportObjType[source]

Bases: object

Class representing a type of object to be reported on. Instances of ReportObjType must specify an identifier, a description, and a data function that will return the correct type of object from a compound object containing data objects of different types. For reports that use only a single object type the data_fn member may be simply lambda x: x.

__init__(objtype, desc, prefix, data_fn)[source]

Initialise ReportObjType.

Initialise a new ReportObjType object with the specified objtype, desc, optional prefix and data_fn. The objtype must be an integer power of two that is unique within a given report. The data_fn should accept an object as its only argument and return an object of the requested type.

class snapm.report.ReportOpts[source]

Bases: object

Options controlling the formatting and output of a report.

__eq__(other)[source]

Return self==value.

__hash__ = None
__init__(columns=80, headings=True, buffered=True, separator=' ', field_name_prefix='', unquoted=True, aligned=True, json=False, columns_as_rows=False, report_file=<_io.TextIOWrapper name='<stdout>' mode='w' encoding='utf-8'>)[source]

Initialise ReportOpts object.

Initialise a ReportOpts object to control output of a Report.

Parameters
  • columns – the number of columns to use for output.

  • headings – a boolean indicating whether to output column headings for this report.

  • buffered – a boolean indicating whether to buffer output from this report.

  • report_file – a file to which output will be sent.

Returns

a new ReportOpts object.

Return type

<class ReportOpts>

__str__()[source]

Return str(self).

snapm.manager.plugins module

Snapshot manager plugin interface.

class snapm.manager.plugins.Plugin(logger, plugin_cfg)[source]

Bases: object

Abstract base class for snapshot manager plugins.

__init__(logger, plugin_cfg)[source]

Initialize self. See help(type(self)) for accurate signature.

_log_debug(*args)[source]

Log at debug level.

_log_error(*args)[source]

Log at error level.

_log_info(*args)[source]

Log at info level.

_log_warn(*args)[source]

Log at warning level.

activate_snapshot(name)[source]

Activate the snapshot named name

Parameters

name – The name of the snapshot to be activated.

can_snapshot(source)[source]

Test whether this plugin can snapshot the specified mount point or block device.

Parameters

source – The block device or mount point path to test.

Returns

True if this plugin can snapshot the file system mounted at mount_point, or False otherwise.

check_create_snapshot(origin, snapset_name, timestamp, mount_point, size_policy)[source]

Perform pre-creation checks before creating a snapshot.

Parameters
  • origin – The origin volume for the snapshot.

  • snapset_name – The name of the snapshot set to be created.

  • timestamp – The snapshot set timestamp.

  • mount_point – The mount point path for this snapshot.

Raises

SnapmNoSpaceError if there is insufficient free space to create the snapshot.

check_resize_snapshot(name, origin, mount_point, size_policy)[source]

Chcek whether this snapshot can be resized to the requested size_policy. This method returns if the resize can be satisfied and raises an exception if not.

Returns

None

Raises

SnapmNoSpaceError if insufficient space is available to satisfy the requested size policy or SnapmPluginError if another reason prevents the snapshot from being resized.

check_revert_snapshot(name, origin)[source]

Check whether this snapshot can be reverted or not. This method returns if the current snapshot can be reverted and raises an exception if not.

Returns

None

Raises

NotImplementedError if this plugin does not support the revert operation, SnapmBusyError if the snapshot is already in the process of being reverted to another snapshot state or SnapmPluginError if another reason prevents the snapshot from being merged.

create_snapshot(origin, snapset_name, timestamp, mount_point, size_policy)[source]

Create a snapshot of origin in the snapset named snapset_name.

Parameters
  • origin – The origin volume for the snapshot.

  • snapset_name – The name of the snapshot set to be created.

  • timestamp – The snapshot set timestamp.

  • mount_point – The mount point path for this snapshot.

Raises

SnapmNoSpaceError if there is insufficient free space to create the snapshot.

deactivate_snapshot(name)[source]

Deactivate the snapshot named name

Parameters

name – The name of the snapshot to be deactivated.

delete_snapshot(name)[source]

Delete the snapshot named name

Parameters

name – The name of the snapshot to be removed.

discover_snapshots()[source]

Discover snapshots managed by this plugin class.

Returns a list of objects that are a subclass of Snapshot. :returns: A list of snapshots discovered by this plugin class.

end_transaction()[source]

End a snapshot set creation transaction in this plugin.

info()[source]

Return plugin name and version.

name = 'plugin'
origin_from_mount_point(mount_point)[source]

Return a string representing the origin from a given mount point path.

Parameters

mount_point – The mount point path.

rename_snapshot(old_name, origin, snapset_name, timestamp, mount_point)[source]

Rename the snapshot named old_name according to the provided snapshot field values.

Parameters
  • old_name – The original name of the snapshot to be renamed.

  • origin – The origin volume for the snapshot.

  • snapset_name – The new name of the snapshot set.

  • timestamp – The snapshot set timestamp.

  • mount_point – The mount point of the snapshot.

resize_snapshot(name, origin, mount_point, size_policy)[source]

Attempt to resize the snapshot name to the requested size_policy. This method returns if the resize can be satisfied and raises an exception if not.

Returns

None

Raises

SnapmNoSpaceError if insufficient space is available to satisfy the requested size policy or SnapmPluginError if another reason prevents the snapshot from being resized.

revert_snapshot(name)[source]

Request to revert a snapshot and revert the content of the origin volume to its state at the time of the snapshot.

This may be deferred until the next device activation or mount operation for the respective volume.

Parameters

name – The name of the snapshot to revert.

set_autoactivate(name, auto=False)[source]

Set the autoactivation state of the snapshot named name.

Parameters
  • name – The name of the snapshot to be modified.

  • autoTrue to enable autoactivation or False otherwise.

snapshot_class

alias of snapm._snapm.Snapshot

start_transaction()[source]

Begin a snapshot set creation transaction in this plugin.

version = '0.1.0'
snapm.manager.plugins.decode_mount_point(mount_str)[source]

Parse the mount point component of a snapshot name.

snapm.manager.plugins.device_from_mount_point(mount_point)[source]

Convert a mount point path to a corresponding device path.

Return the device corresponding to the file system mount point mount_point according to /proc/self/mounts.

snapm.manager.plugins.encode_mount_point(mount_point)[source]

Encode mount point paths.

Encode a mount point for use in a snapshot name by replacing the path separator with ‘-‘.

snapm.manager.plugins.format_snapshot_name(origin, snapset_name, timestamp, mount_point)[source]

Format structured snapshot name.

Format a snapshot name according to the snapshot manager naming format.

snapm.manager.plugins.mount_point_space_used(mount_point)[source]

Retrieve space usage for a mount point path.

Return the space used on the file system mounted at mount_point as a value in bytes.

snapm.manager.plugins.parse_snapshot_name(full_name, origin)[source]

Attempt to parse a snapshot set snapshot name.

Returns a tuple of (snapset_name, timestamp, mount_point) if full_name is a valid snapset snapshot name, or None otherwise.