dg_sysctl(1M) DG/UX 5.4R3.00 dg_sysctl(1M)
NAME
dg_sysctl - display or modify boot and dump parameters
SYNOPSIS
dg_sysctl [ -t ] [ -R ] [ -r reboot-state ] [ -b boot-path ]
[ -d auto-dump-state ] [ -f dump-device ] [ -l dump-level ]
[ -p poweroff-state ]
DESCRIPTION
Use dg_sysctl to display or modify these boot and dump parameters:
auto-boot behavior, boot path, auto-dump behavior, dump device, dump
level, and auto-poweroff behavior. Entered without options, dg_sysctl
displays the current settings. While any user can display values,
only the superuser can change any.
The valid options are:
-t By default, changes you make with dg_sysctl remain in effect
permanently, or until you change them. Use this option to
make the changes temporary: after the next reboot, changed
values revert to whatever they were before the change.
If you use this option, it must be the first option specified
on the command line, and it must be followed by one or more of
the options explained below.
-R Reset defaults: set auto-boot (-r) to halt, auto-dump (-d) to
ask, dump level (-l) to kernel, boot path (-b) to the path of
the most recent boot, dump device (-f) to the value of the
DUMP variable, and poweroff (-p) to auto if the system
supports auto-poweroff and to skip otherwise.
This option may be preceded by the -t option. No options other
than -t are permitted on the command line.
-r halt | auto
Set the reboot behavior. The default is halt: after a panic,
the systems halts and waits to be rebooted manually. If set to
auto, the system tries to reboot after a panic, using the
current boot path.
-b boot-path
Specify the SCM boot pathname, enclosed in quotes. The default
boot path is that used for the most recent boot. (If you
specify an empty name or spaces, the default SCM boot path is
used.)
-d ask | skip | auto
Specify system behavior after a panic. The default is ask:
after a panic, a prompt appears asking whether you want to
dump memory contents to the dump device (see the -f option,
next). If you specify skip, the system gives you no
opportunity to dump memory. If you specify auto, the system
trys to dump memory contents to the dump device without
Licensed material--property of copyright holder(s) 1
dg_sysctl(1M) DG/UX 5.4R3.00 dg_sysctl(1M)
asking.
Note that, if auto is set and a panic occurs, and if the dump
device is a tape drive:
(1) Any tape in the drive that is not write-protected will be
overwritten.
(2) If the drive contains no tape, or a write-protected tape,
or a tape that is too small to hold the memory dump, no
opportunity is provided to restart the dump with a new tape.
Also note that for operator-invoked panics such as "hot key"
and "S 1000" this option will not change the behavior after a
system panic. Operator invoked panics will always ask you
whether you want to take a dump.
-f dump-device
Specify the dump device to use after a panic. The default
device is the value of the DUMP variable, which may be
assigned in the DG/UX system file. If the system
configuration file contains no DUMP assignment statement, the
variable initially contains the device name given in the file
/usr/etc/master.d/dgux, whether or not this device is present
on your system.
The dump-device may specify a tape or virtual disk device. To
specify a tape device for the dump-device, use the tape's
device specification, like this:
st(insc(),4)
To specify a virtual disk for the dump-device, use a string of
the form:
vdm_dump(physical-disk,virtual-disk)
where the virtual-disk is a partition virtual disk residing on
the physical-disk. For example:
vdm_dump(sd(insc(),0),sys_dump)
is a valid specification.
Devices and naming conventions are explained in Customizing the
DG/UX System, Appendix C.
-l kernel | all
Specify which main memory frames to dump during a memory dump:
either kernel frames--the default--or all memory frames.
This parameter does not apply to diskless workstations.
Diskless workstations always dump all memory frames.
Note: unless requested by Data General to change this setting,
Licensed material--property of copyright holder(s) 2
dg_sysctl(1M) DG/UX 5.4R3.00 dg_sysctl(1M)
leave it set to the default. Kernel-frame dumps are smaller and
faster, and in most cases contain all the information needed to
understand the cause of a panic.
-p auto | skip
Specify poweroff behavior after a normal shutdown. If you
specify auto, the system attempts to power itself off after a
normal shutdown. If you specify skip, the system does not
attempt to power itself off.
This setting applies only to normal shutdowns. It has no affect
on system behavior after a panic or other abnormal shutdown.
Not all systems support automatic poweroff. On systems which
do, the default value is auto; on other systems, the default is
skip.
EXAMPLES
dg_sysctl -r auto -b "/dgux -3" -d auto -f "st(insc(),4)"
Enable auto-reboot after a panic; reboot the kernel /dgux
to init level 3; enable auto-dump after a panic; dump
memory contents to SCSI tape device 4.
FILES
/etc/default/dg_sysctl
Stores the parameters that have been set by dg_sysctl.
This file does not exist unless permanent changes have been
made using dg_sysctl.
/etc/bootparams
On a system that serves diskless workstations, specifies
for each the boot, swap, and dump pathnames.
DIAGNOSTICS
The dg_sysctl exit codes have the following meanings:
0 The operation was successful.
1 The operation was unsuccessful.
2 The operation failed due to access restrictions.
3 There was an error in the command line.
SEE ALSO
reboot(1M), dg_sysctl(2), Using the AViiON® System Control
Monitor(SCM) (014-001802), Customizing the DG/UX System (093-701101),
Managing the DG/UX System (093-701088).
Licensed material--property of copyright holder(s) 3