AnyPS5/docs/dev/debt/libScePosixForWebKit.md

libScePosixForWebKit technical debt

Unknown function info

• gethostbyname (libScePosixForWebKit) - numeric IPv4 forms, trailing whitespace and 64-bit accumulation follow FreeBSD 11.4 inet_aton; clearing the resolver error on numeric success follows fakeaddr. Exact PS5 behavior is unverified; hostname lookup still uses the host resolver
• clock_gettime_np, getenv_np, gethostbyname_r (scePosixForWebKit_gethostbyname_r), mmap_np, msetname, pthread_setschedparam_np, setenv_np, sysinfo (scePosixForWebKit_sysinfo) (libScePosixForWebKit) - names/NIDs appear in the PS5 3.20 export inventory and verified NID name database; credible prototypes are unknown. These exports use renamed helpers; defining gethostbyname_r would interpose on the host function this library calls itself. All are parameterless import stubs, not ABI claims; callers must not use them until signatures are verified.
• __wrap_fchown, __wrap_link, __wrap_readlink, __wrap_statvfs, __wrap_symlink (libScePosixForWebKit) - parameterless throwing stubs. Under the --wrap convention assumed for the forwarding wrappers (see Functional) each would take the POSIX signature of the function it wraps, but the targets are in libkernel_sys (fchown, link, readlink, symlink) and libSceLibcInternal (statvfs), which no prx links; libkernel_sys's fchown, readlink and symlink also still throw for some arguments

Functional

• strcasestr (libScePosixForWebKit) - console locale behavior is unmeasured. It follows FreeBSD 11.4's strcasestr.c in the guest's supported C locale; other guest locales are not implemented.
• mkstemp and isatty (libScePosixForWebKit) follow FreeBSD's temporary-file API and terminal check, without console verification. mkstemp replaces all trailing X characters, accepts a fixed name, and creates files through the guest path resolver with exclusive read/write access and mode 0600. Windows file permissions follow the existing kernel file implementation. isatty tests Windows console handles rather than all character devices; files, pipes and guest sockets return ENOTTY, closed descriptors return EBADF.
• arc4random (libScePosixForWebKit) returns four bytes of host OS entropy (getentropy, rand_s on Windows), as arc4random_buf does, uniform over the 32-bit range like FreeBSD 11.4's RC4 keystream in arc4random.c. The console's generator and its reseeding are unknown; arc4random_uniform, arc4random_stir and arc4random_addrandom are not in the module's export set and are absent
• pthread_setname_np (libScePosixForWebKit) stores the guest thread name in libkernel's thread object, so pthread_getname_np returns it, and follows libkernel's pthread_rename_np: EINVAL (22) for a null thread or name, ENAMETOOLONG (63) from 32 bytes on, 0 otherwise, with the name truncated to 31 bytes when read back. It does not apply the Windows thread description or the job affinity that scePthreadRename sets, because those helpers are private to libkernel; the console's exact error numbers for this module are unverified
• fnmatch (libScePosixForWebKit) follows FreeBSD 11 fnmatch.c in the C locale: each byte is one character, FNM_CASEFOLD folds ASCII letters only, and bracket ranges compare byte values. [:class:] names are not character classes: as in FreeBSD 11 through 14, [[:digit:]] is the set of [, :, d, i, g, t followed by a literal ] (classes were added to fnmatch.c after 14). Multibyte characters and locale collation are not modelled. A null pattern or string throws
• getservbyname (libScePosixForWebKit) searches a built-in copy of 37 lines of FreeBSD 11.4's etc/services (ftp-data, ftp, ssh, telnet, smtp, domain, tftp, http, pop3, ntp, imap, https, rtsp, submission, imaps, pop3s with their aliases and protocols, in file order) the way getservent.c searches the file: case-sensitive name or alias, a null protocol takes the first match, the port in network byte order, the result in per-thread storage. The console's /etc/services is unknown, so any other service returns null without setting errno, as for a name the file lacks. getaddrinfo still resolves service names through the host's service database
• __wrap_access, __wrap_clock_gettime, __wrap_getcwd, __wrap_getenv, __wrap_lstat and __wrap_mmap (libScePosixForWebKit) assume, from the export names alone, the GNU ld --wrap convention (a reference to <name> resolves to __wrap_<name>): each takes its target's POSIX signature and forwards to libc's (access, getcwd, getenv) or libkernel's (clock_gettime, lstat, mmap) implementation, which sets errno. No PS5 module or WebKit call site was read to confirm that WebKit imports __wrap_<name> in place of <name> or that the console wrappers only forward. Any sandbox or path handling the console module adds is not modelled, and how the wrappers relate to getenv_np, setenv_np, mmap_np and clock_gettime_np (such as a separate environment that setenv_np fills) is unknown