Fri Mar 6 20:07:26 2020 UTC ()
Remove note that has been incorrect for a while.

Thanks ottavio for the heads up.


(maya)
diff -r1.2 -r1.3 src/usr.sbin/sysinst/sysinst.8
cvs diff -r1.2 -r1.3 src/usr.sbin/sysinst/sysinst.8 (switch to unified diff)

--- src/usr.sbin/sysinst/sysinst.8 2020/02/19 21:51:21 1.2
+++ src/usr.sbin/sysinst/sysinst.8 2020/03/06 20:07:26 1.3
@@ -1,118 +1,113 @@ @@ -1,118 +1,113 @@
1.\" $NetBSD: sysinst.8,v 1.2 2020/02/19 21:51:21 martin Exp $ 1.\" $NetBSD: sysinst.8,v 1.3 2020/03/06 20:07:26 maya 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 June 30, 2012 27.Dd March 6, 2020
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 definition_file 36.Op Fl f Ar definition_file
37.Sh DESCRIPTION 37.Sh DESCRIPTION
38.Nm 38.Nm
39is a menu-based program that may be used to install or upgrade a 39is a menu-based program that may be used to install or upgrade a
40.Nx 40.Nx
41system. 41system.
42It 42It
43is usually invoked automatically when the system is booted 43is usually invoked automatically when the system is booted
44from appropriate installation media. 44from appropriate installation media.
45.Pp 45.Pp
46.Nm 
47is usually not present on a 
48.Nx 
49system that has been fully installed. 
50.Pp 
51The following options are available: 46The following options are available:
52.Bl -tag -width XfXdefinition_fileXX 47.Bl -tag -width XfXdefinition_fileXX
53.It Fl D 48.It Fl D
54Switch on debugging. 49Switch on debugging.
55.It Fl f Ar definition_file 50.It Fl f Ar definition_file
56Use 51Use
57.Ar definition_file 52.Ar definition_file
58as a file for definitions other than the defaults. 53as a file for definitions other than the defaults.
59See the 54See the
60.Sx DEFINITION FILE 55.Sx DEFINITION FILE
61section for its format. 56section for its format.
62.El 57.El
63.Sh DEFINITION FILE 58.Sh DEFINITION FILE
64A definition file can be used with 59A definition file can be used with
65.Nm 60.Nm
66to control several aspects of the installation or upgrade process. 61to control several aspects of the installation or upgrade process.
67Options can be stored within the file as 62Options can be stored within the file as
68.Dl option = value 63.Dl option = value
69pairs. 64pairs.
70Options include the following, shown with their defaults 65Options include the following, shown with their defaults
71as well as a description 66as well as a description
72.Dq ( REL 67.Dq ( REL
73and 68and
74.Dq MACH 69.Dq MACH
75are the release and architecture 70are the release and architecture
76respectively, as determined by the image 71respectively, as determined by the image
77.Nm 72.Nm
78is used on): 73is used on):
79.Bl -column "targetroot mount" "pub/NetBSD/NetBSD-REL" 74.Bl -column "targetroot mount" "pub/NetBSD/NetBSD-REL"
80.It Sy "option name" Ta Sy "default value" Ta Sy "description" 75.It Sy "option name" Ta Sy "default value" Ta Sy "description"
81.It machine Ta MACH Ta Machine architecture 76.It machine Ta MACH Ta Machine architecture
82.It xfer dir Ta /usr/INSTALL Ta Transfer dir 77.It xfer dir Ta /usr/INSTALL Ta Transfer dir
83.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)
84.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
85.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
86.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,
87used for all methods of fetching (i.e., not just FTP) 82used for all methods of fetching (i.e., not just FTP)
88.It ftp user Ta "ftp" Ta FTP user for connecting 83.It ftp user Ta "ftp" Ta FTP user for connecting
89.It ftp pass Ta "-" Ta FTP password 84.It ftp pass Ta "-" Ta FTP password
90.It ftp proxy Ta "-" Ta FTP proxy 85.It ftp proxy Ta "-" Ta FTP proxy
91.It nfs host Ta "-" Ta NFS host for fetching via NFS 86.It nfs host Ta "-" Ta NFS host for fetching via NFS
92.It nfs dir Ta "/bsd/release" Ta NFS directory for fetching files 87.It nfs dir Ta "/bsd/release" Ta NFS directory for fetching files
93.It cd dev Ta "cd0a" Ta Name of CD device for fetching files 88.It cd dev Ta "cd0a" Ta Name of CD device for fetching files
94.It fd dev Ta "/dev/fd0a" Ta Name of floppy device for fetching files 89.It fd dev Ta "/dev/fd0a" Ta Name of floppy device for fetching files
95.It local dev Ta "-" Ta Other device to be mounted for fetching files 90.It local dev Ta "-" Ta Other device to be mounted for fetching files
96.It local fs Ta "ffs" Ta File system type for local device 91.It local fs Ta "ffs" Ta File system type for local device
97.It local dir Ta "release" Ta Directory to look for in the mounted local file system 92.It local dir Ta "release" Ta Directory to look for in the mounted local file system
98.It targetroot mount Ta "/targetroot" Ta Directory to mount target root dir to 93.It targetroot mount Ta "/targetroot" Ta Directory to mount target root dir to
99.It dist postfix Ta ".tgz" Ta Suffix of set files to be extracted 94.It dist postfix Ta ".tgz" Ta Suffix of set files to be extracted
100.It diskname Ta "mydisk" Ta Xr disktab 5 diskname to use for target disk 95.It diskname Ta "mydisk" Ta Xr disktab 5 diskname to use for target disk
101.El 96.El
102.Sh SEE ALSO 97.Sh SEE ALSO
103.Xr release 7 , 98.Xr release 7 ,
104.Xr afterboot 8 , 99.Xr afterboot 8 ,
105.Xr boot 8 , 100.Xr boot 8 ,
106.Xr diskless 8 101.Xr diskless 8
107.Pp 102.Pp
108.Em <machine> Ns Pa /INSTALL.* 103.Em <machine> Ns Pa /INSTALL.*
109files on CD-ROM installation media 104files on CD-ROM installation media
110.Pa .../NetBSD- Ns Em <rel> Ns Pa / Ns Em <machine> Ns Pa /INSTALL.* 105.Pa .../NetBSD- Ns Em <rel> Ns Pa / Ns Em <machine> Ns Pa /INSTALL.*
111files in 106files in
112.Nx 107.Nx
113releases or snapshots. 108releases or snapshots.
114.Sh HISTORY 109.Sh HISTORY
115A 110A
116.Nm 111.Nm
117command appeared in 112command appeared in
118.Nx 1.3 . 113.Nx 1.3 .