NAME

charon.pipe - filter filenames generated by tartarus and print those exceeding a certain age

SYNOPSIS

charon.pipe [--null|-0] --maxage days (--profile identifier| --all) [--dry-run] [--verbose] [--help]

This program is swiss-army-knife of the charon suite. It does not operate on files itself, but exposes the filtering mechanism of the Tartarus::Charon::Filter module to shell scripting. It does read filenames from its standard input and processes the filenames supplied, writing the filenames of expired files to the standard output.

OPTIONS AND ARGUMENTS

--null | -0: Setting this parameter makes charon.local use \0 as filename separator instead of newline, allowing it to process even more exotic filenames and collaboration with tools like find or xargs.
--maxage n: Set the maximum number of days after which a backup is expired.
--profile name: Set the profile name to process. This is mandatory unless --all is supplied.
--all: This options makes charon.pipe process the filenames of all profiles.
--dry-run: This option prevents charon from actually deleting files.
--verbose: This option makes charon more verbose about the actions made
--help: This parameter shows a brief command reference.

EXAMPLE

Charon.pipe can be used to emplay custom cleanup scripts, for example by gathering filenames through an SSH connection. It can also be used for testing purposes:

    $ find -maxdepth 1 -type f -printf '%f\0' | charon.local -0 --maxage 7 --all | xargs -0 -- ls -l

AUTHOR

Stefan Tomanek <stefan.tomanek@wertarbyte.de>