mirror of
https://github.com/freebsd/freebsd-src.git
synced 2026-11-07 04:36:52 -10:00
Devin Teske
3fe5961a0b
Complete the native configuration trinity: sysctl(8) for live kernel state, sysrc(8) for rc.conf(5), and sysconf(8) for the remaining base configuration -- loader.conf(5), sysctl.conf(5), and the make.conf(5) family -- atop libbsdconf(3). libbsdconf resurrects figpar as a unified reader/writer. Callbacks own semantics; statements may span multiple lines via backslash continuation; non-seekable input is spooled; writes are atomic (mkstemp, fsync, rename) with mode/owner preservation. Format descriptors name each target, its files, and quoting rules without private parsers. Multi-file targets follow boot sourcing order; loader chases loader_conf_files as the boot loader does. sysconf(8) is the operator-facing tool: name / name=value on a required target, sysrc-style list edits, make append and list-strike where they belong, jail/altroot, and a capsicum sandbox for read-only use. Sysctl writes validate against the running kernel first -- unknown and read-only OIDs, CTLFLAG_TUN (pointing at the loader target), and CTLTYPE range checks -- so a typo or overflow does not land in sysctl.conf. Make and src treat WITH_/WITHOUT_ as presence knobs (as bsd.mkopt.mk / src.conf(5) do) and warn on the WITH_*=no form that does not disable the option, so a bad assignment is caught before an /usr/src build surfaces it. The rc target passes through to sysrc(8). Defaults querying (-d/-D/-A) mirrors sysrc for dumps and descriptions on targets that have a defaults file; named reads already see defaults, and -A only widens dump scope. Manuals are split pkg(8)-style (bsdconf/put/format; sysconf plus per-target pages). ATF coverage exercises the frontend. Co-authored-by: Faraz Vahedi <[email protected]> Reviewed by: fuz, kfv Differential Revision: https://reviews.freebsd.org/D58066
39 lines
1.4 KiB
C
39 lines
1.4 KiB
C
/*
|
|
* Copyright (c) 2013-2026 Devin Teske <[email protected]>
|
|
* Copyright (c) 2021-2026 Faraz Vahedi <[email protected]>
|
|
*
|
|
* SPDX-License-Identifier: BSD-2-Clause
|
|
*/
|
|
|
|
#include "bsdconf_formats.h"
|
|
|
|
/*
|
|
* BSDCONF_FORMAT_SRC: /usr/src build audience
|
|
*
|
|
* Make(1) syntax, matching make.conf(5) / src.conf(5). The FreeBSD source
|
|
* tree consults three configuration files in order (see src.sys.env.mk,
|
|
* sys.mk, and src.sys.mk): src-env.conf, make.conf, then src.conf. New
|
|
* directives are written to src.conf (def->path); later files override
|
|
* earlier ones for `=' and accumulate for `+='. Environment overrides
|
|
* (SRC_ENV_CONF, __MAKE_CONF, SRCCONF) are applied by sysconf(8).
|
|
*
|
|
* sys.mk / local.sys.mk and `.if' / control flow are intentionally out of
|
|
* scope: conf files may contain them, but this format does not evaluate
|
|
* them (see LIMITATIONS in sysconf(8)).
|
|
*/
|
|
static const struct bsdconf_source bsdconf_src_sources[] = {
|
|
{ BSDCONF_SOURCE_FILE, "/etc/src-env.conf" },
|
|
{ BSDCONF_SOURCE_FILE, "/etc/make.conf" },
|
|
{ BSDCONF_SOURCE_FILE, "/etc/src.conf" },
|
|
{ BSDCONF_SOURCE_FILE, NULL },
|
|
};
|
|
|
|
const struct bsdconf_format_def bsdconf_format_src_def = {
|
|
.keyword = "src",
|
|
.path = "/etc/src.conf",
|
|
.sources = bsdconf_src_sources,
|
|
.processing = BSDCONF_BREAK_ON_EQUALS | BSDCONF_CASE_SENSITIVE |
|
|
BSDCONF_OPERATOR_EQUALS,
|
|
.put = BSDCONF_PUT_UNQUOTED | BSDCONF_PUT_ALLOW_EMPTY,
|
|
};
|