summaryrefslogtreecommitdiff
path: root/hurd
diff options
context:
space:
mode:
Diffstat (limited to 'hurd')
-rw-r--r--hurd/libchannel.mdwn62
-rw-r--r--hurd/running/debian/faq/sshd.mdwn2
-rw-r--r--hurd/translator.mdwn4
-rw-r--r--hurd/translator/mboxfs.mdwn11
-rw-r--r--hurd/translator/procfs.mdwn19
-rw-r--r--hurd/translator/procfs/htop.mdwn25
-rw-r--r--hurd/translator/procfs/killall.mdwn23
-rw-r--r--hurd/translator/procfs/procps.mdwn23
-rw-r--r--hurd/translator/procfs/top.mdwn18
-rw-r--r--hurd/translator/stowfs.mdwn11
-rw-r--r--hurd/translator/unionfs.mdwn17
-rw-r--r--hurd/translator/xmlfs.mdwn11
12 files changed, 225 insertions, 1 deletions
diff --git a/hurd/libchannel.mdwn b/hurd/libchannel.mdwn
new file mode 100644
index 00000000..d3dff162
--- /dev/null
+++ b/hurd/libchannel.mdwn
@@ -0,0 +1,62 @@
+[[meta copyright="Copyright © 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]]."]]"""]]
+
+# libchannel
+
+*libchannel* was accepted as a project for [[Google_Summer_of_Code|community/gsoc]] (or
+just GSoC) in 2007. It was written by Carl Fredrik Hammar who was mentored by
+Richard Braun.
+
+
+## Outline
+
+*libchannel* was intended to be used to cleanly and efficiently
+implement *channel* translators that would correspond to character
+device files. In other words, translators for input devices, sound,
+network and the like.
+
+There are many cases where one wishes to stack translators over one
+another. Take networking as an example, you may wish to have a pseudo
+network device that balance traffic over two real devices.
+
+The problem with stacking translators this way is that it's
+inefficient, for every RPC to the balancer a RPC is made to each of
+the real devices. Now a RPC isn't really *that* expensive, but in a
+more complex example with more layers the overhead of these RPC's makes
+such a stacking infeasible.
+
+However, by using *libchannel* a translator can provide a description
+of what it does (i.e. the code and data it uses), which a translator
+layered untop can fetch and use directly. Now only strictly required
+RPC's needs to be sent.
+
+
+## Result
+
+By the end of GSoC 2007, *libchannel* had mostly reached the initial
+goals. There some code missing, most notably the code for
+transferring channels via RPC, but similar code was already present in
+*libstore* and can be trivially adapted for *libchannel*. It also
+needed more debugging.
+
+Despite these minor deficiencies, the project was considered a
+success, never the less.
+
+
+## Future directions
+
+However, while *libchannel* matched the original specifications. It's
+believed that it's too inflexible to make use of in many specific
+cases and that a more general solution is desired. While the
+discussion isn't over yet, it seems *libchannel* will become a support
+library to implement specialized channel libraries, e.g. *libaudio*
+and *libnetwork* or similar.
+
+So work on *libchannel* will continue, in one form or another.
diff --git a/hurd/running/debian/faq/sshd.mdwn b/hurd/running/debian/faq/sshd.mdwn
index 3b98eddf..4ae689bf 100644
--- a/hurd/running/debian/faq/sshd.mdwn
+++ b/hurd/running/debian/faq/sshd.mdwn
@@ -8,5 +8,5 @@ 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]]."]]"""]]
-You need to disable `PriviledgeSeperation` in `/etc/ssh/sshd_options`. Also
+You need to disable `PrivilegeSeparation` in `/etc/ssh/sshd_options`. Also
make sure you have `/dev/random`, see below.
diff --git a/hurd/translator.mdwn b/hurd/translator.mdwn
index afc4dd0f..3f763013 100644
--- a/hurd/translator.mdwn
+++ b/hurd/translator.mdwn
@@ -46,6 +46,9 @@ See some [[examples]] about how to use translators.
* [[ext2fs]]
* [[fatfs]]
* [[magic]]
+* [[mboxfs]]
+* [[unionfs]]
+* [[xmlfs]]
* ...
@@ -55,6 +58,7 @@ See some [[examples]] about how to use translators.
* [[emailfs]] -- email as a filesystem
* [[cvsfs]]
* [[tmpfs]]
+* [[procfs]]
* ...
diff --git a/hurd/translator/mboxfs.mdwn b/hurd/translator/mboxfs.mdwn
new file mode 100644
index 00000000..be959d0b
--- /dev/null
+++ b/hurd/translator/mboxfs.mdwn
@@ -0,0 +1,11 @@
+[[meta copyright="Copyright © 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]]."]]"""]]
+
+<http://www.nongnu.org/hurdextras/#mboxfs>
diff --git a/hurd/translator/procfs.mdwn b/hurd/translator/procfs.mdwn
new file mode 100644
index 00000000..eb07a8f6
--- /dev/null
+++ b/hurd/translator/procfs.mdwn
@@ -0,0 +1,19 @@
+[[meta copyright="Copyright © 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]]."]]"""]]
+
+<http://www.nongnu.org/hurdextras/#procfs>
+
+ * [[`ps`|procps]]
+ * [[`top`|top]]
+ * [[`htop`|htop]]
+ * `gtop`
+ * [[`killall`|killall]]
+ * `pkill`
+ * ...
diff --git a/hurd/translator/procfs/htop.mdwn b/hurd/translator/procfs/htop.mdwn
new file mode 100644
index 00000000..5228c702
--- /dev/null
+++ b/hurd/translator/procfs/htop.mdwn
@@ -0,0 +1,25 @@
+[[meta copyright="Copyright © 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]]."]]"""]]
+
+ open("/proc/stat", O_RDONLY) = 3
+ open("/proc/meminfo", O_RDONLY) = 3
+ open("/proc/stat", O_RDONLY) = 3
+ open("/proc", O_RDONLY|O_NONBLOCK|O_LARGEFILE|O_DIRECTORY|0x80000) = 3
+ open("/proc/1/task", O_RDONLY|O_NONBLOCK|O_LARGEFILE|O_DIRECTORY|0x80000) = 4
+ open("/proc/1/status", O_RDONLY) = 4
+ open("/proc/1/statm", O_RDONLY) = 4
+ open("/proc/1/stat", O_RDONLY) = 4
+ open("/proc/1/cmdline", O_RDONLY) = 4
+ open("/proc/2/task", O_RDONLY|O_NONBLOCK|O_LARGEFILE|O_DIRECTORY|0x80000) = 4
+ open("/proc/2/status", O_RDONLY) = 4
+ open("/proc/2/statm", O_RDONLY) = 4
+ open("/proc/2/stat", O_RDONLY) = 4
+ open("/proc/2/cmdline", O_RDONLY) = 4
+ [...]
diff --git a/hurd/translator/procfs/killall.mdwn b/hurd/translator/procfs/killall.mdwn
new file mode 100644
index 00000000..99790a36
--- /dev/null
+++ b/hurd/translator/procfs/killall.mdwn
@@ -0,0 +1,23 @@
+[[meta copyright="Copyright © 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]]."]]"""]]
+
+ open("/proc/stat", O_RDONLY) = 3
+ open("/proc/self/stat", O_RDONLY) = 3
+ open("/proc/uptime", O_RDONLY) = 3
+ open("/proc/sys/kernel/pid_max", O_RDONLY) = 4
+ open("/proc/meminfo", O_RDONLY) = 4
+ open("/proc", O_RDONLY|O_NONBLOCK|O_LARGEFILE|O_DIRECTORY|0x80000) = 5
+ open("/proc/1/stat", O_RDONLY) = 6
+ open("/proc/1/status", O_RDONLY) = 6
+ open("/proc/1/cmdline", O_RDONLY) = 6
+ open("/proc/2/stat", O_RDONLY) = 6
+ open("/proc/2/status", O_RDONLY) = 6
+ open("/proc/2/cmdline", O_RDONLY) = 6
+ [...]
diff --git a/hurd/translator/procfs/procps.mdwn b/hurd/translator/procfs/procps.mdwn
new file mode 100644
index 00000000..99790a36
--- /dev/null
+++ b/hurd/translator/procfs/procps.mdwn
@@ -0,0 +1,23 @@
+[[meta copyright="Copyright © 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]]."]]"""]]
+
+ open("/proc/stat", O_RDONLY) = 3
+ open("/proc/self/stat", O_RDONLY) = 3
+ open("/proc/uptime", O_RDONLY) = 3
+ open("/proc/sys/kernel/pid_max", O_RDONLY) = 4
+ open("/proc/meminfo", O_RDONLY) = 4
+ open("/proc", O_RDONLY|O_NONBLOCK|O_LARGEFILE|O_DIRECTORY|0x80000) = 5
+ open("/proc/1/stat", O_RDONLY) = 6
+ open("/proc/1/status", O_RDONLY) = 6
+ open("/proc/1/cmdline", O_RDONLY) = 6
+ open("/proc/2/stat", O_RDONLY) = 6
+ open("/proc/2/status", O_RDONLY) = 6
+ open("/proc/2/cmdline", O_RDONLY) = 6
+ [...]
diff --git a/hurd/translator/procfs/top.mdwn b/hurd/translator/procfs/top.mdwn
new file mode 100644
index 00000000..f0030d61
--- /dev/null
+++ b/hurd/translator/procfs/top.mdwn
@@ -0,0 +1,18 @@
+[[meta copyright="Copyright © 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]]."]]"""]]
+
+ open("/proc/stat", O_RDONLY) = 3
+ open("/proc/sys/kernel/pid_max", O_RDONLY) = 3
+ open("/proc", O_RDONLY|O_NONBLOCK|O_LARGEFILE|O_DIRECTORY|0x80000) = 3
+ open("/proc/1/stat", O_RDONLY) = 4
+ open("/proc/1/statm", O_RDONLY) = 4
+ open("/proc/2/stat", O_RDONLY) = 4
+ open("/proc/2/statm", O_RDONLY) = 4
+ [...]
diff --git a/hurd/translator/stowfs.mdwn b/hurd/translator/stowfs.mdwn
new file mode 100644
index 00000000..022e3d5e
--- /dev/null
+++ b/hurd/translator/stowfs.mdwn
@@ -0,0 +1,11 @@
+[[meta copyright="Copyright © 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]]."]]"""]]
+
+[[meta redir=unionfs#stowfs]]
diff --git a/hurd/translator/unionfs.mdwn b/hurd/translator/unionfs.mdwn
new file mode 100644
index 00000000..7eee5245
--- /dev/null
+++ b/hurd/translator/unionfs.mdwn
@@ -0,0 +1,17 @@
+[[meta copyright="Copyright © 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]]."]]"""]]
+
+<http://www.nongnu.org/hurdextras/#unionfs>
+
+
+<a name="stowfs"></a>
+# `stowfs`
+
+... is a special mode of `unionfs`.
diff --git a/hurd/translator/xmlfs.mdwn b/hurd/translator/xmlfs.mdwn
new file mode 100644
index 00000000..cff15f59
--- /dev/null
+++ b/hurd/translator/xmlfs.mdwn
@@ -0,0 +1,11 @@
+[[meta copyright="Copyright © 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]]."]]"""]]
+
+<http://www.nongnu.org/hurdextras/#xmlfs>