manpage

summary

Back up a hard drive on to removable media, storing the data in pax or hfspax archives.

synopsis

[ --days | -d days ] [ --level | -l ] [ --append | -a ] [ --medium | -m medium ] [ --script | -s script ] [ --image ] [ --check-files | -c ] [ --no-pax-warning ] [ --test-run ] [ --make-test-file ] [ --no-verify ] --file file | -f file | path...

[ --days | -d days ] [ --level | -l ] [ --medium | -m medium ] [ --script | -s script ] [ --image ] [ --check-files | -c ] [ --no-pax-warning ] [ --repair ] [ --test-run ] [ --make-test-file ] [ --no-verify ] [ --file | -f file ] [ path... ]

[ --verify-set ]

[ --info ]

[ --version ]

[ --config ]

description

The script paxbac creates either full or incremental backups to removable media, using pax (or hfspax) to create cpio archives. The script paxbac will split large amounts of data across removable media, and also allows a user to append data to an existing archive.

paxbac gives a user three choices when creating archives. It will burn a CD directly; it will pause in between the creation of chunks and have a user copy the chunks to a removable media; or it will run a script in between the creation of a chunk.

paxbac works on a linux or Mac OS X system.

paxbac will repair disks in sets that are lost or damaged. If given the --verify-set option, paxbac will verify all the members in your archive. The --info option will print out all the information for your sets of backups, such as the number of disks and backup dates.

options

-- days | -d

Determine how many days ago to backup. You can use either a number, or the word "last". If you use the word "last", paxbac will only backup those files that have been modified since the last backup. You should only use "last" if you are appending to an existing archive.

-- level | -l

Set the level of interaction for paxbac. The lower the level, the least amount of messages and prompts.

-- append | -a

Append the the backup to an existing archive.

-- medium

Set the type of medium for your backups. The default is "cd". The only other choice is "ask", which prompts paxbac to pause between each slice of data to allow you to copy the data to your removable media.

-- script

Execute the argument of script after each slice of data is made. If the exit result of running the script is not zero, paxbac will give you the option of trying again.

-- image

image tells paxbac to create a CD image of the pax archives and other data. By default, when using the medium or script options, paxbac does not make a CD image, so use this option if you want to copy a CD image rather than a directory.

-- check-files | -c

Pause once after the size of the backup is determined. This allows you to go into the paxbac home directory and look at the "files_created_today" file and "files_excluded_today" file to make sure nothing has been excluded or included inappropriately.

-- no-pax-warning

By default, each time paxbac tries to verify a CD, it gives a long warning message instructing you what to do if the pax archive is corrupt and you therefore see an ambiguous message. If you understand what to do, you may not want to be reminded each time by a message that in itself looks like an error. Using this option will insure that you don't see the message.

-- test-run

Run paxbac in a test mode, in which no CD images will be created and mounted, but not burned.

-- no-verify

By default, paxbac verifies the data copied on to each disk. If you don't want to verify each disk, use this option.

-- make-test-file

paxbac can create a test file in one of the directories you backup and then test for the presence of this file on the members you create. This allows you an extra test when running paxbac. The file will be removed from your hard drive before paxbac, but will remain on the member. However, the actual file name will be put on the stale list (present on each disk) of files that should be removed if you have to restore your data.

-- file | -f

Read the file to determine what to backup. This saves you the effort of having to type each directory every time you want to backup, and insures that you are always backing up the same directories each time.

-- repair

Replace disks in your set that are lost or damaged. paxbac finds the paths of the files that were on that disk and created new disks with those files. If the files no longer exist on your hard drive, paxbac cannot restore them.

-- config

Show the current configuration settings.

-- info

Show the information about backup sets.

-- help

Print a help message.

Author

Paul Tremblay

home