swmgr(1M) swmgr(1M)
swmgr, SoftwareManager - software manager
swmgr [ -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 ]
swmgr 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.
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.
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.*
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 whitespaceseparated
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).
/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
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 deselected,
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 NFSmounted
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 nfsmounted
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 manageinstalled-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 (nondiskless)
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
|
