Networking¶
Amix networks the way a stock AT&T System V Release 4 workstation does: a STREAMS-based TCP/IP stack with both TLI and BSD sockets, configured with static IPv4 addresses β
. The native Ethernet card is the Commodore A2065 (a LANCE/Am7990 board), which appears as the interface aen0 β
. There is no DHCP and no PPP; DNS resolution is disabled out of the box (the resolver falls back to /etc/hosts) and must be switched on by hand β
/π‘. NFS works as both server and client β
. SLIP exists but is buggy enough that you must reboot between dial-up sessions π‘.
For driver-level mechanics of how a network card hangs off the kernel, see the STREAMS driver guide and the Hydra case study. For the broader kernel picture see the kernel architecture page.
This page condenses Β§11 of the research brief. Networking facts there are tagged β where they come from SVR4 itself or repo source, and π‘ where they come from amigaunix.com / community write-ups. Carry those tags as written.
The stack: SVR4 STREAMS TCP/IP¶
- Amix uses the SVR4 STREAMS framework for its protocol stack β . TCP/IP, the transport providers, and the network drivers are all STREAMS modules pushed onto a stream β this is the same architecture SVR4 documents in its Streams Programmer's Guide and Network Programmer's Guide (both cited by the Ditto driver paper as the references for writing such drivers) β .
- Two programming interfaces are available on top of it: TLI (the SVR4-native Transport Layer Interface) and BSD sockets β .
- A network interface driver is therefore a STREAMS character driver β a third kind of driver alongside plain block and character drivers, distinguished by carrying a
streamtabrather than ordinaryread/writeentry points β . See how STREAMS drivers differ.
Because the stack is statically linked into a monolithic kernel with no loadable modules β
, adding or swapping a network card driver means relinking /unix (see Adding a driver below and the kernel build page).
Interfaces and devices¶
| Card | Interface | Bus | Driver | Tag |
|---|---|---|---|---|
| A2065 (Am7990 LANCE Ethernet) | aen0 |
Zorro II | native (aen/ in the kernel source tree) |
β |
| Hydra AmigaNet (NE2000 / DP8390) | hya0 |
Zorro II | modern hydra-amix STREAMS/DLPI driver |
β |
| Z3660 (accelerator's onboard Zynq GEM) | zen0 |
Zorro III (eth window at 0x10000000, inside the identity-mapped low 1 GB) |
modern z3660eth STREAMS/DLPI driver β works on real hardware (2026-06) |
β |
| Ariadne I | (Gateway! Vol.2 driver) | Zorro II | community | π‘ |
The A2065 is the card Commodore shipped and the only Ethernet board Amix supports out of the box β
. aen0 is what ifconfig and the routing tables refer to. Both modern STREAMS/DLPI add-on drivers (Hydra β hya0, Z3660 β zen0) are real-hardware-verified β see Adding other network cards.
Note: the loopback interface (lo0) and the conventional 127.0.0.1 are SVR4 standard; only the physical-interface name aen0 is Amix-specific here.
Static IP configuration (no DHCP)¶
There is no DHCP client in Amix β every host gets a static IPv4 address β . The pieces are the standard SVR4 / BSD-derived files and commands:
# Bring the A2065 up with a static address and netmask.
ifconfig aen0 192.168.0.10 netmask 255.255.255.0 up
# Verify.
ifconfig aen0
Hostname and host/network databases live where SVR4 keeps them:
/etc/hosts # name β IP, and the resolver's only source until DNS is enabled
/etc/netmasks # subnet masks per network
/etc/networks # network names
/etc/netconfig # STREAMS/TLI transport provider table
The node name lives in a file, not in the kernel β check before you believe otherwise. A boot
applies the host's name at runtime from /etc/nodename β
, and on a kernel line whose
boot-slice kernel is loaded from the boot partition, that kernel contains no hostname at all β
measured 2026-09-09: neither the old nor the new name appears anywhere in the running kernel's bytes,
yet the box reports the new one. SVR4's setuname -n patches /stand/unix, which on such a line
is not the kernel that boots, so running it neither persists a rename nor invalidates the running
kernel's checksums π‘.
The nuance matters because the opposite is true of some images: where /stand/unix is what boots,
a setuname -n rename does live in that kernel file and must be re-applied after replacing it. Both
behaviours are real; they belong to different image lineages, and a note describing one is not a fact
about the other β
. Establish which applies to the image in front of you before relying on either β
strings the kernel that actually boots for the name.
Renaming a host also touches /etc/inet/hosts (the entry the interface's own address resolves
through) and /etc/net/{ticlts,ticots,ticotsord}/hosts (the RPC transport names, a manual step no
first-boot script performs) β
.
Default route β the metric is mandatory. Amix requires a metric (hop count) argument on route add default; omit it and the route is rejected β
/π‘:
The trailing 1 is the metric/hopcount, not an option flag. This is the single most common networking gotcha on Amix and is listed in the quirks checklist.
DNS is off by default β turning it on¶
By default the C library resolves names from /etc/hosts only; DNS lookups are disabled β
. This is deliberate in the shipped configuration β the stock libsocket.so does not call a name server. Enabling DNS means swapping in the DNS-capable library on two resolution paths and providing a resolver config. This procedure is now first-hand verified on a running Amix 2.1 β
:
# 1. gethostbyname() path (ping / telnet / ftp clients): swap libsocket -> libsockdns.
cp /usr/lib/libsocket.so /usr/lib/libsocket.so.orig
ln -f /usr/lib/libsockdns.so /usr/lib/libsocket.so
# 2. TLI / netdir path: activate the DNS-enabled transport table.
cp /etc/netconfig /etc/netconfig.TCP
cp /etc/netconfig.DNS /etc/netconfig # appends /usr/lib/resolv.so to tcp/udp/icmp/rawip
# 3. resolver config β nameservers ONLY (see the domain warning below).
cat > /etc/resolv.conf <<'EOF'
nameserver 192.168.0.1
nameserver 192.168.0.2
EOF
Notes and caveats:
/usr/lib/libsockdns.sois the DNS-enabled socket library; hard-linkinglibsocket.soonto it is what flipsgethostbyname()from hosts-only to DNS β . Useln -f(atomic relink) so already-running daemons keep the old inode safely./etc/netconfig.DNSis a ready-made variant of the SVR4 transport table that appends/usr/lib/resolv.soto each provider; copying it over/etc/netconfigenables DNS on the TLI/netdir_getbyname()path β . Both files ship with the install.in.named(BIND) is only needed if this host is serving DNS; a pure client needs just the two swaps above plus/etc/resolv.confβ .
π Leave the domain UNSET β the
/etc/domain"general weirdness". If a default domain is set, the resolver appends it to every lookup, including fully-qualified names β sowww.google.comis queried aswww.google.com.<yourdomain>. If your local zone has a wildcard, that resolves to the wrong address and never falls back (the classic symptom ispinggettingICMP Host Unreachablefor a name while the literal IP works). The domain is set atsysinitfrom/etc/domainviadomainname \cat /etc/domain`. Fix it by emptying the file (cp /dev/null /etc/domain, orecho nodomain > /etc/domain) anddomainname ""to apply now.options ndots:1` does not help β this resolver ignores it. β (Documented as "general weirdness" on amigaunix.com and confirmed first-hand.)β οΈ Also fix the boot-time
ifconfigs, or enabling DNS adds ~3 minutes to every boot. After enabling DNS via the procedure above, the box stalls ~3 minutes atThe system is coming up. Please wait.on every boot. Stock Amix (DNS off) does not. Reproduced first-hand on Amix 2.1c under Amiberry, 2026-06-07 β .Root cause β :
/etc/rc2.d/S69inetbrings networking up with twoifconfigcalls that take hostnames, each forcing agethostbyname(): -ifconfig lo0 localhost upβ inS69inetitself -ifconfig aen0 \uname -n` up -trailersβ in/etc/inet/network-config`With DNS enabled,
gethostbyname()tries DNS first, but these run before the default route is installed (route add default β¦happens later, in/etc/inet/rc.inet). With no route to the nameservers, each lookup burns the full resolver retransmit schedule β ~90 s each, ~180 s total β before falling back to/etc/hosts. With DNS off (stock) the same names resolve instantly from/etc/hosts, which is why the trap appears only after you enable DNS.This is independent of the
/etc/domainweirdness above β β a box with an already-empty/etc/domainstill hangs the full 180 s. They are two different problems; fix both.
The fix β give both boot-time ifconfigs a literal IP (boot 210 s β 29 s; runtime DNS is unaffected) β
. Configuring your own interface should never depend on a name service:
# /etc/rc2.d/S69inet
- /usr/sbin/ifconfig lo0 localhost up
+ /usr/sbin/ifconfig lo0 127.0.0.1 up
# /etc/inet/network-config
- /usr/sbin/ifconfig aen0 `uname -n` up -trailers
+ /usr/sbin/ifconfig aen0 <this-host-static-ip> up -trailers
lo0 is always 127.0.0.1; aen0 takes this host's own static address (the same one already in /etc/hosts β e.g. 192.168.2.38 in the LAN setup). Only the boot path stops calling the resolver; DNS for clients, mail, etc. is untouched β
.
π Edit
S69inetin place β it is a hardlink (the same inode is also/etc/init.d/inetinit), so unlink/recreate would desync the two β . And never leave backup copies namedS*inside/etc/rc2.d/βrc2'sfor f in /etc/rc2.d/S*glob will run them at boot; park backups elsewhere β .
For a complete, reproducible LAN setup (static IP at boot, gateway, DNS, internet, reachable inbound β all surviving reboot) under Amiberry, see Putting Amix on your real LAN.
NFS (server and client)¶
Amix includes NFS as both server and client β
, the SVR4-standard RPC/NFS stack. The install/boot kernel is itself NFS/RPC-capable: the on-floppy bootstrap embeds a full NFS/RPC client string table (confirmed by string analysis of amix_21_boot.adf) β
, so network booting / network install paths are wired in at the bootstrap level.
Typical usage follows ordinary SVR4 conventions:
# Server: export a directory (entries in /etc/dfs/dfstab, then):
shareall
share
# Client: mount a remote export.
mount -F nfs server:/export/home /mnt
share/shareall/dfstab and mount -F nfs are the SVR4 distributed-filesystem (DFS) interfaces; Amix carries them as part of the SVR4 base β
. For local disk and filesystem details (UFS vs s5) see filesystems and disks.
STREAMS message-block exhaustion β the box wedges with memory to spare π‘¶
Under sustained bench sessions a box can wedge while freemem is still healthy π‘. The console
signature is WARNING: ldterm: (ldtermsrv) out of blocks and console_get_buffer: out of blocks; the
kernel is still alive (it echoes those warnings on each keypress) but TCP dies first and console echo
second. Crucially freemem was still ~2100 pages (β4.3 MB) when it happened, so this is not page
exhaustion β SVR4 STREAMS mblks come from their own preallocated arena, which the entire network
stack lives on, and that arena can starve while the page pool is fine β
(mechanism) / π‘ (the leak).
It tracked the number of telnet/FTP sessions opened, not the filesystem workload β pointing at a
per-connection / per-packet mblk leak on the network path (the specific driver is not yet
isolated, so this is carried π‘). Bench workarounds: power-cycle after heavy session churn, and run
long scripts as a single session with output redirected to a file on the box rather than streamed
over many short-lived connections.
Distinguishing it from a heap/page leak is easy once you know the shape: sample freemem (via
live adb on /dev/kmem) β
if it barely moves while the box dies, the culprit is STREAMS mblks, not the heap. (This is an
open issue on the z3660eth / TCP network path; cdfs was
ruled out with these numbers.)
A 2026-07-27 soak of 69 530 cdfs mount/read/unmount cycles measured FAIL=0 in every STREAMS class
with use at baseline, so cdfs is not a source of this β
; and a refused (rather than timed-out)
connection is the inetd throttle,
not this.
The inetd anti-looping throttle β one service refuses connections while the box is healthy β
¶
If telnet answers Connection refused while FTP still answers, ICMP is alive, and the console shows
an undisturbed login:, the box is fine β SVR4 inetd has disabled that one service because
something opened 40 connections to it inside 60 seconds β
. It re-enables itself within ten minutes
with no intervention, and it says so only into a log nobody is reading (below). This is the most
misleading failure shape on a bench Amix box: it was chased for two days as a filesystem/STREAMS wedge
before being reproduced in four minutes from bare TCP connect/close with the filesystem unmounted β
.
The mechanism and its constants β ¶
inetd's accept loop counts invocations per service entry and, on the 40th inside the window,
logs a message, closes and deregisters the listening socket, and arms a re-enable alarm. All three
constants are compile-time immediates in the shipped /usr/sbin/inetd (Amix 2.1c; 38 228 bytes,
md5 ddfbd40aaaa02a1935a5ef6a37879337, not stripped), read out of its disassembly β
:
| Constant | Value | Governs |
|---|---|---|
TOOMANY |
40 invocations | the trip threshold, counted per service |
CNT_INTVL |
60 s | the counting window |
RETRYTIME |
600 s | the alarm() that re-enables the service |
These match the classic BSD inetd values π‘ β but this build encodes them as immediates, which
is what makes the next section true. The message is
<service>/<proto> server failing (looping), service terminated at daemon.err, tagged
inetd[<pid>] (openlog("inetd", LOG_NOWAIT|LOG_PID, LOG_DAEMON)) β
.
Three details change how you reason about it β :
- The window is anchored, not sliding.
se_timeis stamped when the counter is at 1 and the elapsed check runs only once the counter reaches 40, so the real rule is: the 40th connection of a window trips iff it lands within 60 s of the 1st. A trailing-60 s counter held under 40 is therefore a sound and conservative guard. - The 600 s re-enable timer is global, not per service.
retry()re-setup()s every service whose listening fd is-1, so a second service that trips while the timer is already running does not get its own 600 s. Recovery is "up to 600 s"; a recovery much shorter than ten minutes is not evidence against this mechanism. - The refusal you observe lands later than the 40th connect, because the kernel's listen backlog
keeps completing handshakes while
inetdworks through them. Measured first-refusal indexes across four trips: 40, 61, 68, 70 β . 40 is the floor and the only safe number to design against β never calibrate a guard against an observed refusal index.
There is no knob β ¶
This build exposes no per-service rate cap, by any syntax or flag β β established three independent ways:
- The
inetd.confwait field is a boolean.getconfigent()parses the 4th field with a single full-tokenstrcmp("wait", β¦)and stores 0/1. There is nose_maxmember and no suffix parsing, so the 4.4BSD/Linuxnowait.<max>syntax is simply not implemented β . - Live confirmation.
telnet stream tcp nowait.100 root /usr/sbin/in.telnetd in.telnetdplus aSIGHUPwas re-read without complaint, telnet kept working β and the service still tripped, at connect #68. The.100is silently ignored: a config that looks like it worked and did nothing β . - No command-line flag either. Argument parsing is hand-rolled and accepts exactly
-d(debug),-s(standalone, i.e. outside the SAF), and-t(log every connection); anything else printsinetd: Unknown flag -%c ignored.There is no-R rateβ .
So the only ways to move the threshold are to patch three immediates in a vendor binary, or not to trip it. Don't trip it β see the operational rule below.
It is per service β which makes the diagnosis one command β ¶
The counter lives in the per-service servtab entry, so every nowait service in
/etc/inet/inetd.conf has its own independent counter (on the stock image: ftp, telnet, shell,
login, exec, uucp, nntp, finger). Measured in both directions on the same box β
:
- tripping ftp (70 rapid connects to :21) β :21 refused, :23 still open
- tripping telnet (68 rapid connects to :23) β :23 refused, :21 still open
Port 21 answering while port 23 refuses β the throttle. Nothing needs fixing; the service returns by itself. It also means you can still pull evidence off the box over FTP while telnet is throttled.
Distinguish it from the two failures it imitates β :
| What you see | What it is |
|---|---|
One port refuses (ECONNREFUSED), another answers, ICMP alive, console healthy |
this throttle β wait up to 10 min |
Ports time out, console prints ldterm: (ldtermsrv) out of blocks |
STREAMS mblk starvation (previous section) π‘ |
| Nothing answers and the console is dead | a genuine kernel wedge |
Why it is silent: syslogd ships deliberately disabled β
¶
The box does report the trip β into a void. Everything the logging system needs is present and
correct on the stock image: /usr/sbin/syslogd (22 728 bytes, May 1992), a valid /etc/syslog.conf,
the eight /var/log/* targets (all present, all zero-length, never written), and /dev/log +
/dev/conslog. What is missing is the daemon ever starting β /etc/init.d/syslogd line 8 is a
vendor-hardcoded exit β
:
sh -x /etc/init.d/syslogd start outputs exactly + exit. Note also that this SVR4 logs to
/var/log/*, not /var/adm/messages β
β looking for the latter finds nothing and misleads you
into "this image has no syslog".
Enabling it is one commented-out line, with no /etc/syslog.conf change: the stock
*.notice;kern.none /var/log/notice line already selects daemon.err β
.
π Edit with
cpin place, nevermv./etc/init.d/syslogdand/etc/rc2.d/S70syslogdare the same inode (3 hard links, inode 10261 on the stock image).mvreplaces the file and silently breaks therc2.dhook, so the fix works once and never again after a reboot β . This is the same hazard as theS69inet/inetinithardlink noted above.
# on the box, as root
cp /etc/init.d/syslogd /etc/init.d/syslogd.orig
sed '8s/^exit$/#exit/' /etc/init.d/syslogd > /tmp/sl.new
cp /tmp/sl.new /etc/init.d/syslogd # cp, NOT mv -- preserves the inode
/etc/init.d/syslogd start # or reboot; S70syslogd now runs it
Verified end to end β both real trips were then recorded β :
Mar 23 09:51:02 uaeamix inetd[156]: ftp/tcp server failing (looping), service terminated
Mar 23 10:02:59 uaeamix inetd[156]: telnet/tcp server failing (looping), service terminated
Measured cost, over 23 minutes of deliberate abuse (2 trips, ~170 telnet logins, 120 batched
commands): one daemon, and 293 bytes total across the whole of /var/log β
β roughly 80 bytes
per event, into the eight pre-existing files, with no new files or directories. The 20-minute mark
heartbeat is routed to /dev/console only by the stock config and never to a file, so its disk
cost is zero (syslogd -m 0 disables it outright) β
. Nothing else broke across the session. To also
put it on the console, add one line β daemon.err<TAB>/dev/console. Reverse it by restoring the
exit.
The operational rule for anything that drives an Amix box β ¶
The throttle only ever fires on automation. Any harness that opens a fresh telnet (or FTP)
session per command reaches 40 in a minute trivially β a for f in *; do <one login>; done loop
self-destructs at the 40th file and then looks dead for ten minutes. Measured: ~30 invocations/min
never tripped across 200 invocations; ~575/min tripped within seconds β
.
- Hold one session open for a batch of commands instead of one login per command.
- Or keep invocations under ~30 per 60 s, per service β the same guard is needed on port 21, because a per-file FTP loop trips identically at 40 files.
- Best for bulk work: run an on-box script and poll for progress at a low rate. One soak sustained ~330 filesystem cycles/min at 0.5 telnet logins/min for three hours with no trips β .
Serial networking: SLIP is buggy, no PPP¶
- PPP is not available on Amix β β there is no PPP stack to dial out with.
- SLIP exists but is buggy π‘. The reported workaround is to reboot between SLIP sessions: a connection that has been torn down does not cleanly reset, so a second
dial β connectin the same uptime tends to fail. Treat SLIP as a one-shot-per-boot facility. This is recorded in the quirks checklist.
If you need IP over serial in practice, the community guidance is effectively "use Ethernet (A2065 or Hydra) instead" π‘.
Adding other network cards¶
Because the kernel is monolithic with no loadable modules β
, a non-A2065 card needs a driver compiled into /unix. The modern, fully worked example is the Hydra AmigaNet driver β and as of 2026-06 it works on real hardware: ARP resolves and ICMP ping reaches both the local gateway and external IPs, which the repo calls "believed to be the first working AMIX network driver for the Hydra card" π‘ (first-party). See the Hydra case study for the bring-up story.
hydra-amixis a STREAMS / DLPI network driver for the Hydra card (an NE2000 / DP8390 design), rev 1.2a, Zorro II, AutoConfig ID 2121/1 (0x08490001) β .- It registers at
cdevswslot 47 with thehyatag. Amix is SVR4.0 β there is noifconfig β¦ plumb; you link the interface in withslink addaen /dev/hya0 hya0, thenifconfig hya0 <ip> netmask <m> up -trailersβ . - Its entry points (
hydraopen,hydrawput,hydraintr,setup_ne2000) handle DLPI primitives (DL_INFO_REQ,DL_BIND_REQ,DL_UNITDATA_REQ) and the INT2 RX/TX interrupt;hydraopenruns a three-method card detect (autocon()/bootinfo with address validation, then direct Zorro II I/O-slot and memory probes β the bootinfo table can be corrupt on 2.1p2), and it deliberately mirrors the existing A2065 LANCE driver (aen/) β . - It is built natively on the Amix box (
makein the driver dir,make forceto relink the kernel) with GCC 2.7.2.3 packaged on amigaunix.com β no cross-compiler; it is source-only because building needs a licensed Amix tree β .
Full detail β the build line, the DLPI flow, and the LANCE-mirroring design β is on the Hydra case study. The general procedure for writing this class of driver is on Writing a STREAMS driver, and the relink/boot-partition steps are on the kernel build page.
A second real-hardware-verified example is the z3660eth driver for the Z3660 accelerator's onboard ethernet (interface zen0) β the network analogue of the A4091 SCSI work, giving Amix full bidirectional TCP/IP on a physical A4000 + Z3660 (2026-06) β
. It is a contrasting design to hydra: instead of programming a NIC chip directly it speaks the Z3660 firmware's frame mailbox over MMIO, registers at cdevsw slot 51 (tag zen; 48 until 2026-07-30), and services RX from a polled timeout() callout β no int2_tbl/init_tbl edit. The one real-hardware blocker was an INT6 interrupt storm (the firmware raised level-6 on every received frame, but Amix has no eth INT6 handler, so ARP broadcasts hard-locked the box); the fix was to disable the firmware interrupt and keep the polled drain. Bring-up is the same slink plumbing as hydra (slink addaen /dev/zen0 zen0, then ifconfig zen0 β¦ up -trailers). See the Z3660 ethernet driver case study for the mailbox protocol, the storm, and the build/deploy story.
Build note:
hydra-amixis built natively on the Amix box with GCC 2.7.2.3 (a pkg on amigaunix.com). As of 2026-06 a Linux-hosted cross-toolchain also exists βisoriano1968/gcc-cross-amix(m68k-cbm-sysv4-gcc) β so you can build driver objects on a modern host too β . Either way you need a licensed Amix install (its headers/libs aren't redistributable; the cross-toolchain consumes them as a sysroot). See the toolchain page.
Quick reference¶
| Task | Command / file | Tag |
|---|---|---|
| Bring A2065 up | ifconfig aen0 <ip> netmask <mask> up |
β |
| Bring Hydra up | slink addaen /dev/hya0 hya0, then ifconfig hya0 <ip> β¦ up -trailers (no ifconfig plumb on SVR4.0) |
β |
Bring Z3660 (zen0) up |
slink addaen /dev/zen0 zen0, then ifconfig zen0 <ip> β¦ up -trailers (cdevsw 51; real-HW) |
β |
| Default route (metric required) | route add default <gw> 1 |
β /π‘ |
| Static nameβIP, resolver fallback | /etc/hosts |
β |
| Enable DNS (1/2) | ln -f /usr/lib/libsockdns.so /usr/lib/libsocket.so + /etc/resolv.conf (nameservers only) |
β |
| Enable DNS (2/2) | cp /etc/netconfig.DNS /etc/netconfig (activates /usr/lib/resolv.so) |
β |
| Unset domain (or DNS breaks) | cp /dev/null /etc/domain; domainname "" β else it's appended to every lookup |
β |
| Fix slow boot after DNS | literal IPs in boot ifconfigs: lo0 127.0.0.1, aen0 <static-ip> β else +180 s/boot |
β |
| NFS export / mount | share / shareall; mount -F nfs host:/path /mnt |
β |
| SLIP | works once per boot; reboot between sessions | π‘ |
| PPP | not available | β |
STREAMS mblk starvation |
box wedges (ldterm: out of blocks) while freemem is fine; tracks session churn β power-cycle, single-session long jobs |
π‘ |
| Service refuses connections (one port only) | inetd anti-looping throttle: 40 conns/60 s per service, self-heals β€ 600 s. Diagnose: port 21 open + port 23 refused β throttle |
β |
See the throttle (and every other daemon.*) |
Comment the exit on line 8 of /etc/init.d/syslogd (cp in place β 3 hard links); logs land in /var/log/notice |
β |
See also¶
- Writing a STREAMS driver β how a network interface attaches to the SVR4 stack.
- Hydra case study β a complete modern STREAMS/DLPI network driver (
hya0). - Z3660 ethernet driver case study β a real-hardware STREAMS/DLPI driver (
zen0) over the Z3660 firmware mailbox; the INT6 storm and polled RX. - Kernel architecture β monolithic SVR4, STREAMS, no loadable modules.
- Filesystems and disks β UFS/s5, needed for NFS server exports.
- Quirks β DNS-off-by-default, the
routemetric, and the SLIP reboot bug in one list. - Hardware β the A2065 and other supported expansion.
- amigaunix.com networking notes β end-user network setup (the community source for the DNS/resolver procedure).
Sources¶
- Research brief Β§11 "Networking, X11, userland" (STREAMS TCP/IP;
aen0/A2065; static IP, no DHCP; DNS off by default +libsockdns.soswap,in.named,/etc/resolv.conf;route add default <gw> 1; NFS server+client; SLIP buggy; no PPP). - Research brief Β§2 "Hardware & requirements" (A2065 native; Hydra via
hydra-amix; Ariadne I via Gateway π‘). - Research brief Β§6 (
isoriano1968/hydra-amixβ STREAMS/DLPI, NE2000/DP8390,cdevswslot 47,hya0, AutoConfig0x08490001, three-method autoconfig detect, nativemake/make forcebuild with GCC 2.7.2.3 from amigaunix.com,slinkbring-up). - Research brief Β§4 "Kernel architecture" (monolithic SVR4; STREAMS, TLI + BSD sockets; no loadable modules).
- Research brief Β§3 / Β§10 (
amix_21_boot.adfstring analysis β embedded NFS/RPC client string table), viatools/inspect-adf.sh. - Research brief Β§12 "Quirks checklist" (DNS off by default; SLIP reboot bug).
- Research brief Β§13 (cross-toolchain:
gcc-cross-amixnow provides a publicm68k-cbm-sysv4recipe; native on-box build still simplest). - Ditto, Writing Amix Device Drivers, 1990 European Amiga Developer's Conference (cites the SVR4 Streams Programmer's Guide and Network Programmer's Guide).
- github.com/isoriano1968/hydra-amix
- amigaunix.com β networking (community-reported resolver/DNS procedure).
- The A4091-on-Amix project β networking investigation, 2026-06-07 (reproduced locally β
): instrumented
/etc/rc2per-script timing on Amix 2.1c under Amiberry; DNS-enabled boot 210 s β 29 s after replacing the boot-timeifconfighostnames with literal IPs. Source files:/etc/rc2.d/S69inet,/etc/inet/network-config,/etc/inet/rc.ineton the running system. - The amix-z3660net project β the native
z3660ethSTREAMS/DLPI driver (zen0, cdevsw 51 β 48 until 2026-07-30) for the Z3660's onboard ethernet, validated on a real A4000 + Z3660, 2026-06-21 β (ifconfig zen0,netstat -inzero-error, laptopβboxping/ftp); the firmware-mailbox protocol, the INT6 storm, and the polled-RX design are on the Z3660 ethernet driver case study. - The amix-kerntools bench forensics @
8a76775β STREAMSmblk-arena exhaustion wedges the box (ldterm: (ldtermsrv) out of blocks,console_get_buffer: out of blocks; TCP then console echo die) whilefreememstays ~2100 pages, tracking telnet/FTP session count rather than filesystem load; suspected per-connection/per-packet leak on the network path, driver not yet isolated β real A4000 + Z3660, 2026-07-12, carried π‘. - The amix-kerntools inetd investigation @
f7d741d(docs/inetd-telnet-throttle.md), 2026-07-27 β β the throttle's constants read out of the shipped/usr/sbin/inetd(md5ddfbd40aaaa02a1935a5ef6a37879337):TOOMANY40 /CNT_INTVL60 s /RETRYTIME600 s as compile-time immediates, thedaemon.erropenlog()identity, the anchored (not sliding) window, the global re-enable alarm, the absence of anynowait.<max>syntax or command-line flag (disassembly plus a livenowait.100+SIGHUPtest that still tripped at #68), the per-service independence measured both directions (ftp tripped β 23 open; telnet tripped β 21 open), and thesyslogdenablement (/etc/init.d/syslogdline-8exit, the 3-hard-linkcp-in-place hazard,daemon.erralready selected by the stocksyslog.conf, 293 B of growth in 23 min of abuse). Measured on a disposable copy of a golden bench image; the golden masters were never written to. - The amix-cdfs Packet C wedge soak @
c3eba7e(docs/packet-c-wedge-soak.md), 2026-07-26/27 β β the discovery story and the rate measurements: the wedge reproduced on the first literal sweep replay with the filesystem loop paused; four bare-TCP trips (29.9/min β no trip in 200 invocations; ~550β575/min β trip at 40/61/77); three self-recoveries at 9m48s / 10m11s / 10m00s; FTP up throughout; and the box verified healthy while refusing (28 processes, zeroin.telnetd, STREAMSfail=0in every class, the cdfs mount still traversable). - The 2026-09-08/09 Z3660 hand-over campaign, first-party, real A4000 + Z3660 (workspace record)
β
β the node-name mechanism: on the 040/060-port kernel line the name is applied at runtime from
/etc/nodename(astringsscan of the booting boot-slice kernel found neither the old nor the new name, while the running system reported the new one), sosetuname -nβ which patches/stand/unix, the untouched stock kernel on that line β is neither required nor effective there. The contrary behaviour is real on other image lineages π‘ and the two must not be generalised across each other. Same session:/etc/net/{ticlts,ticots,ticotsord}/hostsconfirmed as a manual rename step that no first-boot script performs.