contrib/ofed/management/infiniband-diags/man/ibdiscover.8

   1 .TH IBDISCOVER.PL 8 "September 21, 2006" "OpenIB" "OpenIB Diagnostics"
   2
   3 .SH NAME
   4 ibdiscover.pl \- annotate and compare InfiniBand topology
   5
   6 .SH SYNOPSIS
   7 .B ibdiscover.pl
   8
   9 .SH DESCRIPTION
  10 .PP
  11 ibdiscover.pl uses a topology file create by ibnetdiscover and a discover.map
  12 file which the network administrator creates which indicates the nodes
  13 to be expected and a ibdiscover.topo file which is the expected connectivity
  14 and produces a new connectivity file (discover.topo.new) and outputs
  15 the changes to stdout. The network administrator can choose to replace
  16 the "old" topo file with the new one or certain changes in.
  17
  18 The syntax of the ibdiscover.map file is:
  19
  20 <nodeGUID>|port|"Text for node"|<NodeDescription from ibnetdiscover format>
  21
  22 e.g.
  23
  24 8f10400410015|8|"ISR 6000"|# SW-6IB4 Voltaire port 0 lid 5
  25
  26 8f10403960558|2|"HCA 1"|# MT23108 InfiniHost Mellanox Technologies
  27
  28 The syntax of the old and new topo files (ibdiscover.topo and
  29 ibdiscover.topo.new) are:
  30
  31 <LocalPort>|<LocalNodeGUID>|<RemotePort>|<RemoteNodeGUID>
  32
  33 e.g.
  34
  35 10|5442ba00003080|1|8f10400410015
  36
  37 These topo files are produced by the ibdiscover.pl tool.
  38
  39 .SH USAGE
  40
  41 .PP
  42 ibnetdiscover | ibdiscover.pl
  43
  44 .SH SEE ALSO
  45 .BR ibnetdiscover(8)
  46
  47 .SH AUTHOR
  48 .TP
  49 Hal Rosenstock
  50 .RI < halr@voltaire.com >