uadmin(ADM)

Syntax

/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

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

Files

/usr/include/sys/uadmin.h

header file containing numeric equivalents for uadmin commands and functions

See also