Aren/NetBSD
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Update for the MKUNPRIVED/MKUPDATE changes.

Browse Source
This commit is contained in:
lukem 2003-07-18 08:38:10 +00:00
parent 1553f8efd9
commit 6d22656bee
2 changed files with 78 additions and 71 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

64
BUILDING
View File

@ -233,6 +233,24 @@ CONFIGURATION
Default: ``yes''
MKUNPRIVED Can be set to ``yes'' or ``no''. Indicates whether an un-
privileged install will occur. The user, group, permissions,
and file flags, will not be set on the installed item; in-
stead the information will be appended to a file called
METALOG in DESTDIR. The contents of METALOG is used during
the generation of the distribution tar files to ensure that
the appropriate file ownership is stored.
Default: ``no''
MKUPDATE Can be set to ``yes'' or ``no''. Indicates whether all in-
stall operations intended to write to DESTDIR will compare
file timestamps before installing, and skip the install phase
if the destination files are up-to-date. This also has im-
plications on full builds (see next subsection).
Default: ``no''
TOOLDIR Directory to hold the host tools, once built. This directory
should be unique to a given host system and NetBSD source
tree. (However, multiple targets may share the same TOOLDIR;
@ -242,23 +260,6 @@ CONFIGURATION
Default: Unset.
UNPRIVED If set, then an unprivileged install will occur. The user,
group, permissions, and file flags, will not be set on the
installed item; instead the information will be appended to a
file called METALOG in DESTDIR. The contents of METALOG is
used during the generation of the distribution tar files to
ensure that the appropriate file ownership is stored.
Default: Unset.
UPDATE If set, then all install operations intended to write to
DESTDIR will compare file timestamps before installing, and
skip the install phase if the destination files are up-to-
date. This also has implications on full builds (see next
subsection).
Default: Unset.
USETOOLS Indicates whether the tools specified by TOOLDIR should be
used as part of a build in progress. Must be set to ``yes''
if cross-compiling.
@ -297,6 +298,13 @@ CONFIGURATION
Default: ``no''
MKUPDATE Can be set to ``yes'' or ``no''. If set, then in addi-
tion to the effects described for MKUPDATE=yes above,
this implies the effects of NOCLEANDIR (i.e., ``make
cleandir'' is avoided).
Default: ``no''
NBUILDJOBS Now obsolete. Use the make(1) option -j, instead (see
below)
@ -323,7 +331,7 @@ CONFIGURATION
cause the system include files have changed. However,
this option should not be used when updating the entire
NetBSD source tree arbitrarily; it is suggested to use
UPDATE in that case.
MKUPDATE=yes in that case.
Default: Unset.
@ -335,10 +343,6 @@ CONFIGURATION
Note: build.sh will provide a default of releasedir (in
the top-level .OBJDIR) unless run in `expert' mode
UPDATE If set, then in addition to the effects described for
UPDATE above, this implies the effects of NOCLEANDIR
(i.e., ``make cleandir'' is avoided).
BUILDING
"make" command line options
This is only a summary of options available to make(1); only the options
@ -526,8 +530,8 @@ BUILDING
-E Set `expert' mode. This overrides various sanity checks, and
allows: DESTDIR does not have to be set to a non-root path for
builds, and UNPRIVED does not have to be set when building as a
non-root user.
builds, and MKUNPRIVED=yes does not have to be set when build-
ing as a non-root user.
Note: It is highly recommended that you know what you are doing
when you use this option.
@ -584,9 +588,9 @@ BUILDING
``make'' will only be rebuilt as needed (when the source files
for make(1) change).
-U Set the UNPRIVED variable.
-U Set MKUNPRIVED=yes.
-u Set the UPDATE variable.
-u Set MKUPDATE=yes.
-V var=[value]
Set the variable var to value (which is optional).
@ -630,9 +634,9 @@ EXAMPLES
Using unprivileged mode, build a complete release to DESTDIR and
RELEASEDIR directories that build.sh selects (and will display).
UPDATE (-u) is set to prevent the ``make cleandir'', so that if this
is run after example 2, it doesn't need to redo that portion of the
release build.
MKUPDATE=yes (-u) is set to prevent the ``make cleandir'', so that
if this is run after example 2, it doesn't need to redo that portion
of the release build.
OBSOLETE VARIABLES
NBUILDJOBS Use the make(1) option -j, instead.
@ -651,4 +655,4 @@ HISTORY
BUGS
A few platforms are not yet using this build system.
NetBSD July 3, 2003 NetBSD
NetBSD July 18, 2003 NetBSD

85
doc/BUILDING.mdoc
View File

@ -1,4 +1,4 @@
.\" $NetBSD: BUILDING.mdoc,v 1.24 2003/07/18 01:55:08 lukem Exp $
.\" $NetBSD: BUILDING.mdoc,v 1.25 2003/07/18 08:38:45 lukem Exp $
.\"
.\" Copyright (c) 2001-2003 The NetBSD Foundation, Inc.
.\" All rights reserved.
@ -40,7 +40,7 @@
.\" Toolchain prefix for commands
.ds toolprefix nb
.
.Dd July 3, 2003
.Dd July 18, 2003
.Dt BUILDING 8
.Os NetBSD
.
@ -447,6 +447,30 @@ will be set to
unconditionally.
.DFLTy
.
.It Sy MKUNPRIVED
.YorN
Indicates whether an unprivileged install will occur.
The user, group, permissions, and file flags, will not be set on
the installed item; instead the information will be appended to
a file called
.Pa METALOG
in
.Sy DESTDIR .
The contents of
.Pa METALOG
is used during the generation of the distribution tar files to ensure
that the appropriate file ownership is stored.
.DFLTn
.
.It Sy MKUPDATE
.YorN
Indicates whether all install operations intended to write to
.Sy DESTDIR
will compare file timestamps before installing, and skip the install
phase if the destination files are up-to-date.
This also has implications on full builds (see next subsection).
.DFLTn
.
.It Sy TOOLDIR
Directory to hold the host tools, once built.
This directory should be unique to a given host system and
@ -463,28 +487,6 @@ of
.Pa src/tools .
.DFLTu
.
.It Sy UNPRIVED
If set, then an unprivileged install will occur.
The user, group, permissions, and file flags, will not be set on
the installed item; instead the information will be appended to
a file called
.Pa METALOG
in
.Sy DESTDIR .
The contents of
.Pa METALOG
is used during the generation of the distribution tar files to ensure
that the appropriate file ownership is stored.
.DFLTu
.
.It Sy UPDATE
If set, then all install operations intended to write to
.Sy DESTDIR
will compare file timestamps before installing, and skip the install
phase if the destination files are up-to-date.
This also has implications on full builds (see next subsection).
.DFLTu
.
.It Sy USETOOLS
Indicates whether the tools specified by
.Sy TOOLDIR
@ -552,6 +554,17 @@ Indicates whether object directories will be created automatically
pass) at the start of a build.
.DFLTn
.
.It Sy MKUPDATE
.YorN
If set, then in addition to the effects described for
.Sy MKUPDATE=yes
above, this implies the effects of
.Sy NOCLEANDIR
(i.e.,
.Dq make cleandir
is avoided).
.DFLTn
.
.It Sy NBUILDJOBS
Now obsolete.
Use the
@ -593,7 +606,7 @@ system include files have changed.
However, this option should not be used when updating the entire
.Nx
source tree arbitrarily; it is suggested to use
.Sy UPDATE
.Sy MKUPDATE=yes
in that case.
.DFLTu
.
@ -614,14 +627,6 @@ unless run in
.Sq expert
mode
.
.It Sy UPDATE
If set, then in addition to the effects described for UPDATE above, this
implies the effects of
.Sy NOCLEANDIR
(i.e.,
.Dq make cleandir
is avoided).
.
.El
.
.Sh BUILDING
@ -1027,7 +1032,7 @@ This overrides various sanity checks, and allows:
.Sy DESTDIR
does not have to be set to a non-root path for builds,
and
.Sy UNPRIVED
.Sy MKUNPRIVED=yes
does not have to be set when building as a non-root user.
.Pp
.Em Note :
@ -1144,14 +1149,12 @@ will only be rebuilt as needed (when the source files for
change).
.
.It Fl U
Set the
.Sy UNPRIVED
variable.
Set
.Sy MKUNPRIVED=yes .
.
.It Fl u
Set the
.Sy UPDATE
variable.
Set
.Sy MKUPDATE=yes .
.
.It Xo
.Fl V
@ -1253,7 +1256,7 @@ and
directories that
.Sy build.sh
selects (and will display).
.Sy UPDATE
.Sy MKUPDATE=yes
.Pq Fl u
is set to prevent the
.Dq make cleandir ,