Skip to content

AROSTCP

Jump to bottom
Nick Andrews edited this page Mar 5, 2026 · 12 revisions

AROSTCP bsdsocket.library -- Implementation Status & To-Do Summary

This document tracks what is implemented, partially implemented, and not yet implemented in the AROSTCP network stack.

Last updated against codebase: March 2026.

Feature Overview

Core Protocol Support -- IMPLEMENTED

Protocol Status Key Files
IPv4 Complete netinet/ip_input.c, ip_output.c, in.c, in_pcb.c
IPv6 Complete netinet6/ip6_input.c, ip6_output.c, in6.c, in6_pcb.c
TCP (v4+v6) Complete netinet/tcp_input.c, tcp_output.c, tcp_usrreq.c, netinet6/
UDP (v4+v6) Complete netinet/udp_usrreq.c, netinet6/udp6_usrreq.c
ICMP Complete netinet/ip_icmp.c
ICMPv6 Complete netinet6/icmp6.c
Raw IP (v4+v6) Complete netinet/raw_ip.c
ARP Complete net/sana2arp.c

IPv6 Control Plane -- IMPLEMENTED

Feature Status Key Files
NDP (Neighbor Discovery) Complete netinet6/nd6.c, nd6_nbr.c, nd6_rtr.c
DAD (Duplicate Address Detection) Complete netinet6/nd6.c (nd6_dad_start/timer)
SLAAC (Stateless Auto-config) Complete netinet6/nd6_rtr.c (RA processing, prefix handling)
Router Discovery Complete netinet6/nd6_rtr.c (RS/RA)
MLD (Multicast Listener Discovery) Complete netinet6/mld6.c, mld6.h (MLDv1, RFC 2710)
IPv6 Multicast membership Complete netinet6/in6.c (in6_addmulti/delmulti), in6_proto.c
IPv6 socket options Complete netinet6/in6_proto.c (ip6_ctloutput)
IPv6 ioctls Complete netinet6/in6.c (in6_control)

Network Interface Layer -- IMPLEMENTED

Feature Status Key Files
SANA-II device integration Complete net/if_sana.c, sana2config.c
Loopback interface Complete net/if_loop.c
Interface management Complete net/if.c
Routing table (radix tree) Complete net/route.c, net/radix.c
PF_ROUTE routing socket Complete net/rtsock.c (RTM_ADD/DELETE/CHANGE/GET + notifications)
BPF (packet capture/filter) Complete net/bpf.c, net/bpf_filter.c
Packet filter framework Complete net/pfil.c (conditional on ENABLE_PACKET_FILTER)
IP Filter / firewall Complete net/ipfilter.c (rule engine, NAT support)

BSD Socket API -- IMPLEMENTED

Feature Status Key Files
Core socket ops Complete kern/uipc_socket.c, uipc_socket2.c
DNS resolver Complete api/res_init.c, res_query.c, res_send.c, res_mkquery.c
Name resolution Complete api/gethostnamadr.c, getxbyy.c
inet_ntop / inet_pton Complete api/inet_ntop.c
if_nameindex / getifaddrs Complete api/if_nameindex.c, getifaddrs.c

Configuration & Services -- IMPLEMENTED

Feature Status Key Files
DHCPv4 client Complete kern/amiga_dhcp.c (external dhclient launcher)
DHCPv6 client Complete kern/amiga_dhcp.c (conditional on INET6 && DHCP6)
Network database Complete kern/amiga_netdb.c
ARexx interface Complete kern/amiga_rexx.c
GUI configuration Complete kern/amiga_gui.c
Logging / debug Complete kern/amiga_log.c, kern/subr_prf.c
RC file configuration Complete kern/amiga_rc.c, amiga_config.c

Network Utilities -- IMPLEMENTED

Utility Location
arp common/C/arp.c
ifconfig common/C/ifconfig.c
ping common/C/ping.c
route common/C/route.c
netstat common/C/netstat/ (inet, inet6, route, if, mbuf stats)
traceroute common/C/traceroute/
nslookup common/C/nslookup/ (interactive mode)
hostname common/C/hostname.c
resolve common/C/resolve.c
logger common/C/logger.c
whoami common/C/whoami.c
ipf common/C/ipf/ (IP Filter rule management)
ipnat common/C/ipnat/ (NAT rule management)

Roadshow "extended" API -- Status

BPF (Berkeley Packet Filter) -- IMPLEMENTED

Full kernel BPF engine with RX/TX hook points and Roadshow API layer.

  • bpf_open() -- allocates & initializes BPF descriptor
  • bpf_close() -- closes descriptor and frees resources
  • bpf_read() -- reads captured packets from hold buffer
  • bpf_write() -- transmits raw packets via interface
  • bpf_set_notify_mask() -- sets EXEC signal notification
  • bpf_set_interrupt_mask() -- sets interrupt mask
  • bpf_ioctl() -- handles 16+ ioctl commands (BIOCGBLEN, BIOCSBLEN, BIOCSETF, BIOCFLUSH, BIOCPROMISC, BIOCGDLT, BIOCSETIF, BIOCGSTATS, BIOCVERSION, etc.)
  • bpf_data_waiting() -- returns bytes available for reading

