diff options
Diffstat (limited to 'hurd/documentation/translator_primer.mdwn')
-rw-r--r-- | hurd/documentation/translator_primer.mdwn | 27 |
1 files changed, 14 insertions, 13 deletions
diff --git a/hurd/documentation/translator_primer.mdwn b/hurd/documentation/translator_primer.mdwn index bbfb3649..073d5e07 100644 --- a/hurd/documentation/translator_primer.mdwn +++ b/hurd/documentation/translator_primer.mdwn @@ -8,9 +8,11 @@ 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]]."]]"""]] +[[!meta title="Translator Primer"]] + # Small Examples on Using Translators -The [[concept|concepts]] of user-space servers, [[translator]]s, is a very +The [[concept|concepts]] of user-space servers, [[Translators|translator]], is a very powerful one. Here is an introductionary text. @@ -28,13 +30,11 @@ to enable you to easily try three of them: To try out the simplest of translators, you can go the following simple steps: $ touch hello - $ cat hello + $ cat hello $ settrans hello /hurd/hello $ cat hello "Hello World!" - $ settrans -g hello - $ cat hello - $ + $ fsysopts hello /hurd/hello --contents='Hello World! ' @@ -42,22 +42,23 @@ To try out the simplest of translators, you can go the following simple steps: > ' $ cat hello Hello GNU! - $ - -What you do with these steps is first verifying that the file "hello" is empty. + + $ settrans -g hello + $ cat hello +What you do with these steps is first creating the file "hello" and verifying that it is empty. -Then you setup the translator /hurd/hello in the file/node hello. +Then you setup the translator `/hurd/hello` in the file/node `hello`. -After that you check the contents of the file, and the translator returns "Hello World!". +After that, you check the contents of the file, and the translator returns "Hello World!". Because you are a curious hacker, you wonder what filesystem options this node has. It turns out that the hello translator uses a "contents" option. We can change what the hello -translator returns with another call to fsysopts. +translator returns with another call to [[fsysopts]]. To finish it, you remove the translator from the file "hello" (and tell any active running instances to go away) -via "settrans -g hello". +via "`settrans --g hello`", which is shorthand for "`settrans --goaway hello`" Having done that, verify that now the file is empty again. ### Transparent FTP @@ -83,7 +84,7 @@ What you do here is setting up the translator /hurd/hostmux on ftp: and passing Now that we can access ftp.gnu.org transparently, let's mount a remote ISO file: - $ settrans -c mnt /hurd/iso9660fs ftp://ftp.gnu.org/old-gnu/gnu-f2/hurd-F2-main.iso + $ settrans -c mnt /hurd/iso9660fs $PWD/ftp://ftp.gnu.org/old-gnu/gnu-f2/hurd-F2-main.iso $ ls mnt/ It is interesting to note that since the ISO9660 format is indexed, ftpfs does not have to download the whole ISO file, it merely fetches what iso9660fs requests. |