]> git.rkrishnan.org Git - tahoe-lafs/tahoe-lafs.git/blobdiff - src/allmydata/scripts/cli.py
CLI: make the --mutable-type option value for 'tahoe put' and 'tahoe mkdir' case...
[tahoe-lafs/tahoe-lafs.git] / src / allmydata / scripts / cli.py
index 42388f35913093fda10845af8fc336929e39de2c..970c8c409e80491261f94389f487daf05b98feff 100644 (file)
@@ -1,34 +1,35 @@
-
-import os.path, re, sys
+import os.path, re, fnmatch
 from twisted.python import usage
-from allmydata.scripts.common import BaseOptions, get_aliases
+from allmydata.scripts.common import BaseOptions, get_aliases, get_default_nodedir, DEFAULT_ALIAS
+from allmydata.util.encodingutil import argv_to_unicode, argv_to_abspath, quote_output
+
+NODEURL_RE=re.compile("http(s?)://([^:]*)(:([1-9][0-9]*))?")
 
-NODEURL_RE=re.compile("http://([^:]*)(:([1-9][0-9]*))?")
+_default_nodedir = get_default_nodedir()
 
-class VDriveOptions(BaseOptions, usage.Options):
+class VDriveOptions(BaseOptions):
     optParameters = [
-        ["node-directory", "d", "~/.tahoe",
-         "Look here to find out which Tahoe node should be used for all "
-         "operations. The directory should either contain a full Tahoe node, "
-         "or a file named node.url which points to some other Tahoe node. "
-         "It should also contain a file named private/aliases which contains "
-         "the mapping from alias name to root dirnode URI."
-         ],
+        ["node-directory", "d", None,
+         "Specify which Tahoe node directory should be used. The directory "
+         "should either contain a full Tahoe node, or a file named node.url "
+         "that points to some other Tahoe node. It should also contain a file "
+         "named '" + os.path.join('private', 'aliases') + "' which contains the "
+         "mapping from alias name to root dirnode URI." + (
+            _default_nodedir and (" [default: " + quote_output(_default_nodedir) + "]") or "")],
         ["node-url", "u", None,
-         "URL of the tahoe node to use, a URL like \"http://127.0.0.1:8123\". "
+         "Specify the URL of the Tahoe gateway node, such as 'http://127.0.0.1:3456'. "
          "This overrides the URL found in the --node-directory ."],
         ["dir-cap", None, None,
-         "Which dirnode URI should be used as the 'tahoe' alias."]
+         "Specify which dirnode URI should be used as the 'tahoe' alias."]
         ]
 
     def postOptions(self):
-        # compute a node-url from the existing options, put in self['node-url']
         if self['node-directory']:
-            if sys.platform == 'win32' and self['node-directory'] == '~/.tahoe':
-                from allmydata.windows import registry
-                self['node-directory'] = registry.get_base_dir_path()
-            else:
-                self['node-directory'] = os.path.expanduser(self['node-directory'])
+            self['node-directory'] = argv_to_abspath(self['node-directory'])
+        else:
+            self['node-directory'] = _default_nodedir
+
+        # compute a node-url from the existing options, put in self['node-url']
         if self['node-url']:
             if (not isinstance(self['node-url'], basestring)
                 or not NODEURL_RE.match(self['node-url'])):
@@ -39,42 +40,99 @@ class VDriveOptions(BaseOptions, usage.Options):
         else:
             node_url_file = os.path.join(self['node-directory'], "node.url")
             self['node-url'] = open(node_url_file, "r").read().strip()
+        if self['node-url'][-1] != "/":
+            self['node-url'] += "/"
 
         aliases = get_aliases(self['node-directory'])
         if self['dir-cap']:
-            aliases["tahoe"] = self['dir-cap']
+            aliases[DEFAULT_ALIAS] = self['dir-cap']
         self.aliases = aliases # maps alias name to dircap
 
 
 class MakeDirectoryOptions(VDriveOptions):
+    optParameters = [
+        ("mutable-type", None, None, "Create a mutable directory in the given format. "
+                                     "Valid formats are SDMF and MDMF, case-insensitive."),
+        ]
+
     def parseArgs(self, where=""):
