machstat Command

Purpose

Reports the value of the first 4 bits of the power status register.

Syntax

machstat { -p | -f }

Description

The machstat command returns the value of a status register. There is no standard output or error except when using the -f flag on CHRP hardware.

Flags

Item Description
-f On non-CHRP machines, returns Power Status Register bits 10–13. On CHRP machines, displays the EPOW status, EPOW modifier, and, if present, EPOW version.
-p Returns the first 4 bits of the power status register.

Exit Status

The machstat command returns a value of 255 if an error occurs. Otherwise it returns the value of the register.

Security

Access Control: root only

Attention RBAC users and Trusted AIX users: This command can perform privileged operations. Only privileged users can run privileged operations. For more information about authorizations and privileges, see Privileged Command Database in Security. For a list of privileges and the authorizations associated with this command, see the lssecattr command or the getcmdattr subcommand.

Examples

To see the current value of the power status register, enter:

machstat -p
echo $?

Files

Item Description
/etc/rc.powerfail Shuts down a system when a power failure is detected