mirror of
https://github.com/alfishe/amiga-bootcamp.git
synced 2026-06-13 00:26:28 +00:00
21751c0025
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.
93 lines
2.9 KiB
Markdown
93 lines
2.9 KiB
Markdown
[← 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 |
|
||
|---|---|---|
|
||
| −30 | `socket(domain, type, protocol)` | `socket()` |
|
||
| −36 | `bind(sock, name, namelen)` | `bind()` |
|
||
| −42 | `listen(sock, backlog)` | `listen()` |
|
||
| −48 | `accept(sock, addr, addrlen)` | `accept()` |
|
||
| −54 | `connect(sock, name, namelen)` | `connect()` |
|
||
| −60 | `sendto(sock, buf, len, flags, to, tolen)` | `sendto()` |
|
||
| −66 | `send(sock, buf, len, flags)` | `send()` |
|
||
| −72 | `recvfrom(sock, buf, len, flags, from, fromlen)` | `recvfrom()` |
|
||
| −78 | `recv(sock, buf, len, flags)` | `recv()` |
|
||
| −84 | `shutdown(sock, how)` | `shutdown()` |
|
||
| −90 | `setsockopt(...)` | `setsockopt()` |
|
||
| −96 | `getsockopt(...)` | `getsockopt()` |
|
||
| −102 | `gethostbyname(name)` | `gethostbyname()` |
|
||
| −108 | `gethostbyaddr(addr, len, type)` | `gethostbyaddr()` |
|
||
| −114 | `getnetbyname(name)` | `getnetbyname()` |
|
||
| −168 | `Errno()` | `errno` (returns last error) |
|
||
| −174 | `CloseSocket(sock)` | `close()` |
|
||
| −180 | `WaitSelect(nfds, rd, wr, ex, timeout, sigmask)` | `select()` + signals |
|
||
| −210 | `inet_addr(cp)` | `inet_addr()` |
|
||
| −216 | `Inet_NtoA(in)` | `inet_ntoa()` |
|
||
| −222 | `inet_makeaddr(net, host)` | `inet_makeaddr()` |
|
||
| −252 | `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
|
||
- `12_networking/sana2.md` — network device driver layer
|