hurd/fsysopts: New page.

5 files changed, 45 insertions, 7 deletions

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.