[PROTON-2339] Introduce 'Drain buffers' event to proactor raw connection

• Type: Improvement
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Affects Version/s: proton-c-0.33.0
• Fix Version/s: proton-c-0.34.0
• Component/s: proton-c
• Assignee: Andrew Stitcher
• Reporter: Andrew Stitcher
• Created: 02/Mar/21 19:25
• Updated: 30/Mar/23 16:51
• Resolved: 02/Mar/21 22:24

Description

In discussions with users of th raw connection API there is constant (if often brief) puzzlement over receiving read/written events after the connectino is closed but before the disconnect event.

These events are to tell the application to retrieve all the buffers that they have given the raw connection before the connection becomes completely inaccessible and hence the buffre would leak.

It would be clearer (and invite less confusion) to have a specific event to tell the application to drain all its buffers.

Issue Links

• incorporates: PROTON-2700 Raw connection API: Remove ambiguous use of READ/WRITTEN events