Brocade Fabric OS Command Reference Guide v6.1.0 (53-1000599-02, June 2008)

318 Fabric OS Command Reference
53-1000599-02
itemList
2
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:
• 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 (“/”).
Besides the syntax rules, there are also some grammatical restrictions on the slot numbers:
• 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.
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.