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