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

Reply via email to