-        self.where = where
+        self.where = argv_to_unicode(where)
+
+        if self['mutable-type']:
+            if self['mutable-type'].lower() not in ("sdmf", "mdmf"):
+                raise usage.UsageError("%s is an invalid format" % self['mutable-type'])
+            self['mutable-type'] = self['mutable-type'].lower()
+
+    def getSynopsis(self):
+        return "Usage:  %s mkdir [options] [REMOTE_DIR]" % (self.command_name,)
+
     longdesc = """Create a new directory, either unlinked or as a subdirectory."""
 
 class AddAliasOptions(VDriveOptions):
     def parseArgs(self, alias, cap):
-        self.alias = alias
+        self.alias = argv_to_unicode(alias)
+        if self.alias.endswith(u':'):
+            self.alias = self.alias[:-1]
         self.cap = cap
 
+    def getSynopsis(self):
+        return "Usage:  %s add-alias [options] ALIAS[:] DIRCAP" % (self.command_name,)
+
+    longdesc = """Add a new alias for an existing directory."""
+
 class CreateAliasOptions(VDriveOptions):
     def parseArgs(self, alias):
-        self.alias = alias
+        self.alias = argv_to_unicode(alias)
+        if self.alias.endswith(u':'):
+            self.alias = self.alias[:-1]
 
-class ListAliasOptions(VDriveOptions):
-    pass
+    def getSynopsis(self):
+        return "Usage:  %s create-alias [options] ALIAS[:]" % (self.command_name,)
+
+    longdesc = """Create a new directory and add an alias for it."""
+
+class ListAliasesOptions(VDriveOptions):
+    def getSynopsis(self):
+        return "Usage:  %s list-aliases [options]" % (self.command_name,)
+
+    longdesc = """Display a table of all configured aliases."""
 
 class ListOptions(VDriveOptions):
     optFlags = [
-        ("long", "l", "Use long format: show file sizes, and timestamps"),
-        ("uri", "u", "Show file/directory URIs"),
-        ("readonly-uri", None, "Show readonly file/directory URIs"),
-        ("classify", "F", "Append '/' to directory names, and '*' to mutable"),
-        ("json", None, "Show the raw JSON output"),
+        ("long", "l", "Use long format: show file sizes, and timestamps."),
+        ("uri", "u", "Show file/directory URIs."),
+        ("readonly-uri", None, "Show read-only file/directory URIs."),
+        ("classify", "F", "Append '/' to directory names, and '*' to mutable."),
+        ("json", None, "Show the raw JSON output."),
         ]
     def parseArgs(self, where=""):
-        self.where = where
+        self.where = argv_to_unicode(where)
+
+    longdesc = """
+    List the contents of some portion of the grid.
+
+    When the -l or --long option is used, each line is shown in the
+    following format:
+
+    drwx <size> <date/time> <name in this directory>
+
+    where each of the letters on the left may be replaced by '-'.
+    If 'd' is present, it indicates that the object is a directory.
+    If the 'd' is replaced by a '?', the object type is unknown.
+    'rwx' is a Unix-like permissions mask: if the mask includes 'w',
+    then the object is writeable through its link in this directory
+    (note that the link might be replaceable even if the object is
+    not writeable through the current link).
+    The 'x' is a legacy of Unix filesystems. In Tahoe it is used
+    only to indicate that the contents of a directory can be listed.
+
+    Directories have no size, so their size field is shown as '-'.
+    Otherwise the size of the file, when known, is given in bytes.
+    The size of mutable files or unknown objects is shown as '?'.
 
-    longdesc = """List the contents of some portion of the virtual drive."""
+    The date/time shows when this link in the Tahoe filesystem was
+    last modified.
+    """
 
 class GetOptions(VDriveOptions):
     def parseArgs(self, arg1, arg2=None):
@@ -83,17 +141,23 @@ class GetOptions(VDriveOptions):
         # tahoe get FOO bar              # write to local file
         # tahoe get tahoe:FOO bar        # same
 
-        self.from_file = arg1
-        self.to_file = arg2
+        self.from_file = argv_to_unicode(arg1)
+
+        if arg2:
+            self.to_file = argv_to_unicode(arg2)
+        else:
+            self.to_file = None
+
         if self.to_file == "-":
             self.to_file = None
 
     def getSynopsis(self):
