wire / wire-format / infiniband-bth
The InfiniBand BTH (Base Transport Header) is a 12-byte header for reliable/ unreliable transport. Fields: opcode (1 byte), solicited event (1 bit), migration request (1 bit), pad count (2 bits), transport header version (4 bits), partition key (2 bytes), reserved (1 byte), destination QP (3 bytes), ACK request (1 bit), reserved (7 bits), PSN (3 bytes).
aka: InfiniBand Base Transport Header (BTH)
spec: InfiniBand Architecture Specification
The InfiniBand BTH (Base Transport Header) is a 12-byte header for reliable/ unreliable transport. Fields: opcode (1 byte), solicited event (1 bit), migration request (1 bit), pad count (2 bits), transport header version (4 bits), partition key (2 bytes), reserved (1 byte), destination QP (3 bytes), ACK request (1 bit), reserved (7 bits), PSN (3 bytes).
| field | size | meaning |
|---|---|---|
| Opcode | 1 byte | Operation code: 0x00 SEND, 0x01 SEND_IMM, 0x02 RDMA_WRITE, 0x03 RDMA_WRITE_IMM, 0x04 RDMA_READ_REQUEST, 0x05 RDMA_READ_RESPONSE, 0x06 ACK, 0x07 ATOMIC_ACK, 0x08 COMPARE_SWAP, 0x09 FETCH_ADD, ... . |
| Solicited Event (SE) | 1 bit | 1 = generate a solicited completion event. |
| Migration Request (M) | 1 bit | 1 = migration request. |
| Pad Count | 2 bits | Number of pad bytes in the payload (0-3). |
| Transport Header Version | 4 bits | Always 0. |
| Partition Key (P_Key) | 2 bytes | Partition key (subnet isolation). |
| Reserved | 1 byte | Reserved. |
| Destination QP | 3 bytes | Destination Queue Pair number. |
| ACK Request | 1 bit | 1 = request an ACK. |
| Reserved | 7 bits | Reserved. |
| Packet Sequence Number (PSN) | 3 bytes (24 bits) | Packet sequence number for reliable transport. |
example:
00 00 00 00 00 00 00 00 00 00 00 00
InfiniBand BTH: opcode 0 (SEND), PSN 0
agent: curl -H 'accept: application/json' wire.phall.io/wire-format/infiniband-bth
or /wire-format/infiniband-bth.json