Command-line restore options

Apart from the CGI interface, BackupPC allows you to restore files and directories from the command line. The following programs can be used:

BackupPC_zcat
    For each file name argument it inflates (uncompresses) the file and writes it to stdout. To use BackupPC_zcat you could give it the full file name, eg: 

        /usr/share/backuppc/bin/BackupPC_zcat /var/lib/backuppc/pc/host/5/fc/fcraig/fexample.txt > example.txt

    It's your responsibility to make sure the file is really compressed: BackupPC_zcat doesn't check which backup the requested file is from. BackupPC_zcat returns a non-zero status if it fails to uncompress a file.

BackupPC_tarCreate
    BackupPC_tarCreate creates a tar file for any files or directories in a particular backup. Merging of incrementals is done automatically, so you don't need to worry about whether certain files appear in the incremental or full backup. 

    The usage is:

       BackupPC_tarCreate [-t] [-h host] [-n dumpNum] [-s shareName]
                        [-r pathRemove] [-p pathAdd] [-b BLOCKS] [-w writeBufSz]
                        files/directories...

    The command-line files and directories are relative to the specified shareName. The tar file is written to stdout.

    The required options are:

-h host
    host from which the tar archive is created 

-n dumpNum
    dump number from which the tar archive is created 

-s shareName
    share name from which the tar archive is created 

Other options are:

-t
    print summary totals 

-r pathRemove
    path prefix that will be replaced with pathAdd 

-p pathAdd
    new path prefix 

-b BLOCKS
    the tar block size, default is 20, meaning tar writes data in 20 * 512 bytes chunks. 

-w writeBufSz
    write buffer size, default 1048576 (1MB). You can increase this if you are trying to stream to a fast tape device. 

The -h, -n and -s options specify which dump is used to generate the tar archive. The -r and -p options can be used to relocate the paths in the tar archive so extracted files can be placed in a location different from their original location.
BackupPC_zipCreate
    BackupPC_zipCreate creates a zip file for any files or directories in a particular backup. Merging of incrementals is done automatically, so you don't need to worry about whether certain files appear in the incremental or full backup. 

    The usage is:

       BackupPC_zipCreate [-t] [-h host] [-n dumpNum] [-s shareName]
                        [-r pathRemove] [-p pathAdd] [-c compressionLevel]
                       files/directories...

    The command-line files and directories are relative to the specified shareName. The zip file is written to stdout.

    The required options are:

-h host
    host from which the zip archive is created 

-n dumpNum
    dump number from which the zip archive is created 

-s shareName
    share name from which the zip archive is created 

Other options are:

-t
    print summary totals 

-r pathRemove
    path prefix that will be replaced with pathAdd 

-p pathAdd
    new path prefix 

-c level
    compression level (default is 0, no compression) 

The -h, -n and -s options specify which dump is used to generate the zip archive. The -r and -p options can be used to relocate the paths in the zip archive so extracted files can be placed in a location different from their original location.

Each of these programs reside in /usr/share/backuppc/bin.