CVS log for src/share/man/man7/release.7

Up to [cvs.NetBSD.org] / src / share / man / man7

Request diff between arbitrary revisions

Keyword substitution: kv
Default branch: MAIN

Create bootable images in ${RELEASEDIR}/${RELEASEMACHINEDIR}/binary/gzimg.

Release builds for arm platforms create compressed images in
${RELEASEDIR}/${RELEASEMACHINEDIR}/binary/gzimg.  However, in some
cases, e.g., armv7.img.gz, they are not bootable.  Consequently, boot
blocks must be manually installed in the images, which is an extra
barrier for testing systems or adopting NetBSD.  This has prompted
creation of external repositories, e.g., armbsd.org, to host a
collection of bootable images.  However, this does not ease the burden
on developers compiling their own systems; for them, manual
installation of boot blocks is still required.

For arm platforms, etc/etc.evbarm/Makefile.inc contains the commands
used to create system images.  Because installboot(8) can write boot
blocks directly to system images, a loop through possible boards can
create a series of bootable images during the normal build process.

In the case of many arm platforms, installboot(8) uses U-Boot boot
blocks, which are not part of the NetBSD source code.  Developers can,
however, install as many U-Boot boot blocks as desired, either in the
default location of /usr/pkg/share/u-boot or in a set of directories
pointed to by the U-Boot search path, the INSTALLBOOT_UBOOT_PATHS
environment variable.  For each board with an available boot block, a
board-specific bootable image will be created in
${RELEASEDIR}/${RELEASEMACHINEDIR}/binary/gzimg.  If a boot block is
not available, which is the typical situation currently, no additional
image will be created.

This facility creates opportunities to build bootable images for any
number of boards within the scope of a standard release build.
However, that is not required and will not occur without the
intervention of installing U-Boot boot blocks prior to the build.

Add the missing rescue(8) and tests(7) sets.  XXX: this manual is somewhat
broken due to the differences in the archival formats used.

