upstream/opnsense-src
1
0
Fork 0
mirror of https://github.com/opnsense/src.git synced 2026-06-06 07:12:52 -04:00
Code Issues Projects Releases Packages Wiki Activity Actions
opnsense-src/sys/tools/syscalls
History
Brooks Davis 9355ad0b0b makesyscalls: emit cpp in syscalls.map 
If there are per-platform differences in which syscalls are supported,
we should only try to export implemented ones in libc.  Fortunately,
syscall maps are run though cpp.  This is arguably incomplete as
syscall.mk isn't (and can't practically be) supported.

Reviewed by:	kevans
Sponsored by:	DARPA, AFRL
Pull Request:	https://github.com/freebsd/freebsd-src/pull/1575
2025-02-18 22:03:33 +00:00
..
core makesyscalls: deprecate cpp other than includes 2025-02-18 22:03:26 +00:00
examples/cpp makesyscalls: emit cpp in syscalls.map 2025-02-18 22:03:33 +00:00
scripts makesyscalls: emit cpp in syscalls.map 2025-02-18 22:03:33 +00:00
tools makesyscalls: Restore support for cpp in input 2025-02-18 22:03:13 +00:00
config.lua
main.lua
README.md Update mentions of makesyscalls.lua 2024-10-30 21:04:31 +00:00

README.md

System call creation library

Parses syscalls.master and packages information into objects with methods. Modules reproduce the previously monolithic file auto-generation.

We generally assume that this script will be run by flua, however we've carefully crafted modules for it that mimic interfaces provided by modules available in ports. Currently, this script is compatible with lua from ports along with the compatible luafilesystem and lua-posix modules.

Usage

main.lua generates all files. Files are associated with their respective modules, and modules can be run as standalone scripts to generate specific files.

Examples

All files: # /usr/libexec/flua /usr/src/sys/tools/syscalls/main.lua /usr/src/sys/kern/syscalls.master
syscalls.h: # /usr/libexec/flua /usr/src/sys/tools/syscalls/scripts/syscalls.h /usr/src/sys/kern/syscalls.master

Organization

  • root

    • main.lua - Main entry point that calls all scripts.

    • config.lua - Contains the global configuration table and associated configuration functions.

    • core (Core Classes)

      • syscall.lua - Packages each system call entry from syscalls.master into a system call object.
      • scarg.lua - Packages each argument for the system call into an argument object.
      • scret.lua - An object for the return value of the system call.
      • freebsd-syscall.lua - Contains the master system call table after processing.

    • scripts

      • init_sysent.lua - Generates init_sysent.c.
      • libsys_h.lua - Generates lib/libsys/_libsys.h.
      • syscall_h.lua - Generates syscall.h.
      • syscall_mk.lua - Generates syscall.mk.
      • syscalls.lua - Generates syscalls.c.
      • syscalls_map.lua - Generates lib/libsys/syscalls.map.
      • sysproto_h.lua - Generates sysproto.h.
      • systrace_args.lua - Generates systrace_args.c.

    • tools

      • util.lua - Contains utility functions.
      • generator.lua - Handles file generation for the library.