administrator/blaise
1
0
Fork 0
Code Issues Pull requests Actions Packages Projects Releases Wiki Activity

stdlib: flag Linux-specific porting boundaries in Net.Sockets and Security.Guid

Browse source 
Document that the socket constants/sockaddr_in layout (Net.Sockets) and the
getrandom(2) call (Security.Guid) are Linux x86_64 specifics, with the per-OS
differences and the fact that the public helper API is the stable surface a
future port keeps.
This commit is contained in:
Graeme Geldenhuys 2026-06-23 00:22:33 +01:00
parent 2ccfd04f69
commit 3c6fbc3184
2 changed files with 19 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

12
stdlib/src/main/pascal/net.sockets.pas
View file

@ -27,6 +27,18 @@ unit Net.Sockets;
interface
{ ponytail: PORTING BOUNDARY — the constants and the sockaddr_in layout below
are LINUX x86_64 values. Other targets differ and need a per-platform layer:
* macOS/BSD: SO_REUSEADDR=4, O_NONBLOCK=4 (impl section), and TSockAddrIn
starts with a sin_len:Byte before sin_family; MSG_NOSIGNAL does not exist
(use the SO_NOSIGPIPE socket option, or keep IgnoreSigPipe).
* Windows: a separate Winsock backend (ws2_32, WSAStartup, closesocket,
SOCKET handles, WSAGetLastError).
The helper API (TcpListen*/TcpConnect*/AcceptConn/RecvString/SendAll/Close/
MakeNonBlocking/IgnoreSigPipe) is the stable surface — callers never touch
these constants — so a future port changes only the implementation, not
consumers. Add the platform split when a second target lands. }
const
{ address families / socket types }
AF_INET = 2;

7
stdlib/src/main/pascal/security.guid.pas
View file

@ -32,6 +32,13 @@ implementation
uses
StrUtils; { TStringBuilder }
{ ponytail: PORTING BOUNDARY — getrandom(2) is LINUX-specific (3.17+, glibc
2.25+). FreeBSD has a compatible getrandom; macOS does NOT (use getentropy(3)
or SecRandomCopyBytes); Windows uses BCryptGenRandom. When a second target
lands, dispatch c_getrandom per platform behind NewGuidRaw — the public API
(NewGuid/NewGuidRaw) stays put. (/dev/urandom would cover all the Unixes but
not Windows, hence the syscall.) }
{ getrandom(buf, buflen, flags): fill buf with buflen random bytes from the
kernel CSPRNG. flags=0 reads from the same pool as /dev/urandom. }
function c_getrandom(ABuf: Pointer; ALen: Int64; AFlags: Integer): Int64;