inst man page on IRIX

Man page or keyword search:  
man Server   31559 pages
apropos Keyword Search (all sections)
Output format
IRIX logo
[printable version]



inst(1M)							      inst(1M)

NAME
     inst - software installation tool

SYNOPSIS
     inst [ -anAEHMNQU ] [ -f source ] [ -m hardware=value ] [ -r target ]
	  [ -u action ] [ -F selections-file ] [ -c command-file ]
	  [ -I selection ] [ -R selection ] [ -K selection ]
	  [ -X file ] [ -Y file ] [ -P file ] [ -V preference:value ]

DESCRIPTION
     inst is the installation tool used to install, upgrade, or remove
     software distributed by Silicon Graphics.	There are two ways to run
     inst:

     -	Invoke inst as a command from the shell.

	This is known as invoking inst using IRIX Installation and you must be
	superuser to do this.  Some software cannot be installed using IRIX
	Installation (Release Notes and inst itself warn you about this
	software) and some commands within inst cannot be performed when using
	IRIX Installation.  This is due to system integrity problems that can
	arise from changing some software or performing certain operations
	while that software is running.

     -	Invoke inst in a standalone mode.

	To invoke inst in a standalone mode (known as Miniroot Installation),
	you shut down the system to the PROM monitor level (see shutdown(1M)),
	and load a collection of files known as the miniroot into the swap
	partition of your system disk.	The miniroot contains a UNIX kernel,
	inst and several other programs.  inst is automatically invoked after
	you load the miniroot and the / and /usr filesystems are automatically
	mounted as /root and /root/usr.	 New versions of IRIX and some
	software options must be installed from the miniroot.  Directions for
	loading the miniroot are in the IRIX Admin: Software Installation and
	Licensing guide.

	Note:  Loading the miniroot from tape is no longer possible as of IRIX
	6.2.  It is still possible to install software from tape, but it is
	not supported.

     The software that you install using inst is known as a software
     distribution. Software distributions are in a format defined by Silicon
     Graphics and can be read only by inst and swmgr(1m).  See the inst_dev
     product for creating your own software distributions.

     Software distributions can be on 1/4" cartridge tapes, on CD-ROM discs
     (CDs), and on disk.  inst can read the distribution from a drive (tape,
     CD-ROM or disk) mounted on the same workstation that the software will be
     installed on (known as the local workstation), or from a tape drive, CD-
     ROM drive or disk on another workstation (known as the remote
     workstation) connected to the same network.  If a distribution is on

									Page 1

inst(1M)							      inst(1M)

     disk, it is in a directory called a distribution directory.

     Note:  Distribution tapes must be written and read using the fixed block
     device.  Variable block mode is not supported.  See the tps(7m) man page
     for more details.

     The software distribution may also be downloaded from a web site, using
     the http protocol, provided the library libwio.so is installed on your
     system.

     In order to install software from a distribution on a remote workstation
     (tape, CD-ROM, or distribution directory), the user ID that you use must
     have read permission for the device or distribution directory.  By
     default, inst uses the current user ID and if the connection can't be
     established the user ID guest is used.  For any user ID this requires
     that either there is no password for the account on the remote
     workstation or that the user ID has been added to the .rhosts file.  See
     the example below.	 A different user ID can be specified with the -f
     option (see below) or the from command within inst.  The user ID for any
     account that does not have a password will work if it is able to read the
     distribution directory or device.	If an account with an assigned
     password must be used, the .rhosts file for that user ID on the remote
     workstation must contain the name of the local workstation and the user
     ID.  For example, the file /usr/people/joe/.rhosts on `bigserver' would
     contain the line:

	  rock.csd.sgi.com    joe

     When joe wants to install C++ on `rock' and the software distribution for
     C++ is located on bigserver in the directory /d/newrelease, he would
     enter the command:

	  inst -f joe@bigserver:/d/newrelease/c++

     The .rhosts file must have the correct ownership and permissions for
     access to be granted.  See the hosts.equiv(4) man page for details.

     When using a distribution on a remote workstation, the file
     /usr/etc/inetd.conf on the remote workstation and on any gateway
     workstations between the local and remote workstation needs to be
     modified.	See the IRIX Admin: Software Installation and Licensing guide
     for details.

     When inst first comes up, it displays the default location of the
     software distribution and possibly the user ID it is using.  When using
     IRIX Installation, the default location of the software distribution will
     be the location of the software distribution that you last installed.
     The -f option (see below) can be used to specify the location of the the
     software distribution when IRIX Installation is used.  This sets the
     default location that will be reported when inst comes up.	 In the case
     of a Miniroot Installation, the default location is wherever the miniroot
     came from.	 If the distribution is none, inst does not load one

									Page 2

inst(1M)							      inst(1M)

     automatically; this is useful for removing or browsing just the installed
     software.	Within inst, the from command can be used to change the
     distribution location.

     The inst command line options are:

     -a	  Execute inst from IRIX with no interaction from the user (automatic
	  mode).  No menus appear and the default location of the software
	  distribution is used unless the -f option is given.  The software
	  that will be installed is selected by inst using an algorithm
	  described in the IRIX Admin: Software Installation and Licensing
	  guide.

     -A	  A shorthand for -a -u all.

     -f source
	  Specify the location of the software distribution.  The format of
	  source depends on the location of the distribution and other
	  factors.  Multiple -f arguments are permitted.  The possibilities
	  are:

	  tape		  local tape drive

	  /dev/nrtape	  local tape drive

	  /CDROM/dist	  local CD-ROM drive

	  distdir	  local distribution directory distdir

	  /CDROM/dist/product
			  installing just product from a local CD-ROM drive

	  distdir/product installing just product from a local distribution
			  directory

	  none		  for browsing or removing installed software only

	  server:/dev/tape
			  tape drive on a remote workstation whose hostname is
			  server

	  server:CDdir/dist
			  CD-ROM drive with the CD mounted at CDdir on a
			  remote workstation whose hostname is server

	  server:distdir  distribution directory distdir on a remote
			  workstation whose hostname is server

	  server:CDdir/dist/product
			  installing just product from a CD mounted at CDdir
			  on a remote workstation whose hostname is server

									Page 3

inst(1M)							      inst(1M)

	  server:distdir/product
			  installing just product from a distribution
			  directory distdir on a remote workstation whose
			  hostname is server

	  http://server/distdir/
			  installing from a web site.  This functionality
			  requires that the libwio.so library be installed on
			  the local system.

	  http://server/distdir/file.tardist
			  download the tardist file, and unpack into a local
			  temporary directory before installing.  Tardist
			  files may be used in conjunction with a .inst
			  selections file so that installations initiated from
			  a web browser will not block the browser during the
			  download.  See -F, TARDIST and SELECTIONS FILE
			  below.

	  When using a remote distribution source, you can prepend user@ to
	  specify a user ID other than guest as discussed above.  For example,
	  to use a remote tape drive on bigserver as user instuser, the -f
	  argument is instuser@bigserver:/dev/tape.

     -r target
	  Set the effective root directory in which the new software will be
	  installed.  By default, this is /.  This option is used to specify
	  the root of a virtual IRIX tree for diskless prototype trees.

	  The -r option may also be used to install software somewhere other
	  than the default location.  However, by changing the effective root
	  directory, the normal installation history database in /var/inst
	  will not be used, and inst may not be able to to correctly resolve
	  prerequisite conflicts.  Therefore when attempting to manage disk
	  space, it is usually preferable to avoid using the -r option, and
	  instead create a symbolic link from the system disk to an option
	  drive before running inst or Software Manager.

	  For example, if a product installs files into the directory
	  /usr/share/foo, you can make a symbolic link (see ln(1)) from
	  /usr/share/foo to /disk2/usr/share/foo, and then run inst or
	  Software Manager without the -r option to install the product's
	  files into /disk2.  A record of the installation will still be
	  maintained under /var/inst.

	  The -r option cannot be used to create a bootable system disk for
	  the same or an alternate OS or machine.  Such a disk is normally
	  created by running inst in the miniroot environment.

     -I selection
	  Specify products or subsystems to install, where selection is a
	  product name, or other expression accepted by the inst install

									Page 4

