Itemlist - Brocade Communications Systems Brocade 8/12c Command Reference Manual

22

itemList

itemList
Lists parameter syntax information.
SYNOPSIS
item_list = element | element white item_list
element = item | item - item
item = num | slot [white]/ [white] num
slot = num
num = hex | int
int = int digit | digit
hex = 0x hex digit | hex hex digit
digit = 0|1|2|3|4|5|6|7|8|9
hex digit = digit |A|B|C|D|E|F|a|b|c|d|e|f
white = *["\\t\\f\\r ,"]
DESCRIPTION
All kernel diagnostics have at least one item list parameter to specify which ports to test. The normal
default value for this parameter is to select everything.
This is not a command; rather, it is a common parameter to many commands.
If you want to restrict the items to be tested to a smaller set, the parameter value is an item list with the
following characteristics:
•
•
•
•
Besides the syntax rules, there are also some grammatical restrictions on the slot numbers:
•
•
•
•
In the case of conflicting settings within a single item list, an error is generated, as described earlier. In
the case of multiple item list parameters, the last one on the command line overrides previous settings.
The exact type of list varies, depending on the test and the parameter; however, the most common are
blade ports and user ports. A list of blade ports is most commonly used by ASIC-level tests such as
turboRamTest and represents which ports on the current blade (specified with --slot number) are
tested. A list of user ports is used by higher-level tests to specify which user-accessible external ports
472
It is a comma-separated list of items.
Each item in the list can be a single element or a range of elements separated by a dash character
or a combination of both. For example,"0,3,4-6,1","0,1,3,4,5,6", and"0 3 4 - 6 1" each select items 0,
1, 3, 4, 5, 6, and 7.
Spaces and tab stops are skipped.
Each item might be proceeded by an optional slot number followed by a slash ("/").
Once specified, a slot selection applies to all items to the right of the slot selections until the next slot
selection or the end of the item list. For example,"1/0 - 15" and"1/0 - 1/15" are equivalent.
If no slot number is specified, user port lists are specified by area number. For instance,"0, 16, 32"
and"1/0, 2/0, 3/0" specify the same ports on a 16-port/blade system. On that same system,"1/0, 16,
32" is not a valid list: even though it is legal syntax, the ports do not exist.
If no slot number is specified, all lists except user port lists use the default slot 0.
No list type except for user port lists may specify multiple conflicting slot numbers. For instance,"1/0,
2/0, 3/0" is a valid user port list but is not valid for any other type of list.
Fabric OS Command Reference
53-1001764-01