Split [[hurd/network]] into [[hurd/translator/pfinet]] and the new [[hurd/settrans]].

4 files changed, 64 insertions, 55 deletions

diff --git a/hurd/network.mdwn b/hurd/network.mdwn
deleted file mode 100644
index 4abb75d4..00000000
--- a/hurd/network.mdwn
+++ /dev/null
@@ -1,54 +0,0 @@
-[[meta copyright="Copyright © 2002, 2004, 2005, 2007, 2008 Free Software
-Foundation, Inc."]]
-
-[[meta license="""[[toggle id="license" text="GFDL 1.2+"]][[toggleable
-id="license" text="Permission is granted to copy, distribute and/or modify this
-document under the terms of the GNU Free Documentation License, Version 1.2 or
-any later version published by the Free Software Foundation; with no Invariant
-Sections, no Front-Cover Texts, and no Back-Cover Texts.  A copy of the license
-is included in the section entitled
-[[GNU_Free_Documentation_License|/fdl]]."]]"""]]
-
-How to setup networking in the Hurd.
-
-First, make sure that Mach recognizes your hardware.  <!-- If it doesn't, you can
-to recompile it in most cases. [ADD LINK TO INFO ON THIS] -->
-
-# The `pfinet` Translator
-
-To configure the network, the `pfinet` (*Protocol Family Internet*) translator
-must be configured.  This is done using the `settrans` command to attach a
-translator to a given file system node.  When programs access the node by, for
-example, sending an RPC, the Hurd will transparently start the server to handle
-the request.
-
-    # settrans -fgap /servers/socket/2 /hurd/pfinet -i eth0 \
-               -a 192.168.0.50 -g 192.168.0.1 -m 255.255.255.0
-
-Here, `settrans` is passed several options:
-
-* `fg`, force any existing translator to go away.
-* `ap`, make both active and passive translators.
-
-The active translator means that the operating system both starts the
-translator immediately and passinve means that the settings are saved in the
-file system node.  The former also means that any error messages are sent to
-`stderr`.
-
-The argument `/server/socket/2` is the node that the translator is to be
-attached to.  This is followed by the translator program to run and any
-arguments to give it.
-
-`-a`, `-g` and `-m` are, quite obviously, the IP address, the gateway and
-netmask.
-
-Help on settrans can be obtained by passing it the `--help` option.  Help on a
-specific translator can be gotten by invoking it from the command line with the
-same argument, e.g.:
-
-    # /hurd/pfinet --help
-
-As there can be a lot of output, consider piping this through a pager.
-
-Finally copy over your `/etc/resolv.conf` from GNU/Linux to allow your DNS to
-resolve correctly.
diff --git a/hurd/settrans.mdwn b/hurd/settrans.mdwn
new file mode 100644
index 00000000..e4383961
--- /dev/null
+++ b/hurd/settrans.mdwn
@@ -0,0 +1,37 @@
+[[meta copyright="Copyright © 2002, 2004, 2005, 2007, 2008 Free Software
+Foundation, Inc."]]
+
+[[meta license="""[[toggle id="license" text="GFDL 1.2+"]][[toggleable
+id="license" text="Permission is granted to copy, distribute and/or modify this
+document under the terms of the GNU Free Documentation License, Version 1.2 or
+any later version published by the Free Software Foundation; with no Invariant
+Sections, no Front-Cover Texts, and no Back-Cover Texts.  A copy of the license
+is included in the section entitled
+[[GNU_Free_Documentation_License|/fdl]]."]]"""]]
+
+The `settrans` command is used to attach a [[translator]] (server) to a given
+[[file_system_node|virtual_file_system]].
+
+`settrans` is commonly used like this:
+
+    $ settrans -fgap *NODE* *TRANSLATOR SETTING*
+
+  * `fg`, **f**orce any existing translator to **g**o away from that node.
+  * `ap`, start an ***a**ctive translator*, and also establish a ***p**assive
+    translator* setting.
+
+*Active translator* means that the operating system starts the translator
+immediately and *passive translator* in turn means that the settings are
+instead saved in the file system node, and then, when programs access the node
+by, for example, sending an [[RPC]], the Hurd will transparently start the
+server to handle the request.
+
+
+Help on settrans can be obtained by passing it the `--help` option.
+
+Likewise, help on a specific translator can be gotten by invoking it from the
+command line with the same argument, e.g.:
+
+    $ /hurd/pfinet --help
+
+As there can be a lot of output, consider piping this through a pager.
diff --git a/hurd/translator.mdwn b/hurd/translator.mdwn
index 3f763013..4f65bb41 100644
--- a/hurd/translator.mdwn
+++ b/hurd/translator.mdwn
@@ -17,6 +17,9 @@ and [[pfinet]]) and thus translates object invocations
 into calls appropriate for the backing store
 (e.g., ext2 file system, nfs server, etc.).
 
+A translator is usually registered with a specific file system node by using
+the [[`settrans`|settrans]] command.
+
 Translators do not require any special privilege
 to run.  The privilege they require is simply
 that to access the indiviudal resources they use.
diff --git a/hurd/translator/pfinet.mdwn b/hurd/translator/pfinet.mdwn
index acd7b855..41bc87c2 100644
--- a/hurd/translator/pfinet.mdwn
+++ b/hurd/translator/pfinet.mdwn
@@ -1,4 +1,5 @@
-[[meta copyright="Copyright © 2007, 2008 Free Software Foundation, Inc."]]
+[[meta copyright="Copyright © 2002, 2004, 2005, 2007, 2008 Free Software
+Foundation, Inc."]]
 
 [[meta license="""[[toggle id="license" text="GFDL 1.2+"]][[toggleable
 id="license" text="Permission is granted to copy, distribute and/or modify this
@@ -8,4 +9,26 @@ Sections, no Front-Cover Texts, and no Back-Cover Texts.  A copy of the license
 is included in the section entitled
 [[GNU_Free_Documentation_License|/fdl]]."]]"""]]
 
+To configure Internet connectivity, the `pfinet` (*Protocol Family Internet*)
+[[translator]] must be configured.  This is done using the
+[[`settrans`|settrans]] command, for example like this:
+
+    # settrans -fgap /servers/socket/2 /hurd/pfinet ↩
+        -i eth0 -a 192.168.0.50 -g 192.168.0.1 -m 255.255.255.0
+
+The argument `/server/socket/2` is the node that the translator is to be
+attached to.  This is followed by the translator program to run and any
+arguments to give it.
+
+There, `-i`, `-a`, `-g` and `-m` are, quite obviously, the (Mach) device to
+use, the IP address, the gateway and netmask.
+
+---
+
+To make DNS lookups work, you'll also have to properly configure the
+`/etc/resolv.conf` file, for example by copying it over from your GNU/Linux
+installation.
+
+---
+
 Notes about [[IPv6]].