swmgr(1M)swmgr(1M)NAME
swmgr, SoftwareManager - software manager
SYNOPSISswmgr [ -nN ] [ -f source ] [ -m hardware=value ] [ -r target ]
[ -u action ] [ -F selections-file ] [ -I selection ]
[ -R selection ] [ -K selection ] [ -X file ] [ -Y file ]
[ -V preference:value ] [ -- X-command-line-option ... ]
SoftwareManager [ swmgr_options ]
DESCRIPTIONswmgr is the graphical tool used to install, remove, and browse software
distributed by Silicon Graphics.
SoftwareManager invokes swmgr with the arguments provided after prompting
for the root password if one is necessary.
The -f option specifies the location of new software to be installed.
The source argument is either a single distribution, or a directory
containing one or more distributions. Software distributions are in a
format defined by Silicon Graphics and that can be read only by swmgr and
inst(1M). See the inst_dev product for creating your own software
distributions.
swmgr can read the distribution from a local drive (tape, CD-ROM or
disk), or from a remote directory, web site, or drive connected to the
same network as your workstation. See the inst(1M) manual page for a
full description of possible distribution media.
The command line options are:
-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
Page 1
swmgr(1M)swmgr(1M)
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
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
Page 2
swmgr(1M)swmgr(1M)
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
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.
Page 3
swmgr(1M)swmgr(1M)-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.
-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
Page 4
swmgr(1M)swmgr(1M)
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.
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.
-m hardware=value
Specify an alternate type of hardware for the installation. See the
inst(1M) manual page for a full description of this option.
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.
Page 5
swmgr(1M)swmgr(1M)
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".
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.
Page 6
swmgr(1M)swmgr(1M)
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.
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
Page 7
swmgr(1M)swmgr(1M)
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.
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.
Page 8
swmgr(1M)swmgr(1M)
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.
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.
Page 9
swmgr(1M)swmgr(1M)
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.
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.
Page 10
swmgr(1M)swmgr(1M)
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
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.
Page 11
swmgr(1M)swmgr(1M)
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
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.
Page 12
swmgr(1M)swmgr(1M)
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.
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
Page 13
swmgr(1M)swmgr(1M)
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
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.
Page 14
swmgr(1M)swmgr(1M)
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".
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
Page 15
swmgr(1M)swmgr(1M)
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
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
Page 16
swmgr(1M)swmgr(1M)
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
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
Page 17
swmgr(1M)swmgr(1M)
"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".
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
Page 18
swmgr(1M)swmgr(1M)
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
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".
Page 19
swmgr(1M)swmgr(1M)
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
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.
Page 20
swmgr(1M)swmgr(1M)
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
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
Page 21
swmgr(1M)swmgr(1M)
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)
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".
Page 22
swmgr(1M)swmgr(1M)
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.
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.
Page 23
swmgr(1M)swmgr(1M)
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.
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
Page 24
swmgr(1M)swmgr(1M)
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.
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.
Page 25
swmgr(1M)swmgr(1M)
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
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).
Page 26
swmgr(1M)swmgr(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.
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
Page 27
swmgr(1M)swmgr(1M)
"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.
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.
Page 28
swmgr(1M)swmgr(1M)
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.
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
Page 29
swmgr(1M)swmgr(1M)
shadowing File shadowing
boolean, default: NULL (readonly)
Controls whether special files are shadowed during a live
(non-miniroot) install.
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"
Page 30
swmgr(1M)swmgr(1M)
command to display this summary even when this preference is
set "off". See also "inst_terse_mode".
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.
Page 31
swmgr(1M)swmgr(1M)
show_percent_done
Display task percentages
boolean, default: on (inst-only expert)
Controls whether percent-done messages are displayed in
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.
Page 32
swmgr(1M)swmgr(1M)
space_update_interval
Seconds between disk space updates
integer, default: 10 (swmgr-only permanent)
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
Page 33
swmgr(1M)swmgr(1M)
user. Maintenance stream products and feature stream
products are incompatible with one another. Maintenance
stream products consist of bug fixes and changes required to
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.
Page 34
swmgr(1M)swmgr(1M)
The "swmgrrc_path" can also be modified by setting the
environment variable SWMGRRC_PATH. If the value is "none",
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 35
swmgr(1M)swmgr(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 36
swmgr(1M)swmgr(1M)SEE ALSOdistcp(1M), inst(1M), showfiles(1M), showprods(1M), versions(1M),
netscape(1M), tar(1M) and IRIX Admin: Software Installation and
Licensing.
Page 37
