connector: allow multiple messages to be sent in one packet

[firefly-linux-kernel-4.4.55.git] / Documentation / connector / connector.txt

diff --git a/Documentation/connector/connector.txt b/Documentation/connector/connector.txt
index e5c5f5e6ab70b697dca09f2b3e19ce3cd45a4586..e56abdb2197576b2e3e6d9d865c30d298f8dd7c0 100644 (file)
--- a/Documentation/connector/connector.txt
+++ b/Documentation/connector/connector.txt
@@ -24,7 +24,8 @@ netlink based networking for inter-process communication in a significantly
 easier way:
 
 int cn_add_callback(struct cb_id *id, char *name, void (*callback) (struct cn_msg *, struct netlink_skb_parms *));
-void cn_netlink_send(struct cn_msg *msg, u32 __group, int gfp_mask);
+void cn_netlink_send_multi(struct cn_msg *msg, u16 len, u32 portid, u32 __group, int gfp_mask);
+void cn_netlink_send(struct cn_msg *msg, u32 portid, u32 __group, int gfp_mask);
 
 struct cb_id
 {
@@ -71,15 +72,21 @@ void cn_del_callback(struct cb_id *id);
  struct cb_id *id              - unique connector's user identifier.
 
 
-int cn_netlink_send(struct cn_msg *msg, u32 __groups, int gfp_mask);
+int cn_netlink_send_multi(struct cn_msg *msg, u16 len, u32 portid, u32 __groups, int gfp_mask);
+int cn_netlink_send(struct cn_msg *msg, u32 portid, u32 __groups, int gfp_mask);
 
  Sends message to the specified groups.  It can be safely called from
  softirq context, but may silently fail under strong memory pressure.
  If there are no listeners for given group -ESRCH can be returned.
 
  struct cn_msg *               - message header(with attached data).
+ u16 len                       - for *_multi multiple cn_msg messages can be sent
+ u32 port                      - destination port.
+                                 If non-zero the message will be sent to the
+                                 given port, which should be set to the
+                                 original sender.
  u32 __group                   - destination group.
-                                 If __group is zero, then appropriate group will
+                                 If port and __group is zero, then appropriate group will
                                  be searched through all registered connector users,
                                  and message will be delivered to the group which was
                                  created for user with the same ID as in msg.