-        return "%s get VDRIVE_FILE LOCAL_FILE" % (os.path.basename(sys.argv[0]),)
+        return "Usage:  %s get [options] REMOTE_FILE LOCAL_FILE" % (self.command_name,)
 
-    longdesc = """Retrieve a file from the virtual drive and write it to the
-    local filesystem. If LOCAL_FILE is omitted or '-', the contents of the file
-    will be written to stdout."""
+    longdesc = """
+    Retrieve a file from the grid and write it to the local filesystem. If
+    LOCAL_FILE is omitted or '-', the contents of the file will be written to
+    stdout."""
 
     def getUsage(self, width=None):
         t = VDriveOptions.getUsage(self, width)
@@ -110,43 +174,55 @@ class PutOptions(VDriveOptions):
     optFlags = [
         ("mutable", "m", "Create a mutable file instead of an immutable one."),
         ]
+    optParameters = [
+        ("mutable-type", None, None, "Create a mutable file in the given format (implies --mutable). "
+                                     "Valid formats are SDMF and MDMF, case-insensitive."),
+        ]
 
     def parseArgs(self, arg1=None, arg2=None):
-        # cat FILE > tahoe put           # create unlinked file from stdin
-        # cat FILE > tahoe put FOO       # create tahoe:FOO from stdin
-        # cat FILE > tahoe put tahoe:FOO # same
-        # tahoe put bar FOO              # copy local 'bar' to tahoe:FOO
-        # tahoe put bar tahoe:FOO        # same
+        # see Examples below
 
         if arg1 is not None and arg2 is not None:
-            self.from_file = arg1
-            self.to_file = arg2
+            self.from_file = argv_to_unicode(arg1)
+            self.to_file =  argv_to_unicode(arg2)
         elif arg1 is not None and arg2 is None:
-            self.from_file = None
-            self.to_file = arg1
+            self.from_file = argv_to_unicode(arg1) # might be "-"
+            self.to_file = None
         else:
-            self.from_file = arg1
-            self.to_file = arg2
-        if self.from_file == "-":
             self.from_file = None
+            self.to_file = None
+        if self.from_file == u"-":
+            self.from_file = None
+
+        if self['mutable-type']:
+            if self['mutable-type'].lower() not in ("sdmf", "mdmf"):
+                raise usage.UsageError("%s is an invalid format" % self['mutable-type'])
+            self['mutable-type'] = self['mutable-type'].lower()
+
+        if self['mutable-type']:
+            self['mutable'] = True
 
     def getSynopsis(self):
-        return "%s put LOCAL_FILE VDRIVE_FILE" % (os.path.basename(sys.argv[0]),)
+        return "Usage:  %s put [options] LOCAL_FILE REMOTE_FILE" % (self.command_name,)
 
-    longdesc = """Put a file into the virtual drive (copying the file's
-    contents from the local filesystem). If LOCAL_FILE is missing or '-',
-    data will be copied from stdin. VDRIVE_FILE is assumed to start with
-    tahoe: unless otherwise specified."""
+    longdesc = """
+    Put a file into the grid, copying its contents from the local filesystem.
+    If REMOTE_FILE is missing, upload the file but do not link it into a
+    directory; also print the new filecap to stdout. If LOCAL_FILE is missing
+    or '-', data will be copied from stdin. REMOTE_FILE is assumed to start
+    with tahoe: unless otherwise specified."""
 
     def getUsage(self, width=None):
         t = VDriveOptions.getUsage(self, width)
         t += """
 Examples:
- % cat FILE > tahoe put           # create unlinked file from stdin
- % cat FILE > tahoe put FOO       # create tahoe:FOO from stdin
- % cat FILE > tahoe put tahoe:FOO # same
- % tahoe put bar FOO              # copy local 'bar' to tahoe:FOO
- % tahoe put bar tahoe:FOO        # same
+ % cat FILE | tahoe put                # create unlinked file from stdin
+ % cat FILE | tahoe put -              # same
+ % tahoe put bar                       # create unlinked file from local 'bar'
+ % cat FILE | tahoe put - FOO          # create tahoe:FOO from stdin
+ % tahoe put bar FOO                   # copy local 'bar' to tahoe:FOO
+ % tahoe put bar tahoe:FOO             # same
+ % tahoe put bar MUTABLE-FILE-WRITECAP # modify the mutable file in-place
 """
         return t
 
