Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
charon.pipe(1)							  charon.pipe(1)

NAME
     charon.pipe - filter filenames generated by tartarus and print those ex-
     ceeding 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 Tar-
     tarus::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 sup-
	 plied.

     --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				   2026-08-04			  charon.pipe(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=charon.pipe&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help