=head1 NAME B =head1 SYNOPSYS ibdmchk has two operation modes: design and verification. DESIGN: ibdmchk [-v][-h][-u][-r ] -t -n -p [-e] [-l ] VERIFICATION: ibdmchk [-v][-h][-r ] [-s ] [-f ] [-m [-l ] [-u] [-M] [-a] [-c ] [-d ] =head1 DESIGN MODE DESCRIPTION The Design mode is intended to be used before the cluster is built. It provides basic checks of the specified network as described by a topology file. After simulating the SM LID assignment and routing algorithms it provides reports of the (H)CA to (H)CA paths depth histogram and credit deadlock potential in the resulting routing scheme. =head1 ARGUMENTS: =item -t|--topo The B specifying the network. See man B =item -n|--node The name of the Subnet Manager node (syntax: /U1) =item -p|--port The port number by which the SM nodes is attached to the fabric. =head1 OPTIONS =item -v|--verbose Verbsoe mode =item -h|--help Provides this help message =item -l|--lmc LMC value > 0 means assigning 2^lmc lids to each port. =item -e|--enh Use enhanced routing algorithm when LMC > 0 and report the resulting paths correlation (using same system/node) histogram =item -r|--roots A file with all the roots node names (one on each line). =head1 VERIFICATION MODE DESCRIPTION After the cluster is built and OpenSM is run (using flag -D 0x43) it reports the subnet and FDB tables into the files osm-subnet.lst, osm.fdbs and osm.fdbs in /var/log/ (or subnet.lst, osm.fdbs and osm.mcfdbs into /tmp in older OpenSM versions). ibdiagnet is also producing the same files in its output directory. Based on these files the utility checks all CA to CA connectivity. Further analysis for credit deadlock potential is performed and reported. In case of an LMC > 0 it reports histograms for how many systems and nodes are common between the different paths for the same port pairs. =head1 ARGUMENTS =item -l|--lmc The LMC value used while running OpenSM. Mandatory if not the default 0. =head1 OPTIONS =item -v|--verbose Verbsoe mode =item -h|--help Provides this help message =item -s|--subnet OpenSM subnet.lst file (default is /var/log/osm-subnet.lst or /tmp/subnet.lst) =item -f|--fdb OpenSM dump of Ucast LFDB. Use -D 0x41 to generate it (default is /var/log/osm.fdbs or /tmp/osm.fdbs). =item -m|--mcfdb OpenSM dump of Multicast LFDB. Use -D 0x41 to generate it (default is /var/log/osm.mcfdbs or /tmp/osm.mcfdbs). =item -c|--psl Source Guid to DLID -> Path SL mapping. Each line holds: src_node_guid dlid sl. Used by the credit loop check to accuartly model SL/VL based routing. =item -d|--slvl SL2VL mapping of all switces. Each line holds: swguid iport oport 0x(sl0)(sl1) 0x(sl2)(sl3)... Used by the credit loop check to accuartly model SL/VL based routing. =item -r|--roots A file holding all root nodes guids (one per line). =item -u|--updn Use Up/Down based credit loop check algorithm instead of the generic one. =item -M|--MFT Include multicast routing in credit loops analysis. =item -a|--all Verify not only CA-CA paths but also SW-SW, CA-SW and SW-CA. Both check for FDB path connectivity and also for credit loops. =head1 AUTHOR Eitan Zahavi, Mellanox Technologies LTD, eitan@mellanox.co.il