wire / wire-format / infiniband-bth

InfiniBand Base Transport Header (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).

wire-format kind wire-format status standard verification verified tier B wire-format@1

aka: InfiniBand Base Transport Header (BTH)

wire format

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).

fieldsizemeaning
Opcode1 byteOperation 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 bit1 = generate a solicited completion event.
Migration Request (M)1 bit1 = migration request.
Pad Count2 bitsNumber of pad bytes in the payload (0-3).
Transport Header Version4 bitsAlways 0.
Partition Key (P_Key)2 bytesPartition key (subnet isolation).
Reserved1 byteReserved.
Destination QP3 bytesDestination Queue Pair number.
ACK Request1 bit1 = request an ACK.
Reserved7 bitsReserved.
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


provenance

agent: curl -H 'accept: application/json' wire.phall.io/wire-format/infiniband-bth or /wire-format/infiniband-bth.json