DragonFly On-Line Manual Pages
charon.pipe(1) charon.pipe(1)
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>
0.9.8 2016-02-19 charon.pipe(1)