docs/configuration.rst: add a "Frontend Configuration" section
authorBrian Warner <warner@lothar.com>
Tue, 22 Feb 2011 01:43:23 +0000 (17:43 -0800)
committerBrian Warner <warner@lothar.com>
Tue, 22 Feb 2011 01:43:23 +0000 (17:43 -0800)
this points to docs/frontends/*.rst, which were previously underlinked

docs/configuration.rst

index 1bb2d3338c39da9acd09c14470b0226a910de947..1d1a1cd6384adb2d545cb89cd53ea0af9d5c1844 100644 (file)
@@ -5,12 +5,13 @@ Configuring a Tahoe-LAFS node
 1.  `Overall Node Configuration`_
 2.  `Client Configuration`_
 3.  `Storage Server Configuration`_
-4.  `Running A Helper`_
-5.  `Running An Introducer`_
-6.  `Other Files in BASEDIR`_
-7.  `Other files`_
-8.  `Backwards Compatibility Files`_
-9.  `Example`_
+4.  `Frontend Configuration`_
+5.  `Running A Helper`_
+6.  `Running An Introducer`_
+7.  `Other Files in BASEDIR`_
+8.  `Other files`_
+9.  `Backwards Compatibility Files`_
+10. `Example`_
 
 A Tahoe-LAFS node is configured by writing to files in its base directory. These
 files are read by the node when it starts, so each time you change them, you
@@ -320,6 +321,39 @@ Client Configuration
     (Mutable files use a different share placement algorithm that does not
     currently consider this parameter.)
 
+Frontend Configuration
+======================
+
+The Tahoe client process can run a variety of frontend file-access protocols.
+You will use these to create and retrieve files from the virtual filesystem.
+Configuration details for each are documented in the following
+protocol-specific guides:
+
+HTTP
+
+    Tahoe runs a webserver by default on port 3456. This interface provides a
+    human-oriented "WUI", with pages to create, modify, and browse
+    directories and files, as well as a number of pages to check on the
+    status of your Tahoe node. It also provides a machine-oriented "WAPI",
+    with a REST-ful HTTP interface that can be used by other programs
+    (including the CLI tools). Please see `<frontends/webapi.rst>`_ for full
+    details, and the ``web.port`` and ``web.static`` config variables above.
+    The `<frontends/download-status.rst>`_ document also describes a few WUI
+    status pages.
+
+CLI
+
+    The main "bin/tahoe" executable includes subcommands for manipulating the
+    filesystem, uploading/downloading files, and creating/running Tahoe
+    nodes. See `<frontends/CLI.rst>`_ for details.
+
+FTP, SFTP
+
+    Tahoe can also run both FTP and SFTP servers, and map a username/password
+    pair to a top-level Tahoe directory. See `<frontends/FTP-and-SFTP.rst>`_
+    for instructions on configuring these services, and the ``[ftpd]`` and
+    ``[sftpd]`` sections of ``tahoe.cfg``.
+
 
 Storage Server Configuration
 ============================