Kernel infrastructure:

  • BPF VM/interpreter (net/bpf_filter.c -- full instruction set)
  • Attach/detach hooks in SANA-II RX/TX paths (net/if_sana.c)
  • Per-interface filter lists and frame dispatch (net/bpf.c)
  • Notify/interrupt signal semantics

Route Management -- IMPLEMENTED

Full TagItem-based route API with BSD 4.4 routing socket support.

  • AddRouteTagList() -- parses tags, calls rtrequest(RTM_ADD, ...)
  • DeleteRouteTagList() -- parses tags, calls rtrequest(RTM_DELETE, ...)
  • ChangeRouteTagList() -- atomic delete+re-add under splnet
  • FreeRouteInfo() -- frees allocated route info buffer
  • GetRouteInfo() -- two-pass radix walk, returns rt_msghdr array with filtering

Kernel infrastructure:

  • PF_ROUTE domain registered (net/rtsock.c)
  • RTM_ADD / RTM_DELETE / RTM_GET / RTM_CHANGE / RTM_LOCK messages
  • RTM_MISS / RTM_RESOLVE / RTM_REDIRECT / RTM_IFINFO / RTM_NEWADDR / RTM_DELADDR notifications

Interface Management -- PARTIALLY IMPLEMENTED

Most are ENOSYS stubs; QueryInterfaceTagList is functional.

  • AddInterfaceTagList() -- STUB (returns -1, ENOSYS)
  • ConfigureInterfaceTagList() -- STUB (returns -1, ENOSYS)
  • QueryInterfaceTagList() -- IMPLEMENTED (full implementation in amiga_netstat.c)
  • ObtainInterfaceList() -- STUB (returns NULL)
  • ReleaseInterfaceList() -- STUB
  • BeginInterfaceConfig() -- STUB
  • AbortInterfaceConfig() -- STUB
  • CreateAddrAllocMessageA() -- STUB (returns 0)
  • DeleteAddrAllocMessage() -- STUB
  • RemoveInterface() -- NOT PRESENT (no entry point)

Work remaining:

  • Dynamic SANA-II device open/close and interface lifecycle management
  • TagItem parsing for Add/Configure
  • Runtime address allocation / configuration hooks
  • ObtainInterfaceList / ReleaseInterfaceList list management

Network Monitoring -- NOT IMPLEMENTED

All are ENOSYS stubs.

  • AddNetMonitorHookTagList() -- STUB (returns -1, ENOSYS)
  • RemoveNetMonitorHook() -- STUB
  • GetNetworkStatistics() -- STUB (returns -1, ENOSYS)

Work required:

  • Stats wrapper over existing if_data counters (low effort)
  • Monitor hook callback injection points into RX/TX paths (medium effort)

DNS Server Management -- PARTIALLY IMPLEMENTED

Runtime add/remove/list is implemented; default domain name API is missing.

  • AddDomainNameServer() -- IMPLEMENTED (parses address, adds to DynDB.dyn_NameServers)
  • RemoveDomainNameServer() -- IMPLEMENTED (finds and removes from list)
  • ObtainDomainNameServerList() -- IMPLEMENTED (returns populated list from static + dynamic entries)
  • ReleaseDomainNameServerList() -- IMPLEMENTED (walks list, frees all nodes)
  • GetDefaultDomainName() -- NOT PRESENT (no entry point)
  • SetDefaultDomainName() -- NOT PRESENT (no entry point)

Work remaining:

  • Implement GetDefaultDomainName() / SetDefaultDomainName() (read/write default domain from resolver state)

IPv6 control plane -- IMPLEMENTED

IPPROTO_IPV6 socket options -- FUNCTIONAL

ip6_ctloutput() in netinet6/in6_proto.c implements real option handling with backing kernel state.

  • IPV6_JOIN_GROUP -- calls in6_joingroup_inp() -> in6_addmulti() -> MLD report
  • IPV6_LEAVE_GROUP -- calls in6_leavegroup_inp() -> in6_delmulti() -> MLD done
  • IPV6_MULTICAST_IF -- sets im6o->im6o_multicast_ifp
  • IPV6_MULTICAST_HOPS -- sets im6o->im6o_multicast_hlim (validated 0-255 or -1)
  • IPV6_MULTICAST_LOOP -- sets im6o->im6o_multicast_loop
  • IPV6_V6ONLY -- sets inp->in6p_v6only
  • IPV6_RECVPKTINFO -- sets/clears IN6P_PKTINFO flag
  • IPV6_TCLASS -- sets inp->in6p_tclass
  • IPV6_UNICAST_HOPS -- sets inp->in6p_hops
  • IPV6_HOPLIMIT -- NOT HANDLED (get/set hop limit ancillary data)

IPv6 Multicast -- IMPLEMENTED

