A chip is an InfiniBand switch chip or InfiniBand channel adapter chip. It may be specified in the following ways:

node GUID.

given name from the GUID name definitions.

the notation switch/slot:index, where switch is a switch name, as described above, slot is a slot number (decimal integer) in a switch, and index is a decimal number. FACT orders chips in a slot by the node GUID. FACT numbers chips from 1 to n, ordered by their node GUIDs, going in ascending order from lowest to highest.

port

A port may be specified as a port GUID, relative to a chassis or relative to a chip. As a port GUID, it is specified in eight hexadecimal octets separated by colons, as shown in the following example:

00:02:c9:02:00:22:2a:c8

Note: Most switch chips do not have port GUIDs.

Chassis-relative form has the 'syntax switch/slot/ext-number, where ext-number is the external port number. Switch has any of the previously listed forms, as shown in the following example:

switch01/2/3

(port 3 on slot 2 of chassis switch01)

Note: Internal chips can be specified in chip-relative syntax only.

Chip-relative form has the syntax chip/internal-number, where chip is an InfiniBand chip as previously listed, and internal number is the port number on the chip, as shown in the following examples:

switch01/2:3/4

(chip port 4 on chip 3 of the card in slot 2 of chassis switch01)

00:02:c9:02:00:22:2a:c4/4

(chip port 4 on the chip with the given GUID)

LID

A LID is a decimal integer.

MLID

A multicast LID is a decimal integer.

Using Plural Arguments

Many of the commands in FACT can accept plural arguments. The plurals can be built in several ways. Several alternatives can be separated by commas, with no spaces, as shown in the following example:

switch01,switch02

Each alternative may contain one or more ranges. A range is surrounded by square brackets and contains one or more comma-separated alternatives. Each alternative may be a single value or a hyphen-separated range of values, as shown in the following example:

rack[A-C,E]-host[01-10]

(rackA-host01 through rackA-host10, and similarly for racks B, C, and E, skipping rackD)

Scans, LIDs, and slot, chip, and port numbers are always numeric, so ranges may be specified without the square brackets, as shown in the following example:

switch03/1/1-4

(ports 1 through 4 on slot 1 of chassis switch03)

A plural scan always describes a single object in a simple form (by not using any alternatives or images), as shown in the following example:

switch03

FACT uses the following plural arguments:

LIDs

chassis

chips

hosts

managed-nodes

multicast-groups

ports

scans

switches

Note: Because all keywords can be abbreviated to a unique prefix, plural keywords such as chips and ports can be abbreviated to chip and port for the most common case of referring to a single unit. They keyword chassis can be either singular or plural.

Using Command Modes

FACT has two modes of operation:

Interactive command-line processor mode

Single-use command mode that performs a single function

Using Interactive Mode

As a command-line program, FACT reads commands from its input, parses them, and writes their output to its output. The following sample output shows FACT interactive mode:

Initiates sequential scan sessions to one managed node at a time. This option is helpful with the --trace command because output displays slower and more predictably. By default, FACT connects up to 50 managed nodes at a time during scans and installations. If sequential is specified, then FACT connects to one managed node at a time.

By default, if --trace is not specified, then FACT will print the transcript of each session when that session is closed. If --trace is specified, FACT will print the transcript of each session as it occurs.

Correcting Commands

Note: This feature will be functional at FCS.

The system response to command line-errors is different when you use the question mark (?) to obtain help for a command. In this case, the system repeats your input following the subsequent prompt for ease of editing, as shown in the following example:

Editing the CLI

Command-line editing lets you modify a command line command that you have just entered or a command line that you entered previously in the CLI session. The CLI supports a variety of ways to move about and edit the currently displayed command line. Table 4 lists and describes these options.

Table 4: Key Stroke Shortcuts

Key Strokes

Description

Ctrl-A

Moves the cursor to the beginning of the line.

Ctrl-B

Moves the cursor to the left (backward) one character.

Ctrl-D

Deletes the current character. Exits FACT if the current input line is empty.

Ctrl-E

Moves the cursor to the end of the line.

Ctrl-F

Moves the cursor to the right (forward) one character.

Ctrl-G

Erases the current input line.

Ctrl-H

Deletes the character to the left of the cursor, analogous to the Backspace key.

Ctrl-I

Completes the current word, analogous to the Tab key.

Ctrl-J

Accepts the current line.

Ctrl-K

Deletes text from the cursor to the end of the line.

Ctrl-L

Refreshes the input line.

Ctrl-M

Accepts the current line, analogous to the Return key.

Ctrl-N

Proceeds to the next line in the command history.

Ctrl-P

Moves to the previous line in the command history.

Ctrl-T

Transposes the current and previous characters.

Ctrl-U

Deletes all text to the left of the cursor, back to the beginning of the line.

Ctrl-W

Deletes the word to the left of the cursor.

Ctrl-Z

Suspends the FACT.

Ctrl-Del

Deletes the chatacter to the left of the cursor, analogous to the Delete key.

?

Completes the current word.

Esc-[A

Moves to the previous line in the command history.

Esc-[B

Proceeds to the next line in the command history.

Esc-[C

Moves the cursor to the right (forward) one character.

Esc-[D

Moves the cursor to the left (backward) on character.

Esc-B

Moves the cursor to the left (backward) one word.

Esc-C

Capitalizes the word to the right of the cursor (forward).

Esc-D

Deletes characters from the cursor through the end of the word.

Esc-F

Moves the cursor right (forward) one word.

Esc-L

Converts characters, from the cursor to the end of the word, to lowercase.

Esc-U

Converts characters, from the cursor to the end of the word, to uppercase.