Ticket #1420: tahoe.1

.TH TAHOE 1 "" "tahoe User Manual"
.SH NAME
.PP
tahoe - Secure distributed filesystem.
.SH SYNOPSIS
.PP
tahoe [general options] [command] [command options]
.SH GENERAL OPTIONS
.TP
.B \f[B]-q,\ --quiet\f[]
Operate silently.
.RS
.RE
.TP
.B \f[B]-V,\ --version\f[]
Display version numbers.
.RS
.RE
.TP
.B \f[B]--version-and-path\f[]
Display version numbers and paths to their locations.
.RS
.RE
.TP
.B \f[B]-d,\ --node-directory\f[]
Specify which Tahoe node directory should be used.
(default for most commands: `$HOME/.tahoe')
.RS
.RE
.SH COMMANDS
.PP
The \f[B]tahoe\f[] runner can be used for various tasks depending
on the command used.
.SS ADMINISTRATION
.PP
tahoe [command] [command options] [NODEDIR]
.RS
.SS COMMANDS
.TP
.B \f[B]create-node\f[]
Create a node that acts as a client, server or both.
.TP
.B \f[B]create-client\f[]
Create a client node (with storage initially disabled).
.TP
.B \f[B]create-introducer\f[]
Create an introducer node.
.TP
.B \f[B]create-key-generator\f[]
Create a key generator service.
.TP
.B \f[B]create-stats-gatherer\f[]
Create a stats-gatherer service.
.SS OPTIONS
.TP
.B \f[B]-C,\ --basedir=\f[]
Same as \[em]node-directory.
.TP
.B \f[B]-d,\ --node-directory=\f[]
Specify which Tahoe node directory should be used.
(default for most commands: \f[B]$HOME/.tahoe/\f[]).
.TP
.B \f[B]-n,\ --nickname=\f[]
Specify the nickname for this node (\f[B]create-node\f[] and
\f[B]create-client\f[] only).
.TP
.B \f[B]-i,\ --introducer=\f[]
Specify the introducer FURL to use (\f[B]create-node\f[] and
\f[B]create-client\f[] only).
.TP
.B \f[B]-p,\ --webport=\f[]
Specify which TCP port to run the HTTP interface on.
Use `none' to disable.
Default: tcp:3456:interface=127.0.0.1 (\f[B]create-node\f[] and
\f[B]create-client\f[] only).
.TP
.B \f[B]--no-storage\f[]
Do not offer storage service to other nodes (\f[B]create-node\f[]
only).
.RE
.SS CONTROLLING NODES
.PP
tahoe [command] [command options] [NODEDIR]
.SS COMMANDS
.TP
.B \f[B]start\f[]
Start a node (of any type).
.RS
.RE
.TP
.B \f[B]stop\f[]
Stop a node.
.RS
.RE
.TP
.B \f[B]restart\f[]
Restart a node.
.RS
.RE
.TP
.B \f[B]run\f[]
Run a node synchronously.
.RS
.RE
.SS OPTIONS
.TP
.B \f[B]-p,\ --profile\f[]
Run under the Python profiler, putting results in
`profiling_results.prof' (use with \f[B]start\f[] or
\f[B]restart\f[] only).
.RS
.RE
.TP
.B \f[B]--syslog\f[]
Tell the node to log to syslog, not a file (use with \f[B]start\f[]
or \f[B]restart\f[] only).
.RS
.RE
.TP
.B \f[B]-C,\ --basedir=\f[]
Same as \[em]node-directory.
.RS
.RE
.TP
.B \f[B]-d,\ --node-directory=\f[]
Specify which Tahoe node directory should be used (default for most
commands: `$HOME/.tahoe/').
.RS
.RE
.TP
.B \f[B]--help\f[]
Display help and exit
.RS
.RE
.SS USING THE FILSYSTEM
.TP
.B \f[B]mkdir\f[]
Create a new directory.
.RS
.RE
.TP
.B \f[B]add-alias\f[]
Add a new alias cap.
.RS
.RE
.TP
.B \f[B]create-alias\f[]
Create a new alias cap.
.RS
.RE
.TP
.B \f[B]list-aliases\f[]
List all alias caps.
.RS
.RE
.TP
.B \f[B]ls\f[]
List a directory.
.RS
.RE
.TP
.B \f[B]get\f[]
Retrieve a file from the grid.
.RS
.RE
.TP
.B \f[B]put\f[]
Upload a file into the grid.
.RS
.RE
.TP
.B \f[B]cp\f[]
Copy one or more files or directories.
.RS
.RE
.TP
.B \f[B]rm\f[]
Unlink a file or directory on the grid.
.RS
.RE
.TP
.B \f[B]unlink\f[]
Unlink a file or directory on the grid (same as \f[B]rm\f[]).
.RS
.RE
.TP
.B \f[B]mv\f[]
Move a file within the grid.
.RS
.RE
.TP
.B \f[B]ln\f[]
Make an additional link to an existing file or directory.
.RS
.RE
.TP
.B \f[B]backup\f[]
Make target dir look like local dir.
.RS
.RE
.TP
.B \f[B]webopen\f[]
Open a web browser to a grid file or directory.
.RS
.RE
.TP
.B \f[B]manifest\f[]
List all files/directories in a subtree.
.RS
.RE
.TP
.B \f[B]stats\f[]
Print statistics about all files/directories in a subtree.
.RS
.RE
.TP
.B \f[B]check\f[]
Check a single file or directory.
.RS
.RE
.TP
.B \f[B]deep-check\f[]
Check all files/directories reachable from a starting point
.RS
.RE
.SS OPTIONS
.PP
Please run `tahoe COMMAND \[em]help' for more details on each
command.
.SS DEBUGGING
.PP
tahoe debug SUBCOMMAND
.SS SUBCOMMANDS
.TP
.B \f[B]dump-share\f[]
Unpack and display the contents of a share.
.RS
.RE
.TP
.B \f[B]dump-cap\f[]
Unpack a read-cap or write-cap.
.RS
.RE
.TP
.B \f[B]find-shares\f[]
Locate sharefiles in node directories.
.RS
.RE
.TP
.B \f[B]catalog-shares\f[]
Describe all shares in node dirs.
.RS
.RE
.TP
.B \f[B]corrupt-share\f[]
Corrupt a share by flipping a bit.
.RS
.RE
.TP
.B \f[B]repl\f[]
Open a Python interpreter.
.RS
.RE
.TP
.B \f[B]trial\f[]
Run tests using Twisted Trial with the right imports.
.RS
.RE
.PP
Please run e.g.\ `tahoe debug dump-share \[em]help' for more
details on each subcommand.
.PP
Another debugging feature is that bin/tahoe allows executing an
arbitrary \[lq]runner\[rq] command (typically an installed Python
script, such as `coverage'), with the Tahoe libraries on the
PYTHONPATH.
The runner command name is prefixed with `\@', and any occurrences
of `\@tahoe' in its arguments are replaced by the full path to the
tahoe script.
.PP
For example, if `coverage' is installed and on the PATH, you can
use:
.PP
\f[CR]
      tahoe\ \@coverage\ run\ --branch\ \@tahoe\ debug\ trial
\f[]
.PP
to get branch coverage for the Tahoe test suite.
Or, to run python with the \[en]3 option that warns about Python 3
incompatibilities:
.PP
\f[CR]
      tahoe\ \@python\ -3\ \@tahoe\ command\ [options]
\f[]
.SH AUTHORS
.PP
Tahoe-lafs has been written by Brian Warner, Zooko Wilcox-O'Hearn
and dozens of others.
This manpage has been written by bertagaz.
.SH COPYRIGHT
.PP
2006\[en]2011 \@ AllMyData, Inc.
.SH AUTHORS
May 10, 2011.