Module auxv

Expand description

Linux auxv support.

§Safety

This uses raw pointers to locate and read the kernel-provided auxv array.

check_elf_base 🔒 ^⚠: Check that base is a valid pointer to the kernel-provided vDSO.
init_auxv 🔒: Read the auxv records and initialize the various static variables. Panic if an error is encountered.
init_auxv_impl 🔒: If we don’t have “use-explicitly-provided-auxv” or “use-libc-auxv”, we read the aux vector via the prctl PR_GET_AUXV, with a fallback to /proc/self/auxv for kernels that don’t support PR_GET_AUXV.
init_from_aux_iter 🔒 ^⚠: Process auxv entries from the auxv array pointed to by auxp.
init_from_auxv_file 🔒: Process auxv entries from the open file auxv.
maybe_init_auxv 🔒: Like init_auxv, but don’t panic if an error is encountered. The caller must be prepared for initialization to be skipped.
pr_get_auxv_dynamic 🔒: Use Linux ≥ 6.4’s PR_GET_AUXV to read the aux records, using a provided statically-sized buffer if possible, or a dynamically allocated buffer otherwise. Return:
pr_get_auxv_static 🔒: Use Linux ≥ 6.4’s PR_GET_AUXV to read the aux records, into a provided statically-sized buffer. Return:
sysinfo_ehdr 🔒: AT_SYSINFO_EHDR isn’t present on all platforms in all configurations, so if we don’t see it, this function returns a null pointer.