@@ -154,59 +230,278 @@ class CpOptions(VDriveOptions):
     optFlags = [
         ("recursive", "r", "Copy source directory recursively."),
         ("verbose", "v", "Be noisy about what is happening."),
+        ("caps-only", None,
+         "When copying to local files, write out filecaps instead of actual "
+         "data (only useful for debugging and tree-comparison purposes)."),
         ]
+
     def parseArgs(self, *args):
         if len(args) < 2:
             raise usage.UsageError("cp requires at least two arguments")
-        self.sources = args[:-1]
-        self.destination = args[-1]
+        self.sources = map(argv_to_unicode, args[:-1])
+        self.destination = argv_to_unicode(args[-1])
+
+    def getSynopsis(self):
+        return "Usage: %s cp [options] FROM.. TO" % (self.command_name,)
+
+    longdesc = """
+    Use 'tahoe cp' to copy files between a local filesystem and a Tahoe grid.
+    Any FROM/TO arguments that begin with an alias indicate Tahoe-side
+    files or non-file arguments. Directories will be copied recursively.
+    New Tahoe-side directories will be created when necessary. Assuming that
+    you have previously set up an alias 'home' with 'tahoe create-alias home',
+    here are some examples:
+
+    tahoe cp ~/foo.txt home:  # creates tahoe-side home:foo.txt
+
+    tahoe cp ~/foo.txt /tmp/bar.txt home:  # copies two files to home:
+
+    tahoe cp ~/Pictures home:stuff/my-pictures  # copies directory recursively
+
+    You can also use a dircap as either FROM or TO target:
+
+    tahoe cp URI:DIR2-RO:ixqhc4kdbjxc7o65xjnveoewym:5x6lwoxghrd5rxhwunzavft2qygfkt27oj3fbxlq4c6p45z5uneq/blog.html ./   # copy Zooko's wiki page to a local file
 
-class RmOptions(VDriveOptions):
+    This command still has some limitations: symlinks and special files
+    (device nodes, named pipes) are not handled very well. Arguments should
+    probably not have trailing slashes. 'tahoe cp' does not behave as much
+    like /bin/cp as you would wish, especially with respect to trailing
+    slashes.
+    """
+
+class UnlinkOptions(VDriveOptions):
     def parseArgs(self, where):
-        self.where = where
+        self.where = argv_to_unicode(where)
+
+    def getSynopsis(self):
+        return "Usage:  %s unlink [options] REMOTE_FILE" % (self.command_name,)
 
+class RmOptions(UnlinkOptions):
     def getSynopsis(self):
-        return "%s rm VE_FILE" % (os.path.basename(sys.argv[0]),)
+        return "Usage:  %s rm [options] REMOTE_FILE" % (self.command_name,)
 
 class MvOptions(VDriveOptions):
     def parseArgs(self, frompath, topath):
-        self.from_file = frompath
-        self.to_file = topath
+        self.from_file = argv_to_unicode(frompath)
+        self.to_file = argv_to_unicode(topath)
 
     def getSynopsis(self):
-        return "%s mv FROM TO" % (os.path.basename(sys.argv[0]),)
+        return "Usage:  %s mv [options] FROM TO" % (self.command_name,)
+
+    longdesc = """
+    Use 'tahoe mv' to move files that are already on the grid elsewhere on
+    the grid, e.g., 'tahoe mv alias:some_file alias:new_file'.
+
+    If moving a remote file into a remote directory, you'll need to append a
+    '/' to the name of the remote directory, e.g., 'tahoe mv tahoe:file1
+    tahoe:dir/', not 'tahoe mv tahoe:file1 tahoe:dir'.
+
+    Note that it is not possible to use this command to move local files to
+    the grid -- use 'tahoe cp' for that.
+    """
 
 class LnOptions(VDriveOptions):
     def parseArgs(self, frompath, topath):
-        self.from_file = frompath
-        self.to_file = topath
+        self.from_file = argv_to_unicode(frompath)
+        self.to_file = argv_to_unicode(topath)
 
     def getSynopsis(self):
