lsportusb

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

Syntax

lsportusb [ usb_port_id ]

Parameters

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.

Table 1 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 is the `usb_port_id` shown in the syntax above. 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.
encryption_state	Indicates the encryption status of the USB device 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 has not yet run to confirm the absence. `prepared` indicates that encryption keys are prepared as part of a rekey operation. `validated_prepared` indicates that encryption keys have been 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 has not started 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