mirror of
https://github.com/freebsd/freebsd-src.git
synced 2026-10-28 11:25:21 +01:00
Devin Teske
b4a465e566
Reviewed by: ziaee, kfv Differential Revision: https://reviews.freebsd.org/D59746
231 lines
4.3 KiB
Plaintext
231 lines
4.3 KiB
Plaintext
.\" Copyright (c) 2013-2026 Devin Teske <[email protected]>
|
|
.\" Copyright (c) 2021-2026 Faraz Vahedi <[email protected]>
|
|
.\"
|
|
.\" SPDX-License-Identifier: BSD-2-Clause
|
|
.\"
|
|
.Dd August 2, 2026
|
|
.Dt SYSCONF-MAKE 8
|
|
.Os
|
|
.Sh NAME
|
|
.Nm "sysconf make"
|
|
.Nd configure make.conf directives
|
|
.Sh SYNOPSIS
|
|
.Nm sysconf
|
|
.Cm make
|
|
.Op Fl ceFinNqsvVx
|
|
.Op Fl j Ar jail | Fl R Ar dir
|
|
.Op Fl f Ar file
|
|
.Ar name Ns Op Ns Oo +|- Oc Ns = Ns Ar value
|
|
.Ar ...
|
|
.Nm sysconf
|
|
.Cm make
|
|
.Op Fl eFnNqvV
|
|
.Op Fl f Ar file
|
|
.Fl a
|
|
.Nm sysconf
|
|
.Cm make
|
|
.Op Fl E
|
|
.Fl l | L
|
|
.Sh DESCRIPTION
|
|
The
|
|
.Cm make
|
|
target of
|
|
.Xr sysconf 8
|
|
reads and writes
|
|
.Xr make 1 Ns -syntax
|
|
configuration on
|
|
.Pa /etc/make.conf
|
|
by default,
|
|
or on any single file named with
|
|
.Fl f .
|
|
Shared options are in
|
|
.Xr sysconf 8 ;
|
|
make(1) limitations and multi-file policy for other targets in
|
|
.Xr sysconf-targets 8 .
|
|
.Pp
|
|
.Ql +=
|
|
is the
|
|
.Xr make 1
|
|
append operator:
|
|
a new
|
|
.Ql name+=value
|
|
line is appended
|
|
.Pq prior assignments for the same name are left intact ,
|
|
and reads report the cumulative effective value as
|
|
.Nm make Fl V
|
|
would.
|
|
Assignment modifiers may also be requested by suffixing the name,
|
|
as in
|
|
.Ql CFLAGS+=-DDEBUG .
|
|
.Pp
|
|
.Ql -=
|
|
is not a
|
|
.Xr make 1
|
|
operator;
|
|
it strikes each given word from the
|
|
.Em last
|
|
assignment whose value contains that word as a whole whitespace-separated
|
|
token
|
|
.Pq rewriting the statement, or deleting it when the value becomes empty ,
|
|
so successive strikes peel list fragments from the end of the assignment
|
|
chain without collapsing earlier
|
|
.Ql +=
|
|
lines.
|
|
.Pp
|
|
.Ql WITH_*
|
|
and
|
|
.Ql WITHOUT_*
|
|
presence knobs may be set with
|
|
.Fl s
|
|
.Pq preferred; writes Ql name=
|
|
or
|
|
.Ar name Ns = ;
|
|
reads report
|
|
.Ql name (present)
|
|
for any assigned value
|
|
.Po
|
|
.Fl e
|
|
prints the real assignment, e.g.\&
|
|
.Ql name=
|
|
or
|
|
.Ql name=t ;
|
|
.Fl n
|
|
prints that same value alone
|
|
.Pc .
|
|
.Fl s
|
|
is a no-op when the knob is already defined
|
|
.Pq any value ;
|
|
an explicit
|
|
.Ar name Ns =
|
|
.Pq including empty
|
|
always writes, and a change of placeholder echoes
|
|
.Ql name: old -> new .
|
|
.Fl s
|
|
does not clear an inverse
|
|
.Ql WITH_
|
|
or
|
|
.Ql WITHOUT_
|
|
for the same option
|
|
.Po
|
|
use
|
|
.Fl V
|
|
and clean up manually if needed
|
|
.Pc .
|
|
.Pp
|
|
Writing
|
|
.Ql WITH_ Ns Ar foo Ns =no
|
|
.Pq exact lowercase Ql no
|
|
still stores the assignment but warns to use
|
|
.Ql WITHOUT_ Ns Ar foo Ns =1 ,
|
|
matching the
|
|
.Ql .warning
|
|
in
|
|
.Pa share/mk/bsd.mkopt.mk .
|
|
.Nm
|
|
emits that advisory on write and on read
|
|
.Pq named queries and Fl a ,
|
|
with
|
|
.Ql file:line:
|
|
of the authoritative statement when known
|
|
.Pq suppressed by Fl q ,
|
|
because
|
|
.Xr make.conf 5
|
|
is read by
|
|
.Pa /usr/src
|
|
builds: a line such as
|
|
.Va WITH_MANCOMPRESS Ns =no
|
|
here is what produces
|
|
.Pp
|
|
.Dl warning: Use WITHOUT_MANCOMPRESS=1 instead of WITH_MANCOMPRESS=no
|
|
.Pp
|
|
when running
|
|
.Xr make 1
|
|
in
|
|
.Pa /usr/src
|
|
.Pq after Pa bsd.opts.mk reloads Pa bsd.mkopt.mk for common options .
|
|
The read-time form matters when the default presence display hides the
|
|
.Ql =no
|
|
value behind
|
|
.Ql (present) .
|
|
The same line stays silent under a bare
|
|
.Ql make -C /tmp
|
|
or ports, which never evaluate that option list.
|
|
Neither
|
|
.Nm
|
|
nor make warns for
|
|
.Ql WITHOUT_* Ns =no
|
|
or
|
|
.Ql WITH_* Ns =NO :
|
|
presence of
|
|
.Ql WITHOUT_
|
|
still disables, and
|
|
.Ql WITH_
|
|
with a value other than lowercase
|
|
.Ql no
|
|
does not match the check.
|
|
.Pp
|
|
.Va WITHOUT_MODULES
|
|
is not a presence knob:
|
|
its value is a module reject list, so
|
|
.Fl s
|
|
is rejected and reads print the module list rather than
|
|
.Ql (present) .
|
|
Set it with a normal assignment
|
|
.Pq e.g. Va WITHOUT_MODULES Ns = Ns Ar plip .
|
|
.Pp
|
|
This target has no defaults file;
|
|
.Fl d ,
|
|
.Fl D ,
|
|
and
|
|
.Fl A
|
|
are errors.
|
|
For the
|
|
.Pa /usr/src
|
|
build triad see
|
|
.Xr sysconf-src 8 .
|
|
.Sh FILES
|
|
.Bl -tag -width "/etc/make.conf" -compact
|
|
.It Pa /etc/make.conf
|
|
Default file for the
|
|
.Cm make
|
|
target.
|
|
.El
|
|
.Sh EXAMPLES
|
|
.Dl sysconf make CFLAGS+=-DDEBUG
|
|
.Dl sysconf make -s WITHOUT_MANCOMPRESS
|
|
.Dl sysconf make WITHOUT_MANCOMPRESS
|
|
.Pp
|
|
Strike a word from the last
|
|
.Ql +=
|
|
fragment that contains it
|
|
.Pq here removing Ql 3 from the final line only :
|
|
.Bd -literal -offset indent
|
|
bar+=1
|
|
bar+=1 2
|
|
bar+=1 2 3
|
|
.Ed
|
|
.Pp
|
|
.Dl sysconf make bar-=3
|
|
.Pp
|
|
leaves
|
|
.Ql bar+=1 2
|
|
on the last line.
|
|
Repeating with
|
|
.Ql bar-=2
|
|
and
|
|
.Ql bar-=1
|
|
peels that line further, then removes it when emptied.
|
|
.Sh SEE ALSO
|
|
.Xr make 1 ,
|
|
.Xr sysconf 8 ,
|
|
.Xr sysconf-src 8 ,
|
|
.Xr sysconf-targets 8
|
|
.Sh HISTORY
|
|
The
|
|
.Nm sysconf
|
|
utility first appeared in
|
|
.Fx 16.0 .
|
|
.Sh AUTHORS
|
|
.An Devin Teske Aq Mt [email protected]
|
|
.An Faraz Vahedi Aq Mt [email protected]
|