Debian Codegraph @

src/vendor/azure-uamqp-c/devdoc/session_requirements.md

raw
1 # session requirements
2
3 ## Overview
4
5 session is module that implements the session layer in the AMQP ISO.
6
7 ## Exposed API
8
9 ```C
10 typedef struct SESSION_INSTANCE_TAG* SESSION_HANDLE;
11 typedef struct LINK_ENDPOINT_INSTANCE_TAG* LINK_ENDPOINT_HANDLE;
12
13 #define SESSION_STATE_VALUES \
14 SESSION_STATE_UNMAPPED, \
15 SESSION_STATE_BEGIN_SENT, \
16 SESSION_STATE_BEGIN_RCVD, \
17 SESSION_STATE_MAPPED, \
18 SESSION_STATE_END_SENT, \
19 SESSION_STATE_END_RCVD, \
20 SESSION_STATE_DISCARDING, \
21 SESSION_STATE_ERROR
22
23 DEFINE_ENUM(SESSION_STATE, SESSION_STATE_VALUES)
24
25 #define SESSION_SEND_TRANSFER_RESULT_VALUES \
26 SESSION_SEND_TRANSFER_OK, \
27 SESSION_SEND_TRANSFER_ERROR, \
28 SESSION_SEND_TRANSFER_BUSY
29
30 DEFINE_ENUM(SESSION_SEND_TRANSFER_RESULT, SESSION_SEND_TRANSFER_RESULT_VALUES)
31
32 typedef void(*LINK_ENDPOINT_FRAME_RECEIVED_CALLBACK)(void* context, AMQP_VALUE performative, uint32_t frame_payload_size, const unsigned char* payload_bytes);
33 typedef void(*ON_SESSION_STATE_CHANGED)(void* context, SESSION_STATE new_session_state, SESSION_STATE previous_session_state);
34 typedef void(*ON_SESSION_FLOW_ON)(void* context);
35 typedef bool(*ON_LINK_ATTACHED)(void* context, LINK_ENDPOINT_HANDLE new_link_endpoint, const char* name, role role, AMQP_VALUE source, AMQP_VALUE target, fields properties);
36
37 MOCKABLE_FUNCTION(, SESSION_HANDLE, session_create, CONNECTION_HANDLE, connection, ON_LINK_ATTACHED, on_link_attached, void*, callback_context);
38 MOCKABLE_FUNCTION(, SESSION_HANDLE, session_create_from_endpoint, CONNECTION_HANDLE, connection, ENDPOINT_HANDLE, connection_endpoint, ON_LINK_ATTACHED, on_link_attached, void*, callback_context);
39 MOCKABLE_FUNCTION(, int, session_set_incoming_window, SESSION_HANDLE, session, uint32_t, incoming_window);
40 MOCKABLE_FUNCTION(, int, session_get_incoming_window, SESSION_HANDLE, session, uint32_t*, incoming_window);
41 MOCKABLE_FUNCTION(, int, session_set_outgoing_window, SESSION_HANDLE, session, uint32_t, outgoing_window);
42 MOCKABLE_FUNCTION(, int, session_get_outgoing_window, SESSION_HANDLE, session, uint32_t*, outgoing_window);
43 MOCKABLE_FUNCTION(, int, session_set_handle_max, SESSION_HANDLE, session, handle, handle_max);
44 MOCKABLE_FUNCTION(, int, session_get_handle_max, SESSION_HANDLE, session, handle*, handle_max);
45 MOCKABLE_FUNCTION(, void, session_destroy, SESSION_HANDLE, session);
46 MOCKABLE_FUNCTION(, int, session_begin, SESSION_HANDLE, session);
47 MOCKABLE_FUNCTION(, int, session_end, SESSION_HANDLE, session, const char*, condition_value, const char*, description);
48 MOCKABLE_FUNCTION(, LINK_ENDPOINT_HANDLE, session_create_link_endpoint, SESSION_HANDLE, session, const char*, name);
49 MOCKABLE_FUNCTION(, void, session_destroy_link_endpoint, LINK_ENDPOINT_HANDLE, link_endpoint);
50 MOCKABLE_FUNCTION(, int, session_start_link_endpoint, LINK_ENDPOINT_HANDLE, link_endpoint, ON_ENDPOINT_FRAME_RECEIVED, frame_received_callback, ON_SESSION_STATE_CHANGED, on_session_state_changed, ON_SESSION_FLOW_ON, on_session_flow_on, void*, context);
51 MOCKABLE_FUNCTION(, int, session_send_flow, LINK_ENDPOINT_HANDLE, link_endpoint, FLOW_HANDLE, flow);
52 MOCKABLE_FUNCTION(, int, session_send_attach, LINK_ENDPOINT_HANDLE, link_endpoint, ATTACH_HANDLE, attach);
53 MOCKABLE_FUNCTION(, int, session_send_disposition, LINK_ENDPOINT_HANDLE, link_endpoint, DISPOSITION_HANDLE, disposition);
54 MOCKABLE_FUNCTION(, int, session_send_detach, LINK_ENDPOINT_HANDLE, link_endpoint, DETACH_HANDLE, detach);
55 MOCKABLE_FUNCTION(, SESSION_SEND_TRANSFER_RESULT, session_send_transfer, LINK_ENDPOINT_HANDLE, link_endpoint, TRANSFER_HANDLE, transfer, PAYLOAD*, payloads, size_t, payload_count, delivery_number*, delivery_id, ON_SEND_COMPLETE, on_send_complete, void*, callback_context);
56 ```
57
58 ###session_create
59
60 ```C
61 extern SESSION_HANDLE session_create(CONNECTION_HANDLE connection);
62 ```
63
64 **S_R_S_SESSION_01_030: [**session_create shall create a new session instance and return a non-NULL handle to it.**]**
65 **S_R_S_SESSION_01_031: [**If connection is NULL, session_create shall fail and return NULL.**]**
66 **S_R_S_SESSION_01_032: [**session_create shall create a new session endpoint by calling connection_create_endpoint.**]**
67 **S_R_S_SESSION_01_033: [**If connection_create_endpoint fails, session_create shall fail and return NULL.**]**
68 **S_R_S_SESSION_01_042: [**If allocating memory for the session fails, session_create shall fail and return NULL.**]**
69
70 ###session_destroy
71
72 ```C
73 extern void session_destroy(SESSION_HANDLE session);
74 ```
75
76 **S_R_S_SESSION_01_034: [**session_destroy shall free all resources allocated by session_create.**]**
77 **S_R_S_SESSION_01_035: [**The endpoint created in session_create shall be freed by calling connection_destroy_endpoint.**]**
78 **S_R_S_SESSION_01_036: [**If session is NULL, session_destroy shall do nothing.**]**
79
80 ###session_create_link_endpoint
81
82 ```C
83 extern LINK_ENDPOINT_HANDLE session_create_link_endpoint(SESSION_HANDLE session, const char* name, LINK_ENDPOINT_FRAME_RECEIVED_CALLBACK frame_received_callback, void* context);
84 ```
85
86 **S_R_S_SESSION_01_043: [**session_create_link_endpoint shall create a link endpoint associated with a given session and return a non-NULL handle to it.**]**
87 **S_R_S_SESSION_01_044: [**If session, name or frame_received_callback is NULL, session_create_link_endpoint shall fail and return NULL.**]**
88 **S_R_S_SESSION_01_045: [**If allocating memory for the link endpoint fails, session_create_link_endpoint shall fail and return NULL.**]**
89 **S_R_S_SESSION_01_046: [**An unused handle shall be assigned to the link endpoint.**]**
90 **S_R_S_SESSION_01_047: [**The lowest available handle shall be used.**]**
91 **S_R_S_SESSION_01_048: [**If no more handles are available, session_create_link_endpoint shall fail and return NULL.**]**
92
93 ###session_destroy_link_endpoint
94
95 ```C
96 extern void session_destroy_link_endpoint(LINK_ENDPOINT_HANDLE link_endpoint);
97 ```
98
99 **S_R_S_SESSION_01_049: [**session_destroy_link_endpoint shall detach the associated endpoint, but not free the resources of the endpoint.**]**
100 **S_R_S_SESSION_01_050: [**If link_endpoint is NULL, session_destroy_link_endpoint shall do nothing.**]**
101
102 ###session_send_transfer
103
104 ```C
105 extern int session_send_transfer(LINK_ENDPOINT_HANDLE link_endpoint, TRANSFER_HANDLE transfer, PAYLOAD* payloads, size_t payload_count, delivery_number* delivery_id);
106 ```
107
108 **S_R_S_SESSION_01_051: [**session_send_transfer shall send a transfer frame with the performative indicated in the transfer argument.**]**
109 **S_R_S_SESSION_01_053: [**On success, session_send_transfer shall return 0.**]**
110 **S_R_S_SESSION_01_054: [**If link_endpoint or transfer is NULL, session_send_transfer shall fail and return a non-zero value.**]**
111 **S_R_S_SESSION_01_055: [**The encoding of the frame shall be done by calling connection_encode_frame and passing as arguments: the connection handle associated with the session, the transfer performative and the payload chunks passed to session_send_transfer.**]**
112 **S_R_S_SESSION_01_056: [**If connection_encode_frame fails then session_send_transfer shall fail and return a non-zero value.**]**
113 **S_R_S_SESSION_01_057: [**The delivery ids shall be assigned starting at 0.**]**
114 **S_R_S_SESSION_01_058: [**When any other error occurs, session_send_transfer shall fail and return a non-zero value.**]**
115 **S_R_S_SESSION_01_059: [**When session_send_transfer is called while the session is not in the MAPPED state, session_send_transfer shall fail and return a non-zero value.**]**
116
117 ###connection_state_changed_callback
118
119 The following shall be done when the connection_state_changed_callback is triggered:
120
121 - **S_R_S_SESSION_01_060: [**If the previous connection state is not OPENED and the new connection state is OPENED, the BEGIN frame shall be sent out and the state shall be switched to BEGIN_SENT.**]**
122 - **S_R_S_SESSION_01_061: [**If the previous connection state is OPENED and the new connection state is not OPENED anymore, the state shall be switched to DISCARDING.**]**
123 - **S_R_S_SESSION_09_001: [**If the new connection state is ERROR, the state shall be switched to ERROR.**]**
124
125 ##ISO section
126
127 Sessions
128
129 A session is a bidirectional sequential conversation between two containers that provides a grouping for related links. Sessions serve as the context for link communication. Any number of links of any directionality can be attached to a given session. However, a link MUST NOT be attached to more than one session at a time.
130
131 ...
132
133 Figure 2.25: Instance Diagram of Session/Link attachment
134
135 Messages transferred on a link are sequentially identified within the session. A session can be viewed as multiplexing link traffic, much like a connection multiplexes session traffic. However, unlike the sessions on a connection, links on a session are not entirely independent since they share a common delivery sequence scoped to the session.
136 This common sequence allows endpoints to efficiently refer to sets of deliveries regardless of the originating link. This is of particular benefit when a single application is receiving messages along a large number of different links. In this case the session provides aggregation of otherwise independent links into a single stream that can be efficiently acknowledged by the receiving application.
137
138 2.5.1 Establishing A Session
139
140 **S_R_S_SESSION_01_001: [**Sessions are established by creating a session endpoint, assigning it to an unused channel number, and sending a begin announcing the association of the session endpoint with the outgoing channel.**]** **S_R_S_SESSION_01_002: [**Upon receiving the begin the partner will check the remote-channel field and find it empty.**]** This indicates that the begin is referring to remotely initiated session. **S_R_S_SESSION_01_003: [**The partner will therefore allocate an unused outgoing channel for the remotely initiated session and indicate this by sending its own begin setting the remote-channel field to the incoming channel of the remotely initiated session.**]**
141 **S_R_S_SESSION_01_004: [**To make it easier to monitor AMQP sessions, it is RECOMMENDED that implementations always assign the lowest available unused channel number.**]**
142 **S_R_S_SESSION_01_005: [**The remote-channel field of a begin frame MUST be empty for a locally initiated session**]**,**S_R_S_SESSION_01_006: [**and MUST be set when announcing the endpoint created as a result of a remotely initiated session.**]**
143
144 ...
145
146 Figure 2.26: Session Begin Sequence
147
148 2.5.2 Ending A Session
149
150 **S_R_S_SESSION_01_007: [**Sessions end automatically when the connection is closed or interrupted.**]** **S_R_S_SESSION_01_008: [**Sessions are explicitly ended when either endpoint chooses to end the session.**]** **S_R_S_SESSION_01_009: [**When a session is explicitly ended, an end frame is sent to announce the disassociation of the endpoint from its outgoing channel, and to carry error information when relevant.**]**
151
152 ...
153
154 Figure 2.27: Session End Sequence
155
156 2.5.3 Simultaneous End
157
158 Due to the potentially asynchronous nature of sessions, it is possible that both peers simultaneously decide to end a session. If this happens, it will appear to each peer as though their partner's spontaneously initiated end frame is actually an answer to the peers initial end frame.
159
160 ...
161
162 Figure 2.28: Simultaneous Session End Sequence
163
164 2.5.4 Session Errors
165
166 **S_R_S_SESSION_01_010: [**When a session is unable to process input, it MUST indicate this by issuing an END with an appropriate error indicating the cause of the problem.**]** **S_R_S_SESSION_01_011: [**It MUST then proceed to discard all incoming frames from the remote endpoint until receiving the remote endpoint's corresponding end frame.**]**
167
168 ...
169
170 Figure 2.29: Session Error Sequence
171
172 2.5.5 Session States
173
174 UNMAPPED In the UNMAPPED state, the session endpoint is not mapped to any incoming or outgoing channels on the connection endpoint. In this state an endpoint cannot send or receive frames.
175
176 BEGIN SENT In the BEGIN SENT state, the session endpoint is assigned an outgoing channel number, but there is no entry in the incoming channel map. In this state the endpoint MAY send frames but cannot receive them.
177
178 BEGIN RCVD In the BEGIN RCVD state, the session endpoint has an entry in the incoming channel map, but has not yet been assigned an outgoing channel number. The endpoint MAY receive frames, but cannot send them.
179
180 MAPPED In the MAPPED state, the session endpoint has both an outgoing channel number and an entry in the incoming channel map. The endpoint MAY both send and receive frames.
181
182 END SENT In the END SENT state, the session endpoint has an entry in the incoming channel map, but is no longer assigned an outgoing channel number. The endpoint MAY receive frames, but cannot send them.
183
184 END RCVD In the END RCVD state, the session endpoint is assigned an outgoing channel number, but there is no entry in the incoming channel map. The endpoint MAY send frames, but cannot receive them.
185
186 DISCARDING The DISCARDING state is a variant of the END SENT state where the end is triggered by an error. In this case any incoming frames on the session MUST be silently discarded until the peer's end frame is received.
187
188 ...
189
190 Figure 2.30: State Transitions
191
192 There is no obligation to retain a session endpoint after it transitions to the UNMAPPED state.
193
194 2.5.6 Session Flow Control
195
196 **S_R_S_SESSION_01_012: [**The session endpoint assigns each outgoing transfer frame an implicit transfer-id from a session scoped sequence.**]****S_R_S_SESSION_01_013: [**Each session endpoint maintains the following state to manage incoming and outgoing transfer frames**]** :
197 **S_R_S_SESSION_01_014: [**next-incoming-id The next-incoming-id identifies the expected transfer-id of the next incoming transfer frame.**]**
198 **S_R_S_SESSION_01_015: [**incoming-window The incoming-window defines the maximum number of incoming transfer frames that the endpoint can currently receive.**]** This identifies a current maximum incoming transfer-id that can be computed by subtracting one from the sum of incoming-window and next-incomingid.
199 **S_R_S_SESSION_01_016: [**next-outgoing-id The next-outgoing-id is the transfer-id to assign to the next transfer frame.**]** **S_R_S_SESSION_01_017: [**The nextoutgoing-id MAY be initialized to an arbitrary value **]** and **S_R_S_SESSION_01_018: [**is incremented after each successive transfer according to RFC-1982 [RFC1982**]** serial number arithmetic.]
200 **S_R_S_SESSION_01_019: [**outgoing-window The outgoing-window defines the maximum number of outgoing transfer frames that the endpoint can currently send.**]** This identifies a current maximum outgoing transfer-id that can be computed by subtracting one from the sum of outgoing-window and next-outgoing-id.
201 **S_R_S_SESSION_01_020: [**remote-incoming-window The remote-incoming-window reflects the maximum number of outgoing transfers that can be sent without exceeding the remote endpoint's incoming-window.**]****S_R_S_SESSION_01_021: [**This value MUST be decremented after every transfer frame is sent**]**,**S_R_S_SESSION_01_022: [**and recomputed when informed of the remote session endpoint state.**]**
202 **S_R_S_SESSION_01_023: [**remote-outgoing-window The remote-outgoing-window reflects the maximum number of incoming transfers that MAY arrive without exceeding the remote endpoint's outgoing-window.**]****S_R_S_SESSION_01_024: [**This value MUST be decremented after every incoming transfer frame is received**]**, **S_R_S_SESSION_01_025: [**and recomputed when informed of the remote session endpoint state.**]** When this window shrinks, it is an indication of outstanding transfers. Settling outstanding transfers can cause the window to grow.
203 **S_R_S_SESSION_01_026: [**Once initialized, this state is updated by various events that occur in the lifespan of a session and its associated links:**]**
204 **S_R_S_SESSION_01_027: [**sending a transfer Upon sending a transfer, the sending endpoint will increment its next-outgoing-id**]**, **S_R_S_SESSION_01_062: [**decrement its remote-incoming-window**]** ,**S_R_S_SESSION_01_063: [**and MAY (depending on policy) decrement its outgoing window**]** .
205 **S_R_S_SESSION_01_028: [**receiving a transfer Upon receiving a transfer, the receiving endpoint will increment the next-incoming-id to match the implicit transfer-id of the incoming transfer plus one, as well as decrementing the remote-outgoing-window, and MAY (depending on policy) decrement its incoming-window.**]**
206 **S_R_S_SESSION_01_029: [**receiving a flow When the endpoint receives a flow frame from its peer, it MUST update the next-incoming-id directly from the next-outgoing-id of the frame, and it MUST update the remote-outgoingwindow directly from the outgoing-window of the frame.**]**
207
208 The remote-incoming-window is computed as follows:
209
210 next-incoming-idow + incoming-windowow - next-outgoing-idendpoint
211
212 If the next-incoming-id field of the flow frame is not set, then remote-incoming-window is computed as follows:
213
214 initial-outgoing-idendpoint + incoming-windowow - next-outgoing-idendpoint
215
216 Begin frame
217
218 2.7.2 Begin
219
220 Begin a session on a channel.
221
222 \<type name="begin" class="composite" source="list" provides="frame">
223
224 \<descriptor name="amqp:begin:list" code="0x00000000:0x00000011"/>
225
226 \<field name="remote-channel" type="ushort"/>
227
228 \<field name="next-outgoing-id" type="transfer-number" mandatory="true"/>
229
230 \<field name="incoming-window" type="uint" mandatory="true"/>
231
232 \<field name="outgoing-window" type="uint" mandatory="true"/>
233
234 \<field name="handle-max" type="handle" default="4294967295"/>
235
236 \<field name="offered-capabilities" type="symbol" multiple="true"/>
237
238 \<field name="desired-capabilities" type="symbol" multiple="true"/>
239
240 \<field name="properties" type="fields"/>
241
242 \</type>
243
244 Indicate that a session has begun on the channel.
245
246 Field Details
247
248 remote-channel the remote channel for this session
249
250 If a session is locally initiated, the remote-channel MUST NOT be set. When an endpoint responds
251 to a remotely initiated session, the remote-channel MUST be set to the channel on which the
252 remote session sent the begin.
253
254 next-outgoing-id the transfer-id of the first transfer id the sender will send
255
256 See subsection 2.5.6.
257
258 incoming-window the initial incoming-window of the sender
259
260 See subsection 2.5.6.
261
262 outgoing-window the initial outgoing-window of the sender
263
264 See subsection 2.5.6.
265
266 handle-max the maximum handle value that can be used on the session
267
268 The handle-max value is the highest handle value that can be used on the session. A peer MUST
269 NOT attempt to attach a link using a handle value outside the range that its partner can handle.
270 A peer that receives a handle outside the supported range MUST close the connection with the
271
272 framing-error error-code.
273
274 offered-capabilities the extension capabilities the sender supports
275
276 A registry of commonly defined session capabilities and their meanings is maintained
277 [AMQPSESSCAP].
278
279 desired-capabilities the extension capabilities the sender can use if the receiver supports them
280
281 The sender MUST NOT attempt to use any capability other than those it has declared in desiredcapabilities
282 field.
283
284 properties session properties
285
286 The properties map contains a set of fields intended to indicate information about the session and
287 its container.
288 A registry of commonly defined session properties and their meanings is maintained
289 [AMQPSESSPROP].
290
291 Transfer frame
292
293 2.7.5 Transfer
294
295 Transfer a message.
296
297 \<type name="transfer" class="composite" source="list" provides="frame">
298
299 \<descriptor name="amqp:transfer:list" code="0x00000000:0x00000014"/>
300
301 \<field name="handle" type="handle" mandatory="true"/>
302
303 \<field name="delivery-id" type="delivery-number"/>
304
305 \<field name="delivery-tag" type="delivery-tag"/>
306
307 \<field name="message-format" type="message-format"/>
308
309 \<field name="settled" type="boolean"/>
310
311 \<field name="more" type="boolean" default="false"/>
312
313 \<field name="rcv-settle-mode" type="receiver-settle-mode"/>
314
315 \<field name="state" type="*" requires="delivery-state"/>
316
317 \<field name="resume" type="boolean" default="false"/>
318
319 \<field name="aborted" type="boolean" default="false"/>
320
321 \<field name="batchable" type="boolean" default="false"/>
322
323 \</type>
324
325 The transfer frame is used to send messages across a link. Messages MAY be carried by a single transfer up to the maximum negotiated frame size for the connection. Larger messages MAY be split across several transfer frames.
326
327 Field Details
328
329 handle
330
331 Specifies the link on which the message is transferred.
332
333 delivery-id alias for delivery-tag
334
335 The delivery-id MUST be supplied on the first transfer of a multi-transfer delivery. On continuation
336 transfers the delivery-id MAY be omitted. It is an error if the delivery-id on a continuation transfer
337 differs from the delivery-id on the first transfer of a delivery.
338
339 delivery-tag
340
341 Uniquely identifies the delivery attempt for a given message on this link. This field MUST be
342 specified for the first transfer of a multi-transfer message and can only be omitted for continuation
343 transfers. It is an error if the delivery-tag on a continuation transfer differs from the delivery-tag on
344 the first transfer of a delivery.
345
346 message-format indicates the message format
347
348 This field MUST be specified for the first transfer of a multi-transfer message and can only be
349 omitted for continuation transfers. It is an error if the message-format on a continuation transfer
350 differs from the message-format on the first transfer of a delivery.
351
352 settled
353
354 If not set on the first (or only) transfer for a (multi-transfer) delivery, then the settled flag MUST be
355 interpreted as being false. For subsequent transfers in a multi-transfer delivery if the settled flag
356 is left unset then it MUST be interpreted as true if and only if the value of the settled flag on any
357 of the preceding transfers was true; if no preceding transfer was sent with settled being true then
358 the value when unset MUST be taken as false.
359 If the negotiated value for snd-settle-mode at attachment is settled, then this field MUST be true
360 on at least one transfer frame for a delivery (i.e., the delivery MUST be settled at the sender at
361 the point the delivery has been completely transferred).
362 If the negotiated value for snd-settle-mode at attachment is unsettled, then this field MUST be
363 false (or unset) on every transfer frame for a delivery (unless the delivery is aborted).
364
365 more indicates that the message has more content
366
367 Note that if both the more and aborted fields are set to true, the aborted flag takes precedence.
368 That is, a receiver SHOULD ignore the value of the more field if the transfer is marked as aborted.
369 A sender SHOULD NOT set the more flag to true if it also sets the aborted flag to true.
370
371 rcv-settle-mode
372
373 If first, this indicates that the receiver MUST settle the delivery once it has arrived without waiting
374 for the sender to settle first.
375 If second, this indicates that the receiver MUST NOT settle until sending its disposition to the
376 sender and receiving a settled disposition from the sender.
377 If not set, this value is defaulted to the value negotiated on link attach.
378 If the negotiated link value is first, then it is illegal to set this field to second.
379 If the message is being sent settled by the sender, the value of this field is ignored.
380 The (implicit or explicit) value of this field does not form part of the transfer state, and is not
381 retained if a link is suspended and subsequently resumed.
382
383 state the state of the delivery at the sender
384
385 When set this informs the receiver of the state of the delivery at the sender. This is particularly
386 useful when transfers of unsettled deliveries are resumed after resuming a link. Setting the state
387 on the transfer can be thought of as being equivalent to sending a disposition immediately before
388 the transfer performative, i.e., it is the state of the delivery (not the transfer) that existed at the
389 point the frame was sent.
390 Note that if the transfer performative (or an earlier disposition performative referring to the
391 delivery) indicates that the delivery has attained a terminal state, then no future transfer or
392 disposition sent by the sender can alter that terminal state.
393
394 resume indicates a resumed delivery
395
396 If true, the resume flag indicates that the transfer is being used to reassociate an unsettled delivery
397 from a dissociated link endpoint. See subsection 2.6.13 for more details.
398 The receiver MUST ignore resumed deliveries that are not in its local unsettled map. The sender
399 MUST NOT send resumed transfers for deliveries not in its local unsettled map.
400 If a resumed delivery spans more than one transfer performative, then the resume flag MUST be
401 set to true on the first transfer of the resumed delivery. For subsequent transfers for the same
402 delivery the resume flag MAY be set to true, or MAY be omitted.
403 In the case where the exchange of unsettled maps makes clear that all message data has been
404 successfully transferred to the receiver, and that only the final state (and potentially settlement) at
405 the sender needs to be conveyed, then a resumed delivery MAY carry no payload and instead act
406 solely as a vehicle for carrying the terminal state of the delivery at the sender.
407
408 aborted indicates that the message is aborted
409
410 Aborted messages SHOULD be discarded by the recipient (any payload within the frame carrying
411 the performative MUST be ignored). An aborted message is implicitly settled.
412
413 batchable batchable hint
414
415 If true, then the issuer is hinting that there is no need for the peer to urgently communicate
416 updated delivery state. This hint MAY be used to artificially increase the amount of batching
417 an implementation uses when communicating delivery states, and thereby save bandwidth.
418 If the message being delivered is too large to fit within a single frame, then the setting of batchable
419 to true on any of the transfer performatives for the delivery is equivalent to setting batchable to
420 true for all the transfer performatives for the delivery.
421 The batchable value does not form part of the transfer state, and is not retained if a link is suspended
422 and subsequently resumed.