summaryrefslogtreecommitdiff
path: root/hurd/translator/eth-multiplexer.mdwn
diff options
context:
space:
mode:
Diffstat (limited to 'hurd/translator/eth-multiplexer.mdwn')
-rw-r--r--hurd/translator/eth-multiplexer.mdwn35
1 files changed, 35 insertions, 0 deletions
diff --git a/hurd/translator/eth-multiplexer.mdwn b/hurd/translator/eth-multiplexer.mdwn
new file mode 100644
index 00000000..0f7a6189
--- /dev/null
+++ b/hurd/translator/eth-multiplexer.mdwn
@@ -0,0 +1,35 @@
+[[!meta copyright="Copyright © 2024 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]]."]]"""]]
+
+[[!tag stable_URL]]
+
+The `eth-multiplexer` translator lets one share an ethernet device.
+It is commonly used to set up subhurds' networking to share an
+ethernet device with the subhurd and the main hurd. The [[subhurds'
+page|hurd/subhurd]] has a guide to show you how to do this.
+
+Here's a basic example to get you started using the eth-multiplexer.
+To do so, install the multiplexer at `/dev/eth0m`.
+
+ # settrans -c /dev/eth0m /hurd/eth-multiplexer --interface=/dev/eth0
+
+Then configure your main Hurd system to use the virtual network
+interface `/dev/eth0m/0` instead of `/dev/eth0`. On Debian/Hurd, this
+can be accomplished via:
+
+ # ifdown /dev/eth0
+ # sed -i -e s_/dev/eth0_/dev/eth0m/0_ /etc/network/interfaces
+ # ifup /dev/eth0m/0
+
+Now you are all set to follow the [[subhurd's guide|hurd/subhurd]] to
+set up a subhurd's networking! If you want to do more cool stuff with
+the `eth-multiplexer`, then you could take a look at the
+[[hurd/translator/lwip]] page or [[hurd/translator/remap]] page.