summaryrefslogtreecommitdiff
path: root/hurd/settrans.mdwn
blob: 008c73c5c99d13b6eba2c5bb8d092aa47a4e9a88 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
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.