uadmin(ADM)


uadmin -- administrative control

Syntax

/etc/uadmin command function [ parameter ]

/etc/uadmin bdevsync device
/etc/uadmin clock seconds
/etc/uadmin getdev devtype xnamex
/etc/uadmin reboot haltop
/etc/uadmin remount
/etc/uadmin setconfig panicboot haltop
/etc/uadmin shutdown haltop
/etc/uadmin shutfast haltop

Description

uadmin provides control for basic administrative functions. This command is required for system administration procedures; it is not intended for general use.

The commands, functions and the parameters needed for some commands, are converted to integers and passed to the uadmin(S) system call. Alternatively, all the arguments except shutfast may be specified by their numeric equivalent. shutfast must always be specified by name. The numeric equivalents for the other commands and functions are defined in the header file /usr/include/sys/uadmin.h.

uadmin supports the following commands (shown with their functions and parameters):


bdevsync device
Flush all changed blocks (in the buffer cache) and changed inodes (if possible) belonging to block special device, and wait for the flushing to complete (unlike sync(ADM)). device may be one of:

all
all block devices

devnum
a device number

special
a block device special file

major[,]minor
the major and minor numbers of the block special device

xnamex[,]minor
xnamex is the internal name of the device driver as listed in the first field of the mdevice(F) file.

clock seconds
Set the difference in seconds from local time to GMT: west of Greenwich is positive, east is negative. The system's internal time is always GMT, whereas any Real Time Clock (RTC) usually runs in local time.

getdev devtype xnamex
Return the major device number for a driver.

xnamex is the internal name of the device driver as listed in the first field of the mdevice file.

The device type, devtype, is specified as one of:


b
block special device

c
character special device

reboot haltop
Stop the system without any further processing. The next action to be taken is specified by haltop:

boot
Automatic reboot (reboot without operator intervention).

halt
Halt the processor until a key is pressed to reboot the system.

iboot
Interactive reboot (operator intervention required). The system is brought down and a prompt is displayed; the system waits for a key to be pressed before rebooting. Note that in previous releases, iboot caused an automatic reboot,

pwrdown
Halt the processor; the system remains down with no option given to reboot.

pwrnap
A UPS or the BIOS-APM has detected a power outage; do not reboot until power returns. If possible, the machine is turned off.

remount
Remount the root filesystem after it has been fixed; this command is only issued during startup.

setconfig panicboot haltop
Configure how the system should respond after a panic. An automatic reboot haltop is performed. This is normally set by the PANICBOOT keyword in /etc/default/boot.

shutdown haltop
Shut down the system: update the boot filesystem, kill all user processes, flush the buffer cache, and unmount all filesystems including root.

The next action to be taken is specified by haltop as described for the reboot command.


shutfast haltop
Shut down the system: do not update the boot filesystem; otherwise, the action of shutfast is to proceed as for shutdown.

Warning

uadmin is not intended for general use.

Files


/usr/include/sys/uadmin.h
header file containing numeric equivalents for uadmin commands and functions

See also

boot(HW), uadmin(S)
© 2005 The SCO Group, Inc. All rights reserved.
SCO OpenServer Release 6.0.0 -- 03 June 2005