summaryrefslogtreecommitdiff
path: root/hurd/documentation/translator_primer.mdwn
diff options
context:
space:
mode:
Diffstat (limited to 'hurd/documentation/translator_primer.mdwn')
-rw-r--r--hurd/documentation/translator_primer.mdwn27
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.