lsdev Command

Purpose

Displays devices in the system and their characteristics.

Syntax

lsdev [ -C ][ -c Class ] [ -s Subclass ] [ -t Type ] [ -f File ] [ -F Format | -r ColumnName ] [ -h ] [ -H ] [ -l { Name | - } ] [ -p Parent ] [ -S State ] [ -x ]

lsdev -P [ -c Class ] [ -s Subclass ] [ -t Type ] [ -f File ] [ -F Format | -r ColumnName ] [ -h ] [ -H ] [ -x ]

Description

The lsdev command displays information about devices in the Device Configuration database. You can display information about all devices in the Customized Devices object class using the -C flag. Any combination of the -c Class, -s Subclass, -t Type, -l Name, -p Parent, and -S State flags selects a subset of the customized devices. You can display information about all devices in the Predefined Devices object class using the -P flag. Any combination of the -c Class, -s Subclass, and -t Type flags selects a subset of the predefined devices.

You can display the default output one of the following ways:

From the Customized Devices object class by using the -C flag
From the Predefined Devices object class by using the -P flag

To override these two default outputs, use the -F Format flag to display the output in a format that you specify by using the Format parameter. The Format parameter is a quoted list of column names that are separated and possibly ended by non-alphanumeric characters or white space.

The lsdev command shows information only about devices that are based upon information in the Customized Devices (Cudv) object class or the Predefined Devices (PdDv) object class. Other object classes (such as the Customized Path (CuPath) object class) are not examined. This situation means that there might be conditions where a device might not be displayed. For example, if the -p Parent flag is used, but the parent that is identified in the Customized Devices object for a device does not match the Parent that is specified through the -p flag, the device is not displayed. However, the device might have a path to thespecified Parent that is defined in the Customized Paths object class. Use the lspath command to show all MPIO-capable child devices of the specified parent.

You can also use the Devices application in Web-based System Manager, or the System Management Interface Tool (SMIT) smit lsdev fast path to change device characteristics.

Flags

Item	Description
-C	Lists information about a device that is in the Customized Devices object class. The default information that is displayed is name, status, location, and description. The -C flag is not required, but is maintained for compatibility reasons. The -C flag cannot be specified with the -P flag. If neither is specified, the lsdev command behaves as if the -C flag was specified.
-c Class	Specifies a device class name. This flag can be used to restrict output to devices in a specified class.
-f File	Reads the necessary flags from the File parameter.
-F Format	Displays the output in a user-specified format, where the Format parameter is a quoted list of column names from the Predefined or Customized Devices object class, separated and possibly ended by nonalphanumeric characters or white space. If white space is used as the separator, the lsdev command displays the output in aligned columns. If you specify the -F Format flag with the -C flag, you can specify column names from both the Customized and Predefined Devices object classes. If you specify the -F Format flag with the -P flag, you can specify only column names from the Predefined Devices object class. In addition to the column names, the special purpose name description can be used to obtain a display of device descriptions. This flag cannot be used with the -r ColumnName flag. Also, the physloc special purpose name can be used to display a physical location code of the device.
-H	Displays headers above the column output.
-h	Displays the command usage message.
-l Name	Specifies the device logical name from the Customized Devices object class of the device for which information is listed. The Name argument to the -l flag can contain the same wildcard characters that can be used with the odmget command. If the Name argument is a dash, names are read from STDIN. Names on STDIN must be separated by a comma, a tab, a space, or a "newline" character. Names cannot contain wildcard characters. This flag cannot be used with the -P flag.
-p Parent	Specifies the device logical name from the Customized Devices object class for the parent of devices to be displayed. The -p Parent flag can be used to show the child devices of the specified Parent. The Parent argument to the -p flag might contain the same wildcard characters that can be used with the odmget command. This flag cannot be used with the -P flag.
-P	Lists information about a device that is in the Predefined Devices object class. The default information that is displayed is class, type, subclass, and description. This flag cannot be used with the -C, -l, or -S flags.
-r ColumnName	Displays the set of values in a column. For example, the ColumnName parameter takes the value of the Class parameter to list all of the classes. If you specify the -r ColumnName flag with the -C flag, you can specify column names from both the Customized and Predefined Devices object classes. If you specify the -r ColumnName flag with the -P flag, you can specify only column names from the Predefined Devices object class. This flag cannot be used with the -F Format flag.
-S State	Lists all devices in a specified state as named by the State parameter. The State parameter can have one of the following values: d, D, 0 or defined for the Defined state a, A, 1, or available for the Available state s, S, 2, or stopped for the Stopped state This flag can be used to restrict output to devices in a specified state. This flag cannot be used with the -P flag.
-s Subclass	Specifies a device subclass name. This flag can be used to restrict output to devices in a specified subclass.
-t Type	Specifies a device type name. This flag can be used to restrict output to devices of a specified type.
-x	Displays the exported status for devices that are exported to a Workload Partition (WPAR).

Exit Status

This command returns the following exit values:

Item	Description
0	Successful completion.
>0	An error occurred.

Security

Attention RBAC users and Trusted AIX users: This command can perform privileged operations. Only privileged users can run privileged operations. For more information about authorizations and privileges, see Privileged Command Database in AIX® Version 7.1 Security. For a list of privileges and the authorizations associated with this command, see the lssecattr command or the getcmdattr subcommand.

Examples

To list all of the devices in the Predefined Devices object class with column headers, type the following command:

lsdev -P -H