Full multicast stack with MLD protocol support.

  • Per-socket IPv6 group membership list (struct ip6_moptions, max 20 groups)
  • Per-interface multicast group table (struct in6_multi linked list, in6_multihead)
  • MLD (Multicast Listener Discovery) -- MLDv1 per RFC 2710 (netinet6/mld6.c)
    • Query/Report/Done message handling
    • Per-group state machine (IDLE/LAZY/SLEEPING/AWAKENING)
    • Report timer with random delay
    • Report suppression on hearing other reports
    • Unsolicited reports on join, Done on leave
    • ff02::1 (all-nodes) exemption per RFC 2710 Section 6
  • SANA-II multicast MAC registration (sana_add_mcast6 / sana_del_mcast6)

IoctlSocket() -- IPv6 ioctls -- IMPLEMENTED

IPv6 address management ioctls are handled in in6_control():

  • SIOCGIFADDR_IN6 -- get IPv6 interface address
  • SIOCAIFADDR_IN6 -- add/configure IPv6 interface address
  • SIOCDIFADDR_IN6 -- delete IPv6 interface address
  • SIOCGLIFADDR -- enumerate addresses (used by getifaddrs)

Compatibility / spec gaps

Miami compatibility extensions -- PARTIALLY IMPLEMENTED

  • MiamiSysCtl() -- STUB (returns ENOSYS)
  • MiamiGetHardwareLen() -- STUB (returns 0)
  • MiamiSetSocksConn() -- STUB (returns FALSE)
  • MiamiOpenSSL() -- returns NULL (no SSL support; intentional, not an error)
  • MiamiCloseSSL() -- no-op (intentional)
  • sockatmark() -- STUB (returns 0)
  • MiamiPFAddHook() -- IMPLEMENTED (allocates hook, adds to pfil_list)
  • MiamiPFRemoveHook() -- IMPLEMENTED (removes from pfil_list, frees)

Spec-documented functions missing entirely from source

These exist in bsdsocket.doc.txt but have no implementation in AROSTCP.

  • ProcessIsServer()
  • ObtainServerSocket()
  • ChangeRoadshowData()
  • ObtainRoadshowData()
  • ReleaseRoadshowData()

Work required:

  • Add entry points to avoid link-time failures/null vectors
  • Implement minimal viable semantics (RoadshowData likely needs compatibility shim)

SO_REUSEPORT vs SO_REUSEADDR semantics

BSD-standard behavior is implemented in netinet/in_pcb.c:

  • Multicast addresses: SO_REUSEADDR is treated as SO_REUSEPORT (allows full duplication)

  • Unicast addresses: SO_REUSEPORT required on both sockets for shared binds

  • This matches FreeBSD/macOS semantics; differs from Linux where SO_REUSEADDR alone enables UDP port sharing

  • Decide whether to:

    • Keep behavior (BSD-standard) and document it, or
    • Adjust PCB/bind logic for Linux-like UDP reuse semantics

Remaining implementation backlog (ordered by priority)

  1. Implement IPV6_HOPLIMIT socket option (ancillary data for received hop limit)
  2. Implement GetDefaultDomainName() / SetDefaultDomainName()
  3. Implement interface management API (AddInterfaceTagList, ConfigureInterfaceTagList, ObtainInterfaceList, etc.)
  4. Implement network monitoring hooks + statistics wrapper (GetNetworkStatistics, AddNetMonitorHookTagList)
  5. Add missing spec functions (ProcessIsServer, ObtainServerSocket, RoadshowData*)
  6. Implement remaining Miami stubs (MiamiSysCtl, MiamiGetHardwareLen, sockatmark)
  7. Implement RemoveInterface() entry point

What changed since the original wiki page

The following items from the original to-do list have been completed:

Item Status Change
BPF (all 8 API functions + kernel engine) NOT IMPLEMENTED -> IMPLEMENTED
Route management (all 5 API functions) NOT IMPLEMENTED -> IMPLEMENTED
PF_ROUTE routing socket + RTM messages NOT IMPLEMENTED -> IMPLEMENTED
IPv6 socket options (ip6_ctloutput) SILENT NO-OP -> IMPLEMENTED (9 of 10 options)
IPv6 multicast (membership + MLD + delivery) NOT IMPLEMENTED -> IMPLEMENTED (MLDv1 RFC 2710)
IPv6 ioctls (SIOCGIFADDR_IN6, etc.) NOT IMPLEMENTED -> IMPLEMENTED
DNS Add/Remove/Obtain/Release NOT IMPLEMENTED -> IMPLEMENTED (4 of 6 functions)
QueryInterfaceTagList() NOT IMPLEMENTED -> IMPLEMENTED
MiamiPFAddHook() / MiamiPFRemoveHook() PARTIAL -> IMPLEMENTED
Packet filter framework (pfil + ipfilter) (not listed) -> IMPLEMENTED
IP Filter / firewall engine + NAT (not listed) -> IMPLEMENTED
MLD (Multicast Listener Discovery) NOT IMPLEMENTED -> IMPLEMENTED
DHCPv4 + DHCPv6 client (not listed) -> IMPLEMENTED
NDP / DAD / SLAAC / Router Discovery (not listed) -> IMPLEMENTED

Original backlog of 10 items: 7 fully completed, 2 partially completed, 1 remaining (interface management).

Clone this wiki locally