IBPORTSTATE(8)                Open IB Diagnostics               IBPORTSTATE(8)

<?><?><?> (NAME)
       ibportstate - <?><?><?><?><?><?> <?><?><?><?><?> (<?><?><?><?><?><?>)
       <?><?><?><?><?> <?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
       InfiniBand

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       ibportstate [options] <dest dr_path|lid|guid> <portnum> [<op>]

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?> ibportstate <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?> IB <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> (<?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?>)<?> <?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?>. <?><?><?><?><?> <?><?><?><?><?>
       InfiniBand HCA <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> (Subnet Manager) <?><?><?><?><?> <?><?><?><?>.
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?>/<?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?> <?><?> <?><?><?><?><?> IB <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?>.

<?><?><?><?><?><?><?><?> (OPTIONS)

       <op>

              <?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?>: enable, disable, reset,
              speed, espeed, fdr10, width, query,
                     on, off, down, arm, active, vls, mtu, lid, smlid, lmc,
                     mkey, mkeylease, mkeyprot (<?><?><?><?><?><?><?> query
                     <?><?><?>)

              <?><?><?><?><?><?><?> enable, disable, and reset <?><?><?><?><?>
              <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> HCA <?><?>
              <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> (<?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> CA <?><?><?><?>
              <?><?><?> CA <?> <?><?><?><?><?> Port <?><?> <?><?><?><?>
              <?><?><?><?>.)

              <?><?><?><?><?> off <?><?><?><?><?> <?><?><?><?><?> <?><?>
              <?><?> disable <?><?><?><?><?> <?><?><?><?><?><?>.

              <?><?><?><?><?> on <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?>
              enable <?><?><?><?><?> <?><?><?><?><?><?> (<?><?><?><?>
              <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> disable
              <?><?><?><?>).

              <?><?><?><?><?><?><?> speed and width <?><?><?> <?><?>
              <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>

              <?><?><?><?><?><?> speed <?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?> PortInfo:LinkSpeedEnabled <?><?><?><?><?>
              (<?><?><?> PortInfo:LinkSpeedSupported <?><?> <?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>)

              <?><?><?><?><?> espeed <?><?><?> <?><?> <?><?><?><?><?><?>
              <?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?> <?><?><?>

              <?><?><?><?><?> fdr10 <?><?><?> <?><?> <?><?><?><?><?><?> <?><?>
              <?><?> fdr10 <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?> <?><?><?> (<?><?><?> <?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?> <?><?><?>
              PortInfo:LinkSpeedExtSupported <?><?> <?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?>)

              <?><?><?><?><?><?> width <?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?> PortInfo:LinkWidthEnabled <?><?><?><?><?>
              (<?><?><?> PortInfo:LinkWidthSupported <?><?> <?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>) (<?><?><?><?>:
              <?><?><?><?><?><?><?> <?><?><?><?> <?> <?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>)

              <?><?><?><?><?> query <?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> (<?><?><?><?><?>
              <?><?><?><?><?><?> speed <?>espeed <?> fdr10) <?><?> <?><?>
              <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?> (<?><?><?><?><?><?><?><?> <?><?><?><?><?> LID
              <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>) <?><?><?><?>
              <?><?><?> <?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?> <?><?><?>. <?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?> <?><?> <?><?><?><?><?><?> query
              <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?> LID <?><?> <?><?><?><?><?><?><?>
              <?><?><?>.

              <?><?><?><?><?><?><?> mkey, mkeylease, and mkeyprot <?><?><?><?>
              <?><?><?> CA<?><?><?> <?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?> 0 <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
              (<?><?> <?><?><?><?> <?><?><?><?> <?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>).
              <?><?><?><?><?><?><?> mkey <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?> <?> <?><?><?> <?><?> <?><?><?><?><?><?><?>
              <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> '0x' <?><?> '0'
              <?><?> <?><?><?><?> <?><?><?><?> <?><?><?>. <?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?> (<?><?><?><?><?> 'x')
              <?><?><?><?> mkey <?><?><?><?> <?><?><?><?> ibportstate
              <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?>.

   <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> (Addressing Flags)
       -L, --Lid   <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> LID <?><?><?>

       -G, --Guid     <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> Port GUID
       <?><?><?>

       -D, --Direct     <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?> (directed route) <?><?><?>

          <?><?><?><?><?><?><?>:
             [options] -D [options] "0"          # self port
             [options] -D [options] "0,1,2,1,4"  # out via port 1, then 2, ...

             (<?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
             <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>. <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> '-P' <?><?>
             <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?>.)

       -s, --sm_port <smlid>     <?><?><?><?><?><?><?> <?><?> 'smlid' <?><?>
       <?><?><?><?><?> lid <?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> SA.

   <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> (Port Selection
       flags)
       -C, --Ca <ca_name>    <?><?><?><?><?><?><?> <?><?> ca_name
       <?><?><?><?><?><?><?><?>.

       -P, --Port <ca_port>    <?><?><?><?><?><?><?> <?><?> ca_port
       <?><?><?><?><?><?><?><?>.

       -Y, --pkey-idx <idx>
              <?><?><?><?><?> <?><?><?><?> P_Key (0-65535<?>
              <?><?><?><?><?><?><?> 0) <?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?> SA/GMP MAD<?><?><?> <?><?><?><?><?>.  MAD<?><?><?>
              SMP (<?><?><?><?><?> <?><?> SMI directed-route/LID-routed)
              <?><?><?><?><?> <?><?> <?><?><?><?><?> 0 <?><?><?><?> P_Key
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>.

   <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> (Local port Selection)
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?>/<?><?><?><?><?> CA: <?><?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?> IB <?><?><?><?> <?><?><?><?>
       <?><?><?><?> (<?><?> "<?><?><?><?><?><?><?><?><?><?> <?><?><?><?> umad"
       <?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?><?>)<?>
       <?><?><?><?><?><?><?><?> libibumad <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?>:

          1. <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?>
             <?><?><?><?><?> ACTIVE <?><?><?><?>.

          2. <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?>
             <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?>
             <?><?><?><?><?> UP <?><?><?><?> (<?><?><?><?><?>
             <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>).

          <?><?><?> <?><?> <?><?><?><?><?> <?>/<?><?> <?><?><?> CA
          <?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
          libibumad <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
          <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?> <?><?>
          <?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?>
          <?><?><?><?><?> <?><?><?><?><?><?>.

          <?><?><?><?> <?><?><?><?><?>:

             ibaddr                 # use the first port (criteria #1 above)
             ibaddr -C mthca1       # pick the best port from "mthca1" only.
             ibaddr -P 2            # use the second (active/up) port from the first available IB device.
             ibaddr -C mthca0 -P 2  # use the specified port only.

   <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> (Configuration flags)
       --config, -z  <config_file> <?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>.
          <?><?><?><?><?><?><?>: /etc/infiniband-diags/ibdiag.conf

       -t, --timeout <timeout_ms> <?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> mad<?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?>.

       -y, --m_key <key>
              <?><?><?><?><?><?><?> <?><?> M_key <?><?><?><?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?><?><?><?><?><?>. <?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?> (<?><?><?><?><?> 'x')
              <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>.

   <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> (Debugging flags)
       -h, --help      <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?>

       -d     <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
              IB.  <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>
              <?><?><?><?><?><?><?> <?><?><?> (-ddd <?><?> -d -d -d).

       -e     <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?>
              <?><?><?><?><?><?> (<?><?><?><?> <?><?><?><?><?> <?>
              <?><?><?><?><?> <?><?><?><?>)

       -K, --show_keys
              <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?> (mkey
              <?>smkey <?> <?><?><?><?>) <?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?>.

       -v, --verbose
              <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?> (verbosity)
              <?><?><?><?><?><?>.  <?><?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?> <?><?><?><?><?><?><?> <?><?><?> (-vv <?><?> -v -v -v)

       -V, --version     <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>.

<?><?><?><?><?><?><?> (FILES)
   <?><?><?><?> <?><?><?><?><?><?><?><?> (CONFIG FILE)
       /etc/infiniband-diags/ibdiag.conf

       <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?>.
       <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?>.

<?><?><?><?><?><?><?> (EXAMPLES)

          ibportstate -C qib0 -P 1 3 1 disable     # by CA name, CA Port Number, lid, physical port number
          ibportstate -C qib0 -P 1 3 1 enable      # by CA name, CA Port Number, lid, physical port number
          ibportstate -D 0 1                       # (query) by direct route
          ibportstate 3 1 reset                    # by lid
          ibportstate 3 1 speed 1                  # by lid
          ibportstate 3 1 width 1                  # by lid
          ibportstate -D 0 1 lid 0x1234 arm        # by direct route

<?><?><?><?><?><?><?><?><?> (AUTHORS)

       Hal Rosenstock
              < <hal.rosenstock@gmail.com> >

                                  2013-03-26                    IBPORTSTATE(8)