Crate conserve

Conserve backup system.

Re-exports

pub use crate::apath::Apath;

pub use crate::archive::Archive;

pub use crate::archive::DeleteOptions;

pub use crate::backup::backup;

pub use crate::backup::BackupOptions;

pub use crate::backup::BackupStats;

pub use crate::bandid::BandId;

pub use crate::blockdir::BlockDir;

pub use crate::blockhash::BlockHash;

pub use crate::change::ChangeCallback;

pub use crate::change::EntryChange;

pub use crate::entry::EntryTrait;

pub use crate::entry::EntryValue;

pub use crate::errors::Error;

pub use crate::excludes::Exclude;

pub use crate::index::IndexEntry;

pub use crate::index::IndexRead;

pub use crate::index::IndexWriter;

pub use crate::kind::Kind;

pub use crate::live_tree::LiveTree;

pub use crate::misc::bytes_to_human_mb;

pub use crate::owner::Owner;

pub use crate::restore::restore;

pub use crate::restore::RestoreOptions;

pub use crate::show::show_versions;

pub use crate::show::ShowVersionsOptions;

pub use crate::stats::DeleteStats;

pub use crate::transport::open_transport;

pub use crate::transport::Transport;

pub use crate::unix_mode::UnixMode;

pub use crate::validate::ValidateOptions;

Modules

apath

“Apaths” (for archive paths) are platform-independent relative file paths used inside archive snapshots.

archive

Archives holding backup material.

backup

Make a backup by walking a source directory and copying the contents into an archive.

bandid

Bands are identified by a string like b0001, represented by a BandId object.

blockdir

File contents are stored in data blocks.

blockhash

Block hash address type.

change

A change to an entry during backup, diff, restore, etc.

compress

Data compression algorithms.

counters

Track counters of the number of files, bytes, blocks, etc, processed.

entry

An entry representing a file, directory, etc, in either a stored tree or local tree.

errors

Conserve error types.

excludes

Exclude files from operations based on globs, etc.

index

Index lists the files in a band in the archive.

kind

An entry representing a file, directory, etc, in either a stored tree or local tree.

live_tree

Access a “live” on-disk tree as a source for backups, destination for restores, etc.

misc

Generally useful functions.

monitor

Communication from the library to a monitor: a test, a UI, etc.

owner

Stores the user and group as Strings in the archive. There is potentially a more efficient way to do this, but this approach works better than just saving the uid and gid, so that backups may potentially be restored on a different system.

restore

Restore from the archive to the filesystem.

show

Text output formats for structured data.

stats

termui

Terminal UI: tracing, progress bars, etc.

test_fixtures

transport

Filesystem abstraction to read and write local and remote archives.

unix_mode

Discretionary Access Control permissions for archived files.

unix_time

Times relative to the Unix epoch.

validate

Structs

Band

Each backup makes a new band containing an index directory.

DiffOptions

GarbageCollectionLock

MergeTrees

Zip together entries from two trees, into an iterator of [MatchedEntries].

StoredTree

Read index and file contents for a version stored in the archive.

TreeSize

The measured size of a tree.

Enums

BandSelectionPolicy

Describes how to select a band from an archive.

Constants

ARCHIVE_VERSION

Archive format-compatibility version, normally the first two components of the package version.

SYMLINKS_SUPPORTED

Traits

ReadTree

Abstract Tree that may be either on the real filesystem or stored in an archive.

Functions

diff

Generate an iter of per-entry diffs between two trees.

version

Type Aliases

EntryCallback

A callback when an entry is visited.

Result