lsuser

Use the lsuser command to display a list of the users that are created on the system.

Syntax

Parameters

-nohdr

(Optional) By default, headings are displayed for each column of data in a concise style view, and for each item of data in a detailed style view. The -nohdr parameter suppresses the display of these headings.

Note: If there is no data to be displayed, headings are not displayed.

-delim delimiter

(Optional) By default in a concise view, all columns of data are space-separated. The width of each column is set to the maximum width of each item of data. In a detailed view, each item of data has its own row, and if the headers are displayed, the data is separated from the header by a space. If you enter -delim : on the command line, the colon character (:) separates all items of data in a concise view; for example, the spacing of columns does not occur. In a detailed view, the data is separated from its header by the specified delimiter.

-filtervalue attribute=value

(Optional) Specifies a list of one or more filters. Only objects with a value that matches the filter attribute value are displayed.

Note: Some filters allow the use of a wildcard when you enter the command. The following rules apply to the use of wildcards with the FlashSystem 7300 CLI:

The wildcard character is the asterisk (*).
The command can contain a maximum of one wildcard.
When you use a wildcard, enclose the filter entry within double quotation marks (""), as follows:
```
lsuser -filtervalue "usergrp_name=md*"
```

-filtervalue?

(Optional) Displays the valid filter attributes for the -filtervalue attribute=value parameter:

password
ssh_key
remote
usergrp_id
usergrp_name
owner_id
owner_name
locked
password_change_required

usergrp_name | usergrp_id

(Optional) Specifies the ID or name of the user for which the association is being deleted. If this parameter is specified, the detailed view for the specified user is displayed in the output. If you do not specify an ID or name, the concise view is displayed.

Description

This command displays a list of users that is created on the system.

This table provides the possible values that are displayed for the lsuser command.

Table 1. lsuser attribute values
Attribute	Value
`id`	Specifies the ID of the user.
`name`	Specifies the name of the user.
`password`	Specifies if a password is set for the user.
`ssh_key`	Specifies if an SSH key is set for the user.
`remote`	Specifies if the user is remote.
`usergrp_id`	Specifies the ID of the user group that the user is a member of.
`usergrp_name`	Specifies the name of the user group that the user is a member of.
`owner_id`	Specifies the owner ID of the user group that the user is a member of.
`owner_name`	Specifies the owner name of the user group that the user is a member of.
`locked`	Specifies whether a user is locked or not. The possible values are: no - The user is unlocked. auto (blank) - The user is permanently locked due to exceeding the max_failed_login_attempts when the value of lockout_period is 0. auto (timestamp) - The user is temporarily locked until the time specified due to exceeding the max_failed_login_attempts when the value of lockout_period is in the range 1 - 10080. manual - The user is permanently locked due to the security administrator using the `chuser -lock id` command.
`locked_until`	Specifies a timestamp that displays the time in the format YYMMDDHHMMSS when the user account automatically unlocks.
`password_expiry_time`	Specifies a timestamp that displays the time in the format YYMMDDHHMMSS when the user's password expires.
`password_change_required`	Specifies whether a user's password is expired. The value is either yes or no. The value is set to yes when the password expires or if the `chuser -forcepasswordchange` command is used.

A concise invocation example

lsuser

The resulting output:

id name      password ssh_key remote usergrp_id usergrp_name locked password_change_required 
0  superuser yes      no      no     0          SecurityAdmin                     no     no
1  user1     yes      no      no     6          usergrp1    auto   no
2  user2     yes      no      no     7          usergrp2    no     no
3  user3     yes      no      no     8          usergrp3    no     yes
4  user4     yes      no      yes    9          usergrp4      4        tenant4    manual no

A detailed invocation example

lsuser 1

The resulting output:

id 1
name user1
password yes
ssh_key no
remote no
usergrp_id 6
usergrp_name usergrp1

locked auto
locked_until 200601235636
password_expiry_time
password_change_required no