Module Name: src
Committed By: lukem
Date: Thu May 18 14:22:53 UTC 2023
Modified Files:
src: BUILDING
src/doc: BUILDING.mdoc
Log Message:
BUILDING: TMPDIR must not be noexec
Describe $TMPDIR as used by build.sh, and
add a note that it can't be mounted noexec.
PR toolchain/44459
To generate a diff of this commit:
cvs rdiff -u -r1.148 -r1.149 src/BUILDING
cvs rdiff -u -r1.137 -r1.138 src/doc/BUILDING.mdoc
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/BUILDING
diff -u src/BUILDING:1.148 src/BUILDING:1.149
--- src/BUILDING:1.148 Tue May 16 21:39:26 2023
+++ src/BUILDING Thu May 18 14:22:53 2023
@@ -157,6 +157,15 @@ CONFIGURATION
cannot usefully be set inside a Makefile, including
mk.conf or ${MAKECONF}.
+ TMPDIR Top-level directory to store temporary directories used
+ by build.sh before paths to other directories such as
+ .OBJDIR can be determined.
+
+ Note: Must support execution of binaries. I.e.,
+ without mount(8)'s -o noexec option.
+
+ Default: "/tmp".
+
"make" variables
Several variables control the behavior of NetBSD builds. Unless
otherwise specified, these variables may be set in either the process
@@ -1115,7 +1124,7 @@ OBSOLETE VARIABLES
TOOLCHAIN_MISSING=yes.
SEE ALSO
- make(1), hier(7), release(7), etcupdate(8), installboot(8),
+ make(1), hier(7), release(7), etcupdate(8), installboot(8), mount(8),
postinstall(8), sysinst(8), pkgsrc/sysutils/cdrtools
HISTORY
@@ -1128,4 +1137,4 @@ CAVEATS
in object directories. Instead, one may have to manually remove the
files. Consult the UPDATING file for notices concerning this.
-NetBSD May 16, 2023 NetBSD
+NetBSD May 18, 2023 NetBSD
Index: src/doc/BUILDING.mdoc
diff -u src/doc/BUILDING.mdoc:1.137 src/doc/BUILDING.mdoc:1.138
--- src/doc/BUILDING.mdoc:1.137 Tue May 16 21:39:26 2023
+++ src/doc/BUILDING.mdoc Thu May 18 14:22:53 2023
@@ -1,4 +1,4 @@
-.\" $NetBSD: BUILDING.mdoc,v 1.137 2023/05/16 21:39:26 lukem Exp $
+.\" $NetBSD: BUILDING.mdoc,v 1.138 2023/05/18 14:22:53 lukem Exp $
.\"
.\" Copyright (c) 2001-2023 The NetBSD Foundation, Inc.
.\" All rights reserved.
@@ -33,7 +33,7 @@
.\" Toolchain prefix for commands
.ds toolprefix nb
.
-.Dd May 16, 2023
+.Dd May 18, 2023
.Dt BUILDING 8
.Os NetBSD
.
@@ -186,6 +186,28 @@ and the release layout is described in
.
.Ss Environment variables
.
+.de YorN
+Can be set to
+.Dq yes
+or
+.Dq no .
+..
+.de DFLT
+.Pp
+.Em Default :
+..
+.de DFLTu
+.DFLT
+Unset.
+..
+.de DFLTy
+.DFLT
+.Dq yes
+..
+.de DFLTn
+.DFLT
+.Dq no
+..
Several environment variables control the behaviour of
.Nx
builds.
@@ -327,32 +349,28 @@ it cannot usefully be set inside a Makef
or
.Sy ${MAKECONF} .
.
+.
+.It Sy TMPDIR
+Top-level directory to store temporary directories used by
+.Sy build.sh
+before paths to other directories such as
+.Sy .OBJDIR
+can be determined.
+.Pp
+.Em Note :
+Must support execution of binaries.
+I.e., without
+.Xr mount 8 Ns 's
+.Fl o
+.Sy noexec
+option.
+.DFLT
+.Dq /tmp .
+.
.El
.
.Ss \*qmake\*q variables
.
-.de YorN
-Can be set to
-.Dq yes
-or
-.Dq no .
-..
-.de DFLT
-.Pp
-.Em Default :
-..
-.de DFLTu
-.DFLT
-Unset.
-..
-.de DFLTy
-.DFLT
-.Dq yes
-..
-.de DFLTn
-.DFLT
-.Dq no
-..
Several variables control the behavior of
.Nx
builds.
@@ -2162,6 +2180,7 @@ To disable, use
.Xr release 7 ,
.Xr etcupdate 8 ,
.Xr installboot 8 ,
+.Xr mount 8 ,
.Xr postinstall 8 ,
.Xr sysinst 8 ,
.Pa pkgsrc/sysutils/cdrtools