Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

bup-ftp(1) [debian man page]

bup-ftp(1)						      General Commands Manual							bup-ftp(1)

bup-ftp - ftp-like client for navigating bup repositories SYNOPSIS
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 ar- chive 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 EXAMPLE
$ 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. AUTHORS
Avery Pennarun <>. Bup unknown- bup-ftp(1)

Check Out this Related Man Page

bup-index(1)						      General Commands Manual						      bup-index(1)

bup-index - print and/or update the bup filesystem index SYNOPSIS
bup index <-p|-m|-s|-u> [-H] [-l] [-x] [--fake-valid] [--fake-invalid] [--check] [-f indexfile] [--exclude path] [--exclude-from filename] [-v] DESCRIPTION
bup index prints and/or updates the bup filesystem index, which is a cache of the filenames, attributes, and sha-1 hashes of each file and directory in the filesystem. The bup index is similar in function to the git(1) index, and can be found in ~/.bup/bupindex. Creating a backup in bup consists of two steps: updating the index with bup index, then actually backing up the files (or a subset of the files) with bup save. The separation exists for these reasons: 1. There is more than one way to generate a list of files that need to be backed up. For example, you might want to use inotify(7) or dno- tify(7). 2. Even if you back up files to multiple destinations (for added redundancy), the file names, attributes, and hashes will be the same each time. Thus, you can save the trouble of repeatedly re-generating the list of files for each backup set. 3. You may want to use the data tracked by bup index for other purposes (such as speeding up other programs that need the same informa- tion). MODES
-u, --update recursively update the index for the given filenames and their descendants. One or more filenames must be given. If no mode option is given, this is the default. -p, --print print the contents of the index. If filenames are given, shows the given entries and their descendants. If no filenames are given, shows the entries starting at the current working directory (.) . -m, --modified prints only files which are marked as modified (ie. changed since the most recent backup) in the index. Implies -p. -s, --status prepend a status code (A, M, D, or space) before each filename. Implies -p. The codes mean, respectively, that a file is marked in the index as added, modified, deleted, or unchanged since the last backup. OPTIONS
-H, --hash for each file printed, prepend the most recently recorded hash code. The hash code is normally generated by bup save. For objects which have not yet been backed up, the hash code will be 0000000000000000000000000000000000000000. Note that the hash code is printed even if the file is known to be modified or deleted in the index (ie. the file on the filesystem no longer matches the recorded hash). If this is a problem for you, use --status. -l, --long print more information about each file, in a similar format to the -l option to ls(1). -x, --xdev, --one-file-system don't cross filesystem boundaries when recursing through the filesystem. Only applicable if you're using -u. --fake-valid mark specified filenames as up-to-date even if they aren't. This can be useful for testing, or to avoid unnecessarily backing up files that you know are boring. --fake-invalid mark specified filenames as not up-to-date, forcing the next "bup save" run to re-check their contents. --check carefully check index file integrity before and after updating. Mostly useful for automated tests. -f, --indexfile=indexfile use a different index filename instead of ~/.bup/bupindex. --exclude=path a path to exclude from the backup (can be used more than once) --exclude-from=filename a file that contains exclude paths (can be used more than once) -v, --verbose increase log output during update (can be used more than once). With one -v, print each directory as it is updated; with two -v, print each file too. EXAMPLE
bup index -vux /etc /var /usr SEE ALSO
bup-save(1), bup-drecurse(1), bup-on(1) BUP
Part of the bup(1) suite. AUTHORS
Avery Pennarun <>. Bup unknown- bup-index(1)
Man Page