Unix/Irix/README.networking

README file for networking under IRIX
by Brian J. Johnson 7/23/2002
version 1.0
==================================================

BasiliskII does not currently support networking natively on IRIX.
That is, the emulated Ethernet card does not do anything.  There's no
reason one couldn't use raw domain sockets and the snoop(7p) facility
to do networking, but so far no one has written the required glue
code.

However, it is possible to do TCP/IP networking with BasiliskII on
IRIX via PPP, by connecting an emulated serial port to the IRIX PPP
daemon.  Here are the steps to set it up:


Set up PPP on IRIX
------------------

You need root privileges to do this.

First, make sure you have eoe.sw.ppp and eoe.sw.uucp installed:

  IRIS# versions eoe.sw.ppp eoe.sw.uucp
  I = Installed, R = Removed

     Name                 Date        Description

  I  eoe                  07/22/2002  IRIX Execution Environment, 6.5.17m
  I  eoe.sw               07/22/2002  IRIX Execution Environment Software
  I  eoe.sw.ppp           07/22/2002  Point-to-Point Protocol Software
  I  eoe.sw.uucp          07/22/2002  UUCP Utilities

If they aren't installed, install them from your distribution CDs.

Next, pick IP addresses for the IRIX and MacOS sides of the PPP
connection.  You may want to ask your local network administrator
about this, but any two unused addresses on your local subnet should
work.

Edit /etc/ppp.conf and add these three lines:

_NET_INCOMING
        remotehost=<MacOS PPP IP address>
        localhost=<IRIX PPP IP address>

(Replace the angle brackets and the text in them with the appropriate
IP addresses.)

Next, make a script to set up the environment properly when invoking
pppd from BasiliskII.  You can name this whatever you want; I chose
/usr/etc/ppp-b2:

IRIS# whoami
root
IRIS# cat < /usr/etc/ppp-b2
#!/bin/sh
export USER=_NET_INCOMING
exec /usr/etc/ppp "$@"
IRIS# chmod 4775 /usr/etc/ppp-b2

Rewrite this in perl or python or C or whatever if you don't like
setuid shell scripts.  The alternative is to run BasiliskII as root:
pppd _must_ be run as root.


Configure BasiliskII to start the PPP daemon
--------------------------------------------

Start up BasiliskII, and in the serial devices tab, enter:

  |exec /usr/etc/ppp-b2

Supply the name you used for the script you created.  Be sure to
include the leading pipe symbol ("|").

The "exec" causes your PPP startup script to replace the shell
BasiliskII runs to interpret the command.  It's not strictly
necessary, but cuts down on the number of extra processes hanging
about.


Install a PPP client on MacOS
-----------------------------

The details of this step will vary depending on your PPP client
software.  Set it up for a "direct" connection, with no modem chatting
or login scripting.  For instance, with FreePPP I set the "Connect:"
item on the "Edit..." screen under the "Accounts" tab to "Directly".
Be sure to select the correct serial port.  The serial port speed
shouldn't matter (BasiliskII ignores it), but I set it to 115200 bps.

Next, configure MacOS's TCP/IP stack.  If you're using Open Transport,
Open the TCP/IP control panel and select "Using PPP Server" under the
"Configure" item.  Copy IRIX's DNS client info. from /etc/resolv.conf
to the control panel:  the addresses from the "nameserver" lines go in
the "Name server addr.:"  box, and the domains from the "search" lines
go in the "Search domains:" box.  The steps should be similar for
MacTCP.

Now fire up PPP.  Your PPP client should establish communication with
the IRIX PPP daemon, and you're off and running.


Disclaimer
----------

