NAME

bup-ftp - ftp-like client for navigating bup repositories

SYNOPSIS

bup ftp

DESCRIPTION

bup ftp is a command-line tool for navigating bup repositories. It has commands similar to the Unix ftp(1) command. The file hierarchy is the same as that shown by bup-fuse(1) and bup-ls(1).

Note: if your system has the python-readline library installed, you can use the <tab> key to complete filenames while navigating your backup data. This will save you a lot of typing.

COMMANDS

The following commands are available inside bup ftp:

ls [-s] [-a] [path] : print the contents of a directory. If no path argument is given, the current directory's contents are listed. If -a is given, also include hidden files (files which start with a . character). If -s is given, each file is displayed with its hash from the bup archive to its left.

cd dirname : change to a different working directory

pwd : print the path of the current working directory

cat filenames... : print the contents of one or more files to stdout

get filename localname : download the contents of filename and save it to disk as localname. If localname is omitted, uses filename as the local name.

mget filenames... : download the contents of the given filenames and stores them to disk under the same names. The filenames may contain Unix filename globs (*, ?, etc.)

help : print a list of available commands

quit : exit the bup ftp client

EXAMPLES

$ bup ftp
bup> ls
mybackup/    yourbackup/

bup> cd mybackup/
bup> ls
2010-02-05-185507@   2010-02-05-185508@    latest@

bup> cd latest/
bup> ls
  (...etc...)

bup> get myfile
Saving 'myfile'
bup> quit

SEE ALSO

bup-fuse(1), bup-ls(1), bup-save(1), bup-restore(1)

BUP

Part of the bup(1) suite.