Commit 871d98

2025-07-25 07:42:05 ordex: added details about sync and async messages
DataChannelOffload/LinuxUAPI.md ..
@@ 35,6 35,8 @@
#### OVPN_CMD_PEER_GET
Retrieve the whole list of connected peers with their status. It is possible to limit the retrieval to one peer only by specifying its ID.
+ When receiving this message, _ovpn_ will immediately send back a unicast reply (made up by one message per retrieved peer).
+
#### OVPN_CMD_PEER_DEL
Delete peer from _ovpn_ data structures.
@@ 61,6 63,18 @@
### Events (from kernel to userspace)
+ Events are signaled to userspace by means of notification messages.
+ Notifications are asynchronous and sent as multicas messages to the _OVPN_NLGRP_PEERS_ group.
+ They may be sent by _ovpn_ at any point in time, therefore it's up to userspace to be always ready
+ to receive and process them.
+
+ Please note that a host system may have more than one _ovpn_ interface active at the same time and,
+ while all notifications are delivered to the same multicast group, each receiver should check whether the
+ ifindex associated with the notification is the one they are responsible for.
+
+ Potentially any software on the host system may listen for _ovpn_ notifications and react to them
+ (i.e. by showing a pop-up to the user or by simply logging events).
+
#### OVPN_CMD_PEER_DEL_NTF
Inform userspace that a peer has been deleted.
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 2 3 4 5 6 7 8 9