summaryrefslogtreecommitdiff
path: root/hurd/translator/pfinet.mdwn
blob: 1dd5c8b58d40bf58c2f1d95553444ed5f976450e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
[[!meta copyright="Copyright © 2002, 2004, 2005, 2007, 2008, 2011, 2013 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]]."]]"""]]

Pfinet is a TCP/IP stack from an old linux version.  It works but is not maintained.  Recently Recently [[hurd/translator/lwip]], which is
an userspace tcp/ip library, was ported to the Hurd, which can serve as a direct
replacement for pfinet.

To configure Internet connectivity, the `pfinet` (*Protocol Family Internet*)
[[translator]] must be configured.  This is done using the
[[`settrans`|settrans]] command, for example like this:

    # settrans -fgap /servers/socket/2 /hurd/pfinet ↩
        -i /dev/eth0 -a 192.168.0.50 -g 192.168.0.1 -m 255.255.255.0

The argument `/server/socket/2` is the node that the translator is to be
attached to.  This is followed by the translator program to run and any
arguments to give it.

There, `-i`, `-a`, `-g` and `-m` are, quite obviously, the (Mach) device to
use, the IP address, the gateway and netmask.

You can see your currently running `pfinet`'s options via

	$ fsysopts /servers/socket/2 # provides IPv4
	/hurd/pfinet --interface=/dev/eth0 --address=ADDRESS --netmask=NETMASK --gateway=GATEWAY --address6=ADDRESS --address6=ADDRESS --gateway6=::

	$ fsysopts /servers/socket/26 # provides IPv6
	/hurd/pfinet --interface=/dev/eth0 --address=ADDRESS --netmask=ADDRESS --gateway=GATEWAY --address6=ADDRESS --address6=ADDRESS --gateway6=::

---

To make DNS lookups work, you'll also have to properly configure the
`/etc/resolv.conf` file, for example by copying it over from your GNU/Linux
installation.

---

  * [[DHCP]].

  * [[IPv6]].

  * [[eth-filter]]: Firewall.

  * [[Implementation]].