Skip to main content
Pure1 Support Portal

pureport

Name

pureport, pureport-list — manages an array's host connection ports

Synopsis

pureport list [ --csv | --nvp ] [--filter FILTER] [--initiator] [--limit LIMIT] [--notitle] [--page] [--raw] [--sort SORT]

Options

-h | --help

Can be used with any command or subcommand to display a brief syntax description.

--initiator

Displays host worldwide names (WWNs) and iSCSI qualified names (IQNs) - both those discovered by Purity and those manually assigned by system administrators - along with the array ports (targets) on which they are eligible to communicate.

Options that control display format:

--csv

Lists information in comma-separated value (CSV) format. The --csv output can be used for scripting purposes and imported into spreadsheet programs.

--notitle

Lists information without column titles.

--nvp

Lists information in name-value pair (NVP) format, in the form ITEMNAME=VALUE. Argument names and information items are displayed flush left. The --nvp output is designed both for convenient viewing of what might otherwise be wide listings, and for parsing individual items for scripting purposes.

--page

Turns on interactive paging.

--raw

Displays the unformatted version of column titles and data. For example, in the purearray monitor output, the unformatted version of column title us/op (read) is usec_per_read_op. The --raw output is used to sort and filter list results.

Options that manage display results:

--filter

Displays only the rows that meet the filter criteria specified.

--limit

Limits the size of the list output to the specified maxmimum number of rows.

--sort

Sorts the list output in ascending or descending order by the column specified.

Description

The pureport list command displays the Fibre Channel worldwide names (WWNs) and iSCSI qualified names (IQNs) assigned to an array's target ports. If the array port has failed over, the Failover column displays the name of the port to which this port has failed over. Include the --initiator option to display all host WWNs and IQNs known to the array, either through discovery or manually assigned, and the array ports on which they are eligible to communicate. WWNs and IQNs are manually assigned through the purehost command.

The pureport list output does not include information about network interfaces. For information about network interfaces, refer to purenetwork(1).

Examples

Example 1

pureport list --initiator --notitle
      

Displays initiator WWNs and IQNs known to the array, both discovered and manually assigned by system administrators. If an array port has failed over, also displays the name of the port to which the port has failed over. The output excludes column titles.

Author

Pure Storage Inc.