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

Prefix various paths with 'DESTDIR', to highlight that the DESTDIR

Browse Source 
is taken into account.
This commit is contained in:
lukem 2003-01-30 02:52:40 +00:00
parent 1627b9c342
commit 34e5de7919
2 changed files with 42 additions and 42 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

42
BUILDING
View File

@ -67,8 +67,8 @@ FILES
distrib/, etc/ distrib/, etc/
Sources for items used when making a full release snap- Sources for items used when making a full release snap-
shot, such as files installed in /etc on the destination shot, such as files installed in DESTDIR/etc on the desti-
system, boot media, and release notes. nation system, boot media, and release notes.
regress/ Regression test harness. Can be cross-compiled, but only regress/ Regression test harness. Can be cross-compiled, but only
run natively. run natively.
@ -151,8 +151,8 @@ CONFIGURATION
Default: ``yes'' Default: ``yes''
MKDOC Can be set to ``yes'' or ``no''. Indicates whether system MKDOC Can be set to ``yes'' or ``no''. Indicates whether system
documentation destined for /usr/share/doc will be installed documentation destined for DESTDIR/usr/share/doc will be in-
during a build. stalled during a build.
Default: ``yes'' Default: ``yes''
@ -176,7 +176,7 @@ CONFIGURATION
MKLINT Can be set to ``yes'' or ``no''. Indicates whether lint(1) MKLINT Can be set to ``yes'' or ``no''. Indicates whether lint(1)
will be run against portions of the NetBSD source code during will be run against portions of the NetBSD source code during
the build, and whether lint libraries will be installed into the build, and whether lint libraries will be installed into
/usr/libdata/lint. DESTDIR/usr/libdata/lint.
Default: ``yes'' Default: ``yes''
@ -222,10 +222,10 @@ CONFIGURATION
code. code.
MKSHARE Can be set to ``yes'' or ``no''. Indicates whether files MKSHARE Can be set to ``yes'' or ``no''. Indicates whether files
destined to reside in /usr/share will be built and installed destined to reside in DESTDIR/usr/share will be built and in-
during a build. If set to ``no'', then all of MKCATPAGES, stalled during a build. If set to ``no'', then all of
MKDOC, MKINFO, MKMAN, and MKNLS will be set to ``no'' uncon- MKCATPAGES, MKDOC, MKINFO, MKMAN, and MKNLS will be set to
ditionally. ``no'' unconditionally.
Default: ``yes'' Default: ``yes''
@ -388,9 +388,9 @@ BUILDING
fore any system libraries or programs can be built. fore any system libraries or programs can be built.
install Install programs, libraries, and documentation into DESTDIR. install Install programs, libraries, and documentation into DESTDIR.
Few files will be installed to /dev, /etc, /root or /var in Few files will be installed to DESTDIR/dev, DESTDIR/etc,
order to prevent user supplied configuration data from being DESTDIR/root or DESTDIR/var in order to prevent user supplied
overwritten. configuration data from being overwritten.
lint Run lint(1) against the C source code, where appropriate, and lint Run lint(1) against the C source code, where appropriate, and
generate system-installed lint libraries. generate system-installed lint libraries.
@ -410,8 +410,8 @@ BUILDING
the proper order. the proper order.
distribution Do a ``make build'', and then install a full distribution distribution Do a ``make build'', and then install a full distribution
into DESTDIR, including files in /dev, /etc, /root and into DESTDIR, including files in DESTDIR/dev, DESTDIR/etc,
/var. DESTDIR/root and DESTDIR/var.
buildworld As per ``make distribution'', except that it ensures that buildworld As per ``make distribution'', except that it ensures that
DESTDIR is not the root directory. DESTDIR is not the root directory.
@ -576,20 +576,20 @@ EXAMPLES
Build a new toolchain, and use the new toolchain to configure Build a new toolchain, and use the new toolchain to configure
and build a new GENERIC kernel. and build a new GENERIC kernel.
./build.sh -U -D /path/to/DESTDIR distribution ./build.sh -U -D /path/to/destdir distribution
Using unprivileged mode, build a complete distribution in Using unprivileged mode, build a complete distribution in
/path/to/DESTDIR. /path/to/destdir.
# ./build.sh -U -D /path/to/DESTDIR installworld=/ # ./build.sh -U -D /path/to/destdir installworld=/
As root, install the distribution that was built with unprivi- As root, install the distribution that was built with unprivi-
leged mode from /path/to/DESTDIR to /. (Even though this is leged mode from /path/to/destdir to /. (Even though this is
run as root, -U is required so that the permissions stored in run as root, -U is required so that the permissions stored in
/path/to/DESTDIR/METALOG are correctly applied to the files as /path/to/destdir/METALOG are correctly applied to the files as
they're copied to /). they're copied to /).
./build.sh -U -D /path/to/DESTDIR -R /path/to/RELEASE release ./build.sh -U -D /path/to/destdir -R /path/to/releasedir release
Using unprivileged mode, build a complete release in Using unprivileged mode, build a complete release in
/path/to/dir/RELEASE. /path/to/dir/releasedir.
OBSOLETE VARIABLES OBSOLETE VARIABLES
NBUILDJOBS Use the make(1) option -j, instead. NBUILDJOBS Use the make(1) option -j, instead.

42
doc/BUILDING.mdoc
View File

@ -1,4 +1,4 @@
.\" $NetBSD: BUILDING.mdoc,v 1.13 2003/01/29 22:50:10 lukem Exp $ .\" $NetBSD: BUILDING.mdoc,v 1.14 2003/01/30 02:52:40 lukem Exp $
.\" .\"
.\" Copyright (c) 2001-2003 The NetBSD Foundation, Inc. .\" Copyright (c) 2001-2003 The NetBSD Foundation, Inc.
.\" All rights reserved. .\" All rights reserved.
@ -153,7 +153,7 @@ Makefile semantics when building these programs for a native host.
.It Sy distrib/ , etc/ .It Sy distrib/ , etc/
Sources for items used when making a full release snapshot, such as Sources for items used when making a full release snapshot, such as
files installed in files installed in
.Sy /etc .Sy DESTDIR Ns Pa /etc
on the destination system, boot media, and release notes. on the destination system, boot media, and release notes.
.It Sy regress/ .It Sy regress/
Regression test harness. Regression test harness.
@ -324,7 +324,7 @@ Will not affect use of the standard low-security password encryption system,
.It Sy MKDOC .It Sy MKDOC
.YorN .YorN
Indicates whether system documentation destined for Indicates whether system documentation destined for
.Sy /usr/share/doc .Sy DESTDIR Ns Pa /usr/share/doc
will be installed during a build. will be installed during a build.
.DFLTy .DFLTy
. .
@ -358,7 +358,7 @@ will be run against portions of the
.Nx .Nx
source code during the build, and whether lint libraries will be source code during the build, and whether lint libraries will be
installed into installed into
.Sy /usr/libdata/lint . .Sy DESTDIR Ns Pa /usr/libdata/lint .
.DFLTy .DFLTy
. .
.It Sy MKMAN .It Sy MKMAN
@ -418,7 +418,7 @@ by default at times due to toolchain problems with profiled code.
.It Sy MKSHARE .It Sy MKSHARE
.YorN .YorN
Indicates whether files destined to reside in Indicates whether files destined to reside in
.Sy /usr/share .Sy DESTDIR Ns Pa /usr/share
will be built and installed during a build. will be built and installed during a build.
If set to If set to
.Dq no , .Dq no ,
@ -707,11 +707,11 @@ Typically needed before any system libraries or programs can be built.
Install programs, libraries, and documentation into Install programs, libraries, and documentation into
.Sy DESTDIR . .Sy DESTDIR .
Few files will be installed to Few files will be installed to
.Pa /dev , .Sy DESTDIR Ns Pa /dev ,
.Pa /etc , .Sy DESTDIR Ns Pa /etc ,
.Pa /root .Sy DESTDIR Ns Pa /root
or or
.Pa /var .Sy DESTDIR Ns Pa /var
in order to prevent user supplied configuration data from being overwritten. in order to prevent user supplied configuration data from being overwritten.
.It Sy lint .It Sy lint
Run Run
@ -758,11 +758,11 @@ Do a
and then install a full distribution into and then install a full distribution into
.Sy DESTDIR , .Sy DESTDIR ,
including files in including files in
.Pa /dev , .Sy DESTDIR Ns Pa /dev ,
.Pa /etc , .Sy DESTDIR Ns Pa /etc ,
.Pa /root .Sy DESTDIR Ns Pa /root
and and
.Pa /var . .Sy DESTDIR Ns Pa /var .
. .
.It Sy buildworld .It Sy buildworld
As per As per
@ -789,7 +789,7 @@ before performing this operation.
Create distribution sets from Create distribution sets from
.Sy DESTDIR .Sy DESTDIR
into into
.Sy RELEASEDIR Ns Pa /MACHINE/binary/sets . .Sy RELEASEDIR/MACHINE Ns Pa /binary/sets .
Should be run after Should be run after
.Dq make distribution .Dq make distribution
(as (as
@ -1134,27 +1134,27 @@ or called with an absolute path.
Build a new toolchain, and use the new toolchain to Build a new toolchain, and use the new toolchain to
configure and build a new GENERIC kernel. configure and build a new GENERIC kernel.
. .
.It Li "./build.sh -U -D /path/to/DESTDIR distribution" .It Li "./build.sh -U -D /path/to/destdir distribution"
Using unprivileged mode, Using unprivileged mode,
build a complete distribution in build a complete distribution in
.Pa /path/to/DESTDIR . .Pa /path/to/destdir .
. .
.It Li "# ./build.sh -U -D /path/to/DESTDIR installworld=/" .It Li "# ./build.sh -U -D /path/to/destdir installworld=/"
As root, install the distribution that was built with unprivileged mode from As root, install the distribution that was built with unprivileged mode from
.Pa /path/to/DESTDIR .Pa /path/to/destdir
to to
.Pa / . .Pa / .
(Even though this is run as root, (Even though this is run as root,
.Fl U .Fl U
is required so that the permissions stored in is required so that the permissions stored in
.Pa /path/to/DESTDIR/METALOG .Pa /path/to/destdir/METALOG
are correctly applied to the files as they're copied to are correctly applied to the files as they're copied to
.Pa / ) . .Pa / ) .
. .
.It Li "./build.sh -U -D /path/to/DESTDIR -R /path/to/RELEASE release" .It Li "./build.sh -U -D /path/to/destdir -R /path/to/releasedir release"
Using unprivileged mode, Using unprivileged mode,
build a complete release in build a complete release in
.Pa /path/to/dir/RELEASE . .Pa /path/to/dir/releasedir .
.El .El
. .
.Sh OBSOLETE VARIABLES .Sh OBSOLETE VARIABLES