I haven't tried this procedure from scratch on a freshly installed
system, so I might have missed a step somewhere.  But it should get
you close....
Revision:	1.1
Committed:	2002-07-31T16:46:14Z (22 years, 1 month ago) by cebix
Branch:	MAIN
CVS Tags:	nigel-build-19, nigel-build-12, nigel-build-13, nigel-build-16, nigel-build-17, nigel-build-15, HEAD
Log Message:	- it is now possible to make the serial drivers pipe their input/output to programs by using a '\|' followed by a command line as the modem or printer port setting (instead of a device name like '/dev/ttyS0') [Brian Johnson] - the option "--config FILE" tells B2 to use a different config file
#	Content
1	README file for networking under IRIX
2	by Brian J. Johnson 7/23/2002
3	version 1.0
4	==================================================
5
6	BasiliskII does not currently support networking natively on IRIX.
7	That is, the emulated Ethernet card does not do anything. There's no
8	reason one couldn't use raw domain sockets and the snoop(7p) facility
9	to do networking, but so far no one has written the required glue
10	code.
11
12	However, it is possible to do TCP/IP networking with BasiliskII on
13	IRIX via PPP, by connecting an emulated serial port to the IRIX PPP
14	daemon. Here are the steps to set it up:
15
16
17	Set up PPP on IRIX
18	------------------
19
20	You need root privileges to do this.
21
22	First, make sure you have eoe.sw.ppp and eoe.sw.uucp installed:
23
24	IRIS# versions eoe.sw.ppp eoe.sw.uucp
25	I = Installed, R = Removed
26
27	Name Date Description
28
29	I eoe 07/22/2002 IRIX Execution Environment, 6.5.17m
30	I eoe.sw 07/22/2002 IRIX Execution Environment Software
31	I eoe.sw.ppp 07/22/2002 Point-to-Point Protocol Software
32	I eoe.sw.uucp 07/22/2002 UUCP Utilities
33
34	If they aren't installed, install them from your distribution CDs.
35
36	Next, pick IP addresses for the IRIX and MacOS sides of the PPP
37	connection. You may want to ask your local network administrator
38	about this, but any two unused addresses on your local subnet should
39	work.
40
41	Edit /etc/ppp.conf and add these three lines:
42
43	_NET_INCOMING
44	remotehost=<MacOS PPP IP address>
45	localhost=<IRIX PPP IP address>
46
47	(Replace the angle brackets and the text in them with the appropriate
48	IP addresses.)
49
50	Next, make a script to set up the environment properly when invoking
51	pppd from BasiliskII. You can name this whatever you want; I chose
52	/usr/etc/ppp-b2:
53
54	IRIS# whoami
55	root
56	IRIS# cat < /usr/etc/ppp-b2
57	#!/bin/sh
58	export USER=_NET_INCOMING
59	exec /usr/etc/ppp "$@"
60	IRIS# chmod 4775 /usr/etc/ppp-b2
61
62	Rewrite this in perl or python or C or whatever if you don't like
63	setuid shell scripts. The alternative is to run BasiliskII as root:
64	pppd _must_ be run as root.
65
66
67	Configure BasiliskII to start the PPP daemon
68	--------------------------------------------
69
70	Start up BasiliskII, and in the serial devices tab, enter:
71
72	\|exec /usr/etc/ppp-b2
73
74	Supply the name you used for the script you created. Be sure to
75	include the leading pipe symbol ("\|").
76
77	The "exec" causes your PPP startup script to replace the shell
78	BasiliskII runs to interpret the command. It's not strictly
79	necessary, but cuts down on the number of extra processes hanging
80	about.
81
82
83	Install a PPP client on MacOS
84	-----------------------------
85
86	The details of this step will vary depending on your PPP client
87	software. Set it up for a "direct" connection, with no modem chatting
88	or login scripting. For instance, with FreePPP I set the "Connect:"
89	item on the "Edit..." screen under the "Accounts" tab to "Directly".
90	Be sure to select the correct serial port. The serial port speed
91	shouldn't matter (BasiliskII ignores it), but I set it to 115200 bps.
92
93	Next, configure MacOS's TCP/IP stack. If you're using Open Transport,
94	Open the TCP/IP control panel and select "Using PPP Server" under the
95	"Configure" item. Copy IRIX's DNS client info. from /etc/resolv.conf
96	to the control panel: the addresses from the "nameserver" lines go in
97	the "Name server addr.:" box, and the domains from the "search" lines
98	go in the "Search domains:" box. The steps should be similar for
99	MacTCP.
100
101	Now fire up PPP. Your PPP client should establish communication with
102	the IRIX PPP daemon, and you're off and running.
103
104
105	Disclaimer
106	----------
107
108	I haven't tried this procedure from scratch on a freshly installed
109	system, so I might have missed a step somewhere. But it should get
110	you close....