HP-UX Reference (11i v1 00/12) - 1M System Administration Commands A-M (vol 3)
__________________________________________________________________________________________________________________________________________________________________________________________________
__________________________________________________________________________________________________________________________________________________________________________________________________
STANDARD Printed by: Nora Chuang [nchuang] STANDARD
/build/1111/BRICK/man1m/!!!intro.1m
________________________________________________________________
___ ___
a
amutil(1M) amutil(1M)
Command Authorizations
This command requires the sysadmin authorization to successfully execute.
Privileges
The command has been modified to support least privilege. The potential privileges possessed by the com-
mand and their uses include:
allowdacread This privilege is raised to provide discretionary read access to the devices.
allowdacwrite This privilege is raised to provide discretionary write access to the devices.
allowmacread This privilege is raised to provide mandatory read access to the devices.
allowmacwrite This privilege is raised to provide mandatory write access to the devices.
filesysops This privilege is raised to allow the mknod(2) system call to succeed.
writeaudit The command generates its own audit records and submits these directly to the sys-
tem audit trail. This privilege is raised whenever the command needs to write an
audit record.
EXTERNAL INFLUENCES
Environment Variables
LC_MESSAGES determines the language in which messages are displayed. The current language settings
can be checked with locale(1).
RETURN VALUE
amutil returns the following values:
0 Successful completion.
1 An error in execution (I/O, subsystem, security, etc.) occurred.
2 An error in command syntax occurred: for example, an unknown command line option was
passed.
3 Timeout in communication to server. May indicate the
AM60Srvr is not running.
4 The state of the disk array has changed since AM60Srvr was started. A RESCAN should be per-
formed using amdsp(1M) to update
AM60Srvr status.
DIAGNOSTICS
The following messages can be generated by amutil:
amutil {[-f Channel:Id] | [-F] | [-s] |
-R <LUN> -f <Freq> -a <Amt> | -l ]
[-V] <ArrayID>}
amutil -?
An error in command syntax has occurred. Reenter the command with all necessary arguments.
amutil: Arg out of range
One of the arguments has exceeded its maximum or minimum size, or is incorrect in form. Check the
size and form of each argument.
amutil: The <ArrayID> entered does not identify a known, supported array
The specified ArrayID does not exist or does not identify a device that is communicating with the sys-
tem. Verify the array exists and is operational.
amutil: The specified controller is not physically installed.
A controller-specific command was issued to a non-existent or inaccessible controller.
amutil: The specified LUN does not exist in this array.
The specified LUN does not exist.
amutil: Error in command execution, <Additional Error Info>:
<Error Info Decode>
The command failed due to a device error, an internal error, or a system error. The Additional Error
Info and Error Info Decode fields will hold specifics about the failure and its cause.
EXAMPLES
Flash the amber LEDs on all the disks in disk array RACK_51:
HP-UX Release 11i: December 2000 − 2 − Section 1M−−39
___
___