/usr/share/doc/bup/bup-ls.html is in bup-doc 0.29-3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 | <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta http-equiv="Content-Style-Type" content="text/css" />
<meta name="generator" content="pandoc" />
<meta name="author" content="Avery Pennarun apenwarr@gmail.com" />
<meta name="date" content="2017-04-01" />
<title>bup-ls(1) Bup debian/0.29-3</title>
<style type="text/css">code{white-space: pre;}</style>
</head>
<body>
<div id="header">
<h1 class="title">bup-ls(1) Bup debian/0.29-3</h1>
<h2 class="author">Avery Pennarun <a href="mailto:apenwarr@gmail.com">apenwarr@gmail.com</a></h2>
<h3 class="date">2017-04-01</h3>
</div>
<h1 id="name">NAME</h1>
<p>bup-ls - list the contents of a bup repository</p>
<h1 id="synopsis">SYNOPSIS</h1>
<p>bup ls [OPTION...] <paths...></p>
<h1 id="description">DESCRIPTION</h1>
<p><code>bup ls</code> lists files and directories in your bup repository using the same directory hierarchy as they would have with <code>bup-fuse</code>(1).</p>
<p>The top level directory contains the branch (corresponding to the <code>-n</code> option in <code>bup save</code>), the next level is the date of the backup, and subsequent levels correspond to files in the backup.</p>
<p>When <code>bup ls</code> is asked to output on a tty, and <code>-l</code> is not specified, it formats the output in columns so it can list as much as possible in as few lines as possible. However, when <code>-l</code> is specified or bup 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 print one file name per line. This makes the listing easier to parse with external tools.</p>
<p>Note that <code>bup ls</code> doesn't show hidden files by default and one needs to use the <code>-a</code> option to show them. Files are hidden when their name begins with a dot. For example, on the topmost level, the special directories named <code>.commit</code> and <code>.tag</code> are hidden directories.</p>
<p>Once you have identified the file you want using <code>bup ls</code>, you can view its contents using <code>bup join</code> or <code>git show</code>.</p>
<h1 id="options">OPTIONS</h1>
<dl>
<dt>-s, --hash</dt>
<dd>show hash for each file/directory.
</dd>
<dt>-a, --all</dt>
<dd>show hidden files.
</dd>
<dt>-A, --almost-all</dt>
<dd>show hidden files, except "." and "..".
</dd>
<dt>-d, --directory</dt>
<dd>show information about directories themselves, rather than their contents, and don't follow symlinks.
</dd>
<dt>-l</dt>
<dd>provide a detailed, long listing for each item.
</dd>
<dt>-F, --classify</dt>
<dd>append type indicator: dir/, symlink@, fifo|, socket=, and executable*.
</dd>
<dt>--file-type</dt>
<dd>append type indicator: dir/, symlink@, fifo|, socket=.
</dd>
<dt>--human-readable</dt>
<dd>print human readable file sizes (i.e. 3.9K, 4.7M).
</dd>
<dt>--numeric-ids</dt>
<dd>display numeric IDs (user, group, etc.) rather than names.
</dd>
</dl>
<h1 id="examples">EXAMPLES</h1>
<pre><code>bup ls /myserver/latest/etc/profile
bup ls -a /</code></pre>
<h1 id="see-also">SEE ALSO</h1>
<p><code>bup-join</code>(1), <code>bup-fuse</code>(1), <code>bup-ftp</code>(1), <code>bup-save</code>(1), <code>git-show</code>(1)</p>
<h1 id="bup">BUP</h1>
<p>Part of the <code>bup</code>(1) suite.</p>
</body>
</html>
|