beautypg.com

Itemlist – Dell POWEREDGE M1000E User Manual

Page 501

background image

Fabric OS Command Reference

469

53-1001764-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.