Sun Sep 18 01:21:34 2011 UTC ()
fix markup


(christos)
diff -r1.3 -r1.4 src/share/man/man8/sysinst.8
cvs diff -r1.3 -r1.4 src/share/man/man8/Attic/sysinst.8 (expand / switch to unified diff)

--- src/share/man/man8/Attic/sysinst.8 2011/09/08 19:55:52 1.3
+++ src/share/man/man8/Attic/sysinst.8 2011/09/18 01:21:34 1.4
@@ -1,113 +1,114 @@ @@ -1,113 +1,114 @@
1.\" $NetBSD: sysinst.8,v 1.3 2011/09/08 19:55:52 wiz Exp $ 1.\" $NetBSD: sysinst.8,v 1.4 2011/09/18 01:21:34 christos Exp $
2.\" 2.\"
3.\" Copyright (c) 2007 The NetBSD Foundation, Inc. 3.\" Copyright (c) 2007 The NetBSD Foundation, Inc.
4.\" All rights reserved. 4.\" All rights reserved.
5.\" 5.\"
6.\" Redistribution and use in source and binary forms, with or without 6.\" Redistribution and use in source and binary forms, with or without
7.\" modification, are permitted provided that the following conditions 7.\" modification, are permitted provided that the following conditions
8.\" are met: 8.\" are met:
9.\" 1. Redistributions of source code must retain the above copyright 9.\" 1. Redistributions of source code must retain the above copyright
10.\" notice, this list of conditions and the following disclaimer. 10.\" notice, this list of conditions and the following disclaimer.
11.\" 2. Redistributions in binary form must reproduce the above copyright 11.\" 2. Redistributions in binary form must reproduce the above copyright
12.\" notice, this list of conditions and the following disclaimer in the 12.\" notice, this list of conditions and the following disclaimer in the
13.\" documentation and/or other materials provided with the distribution. 13.\" documentation and/or other materials provided with the distribution.
14.\" 14.\"
15.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS 15.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
16.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 16.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
17.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 17.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
18.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS 18.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
19.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 19.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
20.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 20.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
21.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 21.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
22.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 22.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
23.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 23.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
24.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 24.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
25.\" POSSIBILITY OF SUCH DAMAGE. 25.\" POSSIBILITY OF SUCH DAMAGE.
26.\" 26.\"
27.Dd September 8, 2011 27.Dd September 17, 2011
28.Dt SYSINST 8 28.Dt SYSINST 8
29.Os 29.Os
30.Sh NAME 30.Sh NAME
31.Nm sysinst 31.Nm sysinst
32.Nd install or upgrade a NetBSD system 32.Nd install or upgrade a NetBSD system
33.Sh SYNOPSIS 33.Sh SYNOPSIS
34.Nm 34.Nm
35.Op Fl D 35.Op Fl D
36.Op Fl f Ar deffile 36.Op Fl f Ar deffile
37.Op Fl r Ar releasename 37.Op Fl r Ar releasename
38.Sh DESCRIPTION 38.Sh DESCRIPTION
39.Nm 39.Nm
40is a menu-based program that may be used to install or upgrade a 40is a menu-based program that may be used to install or upgrade a
41.Nx 41.Nx
42system. 42system.
43It 43It
44is usually invoked automatically when the system is booted 44is usually invoked automatically when the system is booted
45from appropriate installation media. 45from appropriate installation media.
46.Pp 46.Pp
47.Nm 47.Nm
48is usually not present on a 48is usually not present on a
49.Nx 49.Nx
50system that has been fully installed. 50system that has been fully installed.
51.Sh OPTIONS 51.Sh OPTIONS
52.Bl -tag 52.Bl -tag -width rrrreleasename
53.It Fl D 53.It Fl D
54Switch on debugging. 54Switch on debugging.
 55.It Fl r Ar releasename
 56Set the releasename if it is different to the one compiled.
 57Currently unused.
