diff options
| author | jbranso@dismail.de <jbranso@dismail.de> | 2024-10-16 19:30:22 -0400 |
|---|---|---|
| committer | Samuel Thibault <samuel.thibault@ens-lyon.org> | 2024-11-12 00:36:16 +0100 |
| commit | f2a943794560bf21626f301b50ada1f05a633992 (patch) | |
| tree | c02d137ca3bca81fb5c4a2f8f865c4f026ba4432 | |
| parent | 3155d45e7e5427c97c1adcdc0d8497635aa2a6eb (diff) | |
add translator/eth-multiplexer page
* hurd/translator.mdwn: add a link
* hurd/translator/eth-multiplexer.mdwn: new file. Describe the
eth-multiplexer. Document that it is used to set up subhurd's
networking. Add a short example of how to start using it.
Message-ID: <20241016233039.17856-6-jbranso@dismail.de>
| -rw-r--r-- | hurd/translator.mdwn | 1 | ||||
| -rw-r--r-- | hurd/translator/eth-multiplexer.mdwn | 35 |
2 files changed, 36 insertions, 0 deletions
diff --git a/hurd/translator.mdwn b/hurd/translator.mdwn index 3ed8b233..9fe4aab0 100644 --- a/hurd/translator.mdwn +++ b/hurd/translator.mdwn @@ -96,6 +96,7 @@ The [[concept|concepts]] of translators creates its own problems, too: * [[pfinet]] * [[lwip]] * [[eth-filter]] +* [[eth-multiplexer]] * [[pflocal]] * [[hostmux]] * [[storeio]] 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. |