backup-manager-purge(8) [debian man page]

BACKUP-MANAGER-PURGE(8) 				       backup-manager-purge					   BACKUP-MANAGER-PURGE(8)

NAME

       backup-manager-purge - backup-manager's wrapper for outdating files

SYNOPSIS

       backup-manager-purge [TTL] <options>

DESCRIPTION

       backup-manager-purge is the only authorized entity that can say if an archive should be purged or not. Any tasks used by backup-manager may
       have to know if an archive is deprecated (eg: the purging phase of an upload method). This tool is here to fulfill that need.

       Given a time to live (TTL) and a list of archives, backup-manager-purge will return another list of archives, corresponding to the ones
       that are outdated by the TTL.

REQUIRED ARGS

       --ttl=time-to-live
	   Specify the time to live (in days) for the archives. Any archive that is older than ttl days will be outdated.

OPTIONAL ARGS

       --files-from=file
	   A file containing a list of archives to parse, one archive per line.  If this option is not used, STDIN will be used for catching the
	   files to parse.

RETURN

       backup-manager-purge will return the list of outdated files on STDOUT, one file per line.

ERROR CODES

       If an error occurs, it will print the error message on stderr and will exit with an error code greater than 0.

       Here are the possible error codes:

       bad command line (wrong arguments) : 10
       internal error (should be reported as a bug) : 20

SEE ALSO

       backup-manager(8) backup-manager-upload(8)

AUTHORS

       Concept and design by Alexis Sukrieh and Jan Metzger.

perl v5.14.2							    2012-05-09						   BACKUP-MANAGER-PURGE(8)

GPODDER-BACKUP(1)						   User Commands						 GPODDER-BACKUP(1)

NAME

       gpodder-backup - Backup and restore utility for gPodder user data

SYNOPSIS

       gpodder-backup [--create|--extract] <archive.gpo.tar.gz> [options] gpodder-backup --purge

DESCRIPTION

       This utility can be used to create a dump of the current gPodder data (configuration files + downloads), optionally replacing the real con-
       tents of the download folder with zero-byte files (for submitting your data to a bug report without having to transfer lots of data).

OPTIONS

       --version
	      show program's version number and exit

       -h, --help
	      show this help message and exit

       -c <FILE>, --create=<FILE>
	      Create a new archive

       -x <FILE>, --extract=<FILE>
	      Extract an existing archive

       -f, --fake-downloads
	      Store downloads as zero-byte files in backup

       -n, --no-covers
	      Do not include cover files in archive

       -D <DIR>, --destination=<DIR>
	      Extract downloads in different folder

       -P, --purge
	      Remove current data (can be combined with --extract)

USAGE FOR BUG REPORTING

       This command is useful if you want to report a bug in gPodder:

       gpodder-backup --create bug123.gpo.tar.gz --fake-downloads
	      Backup your current data to file bug123.gpo.tar.gz, but don't store download data (create zero-size dummy files  instead).  You  can
	      then attach bug123.gpo.tar.gz to the bug report.

       If you are instructed to try gPodder from a "clean state", you can use the following command (be sure to backup your data before!):

       gpodder-backup --purge
	      Remove all gPodder data, so you can start from a clean state

EXAMPLES

       gpodder-backup --create today.gpo.tar.gz
	      Backup your current data to file today.gpo.tar.gz

       gpodder-backup --extract mybackup.gpo.tar.gz
	      Restore (without purging) the contents of mybackup.gpo.tar.gz

       gpodder-backup --extract default.gpo.tar.gz --purge
	      Remove current data, then restore the contents of default.gpo.tar.gz

       gpodder-backup --purge
	      Remove all gPodder data, so you can start from a clean state

EXTRACTING FAKED DOWNLOADS

       Please  note  that  any	existing  downloads will be overwritten with zero-byte files when using the --extract option of the gpodder-backup
       utility with a backup created with --fake-downloads

AUTHOR

       gpodder-backup was written by Thomas Perl (thp@gpodder.org)

gpodder-backup 1.0						   December 2010						 GPODDER-BACKUP(1)