HP Systems Insight Manager 6.3 Command Line Interface Guide

XML file support
The mxauth command enables you to add or remove authorizations by specifying an XML file
containing a list of authorizations. See the Examples section and the mxauth(4) manpage for
more information.
XML input files are processed in three passes:
1. The first pass attempts to parse the XML file and generate a list of authorizations to process.
This pass ensures that the XML file is formatted correctly, and the authorization objects contain
syntactically valid information.
If an error is detected, the process is interrupted, an error is generated, and the Systems Insight
Manager database is not changed.
2. During the second pass, mxauth tries to resolve the components in each authorization to
objects in the database. If the command encounters a logic error, such as a nonexistent user,
toolbox, system, or system group, the process is interrupted, an error is generated, and the
Systems Insight Manager database is not changed.
3. During the third pass, mxauth performs the requested authorization addition or removal, and
updates the database.
Duplicate and undefined authorizations are ignored during add and remove operations.
Options
-a
Add authorizations. The wildcard character (*) is supported for nodename and
groupname .
-r
Remove authorizations. The wildcard character (*) is supported for nodename
and groupname .
-f filename
Specify a file that contains the list of authorizations to add or remove.
-l t
List all authorizations in tabular format.
-l f
List authorization information in XML format. The resulting file can be edited and
used to add or remove authorizations with -f.
-b encoding
Specify the character encoding for the XML file. This is used with -l f.
-u username
Specify the user for the authorization.
-U usergroupname
Specify the authorizations for user groups.
-R toolboxname
Specify the toolbox name for the authorization. Enclose toolbox names with
embedded spaces in quotation marks.
mxauth 21