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
AUTHORS
The mechanism for loading loader.conf.lua
files was originally written by Kyle Evans
<kevans@FreeBSD.org>.