dg_sysctl(1M) DG/UX R4.11MU05 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 ] [ -s scm-boot-path ]
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
(except scm-boot-path), appropriate privilege is required if you want
to change any. For systems with DG/UX information security,
appropriate privilege is defined as having one or more specific
capabilities enabled in the effective capability set of the user.
See the cap_defaults(5) man page for the default capabilities for
this command. On generic DG/UX systems, appropriate privilege means
that your process has an effective UID of root. See the
appropriate_privilege(5) man page for more information.
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.
This option has no effect on the scm-boot-path. Any changes
made to the scm-boot-path are permanent.
-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.
This option has no effect on the scm-boot-path.
-r halt | auto
Set the reboot behavior. The default is halt: after a serious
system error, the systems halts and waits to be rebooted
manually. If set to auto, the system tries to reboot, using
the current boot path.
-b boot-path
Specify the 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 boot path is
used.)
-d ask | skip | auto
Specify system behavior after a halt. The default is ask:
after a halt, 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 asking.
Note that, if auto is set and a halt 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 halts such as "hot key"
and "S 1000" this option will not change the behavior after a
system halt. Operator invoked halts will always ask you
whether you want to take a dump.
-f dump-device
Specify the dump device, enclosed in quotes, to use after a
serious system error or halt. 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.
Note that you can dump to a virtual disk only if it resides
entirely on a local SCSI disk. See CAUTIONS below for
restrictions.
Devices and naming conventions are explained in Managing the
DG/UX System and Managing Mass Storage Devices and DG/UX File
Systems.
-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,
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 halt.
-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 halt 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.
-s scm-boot-path
m88k systems only. Specify the default scm boot pathname,
enclosed in quotes, to be used as the default boot path by the
SCM.
Not all m88k systems support changing the default scm boot
path using dg_sysctl. On systems which do not support
changing the scm boot path via dg_sysctl, an error will be
returned.
For Intel machines, the primary default boot command string,
boot_command_1, can be set by the admnvram(1M) command.
EXAMPLES
dg_sysctl -r auto -b "/dgux -3" -d auto -f "st(insc(),4)"
Enable auto-reboot after a halt; reboot the kernel /dgux to
init level 3; enable auto-dump after a halt; 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), cap_defaults(5), Managing the DG/UX System.
CAUTIONS
You can dump to a virtual disk only if it resides entirely on a local
SCSI disk. You cannot dump to a virtual disk that comprises multiple
partitions spanning multiple physical disks or to any virtual disk
residing on an SMD or ESDI physical disk. The dump process will
write over any data, such as a file system, that resides on the
virtual disk at the time of the dump. Therefore, you should not
create a file system on the disk and attempt to use it for any
purpose other than to contain the dump. For the same reason, there
should be no file system entry in /etc/fstab that uses the virtual
disk.
Licensed material--property of copyright holder(s)