lsportusb

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

Syntax

Read syntax diagramSkip visual syntax diagram lsportusb usb_port_id

Parameters

-delim delimiter
(Optional) Specify a delimiter to separate data in the output.
-nohdr
(Optional) Suppress the headings in the output.
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.
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.