lsportusb

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

Syntax

lsportusb [ -nohdr ] [ -delimdelimiter ] [ usb_port_id ]

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.
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: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

service_state complete