-        return "%s ln FROM TO" % (os.path.basename(sys.argv[0]),)
+        return "Usage:  %s ln [options] FROM_LINK TO_LINK" % (self.command_name,)
+
+    longdesc = """
+    Use 'tahoe ln' to duplicate a link (directory entry) already on the grid
+    to elsewhere on the grid. For example 'tahoe ln alias:some_file
+    alias:new_file'. causes 'alias:new_file' to point to the same object that
+    'alias:some_file' points to.
+
+    (The argument order is the same as Unix ln. To remember the order, you
+    can think of this command as copying a link, rather than copying a file
+    as 'tahoe cp' does. Then the argument order is consistent with that of
+    'tahoe cp'.)
+
+    When linking a remote file into a remote directory, you'll need to append
+    a '/' to the name of the remote directory, e.g. 'tahoe ln tahoe:file1
+    tahoe:dir/' (which is shorthand for 'tahoe ln tahoe:file1
+    tahoe:dir/file1'). If you forget the '/', e.g. 'tahoe ln tahoe:file1
+    tahoe:dir', the 'ln' command will refuse to overwrite the 'tahoe:dir'
+    directory, and will exit with an error.
+
+    Note that it is not possible to use this command to create links between
+    local and remote files.
+    """
+
+class BackupConfigurationError(Exception):
+    pass
+
+class BackupOptions(VDriveOptions):
+    optFlags = [
+        ("verbose", "v", "Be noisy about what is happening."),
+        ("ignore-timestamps", None, "Do not use backupdb timestamps to decide whether a local file is unchanged."),
+        ]
+
+    vcs_patterns = ('CVS', 'RCS', 'SCCS', '.git', '.gitignore', '.cvsignore',
+                    '.svn', '.arch-ids','{arch}', '=RELEASE-ID',
+                    '=meta-update', '=update', '.bzr', '.bzrignore',
+                    '.bzrtags', '.hg', '.hgignore', '_darcs')
+
+    def __init__(self):
+        super(BackupOptions, self).__init__()
+        self['exclude'] = set()
+
+    def parseArgs(self, localdir, topath):
+        self.from_dir = argv_to_unicode(localdir)
+        self.to_dir = argv_to_unicode(topath)
+
+    def getSynopsis(self):
+        return "Usage:  %s backup [options] FROM ALIAS:TO" % (self.command_name,)
+
+    def opt_exclude(self, pattern):
+        """Ignore files matching a glob pattern. You may give multiple
+        '--exclude' options."""
+        g = argv_to_unicode(pattern).strip()
+        if g:
+            exclude = self['exclude']
+            exclude.add(g)
+
+    def opt_exclude_from(self, filepath):
+        """Ignore file matching glob patterns listed in file, one per
+        line. The file is assumed to be in the argv encoding."""
+        abs_filepath = argv_to_abspath(filepath)
+        try:
+            exclude_file = file(abs_filepath)
+        except:
+            raise BackupConfigurationError('Error opening exclude file %s.' % quote_output(abs_filepath))
+        try:
+            for line in exclude_file:
+                self.opt_exclude(line)
+        finally:
+            exclude_file.close()
+
+    def opt_exclude_vcs(self):
+        """Exclude files and directories used by following version control
+        systems: CVS, RCS, SCCS, Git, SVN, Arch, Bazaar(bzr), Mercurial,
+        Darcs."""
+        for pattern in self.vcs_patterns:
+            self.opt_exclude(pattern)
+
+    def filter_listdir(self, listdir):
+        """Yields non-excluded childpaths in path."""
+        exclude = self['exclude']
+        exclude_regexps = [re.compile(fnmatch.translate(pat)) for pat in exclude]
+        for filename in listdir:
+            for regexp in exclude_regexps:
+                if regexp.match(filename):
+                    break
+            else:
+                yield filename
+
+    longdesc = """
+    Add a versioned backup of the local FROM directory to a timestamped
+    subdirectory of the TO/Archives directory on the grid, sharing as many
+    files and directories as possible with earlier backups. Create TO/Latest
+    as a reference to the latest backup. Behaves somewhat like 'rsync -a
+    --link-dest=TO/Archives/(previous) FROM TO/Archives/(new); ln -sf
+    TO/Archives/(new) TO/Latest'."""
 
 class WebopenOptions(VDriveOptions):
