utconfig(8) CLIX utconfig(8)
NAME
utconfig - Displays or sets workstation configuration parameters
SYNOPSIS
utconfig -d[f]
utconfig -s[f]
FLAGS
-d Displays the current configuration parameter values and the valid
parameter settings for the system.
-f Uses the system defaults for displaying the parameter settings or for
saving the parameter values to the system disk.
-s Reads the parameter values from stdin and writes the specified
parameter values to the configuration area of the system disk.
DESCRIPTION
The utconfig command displays or modifies the system configuration
parameters from the workstation Utility Pages. Most of the operations
that can be performed with utconfig can also be performed using the
Utility Pages.
The utconfig -s command reads configuration parameters from stdin. Each
input line describes a parameter. The format of the input line is as
follows, where each item is separated by a tab:
parameter value #comments
Exceptions to this input format are the wkspwd and fdmpwd parameters.
The output format of utconfig -d is the same as the input format for
utconfig -s.
The following parameters are supported:
kfn Specifies the kernel file name. The default is unix. File name
limitations apply.
nn Specifies the network node name associated with the system
network address. Network node name limitations apply.
bsu Forces the system to boot into single user mode as opposed to
multi-user mode. Any :initdefault: entry in the /etc/inittab
file will be ignored if this switch is set to yes. The default
setting is no.
2/94 - Intergraph Corporation 1
utconfig(8) CLIX utconfig(8)
ad Causes the system to automatically dump system memory to the swap
device following a system crash.
ar Causes the system to automatically reboot following a system
crash.
ss Turns the screen saver on or off.
fmp Indicates whether or not a floating menu is present.
kc Turns the keyboard clicks on or off.
mc Turns the membrane clicks on or off.
bt Sets the bell tone volume to loud or soft, or disables the bell
tones.
rtdev Specifies the device on which the root file system resides. Valid
devices are HD (hard disk) and FL (floppy). The default device
is HD.
rtscsi Specifies the SCSI ID for the disk on which the root file system
resides. The default SCSI ID is 0.
rtlun Indicates the Logical Unit Number for the disk on which the root
file system resides. The default is 0.
rtpar Indicates the root partition number. The default partition
number is 7.
rtmod Indicates the root modifier number. The default is 0.
swdev Indicates the device on which the primary swap space resides.
Valid devices are HD (hard disk) and FL (floppy). The default
device is HD.
swscsi Specifies the SCSI ID for the disk on which the primary swap
space resides. The default is SCSI ID is 0.
swlun Indicates the Logical Unit Number for the disk on which the
primary swap space resides. The default is 0.
swpar Indicates the swap partition number. The default partition
number is 7.
swmod Specifies the swap modifier number. The default is 1.
wkspwd Allows the user to specify a new workstation password.
fdmpwd Allows the user to specify the Forth Diagnostic Monitor (FDM)
password.
2 Intergraph Corporation - 2/94
utconfig(8) CLIX utconfig(8)
fdmlim Indicates the invalid password limit for the FDM password.
iop Specifies the I/O Processor ID. Valid processor IDs are 0, 1, 2,
and 3, depending on the system type. Any auxiliary port
parameters following this selection will relate to the specified
I/O Processor (iop). This parameter is only displayed on multiple
iop systems.
aux Specifies the auxiliary port selection. Valid ports are 0, 1, 2,
and 3, depending on the system type. Auxiliary port parameters
following this selection will relate to the specified auxiliary
port. The following auxiliary port options are valid:
sd Enables or disables input from the serial device.
bd Selects a baud rate for the serial device. The
following rates are valid: 50, 75, 110, 134, 150, 300,
600, 1200, 1800, 2000, 2400, 3600, 4800, 7200, 9600, and
19200.
p Selects even, odd, or no parity for the serial device.
ws Selects a word size for the serial device. Valid sizes
are 5, 6, 7, 8.
sb Specifies the number of stop bits required to frame
characters for the serial device. Valid options are 1
and 2.
xon Specifies whether the workstation should generate
automatic XON/XOFF flow control characters for the
serial device. Valid options are no and yes.
xoff Specifies whether incoming flow control sequences from a
serial device at the chosen auxiliary port should be
honored. Valid options are on or off.
cts Enables or disables RTS/CTS flow control signals for the
serial device.
EXAMPLES
1. This example shows sample output from the display option (-
d). The following command displays default configuration
values as shown:
utconfig -df
PARAM DEFAULT DESCRIPTION OPTIONS
kfn unix # Kernel file name
Filename limitations apply
nn # Node name Nodename limitations apply
2/94 - Intergraph Corporation 3
utconfig(8) CLIX utconfig(8)
bsu NO # Boot single user YES, NO
ad YES # Automatic dump YES, NO
ar NO # Automatic reboot YES, NO
ss YES # Screen saver YES, NO
fmp NO # Floating menu present YES, NO
kc OFF # Key clicks ON, OFF
mc OFF # Membrane clicks ON, OFF
bt SOFT # Bell tones SOFT, LOUD, NONE
rtdev HD # Root device HD, FL
rtscsi 0 # Root SCSI ID 0-6
rtlun 0 # Root logical unit 0-1
rtpar 0x7 # Root partition 0x00-0xff
rtmod 0x0 # Root modifier 0x00-0xff
swdev HD # Swap device HD, FL
swscsi 0 # Swap SCSI ID 0-6
swlun 0 # Swap logical unit 0-1
swpar 0x7 # Swap partition 0x00-0xff
swmod 0x1 # Swap modifier 0x00-0xff
#wkspwd ******* # Workstation password
#fdmpwd ******* # Forth Diagnostic Monitor
# (FDM) password
fdmlim 0 # Forth Diagnostic Monitor
# invalid password limit
# 0-255, 0=NO LIMIT
.
.
.
2. The following command lines save the default parameter
settings:
utconfig -df | utconfig -s
utconfig -sf
3. The following command sequence creates an output file
(sample) listing the current parameter settings, edits
sample, and saves the new parameter settings. First key in:
utconfig -d > sample
Make the needed changes in the file sample, then key in:
utconfig -s < sample
4. This example shows how to read new parameter values from
stdin and save them to the configuration file:
utconfig -s
4 Intergraph Corporation - 2/94
utconfig(8) CLIX utconfig(8)
PARAM VALUE
nn john
bsu yes
kc on
aux 1
bd 1200
wkspwd
New workstation password:
Re-enter new workstation password:
<Ctrl-D>
This example changes the nodename to john, sets the system up
to boot single user, turns on key clicks, and sets the baud
rate to 1200 on auxiliary port 1. This example also sets the
workstation password. Note that the workstation password is
not echoed to the screen.
NOTES
Only the superuser can change configuration parameters.
The system must be rebooted before any parameter changes will take effect.
Saving the default values (-sf flags) saves a null string for the node
name. Therefore, if a node name is present and the default values for the
parameters are saved, the node name must be changed using the -s flag.
The workstation password (wkspwd parameter) and FDM password (fdmpwd
parameter) are not changed by saving the default parameter values. Use
the -s flag to change these parameters.
CAUTIONS
All saved parameter values will remain saved until changed using either
this utility or the Workstation Utility Pages.
EXIT VALUES
The utconfig command exits with a value of 0 when successful. Otherwise,
utconfig exits with a non-zero value.
RELATED INFORMATION
Intergraph System and Network Administrator's Guide
2/94 - Intergraph Corporation 5