inst(1M)							      inst(1M)

	  command.  Multiple expressions can be specified by using a comma
	  separated list or by using multiple -I options.

     -R selection
	  Specify products or subsystems to remove, where selection is a
	  product name, or other expression accepted by the inst remove
	  command.  Multiple expressions can be specified by using a comma
	  separated list or by using multiple -R options.

     -K selection
	  Specify products to keep (don't install or remove), where selection
	  is a product name, or other expression accepted by the inst keep
	  command.  Multiple expressions can be specified by using a comma
	  separated list or by using multiple -K options.

     -V preference:value
	  Initialize preference to value.  See PREFERENCES.

     -F selections-file
	  The selections-file is used to pre-select subsystems for
	  installation or removal.  A remote selections file is allowed using
	  user@host:file or http://server/selections.inst.  By convention
	  selections files located on the web have a .inst suffix.  See
	  SELECTIONS FILE below for complete syntax.

     -c file
	  Causes inst to execute commands in the order that they appear in
	  file.	 Unless the quit command is used, inst will resume in
	  interactive mode after processing the file.  Control-C can be used
	  to summon the interrupt menu.	 Normally Inst will stop processing
	  the file if an error occurs, and present the interactive menu,
	  unless the abort_on_error preference is set to off.  This option is
	  ignored by SoftwareManager.

     -M	  Do not display inst output using its built-in pager, and do not show
	  percent-done messages.  Equivalent to setting page_output=off and
	  show_percent_done=off.

     -E	  Invoke inst_terse_mode.  Provides reduced output for scripting.
	  Equivalent to setting inst_terse_mode=on in the shell environment
	  before invoking inst.	 If set on, it minimizes inst output:  most
	  normal status and progress messages are suppressed unless explicitly
	  asked for, but any warnings, errors, and explicitly requested output
	  still appear.	 See the description of the preference inst_terse_mode
	  within inst or swmgr for more information.

     -P file
	  Specify file to be precious.	See PREFERENCES.

     -N	  Disables space-checking by initializing the space_check preference
	  to off.  See PREFERENCES.

									Page 5

inst(1M)							      inst(1M)

     -u action
	  Specify the type of subsystems to select for installation.  The
	  possible actions are:

	  new		    Select all new products for installation.

	  upgrade	    Select all upgrade products for installation.

	  upgrade_and_new   Select all new and upgrade products for
			    installation.

	  upgrade_or_new    Select upgrade (or new, if no upgrades) products
			    for installation.

	  upgrade_and_rnds_or_new
			    Select upgrade and related new default subsystems
			    (or new defaults, if no upgrades, no downgrades
			    and no same) for installation.  (This is the
			    default action.)

	  all		    Select all products for installation.

     -X file
	  Exclude file during installations and removals.  If file is a
	  directory, its descendents are also excluded.	 Multiple -X options
	  are permitted, however wildcards are not.  To quickly rebuild a
	  corrupted installation history, re-install the same versions of your
	  existing software using -X/ (no files will be touched).  See also
	  the exclusions preference.

     -Y file
	  Install only file during installations and removals.	If file is a
	  directory, only it and its descendents are installed or removed.
	  Multiple -Y options are permitted, however wildcards are not.	 See
	  the restrictions preference.

     -U	  Run the tool in extract_mode, useful for recreating a source tree
	  from a set of images produced by gendist(1M).	 See PREFERENCES.

     -T	  Run the tool in symlink_mode, useful for creating a tree of symbolic
	  links, instead of regular files.  See PREFERENCES.

     -n	  Initialize the dryrun preference to on.  See PREFERENCES.

     -C	  Install software for all architectures that support diskless
	  clients.  This is normally used only when installing (on the server)
	  the share tree for diskless clients.	It will only work correctly
	  with products designed for use with diskless clients (that is, the
	  different hardware-specific files are installed with different names
	  for each hardware type).  Some products install files with the same
	  name, regardless of architecture, and this option will not allow
	  such products to install all files in a unique way.

									Page 6

inst(1M)							      inst(1M)

	  Normally used by share_inst(1M), this option is used to install
	  sharable software (including hardware-specific files) for all
	  architectures listed in the file indicated by the mach_classfile
	  preference.  See PREFERENCES.

     -s	  Install shared software for use by diskless clients.	This option is
	  normally used only by share_inst(1M) when constructing a share-tree
	  for diskless clients.

     -S sharetree
	  Install software for diskless client, and specify the shared tree.
	  This option is normally used only by client_inst(1M) when installing
	  the diskless client-specific software.  When this option is given
	  inst installs the non-sharable software that is used exclusively by
	  an individual diskless client.

     -H	  This option causes inst to print the hardware variables and then
	  exit.	 See the -m option, and the admin hardware command of inst.

     -Z	  Re-writes the installation history in /var/inst using the IRIX 6.2
	  inst format.	Inst will refuse to perform this operation if any
	  overlay maintenance products are installed.  This option is silently
	  ignored by swmgr.

     -Q	  Execute inst in a special mode in which only rqs information about
	  each executable is updated into the installation history.  This will
	  usually trigger an rqsall(1) to quickstart all the files that are
	  contained in the specified distribution.

     -m hardware=value
	  The software distribution for some software products contains
	  several hardware-specific copies of the same file.  By default inst
	  installs the copy that is appropriate for the type of workstation
	  you are installing on.  The -m option is useful when you are
	  installing software on a disk that will be transferred to a
	  different type of workstation or when you are extracting files from
	  a software distribution for a different type of workstation.	In
	  both these cases you would probably also use the -r option.  The
	  inst command admin hardware can be used to view the current hardware
	  variables in effect.

	  Acceptable arguments are:

	       CPUBOARD=cpu
	       GFXBOARD=gfxboard
	       MODE=mode
	       SUBGR=subgr
	       default

	  The default keyword substitutes all of the hardware values for the
	  current system.  Refer to your /var/inst/machfile for an example of
	  the various combinations of hardware configurations currently

									Page 7

inst(1M)							      inst(1M)

	  defined. The first section of /var/inst/machfile is a mapping from
	  the data returned by getinvent(1M) to the strings used by the -m
	  option.

     When the software distribution is a CD in a remote CD-ROM drive, the CD
     must be mounted either manually or by mediad(1M).	When the software
     distribution is a CD in a local CD-ROM drive, the mounting of the CD is
     done automatically by inst, or by mediad if it is running.

     Unless the -a option is given, a menu of commands will be displayed when
     inst is invoked.  This menu, the Inst Main Menu, contains all of the
     commands that most inst users ever need.  The Admin Menu contains less-
     commonly used administrative commands.  The View Menu is used to control
     the order and presentation of software packages, and disk space
     requirements displayed by the list and step commands.  The
     Interrupt/Error Menu, is displayed automatically when certain error
     conditions are encountered during installation.  These menus and their
     commands are described fully in the IRIX Admin: Software Installation and
     Licensing guide.

     inst has an extensive online help system.	Enter the command help at the
     inst prompt to see the list of help topics.  To view the information on a
     particular topic, enter the command help topic.  The topic overview
     provides information about what inst does and how to use it.  This is a
     good starting point for new users.

     The IRIX Admin: Software Installation and Licensing guide is the
     reference manual for inst.	 Installation issues for specific products are
     discussed in the Release Notes for the different products.

SELECTION KEYWORDS
     Some inst commands accept keyword arguments as shorthand ways of choosing
     groups of subsystems.  These keywords may also be used with the -I, -R
     and -K command-line otions, in selections files (-F), in command files
     (-c), and in the SoftwareManager command-pane.

     If more than one keyword is given within a single install, remove, keep,
     etc. command, the intersection of the keywords is taken.  This means that
     the command applies only to subsystems satisfying all of the keywords.

     The following list gives each keyword, its abbreviation if it has one,
     and a brief description.

     all, a		 All subsystems in "showprods -a" output plus all
			 subsystems in the software distribution.

     clientonly, c	 All subsystems that are only for nfs-client installs
			 (see share_inst(1M)).

     default, d		 All subsystems in the distribution that are marked
			 with "d".

									Page 8

inst(1M)							      inst(1M)

     distribution	 All subsytems in the current distribution(s).

     dist:		 When followed by a colon (:), selects all subsytems
			 in any distribution whose name contains the string
			 dist.	Useful when multiple distributions are open.

     downgrade, D	 All subsystems that have a version installed that is
			 newer than the version in the software distribution.

     hardware, h	 All subsystems containing hardware-specific files.

     install, i		 All subsystems that are selected for installation.

     installable, A	 All subsystems in the software distribution, except
			 certain patches, hardware-specific and clientonly
			 subsystems that are inappropriate for the current
			 target.

     uninstallable, X	 All subsystems in the software distribution that are
			 inappropriate for the current target.

     conflicting, C	 All subsystems currently selected for installation or
			 removal, that are causing conflicts.  Useful with
			 "keep conflicting".

     prereqs		 The minimal set of unselected distribution subsystems
			 that will resolve all current prereq conflicts.
			 Useful with "install prereqs".

     installed, I	 All subsystems that are installed on the target.

     keep, k		 All installed subsystems that are not selected for
			 re-installation, replacement or removal.

     reboot, b		 All subsystems that require a reboot to complete
			 installation.

     new, N, n		 All subsystems that aren't installed, and aren't
			 upgrades or downgrades of something installed.

     notinstalled	 All subsystems on the target that have neither been
			 installed nor removed.

     patches		 All patches in the distribution.

     patchupgrade, P	 All patches in the distribution that are upgrades to
			 installed patches.

     removable, L	 All of the installed subsystems that can be selected
			 for removal.

									Page 9

inst(1M)							      inst(1M)

     remove, r		 All of the subsystems that are selected for removal.

     removed, R		 All subsystems that were once installed.

     required, q	 All of the subsystems that are required for proper
			 operation of the workstation.

     same, S, s		 All subsystems that have an identical version
			 installed.

     standard		 This keyword is useful for performing a software
			 upgrade, by using the command sequence keep *
			 followed by install standard.	In Software Manager,
			 an equivalent option is available on the Install
			 menu.	If the distribution contains any related
			 (same, upgrade or downgrade) subsystems, then
			 standard refers to upgrade subsystems plus new,
			 default sibling subsystems (in the same product) that
			 were not part of the product the last time they were
			 installed.  However if the distribution contains no
			 related products (in other words, all products are
			 new) then standard will select all default
			 subsystems.  Finally, standard will also include any
			 prerequisite products (see prereqs) but not overlay
			 subsystems whose base subsystems are missing (see
			 incompleteoverlays).  Standard will not select
			 downgrade or currently installed (same) subsystems or
			 subsystems that are incompatible with your hardware.

     stale		 All installed subsystems on the target that must be
			 re-installed due to hardware changes.

     fresh		 The subset of stale subsystems that are also on the
			 current distribution.	For example, the command
			 install fresh may be used to re-install software that
			 has been affected by a hardware upgrade.

     target		 All subsytems on the target.

     upgrade, U		 All subsystems that have a version installed that is
			 older than the version in the software distribution.

     upgraded, u	 Any subsystem on the target that is being removed as
			 part of an installation of a related (typically
			 newer) version of the product from the distribution.

     applicablepatches	 All patches in the distribution that are installable
			 based on the current selections.

     overlays		 All overlay products in the distribution.

								       Page 10

inst(1M)							      inst(1M)

     incompleteoverlays	 The subset of overlay products which cannot be
			 installed because the corresponding base product is
			 not installed, and is not loaded in the distribution
			 view.

     maint		 This keyword may only be used with the command
			 "install maint" and is used to switch from the
			 feature stream to the maintenance stream.  This
			 command will change the setting of the "stream"
			 preference to "maint", clear the current selections,
			 set the "neweroverride" preference to "on", and make
			 the standard upgrade selections (see the standard
			 keyword), plus downgrade selections, necessary for
			 switching to the maintenance stream.  This command
			 should only be used when "stream" is currently set to
			 "feature" and after opening a distribution containing
			 maintenance products.

     feature		 This keyword may only be used with the command
			 "install feature" and is used to switch from the
			 maintenance stream to the feature stream.  This
			 command will change the setting of the "stream"
			 preference to "feature", clear the current
			 selections, and make the standard upgrade selections
			 (see the standard keyword) necessary for switching to
			 the maintenance streams.  This command should only be
			 used when "stream" is currently set to "maint" and
			 after opening a distribution containing feature
			 products.

SELECTIONS FILE
     A selections-file can be used to specify the distribution(s) and the
     selections for a single installation session.  Blank lines and comment
     lines that begin with a pound-sign (#) are ignored.  All other lines must
     be selections file directives.

     The software distribution is specified using the from directive.  This
     directive can be omitted from the selections file if the distribution has
     already been read and the user uses the admin load command.  A selections
     file can contain multiple distribution directives.

	  from distribution
	  from distdir1 distdir2
	  from /CDROM/dist
	  from host:distribution
	  from user@host:distribution
	  from http://server/distdir/file.tardist

     inst preference values can be specified for the installation session by
     using the set directive.  These directives can appear anywhere in the
     file and all preference directives are interpreted together in the order
     that they appear.

								       Page 11

inst(1M)							      inst(1M)

	  set preference value

     The product/subsystem selections for the installation session are
     specified using the selections directives.	 The selections directives can
     appear anywhere in the file and all selections directives are interpreted
     together in the order that they appear.  The directives are specified
     using their abbreviated forms, and include i (install), r (remove), and k
     (do not remove or install).  These directives take one or more arguments
     that can be a product or subsystem name ((wildcards are permitted), or
     selection keyword described above.

	  i eoe.sw.cdrom
	  i default eoe.sw32.*
	  i installable patches

	  k conflicting
	  k *

	  r *.books.* *.man.*

KEEP FILE
     A keepfile can be used to prevent unwanted products from being marked for
     default installation.  If the file /var/inst/.keepfile exists, its
     contents are processed each time a new distribution is loaded.  The
     keepfile lists new (N) products, images, or subsystems that are not to be
     marked for default installation.  Upgrade (U) subsystems are not affected
     by the keepfile.  The keepfile only affects the initial selections made
     by inst or swmgr when a distribution is loaded.

     The inst command admin updatekeepfile updates the keepfile with respect
     to the current selections.	 New default subsystems that are not selected
     for installation are appended to the keepfile.

     The keepfile contains one pattern per line.  Only the first whitespace-
     separated pattern on each line is considered.  A wildcard character, *,
     can be used in the pattern.  For example eoe.books.* turns off default
     installation of all new subsystems in the eoe.books image.	 Comments
     beginning with # and ending with a newline are ignored.

TARDIST FILE
     A tardist file is a distribution, encoded as a tar(1m) file.  A tardist
     file can be used to distribute a small product or set of products for
     installation over a network.

     When the specified distribution is a tardist file, inst and swmgr unpack
     the distribution into a temporary directory (in /var/tmp), and the
     tardist file's length is zeroed to save space.  Once the installation has
     completed, inst and swmgr give you the option of deleting the temporary
     distribution or saving it for future use.

								       Page 12

inst(1M)							      inst(1M)

     If you decide to save the distribution for later use, it is usually saved
     in the directory /usr/dist (normally expected to be a world-writable
     directory for unpacking and storing distributions).  However, you can
     save the distribution to another directory if desired.

     Tardist files are intended to be used to install distributions located on
     the World Wide Web.  Normally a page will be created with a link to a
     selections file.  The selections file will specify a tardist file (as a
     URL).  Your web browser (e.g., netscape) will download the selections
     file and invoke swmgr.  Swmgr will read the selections file, download the
     specified tardist file, unpack the distribution, and install the
     software.

     Tardist files must have the extension .tardist in order to be recognized
     as such by inst, swmgr, and web browsers (e.g., netscape).

FILES
     /var/inst/.swmgrrc	  most recent values of permanent set options
     /var/inst/.keepfile  new subsystems not selected for default install
     /var/inst/help1	  source for online help
     /var/inst/INSTLOG	  log of installation sessions
     /var/inst/hist	  database of the files installed on your workstation
			  by inst and swmgr.
     /var/inst/product	  binary files, each describing an installed product
     /usr/dist		  directory, writable by the user, in which the
			  contents of the tardist can be saved
     /usr/lib/libwio.so	  http protocol support libraries
     /usr/lib32/libwio.so

PREFERENCES
     A number of preferences are available for customizing inst and swmgr.
     Preferences are loaded from /var/inst/.swmgrrc, /.swmgrrc, ~/.swmgrrc,
     and from the command line, with command-line definitions having the
     highest precedence.

     The modifiers in the following descriptions are:

     inst-only	  used only by inst
     swmgr-only	  used only by swmgr
     permanent	  saved across sessions
     expert	  for experts only
     readonly	  cannot be modified by the user
     boolean	  An on/off value (true/false may also be used)

     abort_cmdfile_on_error
		  Abort command-file installation (-c) on errors
		  boolean, default: true (inst-only expert)
		  Controls how errors are handled during command-file (-c)
		  installations.  If "on" (the default) the installation stops
		  after an error and present an interrupt menu.	 If "off",
		  commands the remaining commands in the command-file are
		  executed despite any errors.	In all cases errors are

								       Page 13

inst(1M)							      inst(1M)

		  reported in /var/inst/INSTLOG. See also abort_on_error.

     abort_on_error
		  Abort automatic installation on errors
		  boolean, default: off (inst-only permanent expert)
		  Controls how errors are handled during automatic (-a)
		  installations.  If "on" the installation terminates
		  immediately.	If "off" (the default) the installation
		  continues. In all cases errors are reported in
		  /var/inst/INSTLOG. See also abort_cmdfile_on_error.

     all_architectures
		  Install all architectures
		  boolean, default: off (readonly)
		  Controls whether files for all architectures are installed.
		  This preference applies during diskless share-tree or
		  client-tree installations, and can only be set with the -C
		  command line option.	See client_inst(1).

     always_confirm_quit
		  Confirm quit action
		  boolean, default: off (permanent)
		  Controls whether the user is always asked for confirmation
		  of a quit command.

     always_page_inst
		  Page optional output
		  boolean, default: off (inst-only expert)
		  Controls whether inst output not specifically requested,
		  such as progress messages during actual installation, are
		  paged or displayed non-stop.

     autoconfig_overhead
		  Autoconfig overhead, in bytes
		  integer, default: 286720 (expert)
		  Controls the amount of disk space reserved during the
		  installation for temporary disk space required by
		  autoconfig(1M) to build a new kernel. Under special
		  circumstances when a debug kernel is being built, this value
		  should be doubled. See also "kernel_size_32" and
		  "kernel_size_64".

     autodeselect Automatically de-select failing subsystems
		  default: confirm, choices: on confirm off
		  This preference controls whether to skip
		  installation/removal of subsystems causing certain types of

								       Page 14

inst(1M)							      inst(1M)

		  errors during the pre-installation check, after "go" or
		  "start" is issued.  If set to "on", and if no conflicts
		  would result, the failing subsystems are automatically de-
		  selected, and the installation is re-tried.  If set to
		  "confirm" (the default), the user is prompted before
		  deselecting.	If set to "off", no de-selecting is attempted.
		  Currently only NFS-readonly errors are handled in this
		  fashion, as may occur when books and manual pages are NFS-
		  mounted from another host, and you attempt to install
		  documentation locally.

     automatic	  Automatic installation
		  boolean, default: off
		  Controls whether the installation proceeds without user
		  intervention.

     autopatchselect
		  Automatic patch selections
		  boolean, default: on
		  Controls whether installable patches are automatically
		  selected when the appropriate base subsystem is installed or
		  selected for install.	 When this preference is "on", patches
		  marked for install will be automatically deselected when the
		  associated base subsystem is marked for removal or
		  deselected for install.

     autoselect	  Automatic installation selections
		  boolean, default: on
		  Controls whether initial selections are made from the list
		  of subsystems to be installed whenever a new distribution is
		  opened.  Unless overridden by other means, such as the -I,
		  -R, -K, and -u command line options, this will be all
		  upgrade (U) subsystems and all new default (Nd) subsystems
		  in the distribution.

     background	  Background the application
		  boolean, default: on (swmgr-only permanent expert)
		  Controls whether SoftwareManager is run in the foreground or
		  in the background when invoked from a shell.

     beep	  Beep when installation completes
		  boolean, default: on (permanent)
		  Controls whether or not an audible "beep" signal is issued
		  whenever an installation is successfully completed.

								       Page 15

inst(1M)							      inst(1M)

     busy_check	  Busy file space checking
		  boolean, default: on (expert)
		  Controls whether busy files (those which are currently
		  accessed by executing processes) are considered during the
		  pre-installation space check. If busy files are removed or
		  overwritten during the installation, their disk blocks are
		  not immediately reclaimed by the operating system. Closing
		  other applications before a live-install may be required in
		  order for the disk space requirements to be met.  In the
		  miniroot, the busy check is always skipped.

     checkpoint_restart
		  Automatically restart install if set
		  boolean, default: off (expert)
		  Used for checkpoint restarting. Automatically restart
		  installation if set.

     checkpoint_restart_mode
		  Override normal checkpoint restart mode
		  string, default: NULL
		  Specifies the initial user interface mode used for
		  checkpoint restarting. Brings up SoftwareManager in a
		  specific mode, overriding any value set by the user in
		  "custom_startup_mode".

     checkpoint_selections
		  Checkpoint before go as well as during go
		  boolean, default: off (permanent expert)
		  Controls whether or not to checkpoint the selections during
		  the selection process. This is useful when making complex
		  selections worth saving.

     clearprompt  Clear the "more?" prompt
		  boolean, default: on (inst-only permanent)
		  Controls the way in which some prompts are displayed.
		  Certain operations use "throw away" prompts that are usually
		  cleared by backspacing, then overwritten with spaces. For
		  terminals that can't clear prompts in this way, it is more
		  appropriate to just move to the next line. Set clearprompt
		  "off" to use the simple case.	 It is "on" by default and
		  saved from session to session.

     columns	  Number of columns in tty display
		  integer, default: 0 (inst-only permanent)
		  The "columns" preference is not supported in this release,
		  but will be supported in a future release. In this release
		  the number of columns is automatically detected by inst (if

								       Page 16

inst(1M)							      inst(1M)

		  possible), but cannot be overridden.

     confirm_nfs_installs
		  Confirm installs onto nfs-mounted filesystems
		  boolean, default: on (permanent)
		  Controls installs onto nfs-mounted filesystems. If set to
		  "on", the user is asked to confirm any installations to
		  nfs-mounted directories located on another host.  When set
		  to "off", inst or SoftwareManager will install on to nfs-
		  mounted filesystems as long as the user has the necessary
		  permissions.

     confirm_quit Confirm quit if pending actions
		  boolean, default: on (permanent)
		  Controls whether the user is notified that install/remove
		  actions are pending when quitting.

     custom_startup_mode
		  SoftwareManager initial selections mode
		  default: off, choices: off distribution always (permanent
		  expert)
		  Controls how SoftwareManager is initially presented.
		  Possible values are: "off" - always start in automatic mode;
		  "distribution" - start in custom-selections mode if a
		  distribution has been specified, otherwise in automatic
		  mode; "always" - start in custom-selections mode if a
		  distribution has been specified, otherwise in manage-
		  installed-software mode.

     debug_menu	  Debug menu
		  boolean, default: off (swmgr-only)
		  Controls whether the debug menu is available in swmgr.

     default_config
		  Force default configuration files
		  boolean, default: off (permanent expert)
		  Controls whether to override the normal configuration file
		  rules, and install ALL the configuration files from the
		  distribution. If the user has modified these files, they are
		  first saved with a ".O" suffix.

     default_dist The name of the default distribution from which to read.
		  string, default: NULL (readonly)
		  If no distribution is supplied by the user on the command
		  line, this is used as the default installation location if
		  set. See also "dist" and "distribution".

								       Page 17

inst(1M)							      inst(1M)

     default_sharedirs
		  Default share directories
		  string, default: /usr (readonly expert)
		  Contains the list of default share directories used in a
		  diskless share-tree or client-tree installation.

     delay_conflicts
		  Controls when certain conflicts are presented
		  default: ask, choices: ask on off
		  Controls when certain "delayable" conflicts are presented to
		  the user. Currently, only particular incompat conflicts may
		  be delayed. The default behavior, "ask", will query the user
		  when the first delayable conflict is presented. At that
		  time, the user will have the option of resolving the
		  conflict before the installation or prior to exiting. In
		  some installation scenarios, the conflict will have to be
		  delayed since the subsystem(s) necessary to resolve the
		  conflict are not on the current distribution. After making a
		  choice, this behavior will continue for the remainder of the
		  installation session or until the preference value is
		  explicitly changed. An "on" value will always present the
		  delayable conflicts prior to exiting. An "off" selection
		  will present all conflicts, including the delayable variety,
		  prior to installation. This preference is not saved from
		  session to session. To make this preference persistent, add
		  "delay_conflicts:" and the desired value to the .swmgrrc
		  file.

     delay_exitops
		  Controls when exitops are executed
		  boolean, default: off (permanent)
		  Controls when exitops are executed. When this preference is
		  "off", the default case, exitops are executed immediately
		  after all files are installed and before control is returned
		  to the user. When this preference is "on", the exitops will
		  not be executed until the user quits. If the user interrupts
		  an installation and chooses to save the exitops for later
		  execution, any unexecuted exitops will be executed upon
		  exiting the application.

     delay_idb_read
		  Delay reading of distribution idb files.
		  default: default, choices: default on off
		  If set to "on", inst will delay reading of the distribution
		  idb files until after the Go/Start command is initiated.
		  This will result in significant speedup when reading large
		  distributions and less memory usage by inst or swmgr since
		  only necessary idb lines will be read into memory. Commands
		  such as "admin files" that require access to the

								       Page 18

inst(1M)							      inst(1M)

		  distribution files will cause the required distribution idb
		  files to be read.  If set to "off", the reading of the
		  distribution idb files will never be delayed. If set to
		  "default", the reading of distribution idb files will be
		  delayed unless the installation medium is CD. CDs are
		  treated specially because delaying the reading of idb files
		  would require extra CD switches in a multi-CD install. If
		  the user is installing from only 1 CD at a time or is
		  comfortable with extra CD switches, this preference may be
		  set to "on".

     delayspacecheck
		  Delay disk space checks until go
		  boolean, default: off (permanent)
		  Controls the timing of disk space calculations.  If
		  "delayspacecheck" is "off", disk space calculation is done
		  when a "list", "step", or "space" command is given if no
		  disk space calculation has yet been done for the current
		  software distribution.  If "delayspacecheck" is "on", disk
		  space calculation is deferred until the "go" or "space"
		  commands are given.  When "delayspacecheck" is "on", no disk
		  space information is displayed by the "list" or "step"
		  commands.

     detailspacecheck
		  Detailed space checking
		  boolean, default: off (permanent)
		  Controls the data used for disk space calculations. If
		  "detailspacecheck" is "on", size and type of every file
		  installed on the system via inst is obtained by stat-ing the
		  file on the disk. If "detailspacecheck" is "off", the state
		  of every file is assumed to be the same as that saved in the
		  history database and that information is used to make the
		  disk space calculations. "detailspacecheck" is slower, but
		  more accurate.

     disable_keepfile
		  Suppress keepfile processing
		  boolean, default: off
		  If set, the normal keepfile processing is skipped. Entries
		  in $rbase/var/inst/.keepfile will be ignored and the initial
		  installation selections will be unaffected by the .keepfile
		  entries.  See the "keepfile" help topic.

     disable_prereq_hints
		  Disable processing of the .prereq_hints file
		  boolean, default: off
		  If a .prereq_hints file is found in the distribution

								       Page 19

inst(1M)							      inst(1M)

		  directory, inst/swmgr will read this file and use the
		  product/version to distribution/CD mapping to help the user
		  figure out where prereq'd products reside. Turning this
		  option on disables this processing.

		  disable_redirect Ignore redirect file in distribution
		  boolean, default: off (expert)
		  Controls behavior when a .redirect file is found in a
		  distribution.	 If "on", the .redirect file is evaluated and
		  the distribution is redirected as specified. If "off" (the
		  default), the specified distribution is used. Please note
		  that setting this preference to "off" may result in some
		  products being skipped if they have been produced for a
		  newer version of inst or SoftwareManager. You should not
		  enable this preference unless you explicitly want to attempt
		  to view products that are not normally intended for
		  installation on your OS version or hardware platform.

     disable_related_dists
		  Ignore related dists file
		  boolean, default: off (expert)
		  If set, inst will ignore any .related_dists file that is
		  found on the distribution.

     disk_avail	  Override available space on target filesystems
		  string, default: NULL
		  This preference specifies the free space (in bytes) used in
		  disk space calculations. If set to a single value, like
		  "50M" or "1000" then it will apply to all filesystems. To
		  set the free space of specific filesystems, use the form:
		  "fs:size|fs:size|..." For example, a value of
		  "/:4096|/usr:50M" will result in 4096 bytes available on the
		  / filesystem, and 50M on /usr.  This preference is used for
		  debugging only.  See also "disk_blocksize" and
		  "disk_capacity".

     disk_blocksize
		  Override blocksize of target filesystems
		  string, default: NULL
		  This preference specifies an alternate blocksize (in bytes)
		  used in disk space calculations. If set to a single value,
		  like "1024", or "4k", then it will apply to all filesystems.
		  To set the blocksize for specific filesystems, use the form:
		  "fs:blocksize|fs:blocksize|..." For example, a value of
		  "/:512|/usr:4k" will result in a blocksize of 512 bytes on
		  the / filesystem, and 4096 byes on the /usr filesystem.
		  Blocksizes should be a multiple of 512 bytes. This
		  preference is used for debugging only.  See also
		  "disk_avail" and "disk_capacity".

								       Page 20

inst(1M)							      inst(1M)

     disk_capacity
		  Override capacity of target filesystems
		  string, default: NULL
		  This preference specifies an alternate filesystem size (in
		  bytes) used in disk space calculations. If set to a single
		  value, like "50M" or "500k" then it will apply to all
		  filesystems. To set the size of specific filesystems, use
		  the form: "fs:size|fs:size|..." For example, a value of
		  "/:300k|/usr:100M|/d2:100000" will result in a size of 300
		  kilobytes on the / filesystem, 100 megabytes on /usr, and
		  100000 bytes on /d2.	This preference is used for debugging
		  only.	 See also "disk_avail" and "disk_blocksize".

     diskless	  Diskless mode
		  default: none, choices: none share client (readonly)
		  Controls whether the tool is operating on a normal (non-
		  diskless) tree, a diskless share tree, or a diskless client
		  tree.

     display_size Units for product sizes
		  default: kbytes, choices: bytes blocks kbytes (inst-only)
		  Controls the units (bytes, kilobytes, or 512-byte blocks)
		  used to display product sizes.

     dist	  Most recent distribution source
		  string, default: NULL (permanent)
		  Each time product descriptions are read, the current
		  software distribution source (see help from) becomes the
		  value of "dist".  (A product name, if included in the "from"
		  argument, is not saved in "dist".)  You can use the value of
		  "dist" in your "from" commands using the syntax "$dist", for
		  example "from $dist/eoe2". The command "from none" results
		  in no distribution being read, and sets the view to target
		  for browsing or removing installed software. The value of
		  dist is saved from session to session.

     distribution The name of the distribution supplied by the user.
		  string, default: NULL (readonly)
		  This is the name of the distribution supplied by the user on
		  the command line. See also "dist".

     dryrun	  Dryrun mode
		  boolean, default: off
		  Controls whether operating in dryrun mode. In this mode, the
		  names of files which would have otherwise been installed or
		  removed are displayed. Even with dryrun mode enabled, some
		  configuration files in $rbase/var/inst may be created or

								       Page 21

inst(1M)							      inst(1M)

		  written and temp directories (/usr/tmp,/var/tmp) under
		  $rbase will be created if necessary.

     enable_autominiroot_compatibility
		  Create 6.3/6.4 compatible command file
		  boolean, default: off
		  This option controls whether the command file created for
		  autominiroot installations is compatible with the 6.3/6.4
		  miniroot.  This option is only required if doing an
		  autominiroot install from CD using a 6.3/6.4 miniroot.

     error_coredump
		  Force coredump on X errors
		  boolean, default: off (swmgr-only)
		  Controls whether errors in the X Windows interface result in
		  an immediate coredump.

     exclusions	  List of excluded files
		  string, default: NULL (expert)
		  This preference holds the list of excluded files, separated
		  by whitespace or the '|' character. Excluded files (and, for
		  directories, their descendents) are not installed or removed
		  during a "go".  A value of "none" indicates no exclusions
		  are in effect.  The -X command line option may also be used
		  to specify the exclusions.  If this preference is changed
		  during an interactive session, any previous disk space
		  calculations may become out of date. Use the "admin recalc"
		  command in inst or the "Recalculate Disk Space" command in
		  SoftwareManager to determine the new space requirements.
		  See also "restrictions".

     exitop_limit Exitop output limit
		  integer, default: 100000 (expert)
		  This is the maximum output allowed from exitops (shell
		  commands executed at the end of the installation). Output
		  over this limit is not displayed or logged. Also applies to
		  preops and postops (commands executed immediately before or
		  after a file is installed) and removeops (executed after a
		  file is removed). Removeops are only executed when a
		  subsystem is removed, for example with "versions remove",
		  but not when a subsystem is upgraded.

     extract_mode Extract images to original source tree
		  boolean, default: off (readonly)
		  Controls whether inst or SoftwareManager operates in extract
		  mode. In this mode, files are installed under their original
		  source names (relative to the effective root) used to create

								       Page 22

inst(1M)							      inst(1M)

		  the images. Only regular files (not directories, symlinks,
		  etc.) are installed.	No conflict checking, rqs processing,
		  or machtag matching is performed.  This preference must be
		  set before reading the distribution, preferably on the
		  command line using the -U option.

     fullmenu	  Display hidden commands
		  boolean, default: off (inst-only permanent)
		  Controls the list of commands shown in menus. If fullmenu is
		  "off" (the default), the most commonly used commands are
		  displayed in the menus. If fullmenu is "on", all commands
		  that are available are shown in the menus, and all the
		  hidden commands are displayed, too.  This preference changes
		  only the display of commands, not their availability. It is
		  "off" by default and saved from session to session.

     hide_image_products
		  Controls the display of image-level products.
		  boolean, default: on (permanent expert)
		  If "hide_image_products" is "on" (the default), image-level
		  products are not displayed. The value of
		  "hide_image_products" is saved between installation
		  sessions.

     http_picky	  Require special format distribution file in an HTTP
		  distribution.
		  boolean, default: on (permanent expert)
		  Require special format distribution file in an HTTP
		  distribution, rather than trying to adapt to any directory
		  format the HTTP server may see fit to provide.

     inst_initial_level
		  Inst product display level
		  default: subsystem, choices: product subsystem (permanent
		  expert)
		  Controls the initial level of products displayed in inst.

     inst_terse_mode
		  Reduced output for scripting
		  boolean, default: off (inst-only expert)
		  If set "on", inst output is minimized:  most normal status
		  and progress messages are suppressed unless explicitly asked
		  for, but any warnings, errors and explicitly requested
		  output still appear.	Also forces "page_output" "off",
		  "show_diskspace" "off", "show_legend" "off",
		  "show_percent_done" "off", "show_files" "off" and
		  "verbosity" to the value "1".	 Useful for automated scripts

								       Page 23

inst(1M)							      inst(1M)

		  driving inst.	 See also the -F<selections-file> command line
		  option, the inst "admin save" and "admin load" commands, and
		  the "verbose" preference.

     inst_visible_preferences
		  Set of optional preferences to display.
		  multivalue, default: permanent,transient,tty, choices:
		  permanent transient beginner expert tty gui (inst-only
		  permanent beginner)
		  Controls the set of optional preferences displayed with the
		  "set" command.  See also "show_hidden_preferences".

     install_identical_files
		  Install files even if contents are not new
		  boolean, default: on (permanent expert)
		  Controls whether to extract files from the distribution even
		  if the version on disk has the same size and checksum. If
		  "install_identical_files" is set to "off" installations are
		  much faster when little has changed from release to release.
		  Caution: use this preference only if you are comfortable
		  with the accuracy of the checksum -r test to determine
		  whether two files of equal length indeed are identical. See
		  sum(1m).

     install_minimum_overlay_files
		  Control number of files installed during overlay installs
		  boolean, default: true
		  This option seeks to minimize the number of files that are
		  installed when the user installs an overlay product.
		  Specifically, if the currently installed stream and the
		  stream to be installed are derived from the same base
		  product, only the minimum required number of base product
		  files are installed.	When set to false, all the base
		  product files are reinstalled if the base subsystem is
		  included in the distribution.	 If the required base
		  subsystem is not included in the distribution and this
		  preference is set to false, the miminum install will still
		  be attempted if no files are required from the base product.

     install_sites
		  List of former install sites
		  string, default: NULL (permanent expert)
		  Controls the list of former installation sites displayed.

     install_sites_size
		  Number of items to keep in the install sites list.
		  integer, default: 10 (permanent)

								       Page 24

inst(1M)							      inst(1M)

		  Controls the number of items in the former installation
		  sites list.

     instmode	  Type of installation
		  default: prototype, choices: normal prototype client
		  (expert)
		  Controls certain details of how the installation is
		  performed. The value is set automatically when the
		  installation target is initialized. The "instmode"
		  preference is exported as the environment variable $instmode
		  for use by exitops. During installs into a bootable target
		  (miniroot installs into /root, and live installs into /)
		  instmode has the value "normal". During other installs the
		  value is "prototype". If the value of "instmode" is changed,
		  it is recommended that the "admin recalc" command in inst or
		  the "Recalculate Disk Space" command in SoftwareManager be
		  used to recalculate space requirements (if any) for the new
		  UNIX kernel. See also "diskless".

     interactive  User interaction control
		  boolean, default: on
		  Controls whether the user will be prompted for responses to
		  questions.

     kernel_size_32
		  Size of 32-bit kernel, in bytes
		  integer, default: 6291456 (expert)
		  Controls the amount of disk space reserved on 32-bit systems
		  for /unix, during installations which will cause a new
		  kernel to be built by autoconfig(1M). See also
		  "kernel_size_64" and "autoconfig_overhead".

     kernel_size_64
		  Size of 64-bit kernel, in bytes
		  integer, default: 8388608 (expert)
		  Controls the amount of disk space reserved on 64-bit systems
		  for /unix, during installations which will cause a new
		  kernel to be built by autoconfig(1M). See also
		  "kernel_size_32" and "autoconfig_overhead".

     lines	  Number of lines in tty display
		  integer, default: 0 (inst-only permanent)
		  The "lines" preference is not supported in this release, but
		  will be supported in a future release.  In this release the
		  number of lines is automatically detected by inst (if
		  possible), but cannot be overridden.

								       Page 25

inst(1M)							      inst(1M)

     live_install Automatically boot miniroot for os installs
		  default: default, choices: default on off
		  If set to "on", installs of operating system software will
		  be allowed in multi-user mode. If set to "default", attempts
		  to install operating system software in multi-user mode will
		  automatically shut down the machine and proceed to
		  automatically boot the miniroot. The user makes selections,
		  resolves conflicts, and addresses any disk space issues from
		  multi-user mode. The go/start command from multi-user mode
		  will initiate the automatic miniroot boot sequence if
		  operating system software is being installed. If set to
		  "off", inst or swmgr will always attempt to boot the
		  miniroot. If no bootable "sa" file is not found in the
		  distribution directory and a miniroot install is needed,
		  inst or swmgr will fail with an appropriate error message.
		  NFS-mounted, remote CDROM, and HTTP distributions are not
		  bootable. Local CDROM and remote distributions, such as
		  "bigserver:/dist", are bootable. This preference is only
		  relevant in multi-user mode when installing into "/". The
		  user will always be prompted before the machine is actually
		  shut down.

     log_pane_height
		  Height of the log pane in SoftwareManager
		  integer, default: 125 (swmgr-only)
		  Specifies the height of the log pane in SoftwareManager.

     log_pane_log_size
		  Size of the log pane display
		  integer, default: 100000 (swmgr-only permanent)
		  Specifies the maximum amount of text that is displayed in
		  the log pane before truncation occurs.

     logfile_size Size of log file in bytes before recycle
		  integer, default: 307200 (permanent)
		  Controls the maximum size of the log file
		  (/var/inst/INSTLOG).

     mach_classfile
		  Mach classes file
		  string, default: /var/boot/.dl_classes (readonly)
		  Holds the name of the file containing the hardware chart
		  used during diskless installations when the -C argument is
		  specified, requesting that all architectures be installed.

								       Page 26

inst(1M)							      inst(1M)

     mach_info	  Mach tag values
		  string, default: NULL
		  Contains the mach tag values that determine which versions
		  of hardware-specific files to install. Multiple mach
		  expressions separated by the `|' character are permitted. If
		  this preference is NULL (the default) the mach values are
		  automatically derived according to the current hardware
		  configuration on the system.

     machfile	  Name of the standard mach file.
		  string, default: /var/inst/machfile
		  Controls the location of the standard machfile.

     menus	  Print menus
		  boolean, default: on (inst-only permanent)
		  Controls the automatic display of menus. Once you are
		  familiar with the menus, you may wish to disable the
		  automatic display by setting this preference "off". You can
		  redisplay the current menu at any time with a "?" command.
		  It is "on" by default and saved from session to session.

     miniroot	  Miniroot install
		  boolean, default: off (readonly)
		  This flag is on if in the miniroot.

     miniroot_graphics
		  Use miniroot graphics
		  default: default, choices: default on off (inst-only)
		  Controls whether or not progress is displayed using a
		  graphical progress box during miniroot installations. The
		  "default" setting will use graphical display of progress and
		  other information in the miniroot only during automatic
		  miniroot installs. A setting of "on" will always display
		  graphics in the miniroot. A setting of "off" will never
		  display graphics in the miniroot, instead displaying
		  information textually. The value of this preference is not
		  saved between sessions. Note: the graphical progress bar is
		  not available on all hardware platforms.

     mock_sproc	  Disable sprocs
		  boolean, default: off
		  When set, this disables sproc'ing, so that debugging is
		  possible. The command is printed on stdout, and execution
		  terminates until something is read from stdin.

								       Page 27

inst(1M)							      inst(1M)

     network_retry
		  Number of network retries
		  integer, default: 2 (permanent)
		  Holds the number of successive network timeouts allowed
		  before giving up on the connection. See "timeout".

     network_seek_threshold
		  Controls behavior of remote seek
		  integer, default: 65536
		  If seeking forward more than "network_seek_threshold" bytes
		  in a remote file, re-start the dd process instead of reading
		  and discarding the intervening bytes. This optimization of
		  re-starting dd may be disabled by setting
		  "network_seek_threshold" to zero. If the remote dd does not
		  support the iseek option, "network_seek_threshold" is always
		  treated as zero.

     never_resize_pane
		  Do not resize panes when switching selections modes
		  boolean, default: on (swmgr-only permanent expert)
		  Controls whether to resize panes when switching between
		  automatic installation and custom selections or manage
		  installed software modes in SoftwareManager.

     neweroverride
		  Allows installation of older products
		  boolean, default: off
		  Controls whether older subsystems can replace newer
		  subsystems that are installed. The default value, "off",
		  prevents you from installing subsystems that are older than
		  what is already installed (i.e., are marked "O" in "list"
		  and "step" output).  If you want to replace a subsystem with
		  an older version, set "neweroverride" to "on". The value of
		  this preference is not saved from inst session to inst
		  session.

     non_root	  Not root user can perform installs/removals
		  boolean, default: off (readonly)
		  Controls if a non-root user can perform installs/removals.

     overlay_mode Controls behavior when overlays are loaded
		  default: none, choices: none ask silent default
		  (permanent_target)
		  Controls behavior when overlays are loaded. Set to "ask" to
		  prompt users to choose an overlay stream if a distribution
		  contains an overlay. Set to "silent" to maintain the setting
		  of the "stream" preference and suppress all stream

								       Page 28

inst(1M)							      inst(1M)

		  preference prompts. Set to "default" to maintain the setting
		  of the "stream" preference but revert to prompting when
		  there are no remaining stream specific products installed or
		  in the distribution. A "none" setting indicates that no
		  stream has been chosen; users will be prompted to choose a
		  stream.

     overprint	  Use overprinting for verbose lists
		  boolean, default: on (inst-only permanent)
		  Controls the manner in which filenames are displayed during
		  installations and removals if the preference "show_files" is
		  turned on.  When this preference is on, scrolling the
		  display is significantly reduced by overprinting the file
		  names on the same line.  If you prefer scrolling as the file
		  names are displayed, set this preference "off". It is "on"
		  by default and saved from session to session.

     override_coarse_check
		  Allow coarse space check to stop install
		  boolean, default: true
		  This option allows the coarse, pre-go, space check to stop
		  the install. By default, this option is disabled since the
		  coarse space check is not as accurate as the post-go,
		  detailed space check that is performed after the user types
		  go in inst or presses start in swmgr.

     override_space_check
		  Override space checking
		  boolean, default: off (expert)
		  If set to "on", allows "go" despite a disk overflow
		  condition.

     page_output  Page output
		  boolean, default: on (inst-only)
		  Controls whether tty output is managed by a paging mechanism
		  similar to more(1m).

     perm_check	  Permissions check
		  boolean, default: on
		  Controls whether permissions-checking is performed during
		  the pre-installation check. When this preference is "on",
		  the inst or SoftwareManager will inform you during the pre-
		  installation check whether you have permission to install or
		  remove files in the affected directories.

								       Page 29

inst(1M)							      inst(1M)

     post_install_dialog
		  Ask about quit after install
		  boolean, default: on (permanent expert)
		  Controls if a dialog is displayed after an install asking if
		  the user wants to quit.

     precious_files
		  List of precious files
		  string, default: NULL (expert)
		  Holds the list of precious file separated by whitespace,
		  specified on the cmd-line or .swmgrrc. Inst or
		  SoftwareManager will not overwrite or remove any files which
		  the user has designated as precious.

     promptforid  Interactive prompt for unknown uid
		  boolean, default: off (permanent)
		  Controls whether the user will be interactively queried for
		  ids corresponding to unknown uids/gids. Unknown uids or gids
		  result when a passwd or group file does not contain an id
		  for the given name.  If "off", inst or SoftwareManager will
		  automatically choose the uids/gids (and write them to
		  /usr/adm/SYSLOG) based on the value of the "startid"
		  preference.

     remote_read_size
		  Remote distribution read buffer size
		  integer, default: 10240
		  Controls the size of the buffer used for reading remote
		  distributions.

     removepolicy Control remove behavior within inst
		  default: safe, choices: anything safe
		  This option controls what the user is allowed to remove from
		  the distribution view in inst. A setting of "anything"
		  allows any target products to be marked for removal in the
		  distribution view. Conversely, a setting of "safe" while in
		  the distribution view only allows targ products with the
		  same name as products in the distribution view to be marked
		  for removal. For example, with a setting of "safe", the
		  "remove *" operation in the distribution view would only
		  mark for removal target products that have the same name as
		  products currently in the distribution view. With a setting
		  of "anything", "remove *" in the distribution view would
		  mark all target products for removal, regardless of what
		  products are in the distribution view.

								       Page 30

inst(1M)							      inst(1M)

     report_exit_status
		  Set process exit status
		  boolean, default: off (permanent)
		  Controls the exit status to be set to various non-zero
		  values, depending on what caused the exit.

     restricted	  Restricted mode
		  boolean, default: off (inst-only)
		  This preference controls restricted mode in inst.

     restrictions List of restricted files
		  string, default: NULL (expert)
		  Holds the list of restricted files, separated by whitespace
		  or the '|' character. Restricted files (and, for
		  directories, their descendents) are the only files installed
		  or removed during a "go". A value of "none" indicates no
		  restrictions are in effect.  The -Y command line option may
		  be used to specify the restrictions.	If this preference is
		  changed during an interactive session, any previous disk
		  space calculations may become out of date. Use the "admin
		  recalc" command in inst or the "Recalculate Disk Space"
		  command in SoftwareManager to determine the new space
		  requirements.	 See also "exclusions".

     rqs_only	  Requickstart mode
		  boolean, default: off
		  Controls whether the only operation performed is rqs In this
		  mode the installation tool will execute any necessary rqs(1)
		  processing, and then exit. This preference can also be set
		  with the -Q command line option.

     rqs_task	  Fine-control over rqs(1) processing
		  default: default, choices: default rqsread rqsall
		  If set to "rqsread", then only the first rqs phase will be
		  performed (the rqs registry file is updated).	 If set to
		  "rqsall", then only the second rqs phase will be performed
		  (executables are requickstarted using the rqs(1) utility).
		  Otherwise both phases are performed, as necessary, when the
		  installation tool exits.

     rqs_timestamp
		  Rqs timestamp
		  string, default: NULL
		  If this preference is set, its value is passed to the
		  rqsall(1) command using the -timestamp argument, during rqs
		  processing.

								       Page 31

inst(1M)							      inst(1M)

     rulesoverride
		  Override any conflict
		  boolean, default: off
		  Controls whether conflicts can be overridden.	 The default
		  value, "off", prevents you from installing subsystems that
		  do not meet specified incompat or prereq rules.  If you want
		  to override these rules, set "rulesoverride" to "on". This
		  preference should be used cautiously. "rulesoverride" is not
		  saved from session to session. NOTE: it is best to first
		  resolve as many conflicts as possible, and then only as a
		  last resort use this preference just before "go" or "start"
		  to overcome the remaining conflicts. After the installation
		  completes, you are advised to set "rulesoverride" back to
		  "off" so that conflicts do not go accidentally unnoticed for
		  the remainder of the session.

     selections_pane_height
		  Height of the selections pane
		  integer, default: 350 (swmgr-only)
		  Specifies the height of the selections pane.

     set_path	  Control $PATH variable for exitops
		  default: default, choices: default environment specific
		  (permanent expert)
		  Can be set to "default", "environment", or "specific":
		  "default" - set path to a known path; "environment" - pass
		  $path in from the environment $PATH (or use the default path
		  if $PATH is not set); "specific" - use whatever is in the
		  preference "set_path_specific".

     set_path_specific
		  Path used for exitops
		  string, default: NULL (permanent expert)
		  Controls the path used for exitops.

     shadow_files List of files to shadow
		  string, default: NULL
		  Holds the list of shadow files, separated by whitespace,
		  specified on the command line or .swmgrrc

     shadowing	  File shadowing
		  boolean, default: NULL (readonly)
		  Controls whether special files are shadowed during a live
		  (non-miniroot) install.

								       Page 32

inst(1M)							      inst(1M)

     sharebase	  Root of sharetree in client mode
		  string, default: NULL
		  Holds the name of the root of sharetree in client mode.

     sharepoints  Potentially shared, read-only directories.
		  string, default: /usr/share|/usr/share/Insight
		  Holds a list of directory names, separated by whitespace or
		  the '|' character. These should be directory names as listed
		  in the installation history (if different from the true
		  pathnames on disk).  As necessary these directories are
		  tested for write-permission at the beginning of the pre-
		  installation check.  Other readonly directories (as are
		  commonly NFS-mounted) take longer to detect the first time.
		  As new readonly directories are discovered, the sharepoints
		  preference is automatically updated, to speed-up error
		  checking in future installations.  If set to "none", or to
		  an empty string, the sharepoint checking is disabled.

     shell	  Program to use for "sh" and "shroot"
		  string, default: /bin/csh (permanent)
		  Controls what program to use for "sh" and "shroot". It may
		  be any pathname, and is the name of the IRIX command that is
		  invoked for "sh" and "shroot" commands. It is normally
		  /bin/sh or /bin/csh; the default value comes from the SHELL
		  environment variable. It is saved from session to session.

     short_names  Display product name instead of description.
		  boolean, default: off (permanent)
		  Controls if the product name is displayed instead of the
		  product description when the products are listed.

     show_command_pane
		  Display the command pane on startup
		  boolean, default: off (swmgr-only)
		  Controls whether the command pane is shown on startup.

     show_diskspace
		  Display diskspace summary
		  boolean, default: on (inst-only permanent)
		  Controls whether the diskspace is displayed by the "list",
		  "step" and "recalculate" commands.  Use the "admin space"
		  command to display this summary even when this preference is
		  set "off".  See also "inst_terse_mode".

								       Page 33

inst(1M)							      inst(1M)

     show_distribution_pane
		  Display the distribution pane on startup
		  boolean, default: on (swmgr-only)
		  Controls whether the distribution pane is shown on startup.

     show_existing_conflicts
		  Display pre-existing conflicts
		  boolean, default: off
		  Controls whether pre-existing conflicts are displayed or
		  not.

     show_files	  Display filenames during install
		  boolean, default: off (permanent expert)
		  Controls whether the name of each file is displayed as it is
		  installed or removed.	 See also "overprint", to control
		  whether these listed filenames are displayed on the same
		  line or not.	See also "verbose".

     show_hidden_preferences
		  Hide or present all preferences
		  boolean, default: off (permanent expert)
		  Controls whether the user is presented with the hidden
		  preferences, in addition to the basic preferences. See also
		  "inst_visible_preferences" and "swmgr_visible_preferences".

     show_legend  Display list legend
		  boolean, default: on (inst-only permanent)
		  Controls whether the legend is displayed at the beginning of
		  the output of the "list" command.  See also
		  "inst_terse_mode".

     show_lint	  Show distribution consistency errors
		  boolean, default: off (permanent expert)
		  Controls whether to display any inconsistencies found while
		  reading the distribution.

     show_log_pane
		  Display the log pane on startup
		  boolean, default: off (swmgr-only)
		  Controls whether the log pane is displayed on startup.

     show_percent_done
		  Display task percentages
		  boolean, default: on (inst-only expert)
		  Controls whether percent-done messages are displayed in

								       Page 34

inst(1M)							      inst(1M)

		  inst.	 See also "verbose".

     show_selections_pane
		  Display the selections pane on startup
		  boolean, default: on (swmgr-only)
		  Controls whether the selections pane is shown on startup.

     show_stat_pane
		  Display the status pane on startup
		  boolean, default: on (swmgr-only)
		  Controls whether the status pane is shown on startup.

     show_subtasks
		  Print tasking information
		  boolean, default: off
		  Controls whether detailed information about tasks and sub-
		  tasks is displayed.

     skip_rqs	  Skip the requickstart process entirely
		  boolean, default: off
		  Controls whether to skip the requickstart process.  Use this
		  preference cautiously, since it can cause newly installed
		  dynamic ELF programs to start-up less quickly.  Note: You
		  should not use this option to avoid security notifications
		  from third-party change detection software, like Tripwire.
		  Instead, the use of "set rqs_task rqsread" is recommended,
		  so that rqs may be postponed until a time when the Tripwire
		  file integrity database can also been updated. See the -Q
		  option to inst for how to requickstart at a later time.

     smart_config_handling
		  Selectively install config(update) files
		  boolean, default: on (permanent)
		  If enabled, config(update) files will not be installed if
		  the previously installed version has the same size and
		  checksum as reported by the inst history file

     space_check  Controls space checking
		  boolean, default: on
		  Controls whether disk space checking is performed.  Use
		  cautiously, or you can run out of diskspace.

     space_update_interval
		  Seconds between disk space updates
		  integer, default: 10 (swmgr-only permanent)

								       Page 35

inst(1M)							      inst(1M)

		  Specifies how often the Disk Space area is automatically
		  updated (in addition to updates that occur when the product
		  selections change). If zero is specified, automatic updates
		  are disabled.

     startid	  Initial id to assign for an unknown uid/gid
		  integer, default: 60000 (permanent)
		  This preference is only relevant if promptforid is "off".
		  Inst or SoftwareManager will automatically assign unknown
		  uid/gid values based on the value of "startid".  After a
		  given unknown uid or gid is assigned the value (startid),
		  the next unknown uid/gid will be assigned (startid - 1), and
		  the next (startid - 2), etc.	It is recommended that startid
		  be assigned a value that no current uids/gids possess. If
		  inst or SoftwareManager automatically assigns a uid or gid
		  to a file, it will write the mapping to /usr/adm/SYSLOG.

     startup_script
		  Control optional installation startup script handling
		  default: prompt, choices: prompt ignore execute (expert)
		  This preference is used to control how inst and
		  SoftwareManager treat the inst.init startup script (if any)
		  that accompanies the software distribution. If set to
		  "prompt", the user is prompted before the script is
		  executed. If set to "ignore", the startup script is ignored.
		  If set to "execute" the startup script is run without
		  confirmation from the user. Non-interactive installations
		  (inst -a or swmgr -a -Vinteractive:off) will fail if a
		  startup script is present, unless this preference is
		  explicitly set on the command line with either
		  -Vstartup_script:ignore or -Vstartup_script:execute. This
		  preference is not saved across sessions, unless a line such
		  as "startup_script:ignore" is manually added to the
		  /var/inst/.swmgrrc file. For security reasons you are
		  strongly advised against adding the line
		  "startup_script:execute" to the .swmgrrc file.

     stream	  Controls type of overlays to be displayed
		  default: maint, choices: maint feature (permanent_target)
		  Controls type of overlays to be displayed.  To switch
		  between streams, normally the inst commands "install maint"
		  and "install feature", or Install menu in Software Manager,
		  should be used rather than setting this preference directly.
		  A setting of "maint" causes feature stream overlay products
		  to be hidden from the user. A setting of "feature" causes
		  maintenance stream overlay products to be hidden from the
		  user. Maintenance stream products and feature stream
		  products are incompatible with one another. Maintenance
		  stream products consist of bug fixes and changes required to

								       Page 36

inst(1M)							      inst(1M)

		  support new hardware. Feature stream products consist of bug
		  fixes and newly introduced features, possibly to take
		  advantage of new hardware. Normally, the inst commands
		  "install maint" and "install feature" should be used to
		  switch from one stream to the other, because these commands
		  modify the current selections in addition to setting the
		  stream preference. In Software Manager, use the Install menu
		  to switch between streams, after first opening a software
		  distribution containing feature or maintenance products and
		  choosing Customize Installation mode.

     suppress_rqs_errors
		  Suppress error message on rqsread/rqsall failure
		  boolean, default: true
		  This option suppresses the inst warning message that
		  accompanies an rqsread(1) or rqsall(1) error. The default is
		  to suppress the message since there is no loss of
		  functionality as the result of such a failure.

     swmgr_initial_level
		  SoftwareManager product display level
		  default: product, choices: product subsystem (swmgr-only
		  permanent expert)
		  Controls the initial level of products displayed.

     swmgr_visible_preferences
		  Set of optional preferences to display.
		  multivalue, default: transient,gui, choices: none transient
		  expert gui tty (swmgr-only permanent beginner)
		  Controls the set of optional preferences displayed in the
		  preferences dialog.  See also "show_hidden_preferences".

     swmgrrc_path Search path for .swmgrrc preference files
		  string, default: /var/inst:$rbase/var/inst:$rbase$HOME:$HOME
		  (expert)
		  Contains a colon-separated list of directories to search for
		  preference files, such as ~/.swmgrrc, that contain
		  preferences to be saved between sessions. The directories
		  are searched in the order specified. Preference settings in
		  the last .swmgrrc found have the highest precedence.

		  Whenever you change the value of a "permanent" preference,
		  its value will be saved in .swmgrrc (the one most recently
		  loaded) and will remain set in future inst or
		  SoftwareManager sessions.

		  The "swmgrrc_path" can also be modified by setting the
		  environment variable SWMGRRC_PATH. If the value is "none",

								       Page 37

inst(1M)							      inst(1M)

		  then no .swmgrrc files will be read, or saved.

     symlink_mode Create a symlink tree
		  boolean, default: off (readonly)
		  Controls whether inst or SoftwareManager operates in symlink
		  mode. In this mode, all files (but not directories, config
		  files, or noshare files) are installed as absolute symbolic
		  links pointing to the corresponding file in the real tree.
		  This preference can only be set on the command line, using
		  -T<symlink_root>. See "symlink_root".

     symlink_root Root of real tree in symlink mode
		  string, default: NULL (readonly)
		  Holds the root of the real tree to which symlinks point.
		  This preference can only be set on the command line, using
		  -T<symlink_root>. See "symlink_mode".

     syslog	  Log messages to /var/adm/SYSLOG
		  boolean, default: off (expert)
		  Controls whether inst or SoftwareManager will log errors and
		  warnings to /var/adm/SYSLOG in addition to
		  /var/inst/INSTLOG.

     target	  Location of target tree
		  string, default: / (readonly)
		  Holds the name of the root directory on the local filesystem
		  where files are installed or removed. SoftwareManager and
		  inst do not install or remove files outside of the target.
		  Normally during a live installation, the target is /, and in
		  the miniroot it is /root. The -r command line option may be
		  used to specify an alternate target.

     timeout	  Network timeout in seconds
		  integer, default: 120 (permanent)
		  Holds the amount of time to wait for a reply from a remote
		  host.	 If the remote machine does not respond after this
		  time, the request is attempted again. See "network_retry".
		  The default is two minutes; if your network is particularly
		  slow, this may not be enough.	 If you receive errors
		  regarding the network timeout, and you believe the access
		  will succeed if given more time, increase the value of this
		  preference. The value of timeout is saved from session to
		  session.

								       Page 38

inst(1M)							      inst(1M)

     toolname	  Name of invoked installation program.
		  string, default: NULL
		  Holds the name of the installation program, either "inst" or
		  "swmgr" (SoftwareManager).

     trace	  Trace debugging
		  multivalue, default: NULL, choices: none category checkpoint
		  config conflict constructor cutpoint destructor diskless
		  dispatcher dist errno file general gui hist http mach malloc
		  orphan perm prod remote resource rules rqs selection space
		  stat tape task all
		  Controls which type of debugging information is displayed.
		  Can be "all" or any combination of categories. Set to "none"
		  to disable debugging.

     verbose	  Display more detailed output
		  boolean, default: off (permanent expert)
		  When set "on", causes more status messages to be displayed.
		  For finer control of the same facility, see "verbosity".
		  See also "show_files", "show_percent_done" and
		  "inst_terse_mode".

     verbosity	  Message verbosity display threshold
		  integer, default: 2, choices: 0 to 6 (permanent)
		  Controls the level of error and related info messages
		  displayed.  0 for silent, 2 for verbose off (default), 4 for
		  verbose on, 6 for all messages.  For another way to control
		  this setting, see "verbose".

     verify_checksum
		  Verify checksum of file during install
		  boolean, default: on (permanent expert)
		  During the installation, verify the checksum of each file as
		  it is uncompressed or read from the archive.

     wrapmode	  Wrap/truncate long lines in display
		  default: wrap, choices: wrap truncate (inst-only permanent)
		  Controls the display of long subsystem descriptions by the
		  "list" command. In "wrap" mode, the part of the description
		  that overflows the right margin of the screen is shown
		  indented on the next line. In "truncate" mode, the line is
		  truncated near the right margin. The "step" command always
		  uses truncate mode, regardless of the setting of this
		  preference. It is "wrap" by default and saved from session
		  to session.

								       Page 39

inst(1M)							      inst(1M)

FILES
     /var/inst/machfile

SEE ALSO
     distcp(1M), gendist(1M), getinvent(3), showfiles(1M), showprods(1M),
     swmgr(1M), versions(1M), netscape(1M), share_inst(1M), client_inst(1M),
     tar(1M) and IRIX Admin: Software Installation and Licensing.

								       Page 40

[top]

List of man pages available for IRIX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
...................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net