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
37 lines
1.2 KiB
C
37 lines
1.2 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_SYSCTL: sysctl.conf(5)
|
|
*
|
|
* Assignments in the format of the sysctl(8) command, whose file parser
|
|
* trims whitespace around the `=' and strips one pair of quotes around the
|
|
* value, so values are written unquoted unless quoting is required to
|
|
* round-trip (embedded whitespace or a comment character).
|
|
*
|
|
* Sourced at boot in the order below: the first two by rc.d/sysctl (and
|
|
* again by rc.d/sysctl_lastload), the module-specific drop-in by
|
|
* rc.subr(8)'s load_kld when the named kernel module loads.
|
|
*/
|
|
static const struct bsdconf_source bsdconf_sysctl_sources[] = {
|
|
{ BSDCONF_SOURCE_FILE, "/etc/sysctl.conf" },
|
|
{ BSDCONF_SOURCE_FILE, "/etc/sysctl.conf.local" },
|
|
{ BSDCONF_SOURCE_MODDIR, "/etc/sysctl.kld.d" },
|
|
{ BSDCONF_SOURCE_FILE, NULL },
|
|
};
|
|
|
|
const struct bsdconf_format_def bsdconf_format_sysctl_def = {
|
|
.keyword = "sysctl",
|
|
.path = "/etc/sysctl.conf",
|
|
.sources = bsdconf_sysctl_sources,
|
|
.processing = BSDCONF_BREAK_ON_EQUALS | BSDCONF_CASE_SENSITIVE |
|
|
BSDCONF_REQUIRE_EQUALS,
|
|
.put = BSDCONF_PUT_ALLOW_EMPTY,
|
|
};
|