swmgr(1M) swmgr(1M) NAME swmgr, SoftwareManager - software manager SYNOPSIS 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 ] DESCRIPTION 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 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 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. -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 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. 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. 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 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. 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. 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. 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. 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. 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 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. 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 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 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 "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 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". 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. 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 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". 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. 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 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. 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). 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 "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. 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 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" 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. 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. 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 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. 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. 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. SEE ALSO distcp(1M), inst(1M), showfiles(1M), showprods(1M), versions(1M), netscape(1M), tar(1M) and IRIX Admin: Software Installation and Licensing. Page 37