-    def parseArgs(self, vdrive_pathname=""):
-        self['vdrive_pathname'] = vdrive_pathname
+    optFlags = [
+        ("info", "i", "Open the t=info page for the file"),
+        ]
+    def parseArgs(self, where=''):
+        self.where = argv_to_unicode(where)
+
+    def getSynopsis(self):
+        return "Usage:  %s webopen [options] [ALIAS:PATH]" % (self.command_name,)
 
-    longdesc = """Opens a webbrowser to the contents of some portion of the virtual drive."""
+    longdesc = """Open a web browser to the contents of some file or
+    directory on the grid. When run without arguments, open the Welcome
+    page."""
 
-class ReplOptions(usage.Options):
-    pass
+class ManifestOptions(VDriveOptions):
+    optFlags = [
+        ("storage-index", "s", "Only print storage index strings, not pathname+cap."),
+        ("verify-cap", None, "Only print verifycap, not pathname+cap."),
+        ("repair-cap", None, "Only print repaircap, not pathname+cap."),
+        ("raw", "r", "Display raw JSON data instead of parsed."),
+        ]
+    def parseArgs(self, where=''):
+        self.where = argv_to_unicode(where)
+
+    def getSynopsis(self):
+        return "Usage:  %s manifest [options] [ALIAS:PATH]" % (self.command_name,)
+
+    longdesc = """Print a list of all files and directories reachable from
+    the given starting point."""
+
+class StatsOptions(VDriveOptions):
+    optFlags = [
+        ("raw", "r", "Display raw JSON data instead of parsed"),
+        ]
+    def parseArgs(self, where=''):
+        self.where = argv_to_unicode(where)
+
+    def getSynopsis(self):
+        return "Usage:  %s stats [options] [ALIAS:PATH]" % (self.command_name,)
+
+    longdesc = """Print statistics about of all files and directories
+    reachable from the given starting point."""
+
+class CheckOptions(VDriveOptions):
+    optFlags = [
+        ("raw", None, "Display raw JSON data instead of parsed."),
+        ("verify", None, "Verify all hashes, instead of merely querying share presence."),
+        ("repair", None, "Automatically repair any problems found."),
+        ("add-lease", None, "Add/renew lease on all shares."),
+        ]
+    def parseArgs(self, where=''):
+        self.where = argv_to_unicode(where)
+
+    def getSynopsis(self):
+        return "Usage:  %s check [options] [ALIAS:PATH]" % (self.command_name,)
+
+    longdesc = """
+    Check a single file or directory: count how many shares are available and
+    verify their hashes. Optionally repair the file if any problems were
+    found."""
+
+class DeepCheckOptions(VDriveOptions):
+    optFlags = [
+        ("raw", None, "Display raw JSON data instead of parsed."),
+        ("verify", None, "Verify all hashes, instead of merely querying share presence."),
+        ("repair", None, "Automatically repair any problems found."),
+        ("add-lease", None, "Add/renew lease on all shares."),
+        ("verbose", "v", "Be noisy about what is happening."),
+        ]
+    def parseArgs(self, where=''):
+        self.where = argv_to_unicode(where)
+
+    def getSynopsis(self):
+        return "Usage:  %s deep-check [options] [ALIAS:PATH]" % (self.command_name,)
+
+    longdesc = """
+    Check all files and directories reachable from the given starting point
+    (which must be a directory), like 'tahoe check' but for multiple files.
+    Optionally repair any problems found."""
 
 subCommands = [
-    ["mkdir", None, MakeDirectoryOptions, "Create a new directory"],
-    ["add-alias", None, AddAliasOptions, "Add a new alias cap"],
-    ["create-alias", None, CreateAliasOptions, "Create a new alias cap"],
-    ["list-aliases", None, ListAliasOptions, "List all alias caps"],
-    ["ls", None, ListOptions, "List a directory"],
-    ["get", None, GetOptions, "Retrieve a file from the virtual drive."],
-    ["put", None, PutOptions, "Upload a file into the virtual drive."],
-    ["cp", None, CpOptions, "Copy one or more files."],
-    ["rm", None, RmOptions, "Unlink a file or directory in the virtual drive."],
-    ["mv", None, MvOptions, "Move a file within the virtual drive."],
-    ["ln", None, LnOptions, "Make an additional link to an existing file."],
-    ["webopen", None, WebopenOptions, "Open a webbrowser to the root_dir"],
-    ["repl", None, ReplOptions, "Open a python interpreter"],
+    ["mkdir", None, MakeDirectoryOptions, "Create a new directory."],
+    ["add-alias", None, AddAliasOptions, "Add a new alias cap."],
+    ["create-alias", None, CreateAliasOptions, "Create a new alias cap."],
+    ["list-aliases", None, ListAliasesOptions, "List all alias caps."],
+    ["ls", None, ListOptions, "List a directory."],
+    ["get", None, GetOptions, "Retrieve a file from the grid."],
+    ["put", None, PutOptions, "Upload a file into the grid."],
+    ["cp", None, CpOptions, "Copy one or more files or directories."],
+    ["unlink", None, UnlinkOptions, "Unlink a file or directory on the grid."],
+    ["rm", None, RmOptions, "Unlink a file or directory on the grid (same as unlink)."],
+    ["mv", None, MvOptions, "Move a file within the grid."],
+    ["ln", None, LnOptions, "Make an additional link to an existing file or directory."],
+    ["backup", None, BackupOptions, "Make target dir look like local dir."],
+    ["webopen", None, WebopenOptions, "Open a web browser to a grid file or directory."],
+    ["manifest", None, ManifestOptions, "List all files/directories in a subtree."],
+    ["stats", None, StatsOptions, "Print statistics about all files/directories in a subtree."],
+    ["check", None, CheckOptions, "Check a single file or directory."],
+    ["deep-check", None, DeepCheckOptions, "Check all files/directories reachable from a starting point."],
     ]
 
 def mkdir(options):
