User guide

G–Commands and Files
Summary and Descriptions of Commands
IB0054606-02 A G-27
In most cases of failure, the script suggests recommended actions. Also refer to
the ipath_checkout man page.
ipath_control
The ipath_control tool is a shell script that manipulates various parameters
for the InfiniPath driver. It is installed from the infinipath RPM. Many of the
parameters are used only when diagnosing problems, and may require special
system configurations. Using these options may require restarting the driver or
utility programs to recover from incorrect parameters.
Most of the functionality is accessed via the /sys filesystem. This shell script
gathers the same information contained in these files:
/sys/class/infiniband/qib0/device/boardversion
/sys/class/infiniband/qib0/ports/1/linkcontrol/status_str
/sys/class/infiniband/qib0/device/driver/version
These files are also documented in Table G-4 and Table G-5.
Other than the -i option, this script must be run with root permissions. See the
man pages for ipath_control for more details.
-k, --keep This option keeps intermediate files that were created while
performing tests and compiling reports. Results are saved in
a directory created by mktemp and named
infinipath_XXXXXX or in the directory name given to
--workdir.
--workdir=DIR Use DIR to hold intermediate files created while running
tests. DIR must not already exist.
--run=LIST This option runs only the tests in LIST. See the seven tests
listed previously. For example, --run=123 will run only
tests 1, 2, and 3.
--skip=LIST This option skips the tests in LIST. See the seven tests listed
previously. For example, --skip=2457 will skip tests 2, 4,
5, and 7.
-d, --debug This option turns on the -x and -v flags in bash(1).
Table G-2. ipath_checkout Options (Continued)
Command Meaning