chunk_payload_data.go 6.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202
  1. package sctp
  2. import (
  3. "encoding/binary"
  4. "errors"
  5. "fmt"
  6. "time"
  7. )
  8. /*
  9. chunkPayloadData represents an SCTP Chunk of type DATA
  10. 0 1 2 3
  11. 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
  12. +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  13. | Type = 0 | Reserved|U|B|E| Length |
  14. +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  15. | TSN |
  16. +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  17. | Stream Identifier S | Stream Sequence Number n |
  18. +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  19. | Payload Protocol Identifier |
  20. +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  21. | |
  22. | User Data (seq n of Stream S) |
  23. | |
  24. +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  25. An unfragmented user message shall have both the B and E bits set to
  26. '1'. Setting both B and E bits to '0' indicates a middle fragment of
  27. a multi-fragment user message, as summarized in the following table:
  28. B E Description
  29. ============================================================
  30. | 1 0 | First piece of a fragmented user message |
  31. +----------------------------------------------------------+
  32. | 0 0 | Middle piece of a fragmented user message |
  33. +----------------------------------------------------------+
  34. | 0 1 | Last piece of a fragmented user message |
  35. +----------------------------------------------------------+
  36. | 1 1 | Unfragmented message |
  37. ============================================================
  38. | Table 1: Fragment Description Flags |
  39. ============================================================
  40. */
  41. type chunkPayloadData struct {
  42. chunkHeader
  43. unordered bool
  44. beginningFragment bool
  45. endingFragment bool
  46. immediateSack bool
  47. tsn uint32
  48. streamIdentifier uint16
  49. streamSequenceNumber uint16
  50. payloadType PayloadProtocolIdentifier
  51. userData []byte
  52. // Whether this data chunk was acknowledged (received by peer)
  53. acked bool
  54. missIndicator uint32
  55. // Partial-reliability parameters used only by sender
  56. since time.Time
  57. nSent uint32 // number of transmission made for this chunk
  58. _abandoned bool
  59. _allInflight bool // valid only with the first fragment
  60. // Retransmission flag set when T1-RTX timeout occurred and this
  61. // chunk is still in the inflight queue
  62. retransmit bool
  63. head *chunkPayloadData // link to the head of the fragment
  64. }
  65. const (
  66. payloadDataEndingFragmentBitmask = 1
  67. payloadDataBeginingFragmentBitmask = 2
  68. payloadDataUnorderedBitmask = 4
  69. payloadDataImmediateSACK = 8
  70. payloadDataHeaderSize = 12
  71. )
  72. // PayloadProtocolIdentifier is an enum for DataChannel payload types
  73. type PayloadProtocolIdentifier uint32
  74. // PayloadProtocolIdentifier enums
  75. // https://www.iana.org/assignments/sctp-parameters/sctp-parameters.xhtml#sctp-parameters-25
  76. const (
  77. PayloadTypeUnknown PayloadProtocolIdentifier = 0
  78. PayloadTypeWebRTCDCEP PayloadProtocolIdentifier = 50
  79. PayloadTypeWebRTCString PayloadProtocolIdentifier = 51
  80. PayloadTypeWebRTCBinary PayloadProtocolIdentifier = 53
  81. PayloadTypeWebRTCStringEmpty PayloadProtocolIdentifier = 56
  82. PayloadTypeWebRTCBinaryEmpty PayloadProtocolIdentifier = 57
  83. )
  84. var errChunkPayloadSmall = errors.New("packet is smaller than the header size")
  85. func (p PayloadProtocolIdentifier) String() string {
  86. switch p {
  87. case PayloadTypeWebRTCDCEP:
  88. return "WebRTC DCEP"
  89. case PayloadTypeWebRTCString:
  90. return "WebRTC String"
  91. case PayloadTypeWebRTCBinary:
  92. return "WebRTC Binary"
  93. case PayloadTypeWebRTCStringEmpty:
  94. return "WebRTC String (Empty)"
  95. case PayloadTypeWebRTCBinaryEmpty:
  96. return "WebRTC Binary (Empty)"
  97. default:
  98. return fmt.Sprintf("Unknown Payload Protocol Identifier: %d", p)
  99. }
  100. }
  101. func (p *chunkPayloadData) unmarshal(raw []byte) error {
  102. if err := p.chunkHeader.unmarshal(raw); err != nil {
  103. return err
  104. }
  105. p.immediateSack = p.flags&payloadDataImmediateSACK != 0
  106. p.unordered = p.flags&payloadDataUnorderedBitmask != 0
  107. p.beginningFragment = p.flags&payloadDataBeginingFragmentBitmask != 0
  108. p.endingFragment = p.flags&payloadDataEndingFragmentBitmask != 0
  109. if len(raw) < payloadDataHeaderSize {
  110. return errChunkPayloadSmall
  111. }
  112. p.tsn = binary.BigEndian.Uint32(p.raw[0:])
  113. p.streamIdentifier = binary.BigEndian.Uint16(p.raw[4:])
  114. p.streamSequenceNumber = binary.BigEndian.Uint16(p.raw[6:])
  115. p.payloadType = PayloadProtocolIdentifier(binary.BigEndian.Uint32(p.raw[8:]))
  116. p.userData = p.raw[payloadDataHeaderSize:]
  117. return nil
  118. }
  119. func (p *chunkPayloadData) marshal() ([]byte, error) {
  120. payRaw := make([]byte, payloadDataHeaderSize+len(p.userData))
  121. binary.BigEndian.PutUint32(payRaw[0:], p.tsn)
  122. binary.BigEndian.PutUint16(payRaw[4:], p.streamIdentifier)
  123. binary.BigEndian.PutUint16(payRaw[6:], p.streamSequenceNumber)
  124. binary.BigEndian.PutUint32(payRaw[8:], uint32(p.payloadType))
  125. copy(payRaw[payloadDataHeaderSize:], p.userData)
  126. flags := uint8(0)
  127. if p.endingFragment {
  128. flags = 1
  129. }
  130. if p.beginningFragment {
  131. flags |= 1 << 1
  132. }
  133. if p.unordered {
  134. flags |= 1 << 2
  135. }
  136. if p.immediateSack {
  137. flags |= 1 << 3
  138. }
  139. p.chunkHeader.flags = flags
  140. p.chunkHeader.typ = ctPayloadData
  141. p.chunkHeader.raw = payRaw
  142. return p.chunkHeader.marshal()
  143. }
  144. func (p *chunkPayloadData) check() (abort bool, err error) {
  145. return false, nil
  146. }
  147. // String makes chunkPayloadData printable
  148. func (p *chunkPayloadData) String() string {
  149. return fmt.Sprintf("%s\n%d", p.chunkHeader, p.tsn)
  150. }
  151. func (p *chunkPayloadData) abandoned() bool {
  152. if p.head != nil {
  153. return p.head._abandoned && p.head._allInflight
  154. }
  155. return p._abandoned && p._allInflight
  156. }
  157. func (p *chunkPayloadData) setAbandoned(abandoned bool) {
  158. if p.head != nil {
  159. p.head._abandoned = abandoned
  160. return
  161. }
  162. p._abandoned = abandoned
  163. }
  164. func (p *chunkPayloadData) setAllInflight() {
  165. if p.endingFragment {
  166. if p.head != nil {
  167. p.head._allInflight = true
  168. } else {
  169. p._allInflight = true
  170. }
  171. }
  172. }