HP-UX Reference (11i v2 07/12) - 1M System Administration Commands A-M (vol 3)

a
amutil(1M) amutil(1M)
Security Behavior/Restrictions
Use of this command is restricted to authorized users only.
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.
DIAGNOSTICS
The following messages can be generated by
amutil:
Usage: amutil {-f <Channel:ID>[,<Channel:ID>...] |
-F | -l | -s |
-R <LUN> -f <Freq> -a <Amt>}
[-V] <ArrayID>}
amutil -p [-V]
Extended help: 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.
64 Hewlett-Packard Company − 2 − HP-UX 11i Version 2: December 2007 Update