55.It Fl f Ar deffile 58.It Fl f Ar deffile
56Set a file for definitions other than the defaults. 59Set a file for definitions other than the defaults.
57See 60See
58.Sx DEFINITION FILE 61.Sx DEFINITION FILE
59for its format. 62for its format.
60.It Fl r Ar releasename 
61Set the releasename if it is different to the one compiled. 
62Currently unused. 
63.El 63.El
64.Sh DEFINITION FILE 64.Sh DEFINITION FILE
65The definition file is used to set several other names and directories to search 65The definition file is used to set several other names and directories
66for. 66to search for.
67You can specify any of the options in the file. 67You can specify any of the options in the file.
68They are stored as 68They are stored as:
69.Dl option = value 69.Dl option = value
70pairs. 70pairs.
71In this description, REL and MACH are the release and architecture 71In this description, REL and MACH are the release and architecture
72respectively, determined by the image sysinst is used on. 72respectively, determined by the image sysinst is used on.
73.Bl -column -offset indent ".Sy option name" ".Sy default value" ".Sy description" 73.Bl -column "targetroot mount" "pub/NetBSD/NetBSD-REL"
74.It Sy "option name" Ta Sy "default value" Ta Sy "description" 74.It Sy "option name" Ta Sy "default value" Ta Sy "description"
75.It release Ta REL Ta Release name (also set by Fl r Ar releasename ) . 75.It release Ta REL Ta Release name (also set by Fl r Ar releasename ) .
76.It machine Ta MACH Ta Machine architecture 76.It machine Ta MACH Ta Machine architecture
77.It xfer dir Ta /usr/INSTALL Ta Transfer dir 77.It xfer dir Ta /usr/INSTALL Ta Transfer dir
78.It ext dir Ta "" Ta Extract dir (will usually be set later on) 78.It ext dir Ta "" Ta Extract dir (will usually be set later on)
79.It ftp host Ta "ftp.NetBSD.org" Ta ftp host for fetching files 79.It ftp host Ta "ftp.NetBSD.org" Ta ftp host for fetching files
80.It ftp dir Ta "pub/NetBSD/NetBSD-REL" Ta ftp directory for fetching files 80.It ftp dir Ta "pub/NetBSD/NetBSD-REL" Ta ftp directory for fetching files
81.It ftp prefix Ta "/MACH/binary/sets" Ta directory to look for sets. 81.It ftp prefix Ta "/MACH/binary/sets" Ta directory to look for sets.
82Not that 82Note that this is used for all kinds of fetching (CDs, local FS, ...),
83this is used for all kinds of fetching (CDs, local FS, ...), not only ftp. 83not only ftp.
84.It ftp user Ta "ftp" Ta ftp user for connecting 84.It ftp user Ta "ftp" Ta ftp user for connecting
85.It ftp pass Ta "" Ta ftp password 85.It ftp pass Ta "-" Ta ftp password
86.It ftp proxy Ta "" Ta ftp proxy 86.It ftp proxy Ta "-" Ta ftp proxy
87.It nfs host Ta "" Ta nfs host for fetching via nfs 87.It nfs host Ta "-" Ta nfs host for fetching via nfs
88.It nfs dir Ta "/bsd/release" Ta nfs directory for fetching files 88.It nfs dir Ta "/bsd/release" Ta nfs directory for fetching files
89.It cd dev Ta "cd0a" Ta name of the CD device for fetching files 89.It cd dev Ta "cd0a" Ta name of the CD device for fetching files
90.It fd dev Ta "/dev/fd0a" Ta name of floppy for fetching files 90.It fd dev Ta "/dev/fd0a" Ta name of floppy for fetching files
91.It local dev Ta "" Ta Other device to be mounted for fetching files 91.It local dev Ta "-" Ta Other device to be mounted for fetching files
92.It local fs Ta "ffs" Ta FS-type for local dev 92.It local fs Ta "ffs" Ta FS-type for local dev
93.It local dir Ta "release" Ta Directory to look for in the mounted local fs 93.It local dir Ta "release" Ta Directory to look for in the mounted local fs
94.It targetroot mount Ta "/targetroot" Ta Directory to mount target root dir to 94.It targetroot mount Ta "/targetroot" Ta Directory to mount target root dir to
95.It dist postfix Ta ".tgz" Ta Suffix of set files to be extracted 95.It dist postfix Ta ".tgz" Ta Suffix of set files to be extracted
96.It diskname Ta "mydisk" Ta Xr disktab 5 diskname to use for target disk 96.It diskname Ta "mydisk" Ta Xr disktab 5 diskname to use for target disk
97.El 97.El
98.Sh SEE ALSO 98.Sh SEE ALSO
99.Xr release 7 , 99.Xr release 7 ,
100.Xr afterboot 8 , 100.Xr afterboot 8 ,
101.Xr boot 8 , 101.Xr boot 8 ,
102.Xr diskless 8 , 102.Xr diskless 8
 103.Pp
103.Em \*[Lt]machine\*[Gt] Ns Pa /INSTALL.* 104.Em \*[Lt]machine\*[Gt] Ns Pa /INSTALL.*
104files on CD-ROM installation media, 105files on CD-ROM installation media
105.Pa .../NetBSD- Ns Em \*[Lt]rel\*[Gt] Ns Pa / Ns Em \*[Lt]machine\*[Gt] Ns Pa /INSTALL.* 106.Pa .../NetBSD- Ns Em \*[Lt]rel\*[Gt] Ns Pa / Ns Em \*[Lt]machine\*[Gt] Ns Pa /INSTALL.*
106files in 107files in
107.Nx 108.Nx
108releases or snapshots. 109releases or snapshots.
109.Sh HISTORY 110.Sh HISTORY
110A 111A
111.Nm 112.Nm
112command appeared in 113command appeared in
113.Nx 1.3 . 114.Nx 1.3 .