Roadmap: Connection Bonding

[maxsharabayko]

Listener Callback: Group Extension (API)

Existing listener callback does not provide fields to pass group-related data.
Another function is needed.

• Add SRTO_GROUPTYPE socket option to retrieve group type inside the listener callback. PR Extracting group type from the incoming handshake for listener callback #1294
• ✖️ New listener callback - postponed (for v1.5.1?).

Rejection Reason Enahancements (API)

Make it possible for an application to set a specific reason for rejecting a connection from a listener callback.

• PR Added timeout reason. Updated correctly reject reason on timeout #1194 - added rejection reason: timeout. Documentation changes are requested.

• PR Customizable reject reason code #1291 - Enhanced and customizable reject reason - Requires an update to latest master

• PR Added access control public header file. #1300 Add definitions of predefined HTTP status codes used as rejection reason codes. (Tasks: @maxsharabayko to review)

Group Statistics

Reusing srt_bistats function for SRT socket group.

• srt_bistats function for groups: Added group support for stats probing. PR Added group support for stats probing #1303.

• srt_bistats function for groups: reuse pktSentTotal, pktSndLossTotal etc. as a sum of corresponding values of the individual socket in a group.

• Decide on pktRcvDiscardTotal for groups

Group Status

• PR srt_group_data(..) returns group size even without output array #1222 - srt_group_data(..) API function to return group size [ralated to the bonding API.

• PR Reworked the structures for config and status for groups #1326 - Add link state field to SRT_GROUP_DATA, and retrieve the value via srt_group_data(..). Possible link states: active/unstable/Idle/broken.

• TODO

Uncategorized

• Issue Change the Group Membership extension of the handshake packet #1245 Group Membership Handshake extension - PR Implemented new Group handshake extension format #1285

• Set latency per socket in a group (and probably some other options like MTU size).

  • requires: design of the idea (Tasks: @maxsharabayko to provide description)

• PR Added unique send/receive stats #1283 [core] Added unique send/receive stats - merged

• PR [docs] Introduced pktSentUnique, pktRecvUnique socket statistics #1263 [docs] Added unique send/receive stats - (discussing undecrypted packets)

• PR Added balancing group implementation. #1257 Balancing group implementation - extract only API-related changes (?) (extraction already done, PR describes extra changes for balancing groups)

• SRT Handshake extension for socket groups - add docs.

• PR Added configuration object to group connection structure #1314 - Added a possibility to install a per-connection socket options, mainly required for supporting SRTO_BINDTODEVICE option

Balancing

• 12. Load balancing implementation

• 13. Load balancing documentation

Completed work

• 1. INTERNALS: Internal structures and basic management for socket groups #1109

• The CUDTGroup class
• Associated symbols the class depends on
• Support functions in CUDT class for creation/deletion and hookup
• (transmission functions temporarily deleted)

• 2. SRT API: API injections for socket groups #1115

• Handling group ID in existing API functions
• Extra API functions dedicated for groups

• 2.1. SRT API docs PR Updated documentation for SRT bonding #1123

• 2.3. Added short doc about bonding PR Added short doc about bonding #1117

• 3. HANDSHAKE AND MANAGEMENT PR Handshake and internal processing for socket groups #1119

• Passing and recognizing the group in the handshake
• Support functions in other classes to handle group synchronization
• Doing specific actions as required for the group in existing internals

• 4. TRANSMISSION PR Added transmission implementation for broadcast type groups #1124

• The receiving function, universal for broadcast and backup type
• The sending function for broadcast type only.

• 4.1. Changed Socket Group API PR Changed group API: source per site can be specified #1137

• 5. APPLICATIONS PR Application support for socket groups (testing app only) #1139

• Handling the special syntax for groupwise connections
• Handling the groups internally in the application

• 6. Added test examples for bonding PR Added test examples for bonding #1143.

• 7. Redesigned SRTO_GROUPCONNECT option PR Redesigned SRTO_GROUPCONNECT option. #1150

• 8. Added accept_bond function for blocking-mode multi-listener accept-waiting PR Added accept_bond function for blocking-mode multi-listener accept-waiting #1153

• 9. Refactoring before Backup groups (PR BACKUP GROUPS: refactoring changes #1167)

• 10. Main backup implementation BACKUP GROUPS: Implementation #1178

• 11. Main backup documentation BACKUP GROUPS: Implementation #1168

[Llorx]

Hi, I have one question.

How will SRT_GTYPE_BALANCING work? will it just roundrobin or will have some kind of congestion control/packet loss count to send just the amount of packets that can handle?

EDIT: Really great work. Keep it up.

[maxsharabayko]

Hi @Llorx
Thanks for your interest in this feature.
The first implementation of the balancing mode will likely be simple, maybe relying on some heuristics.
The goal is to have an extensible module to allow people to add custom algorithms. In a way similar to how Congestion Control and Packet Filter modules are implemented.

[ethouris]

You can take a look at my development branch dev-groups-external-msgsync.

As I know that the method of selecting the link can be based on various parameters, I have provided a framework for adding various possible balancing algorithms. Currently there are two provided:

• linkSelect_plain: simple round-robin with no parameters tracked
• linkSelect_window: the selector tracks the cost of sending of a packet over particular link by checking the flight window on all links and deciding the link load basing on it. Every sending operation is considered as adding a load on this link, and for next sending the least currently loaded link is selected. This algorithm is provided, but didn't undergo yet any stress testing and will likely need to be largely improved.

[Llorx]

Nice @ethouris. linkSelect_window seems pretty cool.

Hm @maxsharabayko, I see a problem with the modular thingy. Most of the users will benefit from SRT by using third-party software that has SRT already implemented, so is impossible to create your own module as you need to compile your own SRT with that module "inserted". One example is vMix.

Will be difficult to release it with some cool modules already built-in? so third-party software can benefit from it, as I don't expect them to build some cool modules on their own.

Or maybe add some kind of "dll" thingy too. I don't know.

Also, there are some MP-TCP congestion control algorithms that maybe you can benefit of.

By the way, I know that this is a long-way until we have something cool hehe. Nice work you have there.