[ Previous | Next | Contents | Glossary | Home | Search ]
AIX Version 4.3 Commands Reference, Volume 3

lsrole Command

Purpose

Displays role attributes. This command applies only to AIX Version 4.2.1 and later.

Syntax

lsrole [ -c | -f ] [ -a List ] { ALL | Name [ ,Name ] ... }

Description

The lsrole command displays the role attributes. You can use this command to list all attributes of all the roles or all the attributes of specific roles. Since there is no default parameter, you must enter the ALL keyword to see the attributes of all the roles. By default, the lsrole command displays all role attributes. To view selected attributes, use the -a List flag. If one or more attributes cannot be read, the lsrole command lists as much information as possible.

By default, the lsrole command lists each role's attributes on one line. It displays attribute information as Attribute=Value definitions, each separated by a blank space. To list the role attributes in stanza format, use the -f flag. To list the information as colon-separated records, use the -c flag.

You can use the Web-based System Manager Users application (wsm users fast path) to run this command. You could also use the System Management Interface Tool (SMIT) to run this command.

Flags

-a List Lists the attributes to display. The List variable can include any attribute defined in the chrole command and requires a blank space between attributes. If you specify an empty list, only the role names are displayed.
-c Displays the role attributes in colon-separated records, as follows:
# role:  attribute1:  attribute2:  ... 
  Role:  value1:      value2:      ...
-f Displays the output in stanzas, with each stanza identified by a role name. Each Attribute=Value pair is listed on a separate line:
Role:
       attribute1=value
       attribute2=value
       attribute3=value

Security

Files Accessed:

Mode File
r /etc/security/roles

Examples

To display the role rolelist and groups of the role ManageAllUsers in colon format, enter:

lsrole -c -a rolelist groups ManageAllUsers

Information similar to the following appears:

# role: rolelist:groups
 ManageAllUsers: ManagerBasicUser:security

Files

/etc/security/roles Contains the attributes of roles.

Related Information

The chrole command, chuser command, lsuser command, mkrole command, mkuser command, rmrole command.

Security Administration in AIX Version 4.3 System Management Guide: Operating System and Devices.

Setting up and running Web-based System Management in AIX Version 4.3 System Management Guide: Operating System and Devices.

Administrative Roles Overview in AIX Version 4.3 System Management Guide: Operating System and Devices.


[ Previous | Next | Contents | Glossary | Home | Search ]