docs(amiga): complete AmigaOS 3.1/3.2 developer reference — 172 files across 17 sections
Comprehensive technical documentation covering:
- Hardware: OCS/ECS/AGA custom chip registers, Copper & Blitter deep dives
- Boot sequence: cold boot through startup-sequence
- Binary format: HUNK executable spec, relocation, debug info
- Linking & ABI: .fd files, LVO tables, register calling conventions
- Exec kernel: tasks, interrupts, memory, signals, semaphores
- AmigaDOS: file I/O, FFS/OFS layout, CLI/Shell scripting
- Graphics: planar bitmaps, Copper programming, HAM/EHB modes
- Intuition: screens, windows, IDCMP, BOOPSI
- Devices: trackdisk, SCSI, serial, timer, audio, keyboard
- Libraries: utility, expansion, IFFParse, locale, ARexx
- Networking: bsdsocket API, SANA-II, TCP/IP stack comparison
- Toolchain: GCC, vasm/vlink, SAS/C, NDK, debugging
- Reverse engineering: IDA/Ghidra setup, compiler fingerprints, case studies
- CPU & MMU: 68040/060 emulation libs, PMMU, cache management
- Driver development: SANA-II, Picasso96/RTG, AHI audio
All files include breadcrumb navigation. No local paths or proprietary content.
2026-04-23 12:16:52 -04:00
[← Home ](../README.md ) · [Networking ](README.md )
# bsdsocket.library — BSD Socket API
## Overview
`bsdsocket.library` is the AmigaOS implementation of the BSD socket API. It is provided by the active TCP/IP stack (AmiTCP, Miami, Roadshow) and presents a POSIX-like socket interface adapted to the Amiga's library-based architecture.
---
## Opening
```c
struct Library *SocketBase = OpenLibrary("bsdsocket.library", 4);
if (!SocketBase) { /* no TCP/IP stack running */ }
```
---
## Core Functions (LVO Mapping)
| LVO | Function | BSD Equivalent |
|---|---|---|
| − `socket(domain, type, protocol)` | `socket()` |
| − `bind(sock, name, namelen)` | `bind()` |
| − `listen(sock, backlog)` | `listen()` |
| − `accept(sock, addr, addrlen)` | `accept()` |
| − `connect(sock, name, namelen)` | `connect()` |
| − `sendto(sock, buf, len, flags, to, tolen)` | `sendto()` |
| − `send(sock, buf, len, flags)` | `send()` |
| − `recvfrom(sock, buf, len, flags, from, fromlen)` | `recvfrom()` |
| − `recv(sock, buf, len, flags)` | `recv()` |
| − `shutdown(sock, how)` | `shutdown()` |
| − `setsockopt(...)` | `setsockopt()` |
| − `getsockopt(...)` | `getsockopt()` |
| − `gethostbyname(name)` | `gethostbyname()` |
| − `gethostbyaddr(addr, len, type)` | `gethostbyaddr()` |
| − `getnetbyname(name)` | `getnetbyname()` |
| − `Errno()` | `errno` (returns last error) |
| − `CloseSocket(sock)` | `close()` |
| − `WaitSelect(nfds, rd, wr, ex, timeout, sigmask)` | `select()` + signals |
| − `inet_addr(cp)` | `inet_addr()` |
| − `Inet_NtoA(in)` | `inet_ntoa()` |
| − `inet_makeaddr(net, host)` | `inet_makeaddr()` |
| − `getservbyname(name, proto)` | `getservbyname()` |
---
## WaitSelect — Amiga-Enhanced select()
Unlike BSD `select()` , `WaitSelect` integrates with Exec signals:
```c
fd_set rdset;
FD_ZERO(&rdset);
FD_SET(sock, &rdset);
ULONG sigmask = SIGBREAKF_CTRL_C; /* also wait for Ctrl-C */
struct timeval tv = { 5, 0 }; /* 5 second timeout */
LONG n = WaitSelect(sock + 1, & rdset, NULL, NULL, & tv, &sigmask);
if (n > 0 & & FD_ISSET(sock, & rdset)) { /* data ready */ }
if (sigmask & SIGBREAKF_CTRL_C) { /* user pressed Ctrl-C */ }
```
---
## Simple TCP Client
```c
LONG sock = socket(AF_INET, SOCK_STREAM, 0);
struct sockaddr_in addr;
addr.sin_family = AF_INET;
addr.sin_port = htons(80);
addr.sin_addr.s_addr = inet_addr("93.184.216.34");
if (connect(sock, (struct sockaddr *)& addr, sizeof(addr)) == 0) {
send(sock, "GET / HTTP/1.0\r\nHost: example.com\r\n\r\n", 38, 0);
char buf[4096];
LONG n = recv(sock, buf, sizeof(buf) - 1, 0);
buf[n] = 0;
Printf("%s\n", buf);
}
CloseSocket(sock);
```
---
## References
- NDK39: `libraries/bsdsocket.h` (stack-specific)
- Roadshow SDK documentation
2026-04-23 12:24:21 -04:00
- [sana2.md ](sana2.md ) — network device driver layer