@@ -258,11 +553,14 @@ def cp(options):
     rc = tahoe_cp.copy(options)
     return rc
 
-def rm(options):
-    from allmydata.scripts import tahoe_rm
-    rc = tahoe_rm.rm(options)
+def unlink(options, command="unlink"):
+    from allmydata.scripts import tahoe_unlink
+    rc = tahoe_unlink.unlink(options, command=command)
     return rc
 
+def rm(options):
+    return unlink(options, command="rm")
+
 def mv(options):
     from allmydata.scripts import tahoe_mv
     rc = tahoe_mv.mv(options, mode="move")
@@ -273,21 +571,35 @@ def ln(options):
     rc = tahoe_mv.mv(options, mode="link")
     return rc
 
-def webopen(options):
-    import urllib, webbrowser
-    nodeurl = options['node-url']
-    if nodeurl[-1] != "/":
-        nodeurl += "/"
-    root_cap = options.aliases["tahoe"]
-    url = nodeurl + "uri/%s/" % urllib.quote(root_cap)
-    if options['vdrive_pathname']:
-        url += urllib.quote(options['vdrive_pathname'])
-    webbrowser.open(url)
-    return 0
-
-def repl(options):
-    import code
-    return code.interact()
+def backup(options):
+    from allmydata.scripts import tahoe_backup
+    rc = tahoe_backup.backup(options)
+    return rc
+
+def webopen(options, opener=None):
+    from allmydata.scripts import tahoe_webopen
+    rc = tahoe_webopen.webopen(options, opener=opener)
+    return rc
+
+def manifest(options):
+    from allmydata.scripts import tahoe_manifest
+    rc = tahoe_manifest.manifest(options)
+    return rc
+
+def stats(options):
+    from allmydata.scripts import tahoe_manifest
+    rc = tahoe_manifest.stats(options)
+    return rc
+
+def check(options):
+    from allmydata.scripts import tahoe_check
+    rc = tahoe_check.check(options)
+    return rc
+
+def deepcheck(options):
+    from allmydata.scripts import tahoe_check
+    rc = tahoe_check.deepcheck(options)
+    return rc
 
 dispatch = {
     "mkdir": mkdir,
@@ -298,10 +610,14 @@ dispatch = {
     "get": get,
     "put": put,
     "cp": cp,
+    "unlink": unlink,
     "rm": rm,
     "mv": mv,
     "ln": ln,
+    "backup": backup,
     "webopen": webopen,
-    "repl": repl,
+    "manifest": manifest,
+    "stats": stats,
+    "check": check,
+    "deep-check": deepcheck,
     }
-