Pull up following revision(s) (requested by sevan in ticket #1351):

	share/man/man4/man4.amiga/grf.4: revision 1.7
	share/man/man4/si.4: revision 1.11
	share/man/man8/man8.sparc/boot.8: revision 1.32
	share/man/man5/nsswitch.conf.5: revision 1.29
	share/man/man5/mixerctl.conf.5: revision 1.7
	share/man/man8/man8.vax/boot.8: revision 1.14
	share/man/man4/man4.vax/dn.4: revision 1.12
	share/man/man8/man8.vax/drtest.8: revision 1.16
	share/man/man8/sysinst.8: revision 1.6
	share/man/man4/ip.4: revision 1.37
	share/man/man5/boot.cfg.5: revision 1.28
	share/man/man1/cd.1: revision 1.10
	share/man/man4/usb.4: revision 1.106
	share/man/man4/man4.vax/ix.4: revision 1.17
	share/man/man7/security.7: revision 1.15
	share/man/man7/hier.7: revision 1.123
	share/man/man8/afterboot.8: revision 1.58
	share/man/man1/man1.x68k/bellctrl.1: revision 1.14
	share/man/man4/se.4: revision 1.6
	share/man/man4/utoppy.4: revision 1.7
	share/man/man4/midi.4: revision 1.32
	share/man/man4/cfb.4: revision 1.5
	share/man/man4/man4.sparc/magma.4: revision 1.12
	share/man/man4/audio.4: revision 1.80
	share/man/man4/isic.4: revision 1.18
	share/man/man1/cd.1: revision 1.7
	share/man/man4/envsys.4: revision 1.51
	share/man/man1/cd.1: revision 1.8
	share/man/man1/cd.1: revision 1.9
	share/man/man3/fast_divide32.3: revision 1.9
	share/man/man4/pci.4: revision 1.97
	share/man/man5/ranlib.5: revision 1.7
	share/man/man3/__arraycount.3: revision 1.7
	share/man/man4/isa.4: revision 1.46
	share/man/man8/man8.atari/ahdilabel.8: revision 1.14
	share/man/man4/chipsfb.4: revision 1.6
	share/man/man8/man8.macppc/boot.8: revision 1.8
	share/man/man5/passwd.5: revision 1.33
	share/man/man8/man8.macppc/ofwboot.8: revision 1.14
	share/man/man8/compat_linux.8: revision 1.38
	share/man/man4/iop.4: revision 1.22
	share/man/man4/ddb.4: revision 1.167
	share/man/man4/termios.4: revision 1.37
	share/man/man8/compat_freebsd.8: revision 1.18
	share/man/man5/ar.5: revision 1.9
	share/man/man7/release.7: revision 1.37
	share/man/man5/core.5: revision 1.31
	share/man/man4/ahd.4: revision 1.6
	share/man/man4/man4.vax/ad.4: revision 1.12
	share/man/man4/pppoe.4: revision 1.39
	share/man/man5/locale.alias.5: revision 1.3
	share/man/man8/man8.amiga/installboot.8: revision 1.23
	share/man/man4/etherip.4: revision 1.8
	share/man/man3/queue.3: revision 1.57
	share/man/man5/genassym.cf.5: revision 1.13
	share/man/man4/mpls.4: revision 1.10
	share/man/man1/wait.1: revision 1.5
	share/man/man5/capfile.5: revision 1.4
	share/man/man4/man4.alpha/ttwopci.4: revision 1.6
	share/man/man4/man4.atari/rtc.4: revision 1.8
	share/man/man4/gpiosim.4: revision 1.6
	share/man/man3/bitstring.3: revision 1.18
	share/man/man4/isdntel.4: revision 1.8
	share/man/man4/ai.4: revision 1.9
	share/man/man8/man8.hppa/boot.8: revision 1.2
	share/man/man4/uyurex.4: revision 1.6
	share/man/man8/man8.alpha/mkbootimage.8: revision 1.9
	share/man/man4/bpf.4: revision 1.56
	share/man/man4/man4.amiga/mfcs.4: revision 1.8
	share/man/man4/cmpci.4: revision 1.9
	share/man/man8/man8.vax/format.8: revision 1.14
	share/man/man8/compat_svr4.8: revision 1.27
	share/man/man4/crypto.4: revision 1.26
	share/man/man4/userconf.4: revision 1.13
	share/man/man4/agp.4: revision 1.17
	share/man/man9/man9.i386/bioscall.9: revision 1.10
	share/man/man4/uftdi.4: revision 1.20
	share/man/man4/radio.4: revision 1.13
	share/man/man4/mfb.4: revision 1.5
	share/man/man7/ascii.7: revision 1.8
	share/man/man4/man4.vax/dl.4: revision 1.13
	share/man/man4/ral.4: revision 1.12
	share/man/man4/unix.4: revision 1.26
	share/man/man4/edc.4: revision 1.12
	share/man/man4/pim.4: revision 1.5
	share/man/man8/compat_ultrix.8: revision 1.21
	share/man/man4/dge.4: revision 1.11
	share/man/man8/diskless.8: revision 1.32
	share/man/man5/passwd.conf.5: revision 1.11
	share/man/man8/man8.acorn26/boot26.8: revision 1.8
	share/man/man4/man4.vax/hy.4: revision 1.12
	share/man/man4/plip.4: revision 1.4
	share/man/man4/sc.4: revision 1.8
	share/man/man4/ec.4: revision 1.14
	share/man/man4/man4.sgimips/giopci.4: revision 1.9
	share/man/man7/sysctl.7: revision 1.114
	share/man/man3/bits.3: revision 1.18
	share/man/man4/we.4: revision 1.19
	share/man/man8/compat_sunos.8: revision 1.21
	share/man/man4/ip6.4: revision 1.31
	share/man/man4/acpilid.4: revision 1.8
	share/man/man4/man4.dreamcast/aica.4: revision 1.6
	share/man/man4/mfi.4: revision 1.12
	share/man/man4/ugen.4: revision 1.32
	share/man/man4/jme.4: revision 1.7
	share/man/man4/man4.sparc64/intro.4: revision 1.5
	share/man/man4/zyd.4: revision 1.5
	share/man/man4/gre.4: revision 1.45
	share/man/man3/bitmap.3: revision 1.10
	share/man/man4/man4.vax/cons.4: revision 1.12
	share/man/man3/gcq.3: revision 1.4
	share/man/man4/man4.hppa/pdc.4: revision 1.3
	share/man/man4/multicast.4: revision 1.8
	share/man/man4/man4.sparc/intro.4: revision 1.27
	share/man/man4/ath.4: revision 1.32
	share/man/man4/ym.4: revision 1.19
	share/man/man3/iso646.3: revision 1.6
	share/man/man4/btsco.4: revision 1.13
	share/man/man4/man4.i386/ndis.4: revision 1.6
	share/man/man4/pad.4: revision 1.6
	share/man/man4/strip.4: revision 1.16
	share/man/man8/man8.x86/boot.8: revision 1.12
	share/man/man4/amr.4: revision 1.15
	share/man/man4/ieee80211.4: revision 1.5
	share/man/man4/options.4: revision 1.467
	share/man/man5/link.5: revision 1.24
	share/man/man8/man8.cobalt/boot.8: revision 1.10
	share/man/man5/stab.5: revision 1.15
	share/man/man3/tree.3: revision 1.12
	share/man/man4/route.4: revision 1.31
	share/man/man4/man4.sun3/leds.4: revision 1.13
	share/man/man4/bluetooth.4: revision 1.20
	share/man/man4/man4.i386/pcibios.4: revision 1.19
	share/man/man5/veriexec.5: revision 1.8
	share/man/man7/operator.7: revision 1.12
	share/man/man4/man4.hp300/dcl.4: revision 1.13
	share/man/man4/man4.i386/intro.4: revision 1.31
	share/man/man5/ld.so.conf.5: revision 1.21
	share/man/man8/man8.alpha/boot.8: revision 1.16
	share/man/man4/bio.4: revision 1.13
	share/man/man4/man4.sun2/leds.4: revision 1.10
	share/man/man8/man8.x86/mbr.8: revision 1.4
	share/man/man8/man8.mvme68k/boot.8: revision 1.9
	share/man/man4/man4.alpha/ttwoga.4: revision 1.6
	share/man/man4/ahc.4: revision 1.34

Direct reader to shell documentation generally, rather than csh(1)
specifically.

Mention variables OLDPWD and PWD.

Move the text that explains that cd(1) is a shell built-in to the very
beginning of the description where it can be seen prominently.

Improve formatting.

 -

Remove workaround for ancient HTML generation code.
Use EXIT STATUS and .Ex.

Document xetc.tgz installation set.

Thanks to <wiz> for the review!

Remove workaround for ancient HTML generation code.

Pull up following revision(s) (requested by snj in ticket #226):
	share/man/man7/release.7: revision 1.35
	share/man/man7/release.7: revision 1.36
fix cksum syntax, CDROM -> CD-ROM, give a specific example of a kernel set
rather than kern.tgz, add dd(1) xref for usb images
bump date

Pull up following revision(s) (requested by snj in ticket #1931):
	share/man/man7/release.7: revision 1.32
	distrib/common/Makefile.bootcd: revision 1.18
	distrib/notes/macppc/prep.OPENFIRMWARE: revision 1.15
	distrib/notes/sparc/install: revision 1.57
	etc/Makefile: revision 1.394
	distrib/notes/common/main: revision 1.484
PR# install/44593: Please give release ISO's more meaningful names
Change release ISO filenames, what was once 'i386cd.iso' will now look
like 'NetBSD-5.99.60-i386.iso'.
ok snj@

Pull up following revision(s) (requested by snj in ticket #1931):
	share/man/man7/release.7: revision 1.32
	distrib/common/Makefile.bootcd: revision 1.18
	distrib/notes/macppc/prep.OPENFIRMWARE: revision 1.15
	distrib/notes/sparc/install: revision 1.57
	etc/Makefile: revision 1.394
	distrib/notes/common/main: revision 1.484
PR# install/44593: Please give release ISO's more meaningful names
Change release ISO filenames, what was once 'i386cd.iso' will now look
like 'NetBSD-5.99.60-i386.iso'.
ok snj@

Pull up following revision(s) (requested by snj in ticket #1931):
	share/man/man7/release.7: revision 1.32
	distrib/common/Makefile.bootcd: revision 1.18
	distrib/notes/macppc/prep.OPENFIRMWARE: revision 1.15
	distrib/notes/sparc/install: revision 1.57
	etc/Makefile: revision 1.394
	distrib/notes/common/main: revision 1.484
PR# install/44593: Please give release ISO's more meaningful names
Change release ISO filenames, what was once 'i386cd.iso' will now look
like 'NetBSD-5.99.60-i386.iso'.
ok snj@

Apply patch (requested by snj in ticket 1930):
Install fully-populated .iso images in ${RELEASEDIR}/images instead
of ${RELEASEDIR}/iso

Apply patch (requested by snj in ticket 1930):
Install fully-populated .iso images in ${RELEASEDIR}/images instead
of ${RELEASEDIR}/iso

Apply patch (requested by snj in ticket 1930):
Install fully-populated .iso images in ${RELEASEDIR}/images instead
of ${RELEASEDIR}/iso

bump date

fix cksum syntax, CDROM -> CD-ROM, give a specific example of a kernel set
rather than kern.tgz, add dd(1) xref for usb images

sync with netbsd-6-0-RELEASE.

sync with head

Pull up following revision(s) (requested by riz in ticket #548):
	doc/README.files: revision 1.5
	share/man/man7/release.7: revision 1.33
	share/man/man7/release.7: revision 1.34
Update release(7) for the recent iso -> images change.
Fix typo.
The "iso" directory never made it into this file, but now
that "iso" is "images", document it here for the edification of
folks browsing the download directories.

Fix typo.

Update release(7) for the recent iso -> images change.

sync with head

PR# install/44593: Please give release ISO's more meaningful names

Change release ISO filenames, what was once 'i386cd.iso' will now look
like 'NetBSD-5.99.60-i386.iso'.

ok snj@

sync to netbsd-5

Pull up the following revisions(s) (requested by snj in ticket #1365):
	share/man/man7/release7:	revision 1.31 (via patch)
	distrib/cdrom/hide-hfs.lst:	revision 1.5
	distrib/mac68k/stand/Makefile:	revision 1.6 (via patch)
	distrib/notes/common/main:	revision 1.451
	distrib/sets/Makefile:	revision 1.70
	distrib/sets/makesrctars:	revision 1.37
	distrib/sets/makesums:	revision 1.16

Only generate SHA512 and MD5 checksums for releases.

Pull up the following revisions(s) (requested by snj in ticket #1365):
	share/man/man7/release.7	revision 1.31 (via patch)
	distrib/cdrom/hide-hfs.lst	revision 1.5
	distrib/mac68k/stand/Makefile	revision 1.6 (via patch)
	distrib/notes/common/main:	revision 1.451
	distrib/sets/Makefile:	revision 1.70
	distrib/sets/makesrctars:	revision 1.37
	distrib/sets/makesums:	revision 1.16

Only generate SHA512 and MD5 checksums for releases.

Pull up following revision(s) (requested by snj in ticket #1066):
	distrib/notes/common/main: revision 1.451
	share/man/man7/release.7: revision 1.31 via patch
	distrib/mac68k/stand/Makefile: revision 1.6
	distrib/sets/makesums: revision 1.16
	distrib/sets/Makefile: revision 1.70
	distrib/sets/makesrctars: revision 1.37
	distrib/cdrom/hide-hfs.lst: revision 1.5
Sync release(7) with reality.
Only generate SHA512 and MD5 checksums for releases.

Pull up following revision(s) (requested by snj in ticket #1066):
	distrib/notes/common/main: revision 1.451
	share/man/man7/release.7: revision 1.31 via patch
	distrib/mac68k/stand/Makefile: revision 1.6
	distrib/sets/makesums: revision 1.16
	distrib/sets/Makefile: revision 1.70
	distrib/sets/makesrctars: revision 1.37
	distrib/cdrom/hide-hfs.lst: revision 1.5
Sync release(7) with reality.
Only generate SHA512 and MD5 checksums for releases.

Sync with reality.

bump date for previous

mention the new modules.tgz set

Sync with HEAD.

Third (and last) commit. See http://mail-index.netbsd.org/source-changes/2009/05/13/msg221222.html

New sentence, new line. Use Aq instead of \*[Lt]\*[Gt].

Don't use .Xo/.Xc to workaround ancient groff macro argument limit.
Reduce indentation a bit to make it more readable.

Fix markup

Sync with HEAD.

sync with head.

Convert TNF licenses to new 2 clause variant

sync with HEAD

Catch up w/ last night's netbsd-4

Pull up following revision(s) (requested by jnemeth in ticket #864):
	distrib/common/Makefile.bootcd: revision 1.9
	distrib/common/Makefile.bootcd: revision 1.10
	distrib/common/Makefile.bootcd: revision 1.11
	doc/BUILDING.mdoc: revision 1.51
	doc/BUILDING.mdoc: revision 1.52
	doc/BUILDING.mdoc: revision 1.53
	build.sh: revision 1.172
	build.sh: revision 1.173
	build.sh: revision 1.174
	build.sh: revision 1.175
	BUILDING: revision 1.64
	BUILDING: revision 1.65
	BUILDING: revision 1.66
	share/man/man7/release.7: revision 1.23
	share/man/man7/release.7: revision 1.24
	Makefile: revision 1.248

Add an iso-dir=directory option.  When combined with iso-image or
iso-image-source, it will cause directory to be added to the CD-ROM image.

Convert build.sh iso-dir=directory option to -C cddir as per jmmv@ on
source-changes.

update for iso-image-source

Pull up following revision(s) (requested by apb in ticket #573):
	share/man/man8/sysinst.8: revision 1.1
	distrib/sets/lists/man/mi: revision 1.987
	share/man/man8/Makefile: revision 1.89
	BUILDING: revision 1.62
	share/man/man7/release.7: revision 1.22
	doc/BUILDING.mdoc: revision 1.49
Improve documentation for "make iso-image" and release(7),
and add a rudimentary man page for sysinst(8).

Mention the .../iso directory and explain the difference between
it and the .../${MACHINE}/installation/cdrom directory.  Discussed in
tech-install.

* Mention that CD-ROM releases don't include the NetBSD-<rel> directory.
* More consistent indentation.

Sync with head.

Fix typo or mispelling.

Change all .Xr config 8 to .Xr config 1, following the recent move of
config from usr.sbin -> usr.bin.

Reviewed by wiz.

Pull up revisions 1.17-1.18 (requested by fredb in ticket #1121):
Removed accidental repetitious words.

Sync with reality...

- - Clarify how to do multi-platform releases. README, SOURCE_DATE, and
     "source" are placed at the root of the heirarchy. Call the heirarchies
     in <machine> the "binary releases", to distinguish from the entire
     release, which includes source.
- - Split sets are gone.
- - We can now do everything with "./build.sh". Tell how.

Fix mdoc warning reported by Nicolas Joly in PR 29708.

Sync with reality...

- - Clarify how to do multi-platform releases. README, SOURCE_DATE, and
    "source" are placed at the root of the heirarchy. Call the heirarchies
    in <machine> the "binary releases", to distinguish from the entire
    release, which includes source.
- - Split sets are gone.
- - We can now do everything with "./build.sh". Tell how.

I proposed this on tech-install and tech-toolchain, and there were no
objections.

Removed accidental repetitious words.

Generate <>& symbolically. I'm avoiding .../dist/... directories for now.

s/seperate/separate/

Fix typos, and formatting fix.

Drop superfluous .Pp.

Improve reference to config 8, and some whitespace fixes.

Pullup 1.11 [tv]:
Describe new shared-set layout:  .../shared/$MACHINE_ARCH and .../shared/ALL.

Describe new shared-set layout:  .../shared/$MACHINE_ARCH and .../shared/ALL.

Pull up rev. 1.10 to netbsd-1-5 branch, OK'd by thorpej:

> Add description about the "source" dir of a release, based on what's there
> for 1.4.2.

Add description about the "source" dir of a release, based on what's there
for 1.4.2.

remove security/

oops - wrong branch!  revert previous

remove security/

Pull up to netbsd-1-5 branch, OK'd by jhawk:

Revisions:
> cvs rdiff -r1.160 -r1.161 basesrc/etc/Makefile
> cvs rdiff -r1.23 -r1.24 basesrc/etc/etc.i386/Makefile.inc
> cvs rdiff -r1.7 -r1.8 sharesrc/share/man/man7/release.7

Log:
> Add standalone "iso-image" target that can be run with DESTDIR and RELEASEDIR
> set in src/etc after a "make release" in both "src" and "xsrc", to create a
> ISO-image of the release in $RELEASEDIR/installation/cdrom.
>
> Hook for architecture dependent pre/post-processing in etc/etc.*/Makefile.inc
> are available as 'iso-image_md_post' and 'iso-image_md_pre', see
> etc/etc.i386/Makefile.inc as an example. Might be useful for setting up
> bootable CDs on alpha, sparc, ...
>
> Reviewed by Todd Whitesel and Thomas Klausner.

Add standalone "iso-image" target that can be run with DESTDIR and RELEASEDIR
set in src/etc after a "make release" in both "src" and "xsrc", to create a
ISO-image of the release in $RELEASEDIR/installation/cdrom.

Hook for architecture dependent pre/post-processing in etc/etc.*/Makefile.inc
are available as 'iso-image_md_post' and 'iso-image_md_pre', see
etc/etc.i386/Makefile.inc as an example. Might be useful for setting up
bootable CDs on alpha, sparc, ...

Reviewed by Todd Whitesel and Thomas Klausner.

pullup 1.6->1.7 (is): legalize INSTALL.{html,txt,ps,more}

Legalize INSTALL.{html,more,ps,txt}

First round of .Os cleanups.  .Os is defined in the tmac.doc-common file,
so we shouldn't override it with versions in the manpages.  Many more to
come.

Assign my copyrights to TNF.

Change occurrences of "UNIX" to .Ux or .At as appropriate.

macroize BSD, NetBSD, FreeBSD and misc cleanup

Fix a typo; s/accomodate/accommodate/

Pull up from trunk: document describing a NetBSD release.

file release.7 was added on branch netbsd-1-3 on 1997-11-25 05:29:16 +0000

Add a document describing the layout of a NetBSD release.