.\"	$NetBSD: sysinst.8,v 1.5.24.1 2019/09/02 16:39:21 martin Exp $
.\"
.\" Copyright (c) 2007 The NetBSD Foundation, Inc.
.\" All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in the
.\"    documentation and/or other materials provided with the distribution.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
.Dd June 30, 2012
.Dt SYSINST 8
.Os
.Sh NAME
.Nm sysinst
.Nd install or upgrade a NetBSD system
.Sh SYNOPSIS
.Nm
.Op Fl D
.Op Fl f Ar definition_file
.Op Fl r Ar release
.Sh DESCRIPTION
.Nm
is a menu-based program that may be used to install or upgrade a
.Nx
system.
It
is usually invoked automatically when the system is booted
from appropriate installation media.
.Pp
.Nm
is usually not present on a
.Nx
system that has been fully installed.
.Pp
The following options are available:
.Bl -tag -width XfXdefinition_fileXX
.It Fl D
Switch on debugging.
.It Fl f Ar definition_file
Use
.Ar definition_file
as a file for definitions other than the defaults.
See the
.Sx DEFINITION FILE
section for its format.
.It Fl r Ar release
Use
.Ar release
as the release name if it is different to the one compiled.
Currently unused.
.El
.Sh DEFINITION FILE
A definition file can be used with
.Nm
to control several aspects of the installation or upgrade process.
Options can be stored within the file as
.Dl option = value
pairs.
Options include the following, shown with their defaults
as well as a description
.Dq ( REL
and
.Dq MACH
are the release and architecture
respectively, as determined by the image
.Nm
is used on):
.Bl -column "targetroot mount" "pub/NetBSD/NetBSD-REL"
.It Sy "option name" Ta Sy "default value" Ta Sy "description"
.It release Ta REL Ta Release name (also set by Fl r Ar release )
.It machine Ta MACH Ta Machine architecture
.It xfer dir Ta /usr/INSTALL Ta Transfer dir
.It ext dir Ta "" Ta Extract dir (will usually be set later on)
.It ftp host Ta "ftp.NetBSD.org" Ta FTP host for fetching files
.It ftp dir Ta "pub/NetBSD/NetBSD-REL" Ta FTP directory for fetching files
.It ftp prefix Ta "/MACH/binary/sets" Ta Directory to look for sets,
used for all methods of fetching (i.e., not just FTP)
.It ftp user Ta "ftp" Ta FTP user for connecting
.It ftp pass Ta "-" Ta FTP password
.It ftp proxy Ta "-" Ta FTP proxy
.It nfs host Ta "-" Ta NFS host for fetching via NFS
.It nfs dir Ta "/bsd/release" Ta NFS directory for fetching files
.It cd dev Ta "cd0a" Ta Name of CD device for fetching files
.It fd dev Ta "/dev/fd0a" Ta Name of floppy device for fetching files
.It local dev Ta "-" Ta Other device to be mounted for fetching files
.It local fs Ta "ffs" Ta File system type for local device
.It local dir Ta "release" Ta Directory to look for in the mounted local file system
.It targetroot mount Ta "/targetroot" Ta Directory to mount target root dir to
.It dist postfix Ta ".tgz" Ta Suffix of set files to be extracted
.It diskname Ta "mydisk" Ta Xr disktab 5 diskname to use for target disk
.El
.Sh SEE ALSO
.Xr release 7 ,
.Xr afterboot 8 ,
.Xr boot 8 ,
.Xr diskless 8
.Pp
.Em <machine> Ns Pa /INSTALL.*
files on CD-ROM installation media
.Pa .../NetBSD- Ns Em <rel> Ns Pa / Ns Em <machine> Ns Pa /INSTALL.*
files in
.Nx
releases or snapshots.
.Sh HISTORY
A
.Nm
command appeared in
.Nx 1.3 .