summaryrefslogtreecommitdiff
path: root/hurd/settrans.mdwn
diff options
context:
space:
mode:
authorThomas Schwinge <tschwinge@gnu.org>2008-09-28 12:47:43 +0200
committerThomas Schwinge <tschwinge@gnu.org>2008-09-28 12:49:15 +0200
commit21351b26bea310be449960df6b6a2e1841430121 (patch)
treee2435a5f2e8b8545bcca9c2b67c4b668cd78e20d /hurd/settrans.mdwn
parentc737895ad313f5b8b2d1ca8f6f012dd70d61a53b (diff)
Split [[hurd/network]] into [[hurd/translator/pfinet]] and the new [[hurd/settrans]].
Diffstat (limited to 'hurd/settrans.mdwn')
-rw-r--r--hurd/settrans.mdwn37
1 files changed, 37 insertions, 0 deletions
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.