[src/trunk]: src BUILDING: TMPDIR must not be noexec

[lukem <lukem%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/887515384afc
branches:  trunk
changeset: 375879:887515384afc
user:      lukem <lukem%NetBSD.org@localhost>
date:      Thu May 18 14:22:53 2023 +0000

description:
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

diffstat:

 BUILDING          |  13 +++++++++-
 doc/BUILDING.mdoc |  67 +++++++++++++++++++++++++++++++++++-------------------
 2 files changed, 54 insertions(+), 26 deletions(-)

diffs (140 lines):

diff -r 7159b870add5 -r 887515384afc BUILDING
--- a/BUILDING  Thu May 18 12:01:58 2023 +0000
+++ b/BUILDING  Thu May 18 14:22:53 2023 +0000
@@ -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
diff -r 7159b870add5 -r 887515384afc doc/BUILDING.mdoc
--- a/doc/BUILDING.mdoc Thu May 18 12:01:58 2023 +0000
+++ b/doc/BUILDING.mdoc Thu May 18 14:22:53 2023 +0000
@@ -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