FreeBSD manual
download PDF document: loader.conf.lua.5.pdf
LOADER.CONF.LUA(5) FreeBSD File Formats Manual LOADER.CONF.LUA(5)
NAME
loader.conf.lua - Lua-based system bootstrap configuration file
DESCRIPTION
When the lua-based loader(8) encounters a filename in loader_conf_files
that has a ".lua" suffix, it will be loaded and executed by the lua
interpreter in a limited environment.
The limited environment does not contain the ability to reference or load
other lua modules. Existing loader environment variables may be
referenced as if they were already defined global variables.
A lua configuration file may set any global variable, which will
subsequently be processed and added to the environment after execution of
the configuration file has completed. Other than the exec setting, all
variables described in loader.conf(5) operate the same in the
loader.conf.lua environment. Note that the settings describing module
options can only be set in the environment; there is currently no way for
a loader.conf.lua to fetch them. At this time, global table and function
values are ignored.
The config.buildenv() hook will be run with an empty environment provided
to it that may be populated by a custom local.lua.
SEE ALSO
loader.conf(5)
AUTHORS
The mechanism for loading loader.conf.lua files was originally written by
Kyle Evans <kevans@FreeBSD.org>.
FreeBSD 14.0-RELEASE-p11 May 10, 2023 FreeBSD 14.0-RELEASE-p11