.\" Automatically generated by Pandoc 2.17.1.1
.\"
.\" Define V font for inline verbatim, using C font in formats
.\" that render this, and otherwise B font.
.ie "\f[CB]x\f[]"x" \{\
. ftr V B
. ftr VI BI
. ftr VB B
. ftr VBI BI
.\}
.el \{\
. ftr V CR
. ftr VI CI
. ftr VB CB
. ftr VBI CBI
.\}
.TH "bup-ftp" "1" "0.33" "Bup 0.33" ""
.hy
.SH NAME
.PP
bup-ftp - ftp-like client for navigating bup repositories
.SH SYNOPSIS
.PP
bup ftp
.SH DESCRIPTION
.PP
\f[V]bup ftp\f[R] is a command-line tool for navigating bup
repositories.
It has commands similar to the Unix \f[V]ftp\f[R](1) command.
The file hierarchy is the same as that shown by \f[V]bup-fuse\f[R](1)
and \f[V]bup-ls\f[R](1).
.PP
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.
.SH COMMANDS
.PP
The following commands are available inside \f[V]bup ftp\f[R]:
.TP
ls [-s] [-a] [\f[I]path\f[R]]
print the contents of a directory.
If no path argument is given, the current directory\[cq]s contents are
listed.
If -a is given, also include hidden files (files which start with a
\f[V].\f[R] character).
If -s is given, each file is displayed with its hash from the bup
archive to its left.
.TP
cd \f[I]dirname\f[R]
change to a different working directory
.TP
pwd
print the path of the current working directory
.TP
cat \f[I]filenames\&...\f[R]
print the contents of one or more files to stdout
.TP
get \f[I]filename\f[R] \f[I]localname\f[R]
download the contents of \f[I]filename\f[R] and save it to disk as
\f[I]localname\f[R].
If \f[I]localname\f[R] is omitted, uses \f[I]filename\f[R] as the local
name.
.TP
mget \f[I]filenames\&...\f[R]
download the contents of the given \f[I]filenames\f[R] and stores them
to disk under the same names.
The filenames may contain Unix filename globs (\f[V]*\f[R], \f[V]?\f[R],
etc.)
.TP
help
print a list of available commands
.TP
quit
exit the \f[V]bup ftp\f[R] client
.SH EXAMPLES
.IP
.nf
\f[C]
$ bup ftp
bup> ls
mybackup/    yourbackup/

bup> cd mybackup/
bup> ls
2010-02-05-185507\[at]   2010-02-05-185508\[at]    latest\[at]

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

bup> get myfile
Saving \[aq]myfile\[aq]
bup> quit
\f[R]
.fi
.SH SEE ALSO
.PP
\f[V]bup-fuse\f[R](1), \f[V]bup-ls\f[R](1), \f[V]bup-save\f[R](1),
\f[V]bup-restore\f[R](1)
.SH BUP
.PP
Part of the \f[V]bup\f[R](1) suite.
.SH AUTHORS
Avery Pennarun <apenwarr@gmail.com>.