OS Manuals

/usr/bin/ibroute

userspace components for the Linux Kernel's drivers/infiniband subsystem

From rdma-core 66.0-r0 (os), captured 2026-11-10 by running ibroute --help (exit 2). permalink

Usage: /usr/bin/ibroute [options] [<dest dr_path|lid|guid> [<startlid> [<endlid>]]]

Options:
  --all, -a               show all lids, even invalid entries
  --no_dests, -n          do not try to resolve destinations
  --Multicast, -M         show multicast forwarding tables
  --node-name-map <file>  node name map file
  --config, -z <config>   use config file, default: /etc/infiniband-diags/ibdiag.conf
  --Ca, -C <ca>           Ca name to use
  --Port, -P <port>       Ca port number to use
  --Direct, -D            use Direct address argument
  --Lid, -L               use LID address argument
  --Guid, -G              use GUID address argument
  --timeout, -t <ms>      timeout in ms
  --sm_port, -s <lid>     SM port lid
  --m_key, -y <key>       M_Key to use in request
  --pkey-idx, -Y <idx>    P_Key table index for outgoing SA/GMP MADs
                          (default 0)
  --errors, -e            show send and receive errors
  --verbose, -v           increase verbosity level
  --debug, -d             raise debug level
  --help, -h              help message
  --version, -V           show version

Examples:
  /usr/bin/ibroute  -- Unicast examples:
  /usr/bin/ibroute 4	# dump all lids with valid out ports of switch with lid 4
  /usr/bin/ibroute -a 4	# same, but dump all lids, even with invalid out ports
  /usr/bin/ibroute -n 4	# simple dump format - no destination resolving
  /usr/bin/ibroute 4 10	# dump lids starting from 10
  /usr/bin/ibroute 4 0x10 0x20	# dump lid range
  /usr/bin/ibroute -G 0x08f1040023	# resolve switch by GUID
  /usr/bin/ibroute -D 0,1	# resolve switch by direct path
  /usr/bin/ibroute  -- Multicast examples:
  /usr/bin/ibroute -M 4	# dump all non empty mlids of switch with lid 4
  /usr/bin/ibroute -M 4 0xc010 0xc020	# same, but with range
  /usr/bin/ibroute -M -n 4	# simple dump format
Options (19)
OptionDescriptionSource
--all, -ashow all lids, even invalid entrieshelp
--no_dests, -ndo not try to resolve destinationshelp
--Multicast, -Mshow multicast forwarding tableshelp
--node-name-map filenode name map filehelp
--config, -z configuse config file, default: /etc/infiniband-diags/ibdiag.confhelp
--Ca, -C caCa name to usehelp
--Port, -P portCa port number to usehelp
--Direct, -Duse Direct address argumenthelp
--Lid, -Luse LID address argumenthelp
--Guid, -Guse GUID address argumenthelp
--timeout, -t mstimeout in mshelp
--sm_port, -s lidSM port lidhelp
--m_key, -y keyM_Key to use in requesthelp
--pkey-idx, -Y idxP_Key table index for outgoing SA/GMP MADs (default 0)help
--errors, -eshow send and receive errorshelp
--verbose, -vincrease verbosity levelhelp
--debug, -draise debug levelhelp
--help, -hhelp messagehelp
--version, -Vshow versionhelp

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.