.\" Automatically generated by Pandoc 3.10.2
.\"
.TH "bup\-ftp" "1" "2026\-09\-01" "Bup 0.34+"
.SH NAME
bup\-ftp \- ftp\-like client for navigating bup repositories
.SH SYNOPSIS
bup ftp
.SH DESCRIPTION
\f[CR]bup ftp\f[R] is a command\-line tool for navigating bup
repositories.
It has commands similar to the Unix \f[CR]ftp\f[R](1) command.
The file hierarchy is the same as that shown by \f[CR]bup\-fuse\f[R](1)
and \f[CR]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
The following commands are available inside \f[CR]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\(cqs contents are
listed.
If \-a is given, also include hidden files (files which start with a
\f[CR].\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[CR]*\f[R],
\f[CR]?\f[R], etc.)
.TP
help
print a list of available commands
.TP
quit
exit the \f[CR]bup ftp\f[R] client
.SH EXAMPLES
.IP
.EX
$ 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 \(aqmyfile\(aq
bup> quit
.EE
.SH SEE ALSO
\f[CR]bup\-fuse\f[R](1), \f[CR]bup\-ls\f[R](1), \f[CR]bup\-save\f[R](1),
\f[CR]bup\-restore\f[R](1)
.SH BUP
Part of the \f[CR]bup\f[R](1) suite.
.SH AUTHORS
Avery Pennarun \c
.MT apenwarr@gmail.com
.ME \c.