luasocket/docs, branch docs/pre-release-audit

docs: document socket.unix and socket.serial, fix stale/missing API references

2026-09-01T08:48:40+00:00

Pre-release documentation audit against master. Adds the two fully undocumented modules and closes gaps found by diffing every docs/*.html page against its corresponding source: - New docs/unix.html and docs/serial.html (socket.unix stream/dgram and socket.serial were never documented), linked from index.html, introduction.html, socket.html and reference.html. serial.html notes the current lack of a baud/parity/flow-control API and includes an os.execute+stty workaround example. Both note Windows is unsupported. - socket.html: document headers.setcanonic, point to unix/serial modules. - tcp.html: document getfamily, setpeername/setsockname aliases. - udp.html: document getfamily, getfd/setfd, dirty; document the ipv6-multicast-hops/ipv6-unicast-hops aliasing as current (known-buggy) behavior rather than the originally intended semantics. - http.html: correct redirect text (301/302/303/307/308, was 301/302 only); document MAXHEADERLINE/MAXHEADERSIZE. - dns.html: document getnameinfo. - ltn12.html: document source.rewind and BLOCKSIZE. - installation.html: fix stale "LuaSocket 3.0" sample output to 3.1.0. - reference.html: index every anchor added above plus new Unix/Serial blocks.

Add Lua 5.5 support (#473)

2026-08-31T15:21:20+00:00

Merge pull request #472 from lunarmodules/feat/url-hosttype

2026-08-31T08:08:19+00:00

feat(url): classify host as name/ipv4/ipv6 in parse and build

Merge pull request #470 from lunarmodules/header-canon

2026-08-31T08:03:24+00:00

feat(headers): dynamically create cononicalized headers

Merge pull request #463 from lunarmodules/feat/receive-limit

2026-08-31T07:57:58+00:00

feat(receive): add maxsize argument to bound memory usage

chore(docs): add docs for SO_EXCLUSIVEADDRUSE and others

2026-08-31T07:52:00+00:00

Adds docs for the option, but also adds the docs for other options present in the code but missing from the docs.

feat(url): classify host as name/ipv4/ipv6 in parse and build

2026-08-30T13:34:15+00:00

parse() now sets hosttype ("name"/"ipv4"/"ipv6") plus a matching hostname/ipv4/ipv6 field alongside host. build() accepts those same fields when host is absent, erroring if more than one is set. classify_host is exported for standalone use; it classifies by shape (colon present -> ipv6, dotted-quad shape -> ipv4) rather than validating the address.

feat(headers): dynamically create cononicalized headers

2026-08-29T17:43:26+00:00

Instead of a static list dynamically add entries in proper casing. Also allowing to add non-standard ones through `setcanonic`. closes #442 fixes #440

chore(docs): some cleanup

2026-08-17T05:39:55+00:00

feat(receive): add maxsize argument to bound memory usage

2026-07-30T20:06:04+00:00

client:receive("*l") and receive("*a") are unbounded: a peer that never sends a newline, or never closes, makes LuaSocket buffer until the process runs out of memory (e.g. src/http.lua reading response headers in a loop). Add an optional maxsize argument that caps the payload a single call may accumulate, including prefix. - Hoist all argument validation ahead of timeout_markstart() so bad calls (maxsize < 1, #prefix >= maxsize, numeric pattern > maxsize) raise before any I/O and leave the socket untouched. - recvline/recvall take a budget and return a new internal BUF_OVERSIZED code, surfaced to Lua as the "oversized" error alongside "timeout"/"closed", with the partial held in the 3rd return value. - recvraw is left untouched: argument checks make the cap unreachable for numeric patterns. - Preserve three invariants: a timeout partial is always shorter than maxsize (safe to retry as prefix), completion beats the cap for *a, and no bytes are lost or skipped on overflow. - tcp.c, unixstream.c and serial.c all share this code path unchanged. Adds test coverage (argument errors, *l/*a boundaries, timeout/close at the cap, the drain idiom, numeric patterns, unix-stream mirror) and documents the new argument, error, and recovery idioms in docs/tcp.html.