hurd/fsysopts: New page.

8 files changed, 53 insertions, 30 deletions

diff --git a/contributing.mdwn b/contributing.mdwn
index 005662c4..c81766c3 100644
--- a/contributing.mdwn
+++ b/contributing.mdwn
@@ -80,7 +80,7 @@ Here is a list of small hacks, which can serve as entries into the Hurd code for
 people who would like to dive into the code but just lack a "somewhere to begin
 with".
 
-* Some translators do not support fsysopts, such as `remap`.
+* Some translators do not support [[hurd/fsysopts]].
 * Make pfinet OK with the ethernet device going away. This would be a very
 nice feature: being able to just restart the ethernet driver; we've just not
 taken the time to fix it yet, but it shouldn't be very hard. The code begins
diff --git a/hurd/console.mdwn b/hurd/console.mdwn
index 411058c8..c9f47afe 100644
--- a/hurd/console.mdwn
+++ b/hurd/console.mdwn
@@ -216,7 +216,7 @@ Available mouse protocols are:
 
 ### <a name="Setting_up_encoding"> Setting up encoding </a>
 
-The virtual consoles you are now running on are providing an ISO8859-1 environment (also known as latin1), which is good enough for the USA and some countries in Europe. If you require a different encoding for your locale (like, let's say, ISO8859-2), you can specify this as an argument to the console server. I am sorry to say that fsysopts doesn't do the trick yet, so you have to set the option with `settrans -fg`, which will _terminate all your login sessions and restart the console server_.
+The virtual consoles you are now running on are providing an ISO8859-1 environment (also known as latin1), which is good enough for the USA and some countries in Europe. If you require a different encoding for your locale (like, let's say, ISO8859-2), you can specify this as an argument to the console server. I am sorry to say that [[hurd/fsysopts]] doesn't do the trick yet, so you have to set the option with `settrans -fg`, which will _terminate all your login sessions and restart the console server_.
 
 To do this, _first_ exit the client. It will get disconnected anyway (and doesn't attempt to reconnnect yet in such a case). Then do a
 
diff --git a/hurd/fsysopts.mdwn b/hurd/fsysopts.mdwn
new file mode 100644
index 00000000..debe2ebc
--- /dev/null
+++ b/hurd/fsysopts.mdwn
@@ -0,0 +1,33 @@
+[[!meta copyright="Copyright © 2013, 2014 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]]."]]"""]]
+
+Get or set command line options for a running [[translator]].
+
+See [[documentation/translators#manage]].
+
+
+# Open Issues
+
+[[!tag open_issue_hurd]] Not all translators support fsysopts:
+
+  * [[console]]
+  * [[translator/pflocal]]
+  * [[virtualization/remap_root_translator]]
+  * [...]
+
+
+## IRC, freenode, #hurd, 2013-05-23
+
+    <braunr> work around this by using showtrans
+    <braunr> fsysopts asks the server itself how it's running, usually giving
+      its command name and options
+    <braunr> showtrans asks the parent how it starts a passive translator
+      attached to the node
+    <gnu_srs> Yes showtrans works :), thanks.
diff --git a/hurd/translator/examples.mdwn b/hurd/translator/examples.mdwn
index 4947808e..69f15c02 100644
--- a/hurd/translator/examples.mdwn
+++ b/hurd/translator/examples.mdwn
@@ -1,4 +1,4 @@
-[[!meta copyright="Copyright © 2007, 2008, 2013 Free Software Foundation,
+[[!meta copyright="Copyright © 2007, 2008, 2013, 2014 Free Software Foundation,
 Inc."]]
 
 [[!meta license="""[[!toggle id="license" text="GFDL 1.2+"]][[!toggleable
@@ -92,4 +92,4 @@ To join "foo/" "bar/" and "baz/" in the directory "quux/", just do:
     $ settrans -capfg quux/ /hurd/unionfs foo/ bar/ baz/
 
 If you want to join even quux/ contents in the union itself, add `-u` as a translator argument.
-You can add filesystems at run-time with the `fsysopts` command.
+You can add filesystems at run-time with the [[fsysopts]] command.
diff --git a/hurd/translator/pflocal.mdwn b/hurd/translator/pflocal.mdwn
index 6cb01e18..13b5e01b 100644
--- a/hurd/translator/pflocal.mdwn
+++ b/hurd/translator/pflocal.mdwn
@@ -67,3 +67,8 @@ implementation).
     <braunr> being faster isn't the side effect itself ;p
     <braunr> nice, sudo was bugged on linux too, its behaviour matched its hurd
       version perfectly
+
+
+## [[hurd/fsysopts]]
+
+Doesn't support [[hurd/fsysopts]].
diff --git a/hurd/translator/unionfs.mdwn b/hurd/translator/unionfs.mdwn
index 2fcd1fad..06524f3e 100644
--- a/hurd/translator/unionfs.mdwn
+++ b/hurd/translator/unionfs.mdwn
@@ -1,5 +1,5 @@
-[[!meta copyright="Copyright © 2008, 2009, 2010, 2013 Free Software Foundation,
-Inc."]]
+[[!meta copyright="Copyright © 2008, 2009, 2010, 2013, 2014 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
@@ -116,7 +116,7 @@ one will see the information about the `<translator>`, not the
 `unionfs` translator.  Although this might seem the only natural way
 to do union mounts, one must keep in mind that such transparency
 deprives one of the possibility to modify the unioned virtual
-filesystem exported by `unionfs` at run-time (via `fsysopts`).
+filesystem exported by `unionfs` at run-time (via [[fsysopts]]).
 
 One can create a nontransparent union mount with the following command:
 
@@ -127,7 +127,7 @@ When running
     $ fsysopts <node>
 
 one will see the information about the `unionfs` translator.  Although
-this way allows modifying the contents of the unioned filesystem
+this way allows [[modifying|fsysopts]] the contents of the unioned filesystem
 exported by `unionfs` at runtime, the access to `<translator>` is
 blocked.
 
diff --git a/open_issues/some_todo_list.mdwn b/open_issues/some_todo_list.mdwn
index 48c2944d..7a7d7487 100644
--- a/open_issues/some_todo_list.mdwn
+++ b/open_issues/some_todo_list.mdwn
@@ -1,5 +1,5 @@
 [[!meta copyright="Copyright © 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009,
-2013 Free Software Foundation, Inc."]]
+2013, 2014 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
@@ -41,22 +41,6 @@ From Marcus, 2002:
   * Is the suid bit correctly set for all installed programs?
   * Translators
     * Does settrans -g work? -fg?
-    * Does fsysopts work? Does setting options with fsysopts work?
-
-      IRC, freenode, #hurd, 2013-05-23:
-
-          <gnu_srs> fsysopts /servers/socket/2 works by /1 gives Operation not
-            supported.
-      
-      [[!taglink open_issue_hurd]].
-      
-          <braunr> ah right, some servers don't implement that
-          <braunr> work around this by using showtrans
-          <braunr> fsysopts asks the server itself how it's running, usually giving
-            its command name and options
-          <braunr> showtrans asks the parent how it starts a passive translator
-            attached to the node
-          <gnu_srs> Yes showtrans works :), thanks.
     * Does stat() work on all translated nodes and give proper data?
     * What about chown, chmod (some translators should pass this through to the underlying node, esp in /dev!)
     * Does statfs give correct data?
@@ -81,10 +65,6 @@ Wolfgang list of [Easy tasks](http://mail.gnu.org/pipermail/help-hurd/2002-July/
   </tr>
   <tr>
     <td> 1 </td>
-    <td> Check if all translators handle fsysopts </td>
-  </tr>
-  <tr>
-    <td> 1 </td>
     <td> Check if all translators respond to "settrans -g" </td>
   </tr>
   <tr>
diff --git a/open_issues/virtualization/remap_root_translator.mdwn b/open_issues/virtualization/remap_root_translator.mdwn
index dcef310d..acbb3147 100644
--- a/open_issues/virtualization/remap_root_translator.mdwn
+++ b/open_issues/virtualization/remap_root_translator.mdwn
@@ -1,4 +1,4 @@
-[[!meta copyright="Copyright © 2013 Free Software Foundation, Inc."]]
+[[!meta copyright="Copyright © 2013, 2014 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
@@ -144,3 +144,8 @@ License|/fdl]]."]]"""]]
 # IRC, freenode, #hurd, 2013-03-16
 
     <braunr> youpi: is the /bin/remap --help output correct ?
+
+
+# [[hurd/fsysopts]]
+
+Doesn't support [[hurd/fsysopts]].