Scroll to navigation

TAHOE(1) User Commands TAHOE(1)

NAME

tahoe - Secure distributed filesystem.

SYNOPSIS

tahoe COMMAND [OPTION]... [PARAMETER]...

GENERAL OPTIONS

Operate silently.
Display version numbers.
Display version numbers and paths to their locations.
Specify which Tahoe node directory should be used. (default for most commands: `$HOME/.tahoe')

COMMANDS

The tahoe runner can be used for various tasks depending on the command used.

ADMINISTRATION

tahoe COMMAND [OPTION]... [NODEDIR]

COMMANDS

Create a node that acts as a client, server or both.
Create a client node (with storage initially disabled).
Create an introducer node.
Create a stats-gatherer service.

OPTIONS

Same as —node-directory.
Specify which Tahoe node directory should be used. (default for create-node and create-client: `$HOME/.tahoe/').
Specify the nickname for this node (create-node and create-client only).
Specify the introducer FURL to use (create-node and create-client only).
Specify which TCP port to run the HTTP interface on. Use `none' to disable. Default: `tcp:3456:interface=127.0.0.1' (create-node and create-client only).
Do not offer storage service to other nodes (create-node only).

CONTROLLING NODES

tahoe COMMAND [OPTION]... [NODEDIR]

COMMANDS

Start a node (of any type).
Stop a node.
Restart a node.
Run a node synchronously.

OPTIONS

Run under the Python profiler, putting results in `profiling_results.prof' (use with start or restart only).
Tell the node to log to syslog, not a file (use with start or restart only).
Same as —node-directory.
Specify which Tahoe node directory should be used (default for commands other than run: `$HOME/.tahoe/').
Display help and exit

USING THE FILESYSTEM

Create a new directory.
Add a new alias cap.
Create a new alias cap.
List all alias caps.
List a directory.
Retrieve a file from the grid.
Upload a file into the grid.
Copy one or more files or directories.
Unlink a file or directory on the grid.
Unlink a file or directory on the grid (same as unlink).
Move a file within the grid.
Make an additional link to an existing file or directory.
Make target dir look like local dir.
Open a web browser to a grid file or directory.
List all files/directories in a subtree.
Print statistics about all files/directories in a subtree.
Check a single file or directory.
Check all files/directories reachable from a starting point

OPTIONS

Please run `tahoe COMMAND --help' for more details on each command.

DEBUGGING

tahoe debug SUBCOMMAND [OPTION]... [PARAMETER]...

SUBCOMMANDS

Unpack and display the contents of a share.
Unpack a read-cap or write-cap.
Locate sharefiles in node directories.
Describe all shares in node dirs.
Corrupt a share by flipping a bit.

Please run e.g. `tahoe debug dump-share --help' for more details on each subcommand.

AUTHORS

Tahoe-LAFS has been written by Brian Warner, Zooko Wilcox-O'Hearn and dozens of others. This manpage was originally written by bertagaz.

REPORTING BUGS

Please see <https://tahoe-lafs.org/trac/tahoe-lafs/wiki/HowToReportABug>.

For known security issues see <https://tahoe-lafs.org/trac/tahoe-lafs/browser/docs/known_issues.rst>.

Tahoe-LAFS home page: <https://tahoe-lafs.org/>

tahoe-dev mailing list: <https://tahoe-lafs.org/cgi-bin/mailman/listinfo/tahoe-dev>

COPYRIGHT

Copyright @ 2006–2013 The Tahoe-LAFS Software Foundation

July 2011 Tahoe-LAFS — tahoe command