contrib/ofed/management/opensm/doc/partition-config.txt

   1 OpenSM Partition configuration
   2 ===============================
   3
   4 The default name of OpenSM partitions configuration file is
   5 '/etc/opensm/partitions.conf'. The default may be changed by
   6 using --Pconfig (-P) option with OpenSM.
   7
   8 The default partition will be created by OpenSM unconditionally even
   9 when partition configuration file does not exist or cannot be accessed.
  10
  11 The default partition has P_Key value 0x7fff. OpenSM's port will have
  12 full membership in default partition. All other end ports will have
  13 partial membership.
  14
  15
  16 File Format
  17 ===========
  18
  19 Comments:
  20 --------
  21
  22 Line content followed after '#' character is comment and ignored by
  23 parser.
  24
  25
  26 General file format:
  27 -------------------
  28
  29 <Partition Definition>:<PortGUIDs list> ;
  30
  31
  32 Partition Definition:
  33 --------------------
  34
  35 [PartitionName][=PKey][,flag[=value]]
  36
  37 PartitionName - string, to be used with logging. When omitted
  38                 empty string will be used.
  39 PKey          - P_Key value for this partition. Only low 15 bits will
  40                 be used. When omitted will be autogenerated.
  41 flag          - used to indicate IPoIB capability of this partition.
  42
  43 Currently recognized flags are:
  44
  45 ipoib       - indicates that this partition may be used for IPoIB, as
  46               result IPoIB capable MC group will be created.
  47 rate=<val>  - specifies rate for this IPoIB MC group (default is 3 (10GBps))
  48 mtu=<val>   - specifies MTU for this IPoIB MC group (default is 4 (2048))
  49 sl=<val>    - specifies SL for this IPoIB MC group (default is 0)
  50 scope=<val> - specifies scope for this IPoIB MC group (default is 2 (link
  51 local))
  52
  53 Note that values for 'rate', 'mtu'. and 'scope' should be specified as defined
  54 in the IBTA specification (for example mtu=4 for 2048).
  55
  56
  57 PortGUIDs list:
  58 --------------
  59
  60 [PortGUID[=full|=limited]] [,PortGUID[=full|=limited]] [,PortGUID] ...
  61
  62 PortGUID     - GUID of partition member EndPort. Hexadecimal numbers
  63                should start from 0x, decimal numbers are accepted too.
  64 full or      - indicates full or limited membership for this port. When
  65   limited      omitted (or unrecognized) limited membership is assumed.
  66
  67 There are two useful keywords for PortGUID definition:
  68
  69 - 'ALL' means all end ports in this subnet.
  70 - 'SELF' means subnet manager's port.
  71
  72 Empty list means no ports in this partition.
  73
  74
  75 Notes:
  76 -----
  77
  78 White spaces are permitted between delimiters ('=', ',',':',';').
  79
  80 The Line can be wrapped after ':' followed after Partition Definition and
  81 between.
  82
  83 PartitionName does not need to be unique, PKey does need to be unique.
  84 If PKey is repeated then those partition configurations will be merged
  85 and first PartitionName will be used (see also next note).
  86
  87 It is possible to split partition configuration in more than one
  88 definition, but then PKey should be explicitly specified (otherwise
  89 different PKey values will be generated for those definitions).
  90
  91
  92 Examples:
  93 --------
  94
  95 Default=0x7fff : ALL, SELF=full ;
  96
  97 NewPartition , ipoib : 0x123456=full, 0x3456789034=limi, 0x2134af2306 ;
  98
  99 YetAnotherOne = 0x300 : SELF=full ;
 100 YetAnotherOne = 0x300 : ALL=limited ;
 101
 102
 103 Note:
 104 ----
 105
 106 The following rule is equivalent to how OpenSM used to run prior to the
 107 partition manager:
 108
 109 Default=0x7fff,ipoib:ALL=full;
 110