aot
/
compiler
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
TypePHP 编译器 https://swoole.com/aot/
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
1816 Commits
2 Branches
17 Tags
66 MiB
 
 
Tag: Branch: Tree: 43e85b8866
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from '43e85b8866'
${ noResults }
compiler/examples/typephp-os/THIRDPARTY.md

5.0 KiB
Raw Blame History

Third-party source policy

The generated thirdparty/ directory is intentionally ignored by Git. Every third-party source dependency must instead be declared by a script under tools/ with all of the following information:

  • an immutable upstream version or commit;
  • the canonical download URL;
  • a SHA-256 checksum for every downloaded archive or individual source file;
  • an explicit list of files copied into the build tree, or an explicitly documented complete release tree for source-port candidates;
  • the upstream license file.

Run the common fetch entry point before compiling:

./tools/fetch-thirdparty.sh

make invokes this command automatically. Each dependency has a dedicated fetch-*.sh script, while fetch-thirdparty.sh is only the common entry point. A matching local version marker makes repeated invocations offline and effectively free. Third-party source must not be committed directly.

Run the upstream integration probes separately:

make thirdparty-smoke
make network-thirdparty-smoke

This target builds a deliberately small hosted Toybox and audits its undefined ABI. It is not installed into the TypePHP-OS disk image by this probe.

The network probe builds a static, protocol-minimal dependency stack under build/network-thirdparty/install. It verifies that libcurl exposes exactly HTTP and HTTPS, with HTTP/2 supplied by nghttp2. This hosted build locks down the upstream feature selection while the same sources are being ported to the freestanding TypePHP-OS userspace ABI.

lwIP

The complete release tree is fetched, but project.yml selects only the raw IPv4/TCP, ARP, ICMP, UDP/DNS, timeout, and Ethernet sources used by the kernel. The lwIP socket-compatibility and netconn layers are not compiled.

HTTPS and HTTP/2 userspace stack

  • OpenSSL 3.5.8 LTS, archive SHA-256 a8f84a39918ec6415ce765d9b429d313ba97b8143169c172e734b9514464f5b2
  • nghttp2 1.70.0, archive SHA-256 e05cb1388eaca3830aded4ccf20044b6e1ac1a61411dcca11b0437c4285c8bc2
  • curl 8.22.0, archive SHA-256 f7ef3ae8a22e521f289803fe93543eb64c329b58aa73a9e224dfd915a2a5f4f7

All three are static userspace libraries. OpenSSL keeps TLS 1.2/1.3, X.509, and the modern algorithms needed for public HTTPS servers, while omitting its apps, tests, dynamic modules, legacy provider, QUIC/DTLS, and old TLS protocol versions. nghttp2 builds only its C library. Only libcurl is built; the curl command-line tool is excluded. libcurl enables only HTTP/HTTPS and HTTP/2; FTP, FILE, IPFS, mail, LDAP, SMB, MQTT, WebSocket, proxy, compression, IDN, PSL, and other optional dependencies are disabled. Redirect handling, cookies, MIME, headers, and ordinary HTTP authentication remain available.

OpenLibm

Only the architecture/compatibility headers and C sources required by TypePHP-OS's current x86_64 double-precision math ABI are installed. The selection keeps unused implementations out of the freestanding payload.

LLVM compiler-rt builtins

The source selection provides the x86-64 128-bit integer shift, multiply, divide, and remainder helpers. It is compiled into build/libcompiler-rt-builtins.a and linked after every kernel, bootstrap C, and TypePHP Nano userspace object set. The builtins.elf smoke command forces signed and unsigned 128-bit division so the archive is tested as a real linker dependency instead of merely being compiled.

Toybox

The hosted probe enables only cat, date, echo, pwd, and uname; it does not enable Toybox's shell or process-management commands. The undefined host ABI is written to build/thirdparty-smoke/toybox-undefined-symbols.txt. ioctl is a system-call API used by Toybox's shared C support library, not a Toybox command. None of those five applet source files calls it directly, but the common terminal/daemon helpers still leave an ioctl reference in the hosted binary. TypePHP-OS now exposes the Linux-numbered syscall and implements TIOCGWINSZ for its fixed console. Toybox still needs a freestanding build and ABI audit before it can replace any existing command.