Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

bup-ls(1) [debian man page]

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

bup-ls - list the contents of a bup repository SYNOPSIS
bup ls [-s] [-a] DESCRIPTION
bup ls lists files and directories in your bup repository using the same directory hierarchy as they would have with bup-fuse(1). The top level directory contains the branch (corresponding to the -n option in bup save), the next level is the date of the backup, and subsequent levels correspond to files in the backup. When bup ls is asked to output on a tty, it formats its output in columns so that it can list as much as possible in as few lines as possi- ble. However, when bup ls is asked to output to something other than a tty (say you pipe the output to another command, or you redirect it to a file), it will output one file name per line. This makes the listing easier to parse with external tools. Note that bup ls doesn't show hidden files by default and one needs to use the -a option to show them. Files are hidden when their name begins with a dot. For example, on the topmost level, the special directories named .commit and .tag are hidden directories. Once you have identified the file you want using bup ls, you can view its contents using bup join or git show. OPTIONS
-s, --hash show hash for each file/directory. -a, --all show hidden files. EXAMPLE
bup ls /myserver/latest/etc/profile bup ls -a / SEE ALSO
bup-join(1), bup-fuse(1), bup-ftp(1), bup-save(1), git-show(1) BUP
Part of the bup(1) suite. AUTHORS
Avery Pennarun <>. Bup unknown- bup-ls(1)

Check Out this Related Man Page

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

bup-restore - extract files from a backup set SYNOPSIS
bup restore [--outdir=outdir] [-v] [-q] DESCRIPTION
bup restore extracts files from a backup set (created with bup-save(1)) to the local filesystem. The specified paths are of the form /branch/revision/path/to/file. The components of the path are as follows: branch the name of the backup set to restore from; this corresponds to the --name (-n) option to bup save. revision the revision of the backup set to restore. The revision latest is always the most recent backup on the given branch. You can dis- cover other revisions using bup ls /branch. /path/to/file the original absolute filesystem path to the file you want to restore. For example, /etc/passwd. Note: if the /path/to/file is a directory, bup restore will restore that directory as well as recursively restoring all its contents. If /path/to/file is a directory ending in a slash (ie. /path/to/dir/), bup restore will restore the children of that directory directly to the current directory (or the --outdir). If the directory does not end in a slash, the children will be restored to a subdirectory of the current directory. See the EXAMPLES section to see how this works. OPTIONS
-C, --outdir=outdir create and change to directory outdir before extracting the files. -v, --verbose increase log output. Given once, prints every directory as it is restored; given twice, prints every file and directory. -q, --quiet don't show the progress meter. Normally, is stderr is a tty, a progress display is printed that shows the total number of files restored. EXAMPLE
Create a simple test backup set: $ bup index -u /etc $ bup save -n mybackup /etc/passwd /etc/profile Restore just one file: $ bup restore /mybackup/latest/etc/passwd Restoring: 1, done. $ ls -l passwd -rw-r--r-- 1 apenwarr apenwarr 1478 2010-09-08 03:06 passwd Restore the whole directory (no trailing slash): $ bup restore -C test1 /mybackup/latest/etc Restoring: 3, done. $ find test1 test1 test1/etc test1/etc/passwd test1/etc/profile Restore the whole directory (trailing slash): $ bup restore -C test2 /mybackup/latest/etc/ Restoring: 2, done. $ find test2 test2 test2/passwd test2/profile SEE ALSO
bup-save(1), bup-ftp(1), bup-fuse(1), bup-web(1) BUP
Part of the bup(1) suite. AUTHORS
Avery Pennarun <>. Bup unknown- bup-restore(1)
Man Page

Featured Tech Videos