valis / Reference / API reference

Main - API reference

Exported surface for the main subsystem. Part of the API reference.

Package valis/src/main

Functions

main

(main &rest args)

Main entry point. Dispatches on command-line arguments. When invoked as the saved image's toplevel, ARGS is empty (SBCL calls the toplevel with no Lisp arguments), so fall back to the process command line. The build saves with :save-runtime-options t, so SBCL passes flags like –version straight through instead of intercepting them itself.

–resident is the steered production boot: it consumes –control-socket <path> and –ports <set> (value args) and fails closed on either being absent or a malformed port, so an incomplete launcher invocation refuses rather than binding a default port. –daemon stays a harmless no-op; –run (foreground loopback) and –dev are unchanged.

stamp-build-commit

(stamp-build-commit)

Set COMMIT from the source tree valis was compiled from and return it. Builders call this immediately before dumping the image.