3 files changed, 53 insertions, 4 deletions
diff --git a/hurd/translator/eth-filter.mdwn b/hurd/translator/eth-filter.mdwn
index 4f59b402..b5dc8f8f 100644
--- a/hurd/translator/eth-filter.mdwn
+++ b/hurd/translator/eth-filter.mdwn
@@ -8,7 +8,33 @@ 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]]."]]"""]]
 
-# IRC, freenode, #hurd, 2013-07-27
+`eth-filter` is a translator that implements a very simple stateless firewall.
+
+
+# Source
+
+[[source_repositories/incubator]], dde
+
+
+# Usage
+
+For instance, to drop any attempt to access port 22:
+
+    # settrans -c /dev/eth0f /hurd/eth-filter -i /dev/eth0 -r "not port 22"
+
+This creates a `/dev/eth0f` device, which is the filtered version of
+`/dev/eth0`.  One can then use `/dev/eth0f` instead of `/dev/eth0`:
+
+    # settrans /servers/socket/2 /hurd/pfinet -i /dev/eth0f [...]
+
+..., or run `dhclient /dev/eth0f`, or similar.
+
+See also Zheng Da's [[user/zhengda/howto]].
+
+
+# Open Issues
+
+## IRC, freenode, #hurd, 2013-07-27
 
 [[!tag open_issue_hurd]]
 
diff --git a/hurd/translator/netio.mdwn b/hurd/translator/netio.mdwn
index 429072d4..885b1cc0 100644
--- a/hurd/translator/netio.mdwn
+++ b/hurd/translator/netio.mdwn
@@ -11,9 +11,16 @@ License|/fdl]]."]]"""]]
 `netio` is a translator designed for creating socket ports through the
 filesystem.
 
-See also [[socketio]].
+This is supposed to be replaced by the better [[socketio]].
 
 
 # Source
 
 [[source_repositories/incubator]], netio/master
+
+
+# Usage:
+
+For example:
+
+    $ cat < ~/tmp/netio/tcp/ftp.gnu.org/21
diff --git a/hurd/translator/socketio.mdwn b/hurd/translator/socketio.mdwn
index 479d5749..de5cf252 100644
--- a/hurd/translator/socketio.mdwn
+++ b/hurd/translator/socketio.mdwn
@@ -11,10 +11,26 @@ License|/fdl]]."]]"""]]
 `socketio` is a translator designed for creating socket ports through the
 filesystem.
 
-See also [[netio]].
+This is supposed to replace [[netio]].
 
 
-# IRC, freenode, #hurd, 2013-06-30
+# Source
+
+[[source_repositories/incubator]], socketio/master
+
+
+# Usage:
+
+For example:
+
+    $ cat < ~/tmp/socketio/tcp/ftp.gnu.org/21
+
+
+# Open Issues
+
+## IRC, freenode, #hurd, 2013-06-30
+
+[[!tag open_issue_hurd]]
 
     <youpi> http://lists.gnu.org/archive/html/bug-hurd/2003-05/msg00069.html
     <youpi> this was supposed to be much better than our current netio