MacNetScan 2.1 - User Manual ============================ A network scanner for System 7 on the classic Macintosh. Macintosh OpenTransport is required! Some functionality might work on MacTCP. Copyright (c) 2026 Pit Förster. Free software, MIT License - no warranty. Made with Claude Code, through AppleBridge. Contents -------- 1. What MacNetScan does 2. Requirements 3. Installation 4. The window 5. The six views 5.1 IP Network 5.2 AppleTalk 5.3 Listen 5.4 Tools 5.5 Map 5.6 Frames 6. Menus and keyboard shortcuts 7. Scan Options 8. Export and Copy 9. Grid lines 10. Demo mode 11. Running under Basilisk II 12. Troubleshooting 13. Authorized use only 14. What's new in 2.1 15. License and credits 1. What MacNetScan does ----------------------- MacNetScan finds what is on your local network and shows it the way a Mac of 1995 would: a platinum tool bar of bevelled buttons, Excel's dotted grid in every table, a little radar scope that turns while it works. It does two kinds of things: - Active: it sweeps the local /24 subnet with TCP connects to ten well-known service ports, looks up AppleTalk devices with NBP in every zone, and offers ping, DNS lookup and traceroute. - Passive: it listens to what reaches the Mac anyway - ARP, broadcasts, multicast DNS, DHCP, NetBIOS, IPv6, LLDP, AppleTalk and AARP - and shows it as meters, a station table, an event log, a map of who talks to whom and a packet list with a protocol tree that takes AppleTalk apart up to AppleShare (AFP). The frames can be saved for Wireshark, and capture files can be opened and filtered. Everything runs over Open Transport and never blocks the Mac: other programs keep running while MacNetScan scans. 2. Requirements --------------- - System 7 with Open Transport 1.1 or later and TCP/IP configured (for example System 7.5.3 to 7.6.1). AppleTalk must be active for the AppleTalk view. - A 68K Macintosh, or a PowerPC Mac running 68K code. - Colour (256 colours recommended) and a screen of at least 720 x 460 pixels for the window. - 1500 K of memory (the preferred size; set in the Finder's Get Info). - Tested under the Basilisk II emulator with System 7.6.1. 3. Installation --------------- 1. Download MacNetScan-2.1.sit. 2. Expand it with StuffIt Expander (any version, 4.0 or later works). You get a folder "MacNetScan 2.1" with four items: MacNetScan the program Read Me a short introduction License the MIT License AFP session.pcap an example capture for the Help's walk-through (see 5.6) 3. Copy the folder wherever you like and double-click MacNetScan. The archive is a classic StuffIt archive, so it keeps the program's resource fork and Finder information intact. If you download it on a modern computer, copy the .sit file to the classic Mac (or into the emulator's shared folder) unchanged and expand it there. MacNetScan keeps its settings in a file "MacNetScan Prefs" in the Preferences folder of the System Folder. To remove MacNetScan, drag the folder and that file to the Trash. 4. The window ------------- From top to bottom: Tool bar Scan (green triangle) Starts what the current view does: the IP sweep, the AppleTalk lookup, or listening. Stop (red square) Ends it. Export (page with arrow) Saves what the view shows to a file. Copy (two pages) Puts what the view shows on the clipboard. Grid (small sheet) Switches the dotted grid lines on and off. The button stays down while the grid is on. IP Network | AppleTalk | Listen | Tools | Map | Frames The six views. The current one stays pressed. ACT The activity light: dark yellow at rest, bright yellow for a moment whenever an answer or a frame comes in. Radar scope Turns while a scan or Listen runs; the hosts found show up as blips that light up when the beam passes. Click it for the About box. View area The current view (see section 5). Status bar On the left what MacNetScan is doing (scanning, naming hosts, looking up AppleTalk devices, listening ...), in the middle a progress bar, on the right the counts: hosts, services and AppleTalk devices found. Buttons that cannot do anything at the moment are greyed out - for example Export and Copy while there is nothing to export. 5. The six views ---------------- 5.1 IP Network -------------- Press Scan to sweep the Mac's own subnet (the /24 its IP address is in, addresses .1 to .254 unless you change the range in Scan Options). For each address MacNetScan tries a TCP connect to ten ports at once: AB 9000 AppleBridge WEB 80 HTTP TLS 443 HTTPS SMB 445 Windows / Samba file sharing NB 139 NetBIOS session AFP 548 AppleShare over IP SSH 22 Secure shell IPP 631 Internet printing FTP 21 File transfer TEL 23 Telnet A host counts as alive when any port answers - with a connection or with a refusal. Every alive host gets a row: green LED alive Address its IP address Name from NetBIOS, multicast DNS (Bonjour) or reverse DNS, filled in after the sweep ("..." while it is being looked up, "-" if nothing answered) RTT the round-trip time of the first answer, as a signal meter (four green bars = fast, one red bar = slow) and in milliseconds, to a tenth of a millisecond one LED per service: coloured = open, white = closed Click a row to see the host in the panel on the right: its name and where the name came from, the round-trip time, and every service with "open" or "-". The sweep runs up to 24 probes at once and takes about a minute for a full /24; then the names are looked up. When the IP sweep is done, MacNetScan goes on to look up the AppleTalk devices. 5.2 AppleTalk ------------- At the top: this Mac's AppleTalk address, zone, network type and router. Press Scan to look up every NBP entity (AFP file servers, printers, workstations, other registered services) in every zone. Each one gets a row with a type LED, its name, type, zone, AppleTalk address and the round-trip time of an AEP echo. Click a row for a box with everything known about that device: for an AFP server its machine type, the AFP versions and login methods it offers, its flags, the other services on the same node, and the volumes you have mounted from it. Click the row again to close the box. Further down the view (scroll) are: - Traffic heard: the AppleTalk traffic Listen has seen, per protocol (RTMP, NBP, ATP, AEP, ZIP, ADSP, AARP - packets, bytes, sizes, share) and per sending node, and a histogram of packet sizes. - Network & routers: the routers on the cable from their RTMP broadcasts, the networks or ranges they announce with hops and zone (from ZIP). - Volume: the mounted volumes with their server, size and how full they are. AFP 2.x servers report at most 2 GB. The traffic and router sections fill while Listen, Map or Frames is listening. 5.3 Listen ---------- Listen is passive: MacNetScan sends nothing except a few multicast group joins, so that the network card passes mDNS, IPv6 and LLDP on. Press Scan to start listening. You see: - Protocol meters: ARP, broadcast, multicast, DHCP, NetBIOS, IPv6, LLDP, AppleTalk and AARP, each with a count and a light that flashes when a frame of that kind arrives. - Stations seen: the most recently heard senders, with MAC address, IP address, AppleTalk address or LLDP system name (for switches), what they were heard sending, the number of packets and when they were last heard. The LED is lit for stations heard in the last three seconds. - Events: new stations, gratuitous ARP, DHCP traffic, IP address conflicts, LLDP neighbours, AppleTalk routers. Listening keeps running when you switch to another view; the Map, Frames and AppleTalk views use what it hears. 5.4 Tools --------- Type a host name or an IP address in the field, then click: Ping Four TCP connects to port 80, half a second apart. An answer or a refusal both count - many hosts do not answer ICMP ping, but nearly all answer a TCP connect one way or the other. Pressing Return in the field also pings. DNS Looks the name up (all addresses it has) or, for an address, the name. Trace ICMP traceroute: each hop with its address, its name if it has one, and the round-trip time. The button of the running tool stays down until it is finished. Stop ends it early. 5.5 Map ------- The Map draws who sends to whom, from what Listen hears (Scan starts listening if it is not running yet): - The 20 busiest stations sit around an oval, in address order. "this Mac" is marked in bold. - The groups they send to - Broadcast, mDNS, IPv6 multicast, LLDP, Multicast, AppleTalk - sit inside the oval. - Lines show traffic: the colour tells the kind of target (see the legend at the bottom), the width the number of packets (1, 10, 100, 1000). Unicast traffic is drawn between two stations. - A hollow node is an address that was only ever seen as a destination. Click a node for a box with what is known about it (IP and MAC address, what it was heard sending, packets, name, round-trip time, open services, the groups it sends to). Click it again, or another node, to change the selection. The map is redrawn every two seconds without flicker. 5.6 Frames ---------- Frames is the capture behind Listen, like a small Wireshark: - The packet list: number, time, source, destination, protocol (coloured) and a one-line summary - the last 500 frames, 384 bytes of each. - Below, for the selected frame, its protocol tree and its bytes in hex. The tree knows ARP/AARP, IPv4/IPv6, TCP/UDP/ICMP/ICMPv6, DNS/mDNS/LLMNR, DHCP, LLDP and AppleTalk: DDP, NBP, RTMP, AEP, ZIP and ATP. On ATP it recognises ZIP and ASP (Tickle, OpenSess, GetStatus, Command, Write, CloseSess), and in an ASP Command the AFP call: FPLogin with its AFP version, login method and user name (never the password), FPOpenVol with the volume, FPRead with fork, offset and length, and the names of the other AFP calls. - A reply is matched to its request by transaction ID and addresses: the list then reads "FPGetVolParms Reply ok", and the tree says how long the server took to answer. The list follows the newest frame. Click a frame to hold it still and look at it; click it again to follow the capture live. Open Transport hands frames over without their Ethernet header, so the link layer shows only the sender's MAC address and the type. And it hands on only what this Mac RECEIVES, not what it sends: live, the replies to this Mac's own requests stand alone. A reply from ZIP's socket still lists its zones; any other reply shows its first bytes read as an ASP result ("ok" or an AFP error). Open pcap The Open pcap button reads a capture file instead of listening (Listen stops first): Ethernet, also with 802.1Q VLAN tags or 802.3/SNAP (AppleTalk, AARP), Linux "cooked" captures (MacNetScan's own export), microsecond or nanosecond time stamps, either byte order. The last 500 frames of the file are kept; times count from its first frame. Filter Type words into the field above the list and press Return (or click Filter). Only frames that contain EVERY word - in source, destination, protocol or info, any case - stay in the list; a word starting with ! must not appear. Examples: "afp", "zip", "3.138", "fpread", "!rtmp !tickle", "-50" (AFP replies with an error code). An empty field shows all frames again. The filter works on a live capture too. The mini Wireshark: both directions (Basilisk II on Linux only) A capture taken outside the Mac sees both directions, so the guest's own AFP requests sit next to their replies. That needs Basilisk II on Linux, where the guest is bridged through a tun interface. On the Linux host: sudo tcpdump -i tun0 -w session.pcap (or add "atalk or aarp" for AppleTalk only), then open the file in Frames with Open pcap. Basilisk II on macOS (the etherhelper backend) has no such interface, and a real Mac cannot capture what it sends. "AFP session.pcap" in the MacNetScan folder is such a capture: a guest opens an AppleShare server, logs in, reads a file and disconnects - 477 frames. View > MacNetScan Help walks through it step by step. Export saves the frames kept as a pcap file that Wireshark opens (link type "Linux cooked capture"). Its time stamps are in UTC - set your time zone in the Map control panel, or they are off by it. Copy puts the selected frame on the clipboard as text. 6. Menus and keyboard shortcuts ------------------------------- Apple menu About MacNetScan... The About box with MacNetScan 1's radar. File menu Quit Cmd-Q Edit menu The usual Cut, Copy, Paste for the text field in Tools. Scan menu Start Scan Cmd-R Same as the Scan button. Stop Cmd-. Same as the Stop button. Export Report... Cmd-E Same as the Export button. Copy Report Same as the Copy button. Options... Cmd-; See section 7 (only while nothing runs). View menu IP Network Cmd-1 AppleTalk Cmd-2 Listen Cmd-3 Tools Cmd-4 Map Cmd-5 Frames Cmd-6 Grid Lines Cmd-G Checked while the grid is shown. Demo Mode Cmd-D Checked while demo mode is on. MacNetScan Help Cmd-? The help text, with the walk through the example capture. Return closes it. 7. Scan Options --------------- Scan > Options... (Cmd-;) sets how the IP sweep works: First address (.n) First host number to probe, 1 to 254. Last address (.n) Last host number, 1 to 254, not below the first. Default: 1 to 254, the whole /24. Timeout (ms) How long to wait for an answer per attempt, 100 to 10000 milliseconds. Default: 600. Probes at once How many addresses are probed at the same time, 1 to 24. Default: 24. Lower it on a slow Mac or a busy network. Ports, comma separated The ports to probe, up to 16, for example "80,443,548". The ten known ports get their short names and colours; others show as "?". Out-of-range values make the Mac beep and keep the dialog open. The settings are saved in "MacNetScan Prefs" and used the next time. 8. Export and Copy ------------------ Export (Cmd-E) saves, and Copy puts on the clipboard, what the current view shows, as tab-delimited text that a spreadsheet or a text editor can open: IP Network, Tools the sweep: one line per host with its address, name, round-trip time and open services AppleTalk this Mac's node and the NBP entities Listen, Map the counters, the stations and the events Frames Export: a pcap file for Wireshark; Copy: the selected frame as text 9. Grid lines ------------- Like a spreadsheet of the time, every table has dotted grey lines between its rows and columns. The Grid button in the tool bar, or View > Grid Lines (Cmd-G), switches them off and on. 10. Demo mode ------------- View > Demo Mode (Cmd-D) is for screenshots and videos you want to put online without giving away your network: - Host names, AppleTalk device names and LLDP names become made-up ones (the Macs of a few well-known emulation enthusiasts - "emendelson's Quadra 950" and so on). A device keeps its made-up name in every view. - AppleTalk zones and volume names become neutral ones ("Engineering", "Macintosh HD" ...). - MAC addresses and IPv6 interface identifiers are replaced by invented but stable ones; well-known multicast addresses stay. - The hex dump in Frames is hidden, because raw bytes cannot be made up. Demo mode changes only what is drawn on the screen. Export, Copy and the pcap file stay real. Private IPv4 addresses (192.168.x.x and the like) are shown as they are. Switch demo mode on before you start a scan if not even a single real name may appear. 11. Running under Basilisk II ----------------------------- MacNetScan was developed and tested in Basilisk II with System 7.6.1 and the "etherhelper" network backend. - Listen sees this Mac's own traffic, broadcasts, the multicast groups it joins, and whatever the host computer's network card receives. - MacNetScan never asks the Ethernet driver for raw or promiscuous mode. Under Basilisk II both requests hang the emulated Mac, and they would add nothing there. - Traceroute may show fewer hops than on real hardware, depending on how the emulator's network is set up. - Only Basilisk II on Linux, bridged through tun, lets the host capture both directions of the guest's traffic for Open pcap (see 5.6). 12. Troubleshooting ------------------- "Open Transport TCP/IP is not available." in the status bar Open Transport is not installed, or TCP/IP has no address. Check the TCP/IP control panel, then start MacNetScan again. The AppleTalk view stays empty AppleTalk is off (Chooser) or there are no other AppleTalk devices. Listen hears little On a switched network a Mac only gets its own traffic, broadcasts and multicasts. That is normal. "Lookup timed out." or "Cannot resolve that host." in Tools The DNS server did not answer or does not know the name. Check the name server in the TCP/IP control panel. A later lookup starts fresh. The window does not fit MacNetScan needs a screen of at least 720 x 460 pixels. MacNetScan quits or runs out of memory Give it more memory in the Finder (File > Get Info, Preferred size); 1500 K is the default. 13. Authorized use only ----------------------- MacNetScan actively probes hosts (port connects, NBP lookups, ping, traceroute). Use it only on networks you own or are explicitly allowed to scan. Scanning other networks may break acceptable-use rules or the law and can set off intrusion-detection systems. The author accepts no responsibility for misuse. 14. What's new in 2.1 --------------------- - Frames takes AppleTalk apart up to AppleShare: ATP with ASP and AFP (FPLogin, FPOpenVol, FPRead ...), ZIP, RTMP and AEP; replies are matched to their requests, with the answer time. - Frames: Open pcap and a filter field; 500 frames instead of 400. - View > MacNetScan Help (Cmd-?), and an example capture of an AppleShare session to follow along. - Short AppleTalk packets: Ethernet padding is no longer read as data. 15. License and credits ----------------------- MacNetScan 2.1 - Copyright (c) 2026 Pit Förster. Free software under the MIT License; see the file "License". No warranty. Version 2 is a rebuild of MacNetScan 1 with Symantec C++ 7, Visual Architect and the THINK Class Library 2.0. It was written, compiled and tested on a System 7.6.1 Mac in Basilisk II through AppleBridge, with Claude Code.