lsportusb

Use the lsportusb command to display information about Universal Serial Bus (USB) ports.

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. The -delim parameter overrides this behavior. Valid input for the -delim parameter is a 1-byte character. 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.
usb_port_id: (Optional) Specifies the USB port ID. Used when detailed information about a USB port is required.

Description

This command displays information about Universal Serial Bus (USB) ports.

This table provides the attribute values that can be displayed as output view data.

Table 1. lsportusb output
Attribute	Possible Values
id	Indicates the unique ID of the USB port in the system. This ID is the `usb_port_id`. The value is a numeric `0` or greater.
node_id	Indicates the ID of the node where the USB port is. The value is a numeric string.
node_name	Indicates the name of the node where the USB port is. The value is an alphanumeric string.
node_side	Indicates the side of the node where the USB port is. The values are `front` and `rear`.
port_id	Indicates the ID of the USB port on the node side. The value is a numeric `1` or greater.
status	Indicates the status of the USB port. The values are: `active`, which indicates that a USB flash drive is plugged in and can be used by the system. `inactive`, which indicates that no USB flash drive is detected. `unsupported`, which indicates that a USB device is plugged in but cannot be used. `disabled`, which indicates that USB ports are disabled on this node.
encryption_state	Indicates the encryption status of the USB device that is attached to the port. The values are: Blank indicates that it is not in use for encryption `validated` indicates that encryption keys are present and validated `missing` indicates that encryption keys were validated and were then removed, and the DMP must run to confirm the absence. `prepared` indicates that encryption keys are prepared as part of a rekey operation. `validated_prepared` indicates that encryption keys are validated and prepared as part of a rekey operation. `wrong_system` indicates that encryption keys are detected on the USB device but none valid for the system. `old` indicates that the USB device contains encryption keys that were generated for this system - but they are not the current keys. `error` indicates that an encryption key is detected and something might be wrong with it.
encryption_filename	Indicates the name of the file in the rot directory of the USB device to which the encryption state relates. The file name can contain up to 110 characters.
service_state	Indicates the USB command status. The values are: Blank indicates that no command is active. `running` indicates that satask.txt is processing, and default USB processing is ongoing. `complete` indicates that satask.txt is processing and default USB processing is complete. `install_image` indicates that satask.txt processing cannot start because there is an installation image on the USB flash drive.

A concise invocation example

lsportusb

The resulting output:

id:node_id:node_name:node_side:port_id:status:encryption_state:encryption_filename:service_state
0:1:node1:rear:1:inactive::
1:1:node1:rear:2:active:validated:complete::
2:2:node2:rear:1:active::complete::
3:2:node2:rear:2:active:wrong_system:complete::

A detailed invocation example

lsportusb 3

The resulting output:

id 3
node_id 2
node_name node2
node_side rear
port_id 2
status active
encryption_state wrong_system
encryption_filename encryption_key_filename_BadSystem

service_state complete