€•ÝíŒsphinx.addnodes”Œdocument”“”)”}”(Œ rawsource”Œ”Œchildren”]”(Œtranslations”Œ LanguagesNode”“”)”}”(hhh]”(hŒpending_xref”“”)”}”(hhh]”Œdocutils.nodes”ŒText”“”ŒChinese (Simplified)”…””}”Œparent”hsbaŒ attributes”}”(Œids”]”Œclasses”]”Œnames”]”Œdupnames”]”Œbackrefs”]”Œ refdomain”Œstd”Œreftype”Œdoc”Œ reftarget”Œ(/translations/zh_CN/driver-api/connector”Œmodname”NŒ classname”NŒrefexplicit”ˆuŒtagname”hhhubh)”}”(hhh]”hŒChinese (Traditional)”…””}”hh2sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ(/translations/zh_TW/driver-api/connector”Œmodname”NŒ classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒItalian”…””}”hhFsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ(/translations/it_IT/driver-api/connector”Œmodname”NŒ classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒJapanese”…””}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ(/translations/ja_JP/driver-api/connector”Œmodname”NŒ classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒKorean”…””}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ(/translations/ko_KR/driver-api/connector”Œmodname”NŒ classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒSpanish”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ(/translations/sp_SP/driver-api/connector”Œmodname”NŒ classname”NŒrefexplicit”ˆuh1hhhubeh}”(h]”h ]”h"]”h$]”h&]”Œcurrent_language”ŒEnglish”uh1h hhŒ _document”hŒsource”NŒline”NubhŒcomment”“”)”}”(hŒ SPDX-License-Identifier: GPL-2.0”h]”hŒ SPDX-License-Identifier: GPL-2.0”…””}”hh£sbah}”(h]”h ]”h"]”h$]”h&]”Œ xml:space”Œpreserve”uh1h¡hhhžhhŸŒB/var/lib/git/docbuild/linux/Documentation/driver-api/connector.rst”h KubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒKernel Connector”h]”hŒKernel Connector”…””}”(hh»hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hh¶hžhhŸh³h KubhŒ paragraph”“”)”}”(hŒaKernel connector - new netlink based userspace <-> kernel space easy to use communication module.”h]”hŒaKernel connector - new netlink based userspace <-> kernel space easy to use communication module.”…””}”(hhËhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Khh¶hžhubhÊ)”}”(hX The Connector driver makes it easy to connect various agents using a netlink based network. One must register a callback and an identifier. When the driver receives a special netlink message with the appropriate identifier, the appropriate callback will be called.”h]”hX The Connector driver makes it easy to connect various agents using a netlink based network. One must register a callback and an identifier. When the driver receives a special netlink message with the appropriate identifier, the appropriate callback will be called.”…””}”(hhÙhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K hh¶hžhubhÊ)”}”(hŒFrom the userspace point of view itâ€™s quite straightforward:”…””}”(hhçhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Khh¶hžhubhŒblock_quote”“”)”}”(hŒ*- socket(); - bind(); - send(); - recv(); ”h]”hŒbullet_list”“”)”}”(hhh]”(hŒ list_item”“”)”}”(hŒ socket();”h]”hÊ)”}”(hjh]”hŒ socket();”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Khjubah}”(h]”h ]”h"]”h$]”h&]”uh1jhhýubj)”}”(hŒbind();”h]”hÊ)”}”(hjh]”hŒbind();”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Khjubah}”(h]”h ]”h"]”h$]”h&]”uh1jhhýubj)”}”(hŒsend();”h]”hÊ)”}”(hj2h]”hŒsend();”…””}”(hj4hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Khj0ubah}”(h]”h ]”h"]”h$]”h&]”uh1jhhýubj)”}”(hŒrecv(); ”h]”hÊ)”}”(hŒrecv();”h]”hŒrecv();”…””}”(hjKhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KhjGubah}”(h]”h ]”h"]”h$]”h&]”uh1jhhýubeh}”(h]”h ]”h"]”h$]”h&]”Œbullet”Œ-”uh1hûhŸh³h Khh÷ubah}”(h]”h ]”h"]”h$]”h&]”uh1hõhŸh³h Khh¶hžhubhÊ)”}”(hX6But if kernelspace wants to use the full power of such connections, the driver writer must create special sockets, must know about struct sk_buff handling, etc... The Connector driver allows any kernelspace agents to use netlink based networking for inter-process communication in a significantly easier way::”h]”hX5But if kernelspace wants to use the full power of such connections, the driver writer must create special sockets, must know about struct sk_buff handling, etc... The Connector driver allows any kernelspace agents to use netlink based networking for inter-process communication in a significantly easier way:”…””}”(hjmhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Khh¶hžhubhŒ literal_block”“”)”}”(hXint cn_add_callback(const struct cb_id *id, char *name, void (*callback) (struct cn_msg *, struct netlink_skb_parms *)); void cn_netlink_send_mult(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 { __u32 idx; __u32 val; };”h]”hXint cn_add_callback(const struct cb_id *id, char *name, void (*callback) (struct cn_msg *, struct netlink_skb_parms *)); void cn_netlink_send_mult(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 { __u32 idx; __u32 val; };”…””}”hj}sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1j{hŸh³h Khh¶hžhubhÊ)”}”(hXDidx and val are unique identifiers which must be registered in the connector.h header for in-kernel usage. `void (*callback) (void *)` is a callback function which will be called when a message with above idx.val is received by the connector core. The argument for that function must be dereferenced to `struct cn_msg *`::”h]”(hŒlidx and val are unique identifiers which must be registered in the connector.h header for in-kernel usage. ”…””}”(hj‹hžhhŸNh NubhŒtitle_reference”“”)”}”(hŒ`void (*callback) (void *)`”h]”hŒvoid (*callback) (void *)”…””}”(hj•hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j“hj‹ubhŒª is a callback function which will be called when a message with above idx.val is received by the connector core. The argument for that function must be dereferenced to ”…””}”(hj‹hžhhŸNh Nubj”)”}”(hŒ`struct cn_msg *`”h]”hŒstruct cn_msg *”…””}”(hj§hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j“hj‹ubhŒ:”…””}”(hj‹hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K&hh¶hžhubj|)”}”(hXstruct cn_msg { struct cb_id id; __u32 seq; __u32 ack; __u16 len; /* Length of the following data */ __u16 flags; __u8 data[0]; };”h]”hXstruct cn_msg { struct cb_id id; __u32 seq; __u32 ack; __u16 len; /* Length of the following data */ __u16 flags; __u8 data[0]; };”…””}”hj¿sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1j{hŸh³h K,hh¶hžhubhµ)”}”(hhh]”(hº)”}”(hŒConnector interfaces”h]”hŒConnector interfaces”…””}”(hjÐhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hjÍhžhhŸh³h K9ubhö)”}”(hŒ¨.. kernel-doc:: include/linux/connector.h Note: When registering new callback user, connector core assigns netlink group to the user which is equal to its id.idx. ”h]”(hŒindex”“”)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œentries”]”(Œsingle”Œcn_add_callback (C function)”Œc.cn_add_callback”hNt”auh1jâhjÞubhŒdesc”“”)”}”(hhh]”(hŒdesc_signature”“”)”}”(hŒ}int cn_add_callback (const struct cb_id *id, const char *name, void (*callback)(struct cn_msg *, struct netlink_skb_parms *))”h]”hŒdesc_signature_line”“”)”}”(hŒzint cn_add_callback(const struct cb_id *id, const char *name, void (*callback)(struct cn_msg*, struct netlink_skb_parms*))”h]”(hŒdesc_sig_keyword_type”“”)”}”(hŒint”h]”hŒint”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”Œkt”ah"]”h$]”h&]”uh1jhjhžhhŸŒ^/var/lib/git/docbuild/linux/Documentation/driver-api/connector:59: ./include/linux/connector.h”h KCubhŒdesc_sig_space”“”)”}”(hŒ ”h]”hŒ ”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”Œw”ah"]”h$]”h&]”uh1jhjhžhhŸjh KCubhŒ desc_name”“”)”}”(hŒcn_add_callback”h]”hŒ desc_sig_name”“”)”}”(hŒcn_add_callback”h]”hŒcn_add_callback”…””}”(hj/hžhhŸNh Nubah}”(h]”h ]”Œn”ah"]”h$]”h&]”uh1j-hj)ubah}”(h]”h ]”(Œsig-name”Œdescname”eh"]”h$]”h&]”h±h²uh1j'hjhžhhŸjh KCubhŒdesc_parameterlist”“”)”}”(hŒg(const struct cb_id *id, const char *name, void (*callback)(struct cn_msg*, struct netlink_skb_parms*))”h]”(hŒdesc_parameter”“”)”}”(hŒconst struct cb_id *id”h]”(hŒdesc_sig_keyword”“”)”}”(hŒconst”h]”hŒconst”…””}”(hjThžhhŸNh Nubah}”(h]”h ]”Œk”ah"]”h$]”h&]”uh1jRhjNubj)”}”(hŒ ”h]”hŒ ”…””}”(hjchžhhŸNh Nubah}”(h]”h ]”j#ah"]”h$]”h&]”uh1jhjNubjS)”}”(hŒstruct”h]”hŒstruct”…””}”(hjqhžhhŸNh Nubah}”(h]”h ]”j_ah"]”h$]”h&]”uh1jRhjNubj)”}”(hŒ ”h]”hŒ ”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”j#ah"]”h$]”h&]”uh1jhjNubh)”}”(hhh]”j.)”}”(hŒcb_id”h]”hŒcb_id”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”j:ah"]”h$]”h&]”uh1j-hjubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”Œc”Œreftype”Œ identifier”Œ reftarget”j’Œmodname”NŒ classname”NŒc:parent_key”Œsphinx.domains.c”Œ LookupKey”“”)”}”Œdata”]”j¬Œ ASTIdentifier”“”)”}”j§j1sbŒc.cn_add_callback”†”asbuh1hhjNubj)”}”(hŒ ”h]”hŒ ”…””}”(hj¹hžhhŸNh Nubah}”(h]”h ]”j#ah"]”h$]”h&]”uh1jhjNubhŒdesc_sig_punctuation”“”)”}”(hŒ*”h]”hŒ*”…””}”(hjÉhžhhŸNh Nubah}”(h]”h ]”Œp”ah"]”h$]”h&]”uh1jÇhjNubj.)”}”(hŒid”h]”hŒid”…””}”(hjØhžhhŸNh Nubah}”(h]”h ]”j:ah"]”h$]”h&]”uh1j-hjNubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆh±h²uh1jLhjHubjM)”}”(hŒconst char *name”h]”(jS)”}”(hjVh]”hŒconst”…””}”(hjñhžhhŸNh Nubah}”(h]”h ]”j_ah"]”h$]”h&]”uh1jRhjíubj)”}”(hŒ ”h]”hŒ ”…””}”(hjþhžhhŸNh Nubah}”(h]”h ]”j#ah"]”h$]”h&]”uh1jhjíubj)”}”(hŒchar”h]”hŒchar”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”jah"]”h$]”h&]”uh1jhjíubj)”}”(hŒ ”h]”hŒ ”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”j#ah"]”h$]”h&]”uh1jhjíubjÈ)”}”(hjËh]”hŒ*”…””}”(hj(hžhhŸNh Nubah}”(h]”h ]”jÔah"]”h$]”h&]”uh1jÇhjíubj.)”}”(hŒname”h]”hŒname”…””}”(hj5hžhhŸNh Nubah}”(h]”h ]”j:ah"]”h$]”h&]”uh1j-hjíubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆh±h²uh1jLhjHubjM)”}”(hŒ;void (*callback)(struct cn_msg*, struct netlink_skb_parms*)”h]”(j)”}”(hŒvoid”h]”hŒvoid”…””}”(hjNhžhhŸNh Nubah}”(h]”h ]”jah"]”h$]”h&]”uh1jhjJubj)”}”(hŒ ”h]”hŒ ”…””}”(hj\hžhhŸNh Nubah}”(h]”h ]”j#ah"]”h$]”h&]”uh1jhjJubjÈ)”}”(hŒ(”h]”hŒ(”…””}”(hjjhžhhŸNh Nubah}”(h]”h ]”jÔah"]”h$]”h&]”uh1jÇhjJubjÈ)”}”(hjËh]”hŒ*”…””}”(hjxhžhhŸNh Nubah}”(h]”h ]”jÔah"]”h$]”h&]”uh1jÇhjJubj.)”}”(hŒcallback”h]”hŒcallback”…””}”(hj…hžhhŸNh Nubah}”(h]”h ]”j:ah"]”h$]”h&]”uh1j-hjJubjÈ)”}”(hŒ)”h]”hŒ)”…””}”(hj“hžhhŸNh Nubah}”(h]”h ]”jÔah"]”h$]”h&]”uh1jÇhjJubjÈ)”}”(hjlh]”hŒ(”…””}”(hj¡hžhhŸNh Nubah}”(h]”h ]”jÔah"]”h$]”h&]”uh1jÇhjJubjS)”}”(hjsh]”hŒstruct”…””}”(hj®hžhhŸNh Nubah}”(h]”h ]”j_ah"]”h$]”h&]”uh1jRhjJubj)”}”(hŒ ”h]”hŒ ”…””}”(hj»hžhhŸNh Nubah}”(h]”h ]”j#ah"]”h$]”h&]”uh1jhjJubh)”}”(hhh]”j.)”}”(hŒcn_msg”h]”hŒcn_msg”…””}”(hjÌhžhhŸNh Nubah}”(h]”h ]”j:ah"]”h$]”h&]”uh1j-hjÉubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”j¥Œreftype”j§Œ reftarget”jÎŒmodname”NŒ classname”Nj«j®)”}”j±]”jµŒc.cn_add_callback”†”asbuh1hhjJubjÈ)”}”(hjËh]”hŒ*”…””}”(hjêhžhhŸNh Nubah}”(h]”h ]”jÔah"]”h$]”h&]”uh1jÇhjJubjÈ)”}”(hŒ,”h]”hŒ,”…””}”(hj÷hžhhŸNh Nubah}”(h]”h ]”jÔah"]”h$]”h&]”uh1jÇhjJubj)”}”(hŒ ”h]”hŒ ”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”j#ah"]”h$]”h&]”uh1jhjJubjS)”}”(hjsh]”hŒstruct”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”j_ah"]”h$]”h&]”uh1jRhjJubj)”}”(hŒ ”h]”hŒ ”…””}”(hj hžhhŸNh Nubah}”(h]”h ]”j#ah"]”h$]”h&]”uh1jhjJubh)”}”(hhh]”j.)”}”(hŒnetlink_skb_parms”h]”hŒnetlink_skb_parms”…””}”(hj1hžhhŸNh Nubah}”(h]”h ]”j:ah"]”h$]”h&]”uh1j-hj.ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”j¥Œreftype”j§Œ reftarget”j3Œmodname”NŒ classname”Nj«j®)”}”j±]”jµŒc.cn_add_callback”†”asbuh1hhjJubjÈ)”}”(hjËh]”hŒ*”…””}”(hjOhžhhŸNh Nubah}”(h]”h ]”jÔah"]”h$]”h&]”uh1jÇhjJubjÈ)”}”(hj•h]”hŒ)”…””}”(hj\hžhhŸNh Nubah}”(h]”h ]”jÔah"]”h$]”h&]”uh1jÇhjJubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆh±h²uh1jLhjHubeh}”(h]”h ]”h"]”h$]”h&]”h±h²uh1jFhjhžhhŸjh KCubeh}”(h]”h ]”h"]”h$]”h&]”h±h²Œ add_permalink”ˆuh1jþŒsphinx_line_type”Œ declarator”hjúhžhhŸjh KCubah}”(h]”jñah ]”(Œsig”Œ sig-object”eh"]”h$]”h&]”Œis_multiline”ˆŒ _toc_parts”)Œ _toc_name”huh1jøhŸjh KChjõhžhubhŒdesc_content”“”)”}”(hhh]”hÊ)”}”(hŒ+Registers new callback with connector core.”h]”hŒ+Registers new callback with connector core.”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸŒ^/var/lib/git/docbuild/linux/Documentation/driver-api/connector:59: ./include/linux/connector.h”h K:hjŒhžhubah}”(h]”h ]”h"]”h$]”h&]”uh1jŠhjõhžhhŸjh KCubeh}”(h]”h ]”(j¥Œfunction”eh"]”h$]”h&]”Œdomain”j¥Œobjtype”j§Œdesctype”j§Œnoindex”‰Œnoindexentry”‰Œnocontentsentry”‰uh1jóhžhhjÞubhŒ container”“”)”}”(hXd**Parameters** ``const struct cb_id *id`` unique connector's user identifier. It must be registered in connector.h for legal in-kernel users. ``const char *name`` connector's callback symbolic name. ``void (*callback)(struct cn_msg *, struct netlink_skb_parms *)`` connector's callback. parameters are ``cn_msg`` and the sender's credentials”h]”(hÊ)”}”(hŒ**Parameters**”h]”hŒstrong”“”)”}”(hj¹h]”hŒ Parameters”…””}”(hj½hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j»hj·ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸŒ^/var/lib/git/docbuild/linux/Documentation/driver-api/connector:59: ./include/linux/connector.h”h K>hj³ubhŒdefinition_list”“”)”}”(hhh]”(hŒdefinition_list_item”“”)”}”(hŒ``const struct cb_id *id`` unique connector's user identifier. It must be registered in connector.h for legal in-kernel users. ”h]”(hŒterm”“”)”}”(hŒ``const struct cb_id *id``”h]”hŒliteral”“”)”}”(hjàh]”hŒconst struct cb_id *id”…””}”(hjähžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhjÞubah}”(h]”h ]”h"]”h$]”h&]”uh1jÜhŸŒ^/var/lib/git/docbuild/linux/Documentation/driver-api/connector:59: ./include/linux/connector.h”h K>hjØubhŒ definition”“”)”}”(hhh]”hÊ)”}”(hŒcunique connector's user identifier. It must be registered in connector.h for legal in-kernel users.”h]”hŒeunique connectorâ€™s user identifier. It must be registered in connector.h for legal in-kernel users.”…””}”(hjýhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸŒ^/var/lib/git/docbuild/linux/Documentation/driver-api/connector:59: ./include/linux/connector.h”h KhjÓubj×)”}”(hŒ9``const char *name`` connector's callback symbolic name. ”h]”(jÝ)”}”(hŒ``const char *name``”h]”jã)”}”(hjh]”hŒconst char *name”…””}”(hj hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhjubah}”(h]”h ]”h"]”h$]”h&]”uh1jÜhŸŒ^/var/lib/git/docbuild/linux/Documentation/driver-api/connector:59: ./include/linux/connector.h”h K?hjubjù)”}”(hhh]”hÊ)”}”(hŒ#connector's callback symbolic name.”h]”hŒ%connectorâ€™s callback symbolic name.”…””}”(hj7hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸj3h K?hj4ubah}”(h]”h ]”h"]”h$]”h&]”uh1jøhjubeh}”(h]”h ]”h"]”h$]”h&]”uh1jÖhŸj3h K?hjÓubj×)”}”(hŒŽ``void (*callback)(struct cn_msg *, struct netlink_skb_parms *)`` connector's callback. parameters are ``cn_msg`` and the sender's credentials”h]”(jÝ)”}”(hŒA``void (*callback)(struct cn_msg *, struct netlink_skb_parms *)``”h]”jã)”}”(hjWh]”hŒ=void (*callback)(struct cn_msg *, struct netlink_skb_parms *)”…””}”(hjYhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhjUubah}”(h]”h ]”h"]”h$]”h&]”uh1jÜhŸŒ^/var/lib/git/docbuild/linux/Documentation/driver-api/connector:59: ./include/linux/connector.h”h K@hjQubjù)”}”(hhh]”hÊ)”}”(hŒLconnector's callback. parameters are ``cn_msg`` and the sender's credentials”h]”(hŒ'connectorâ€™s callback. parameters are ”…””}”(hjphžhhŸNh Nubjã)”}”(hŒ ``cn_msg``”h]”hŒcn_msg”…””}”(hjxhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhjpubhŒ and the senderâ€™s credentials”…””}”(hjphžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸjlh K@hjmubah}”(h]”h ]”h"]”h$]”h&]”uh1jøhjQubeh}”(h]”h ]”h"]”h$]”h&]”uh1jÖhŸjlh K@hjÓubeh}”(h]”h ]”h"]”h$]”h&]”uh1jÑhj³ubeh}”(h]”h ]”Œkernelindent”ah"]”h$]”h&]”uh1j±hjÞubjã)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œentries”]”(jïŒcn_del_callback (C function)”Œc.cn_del_callback”hNt”auh1jâhjÞubjô)”}”(hhh]”(jù)”}”(hŒ-void cn_del_callback (const struct cb_id *id)”h]”jÿ)”}”(hŒ,void cn_del_callback(const struct cb_id *id)”h]”(j)”}”(hŒvoid”h]”hŒvoid”…””}”(hjÂhžhhŸNh Nubah}”(h]”h ]”jah"]”h$]”h&]”uh1jhj¾hžhhŸŒ^/var/lib/git/docbuild/linux/Documentation/driver-api/connector:59: ./include/linux/connector.h”h KJubj)”}”(hŒ ”h]”hŒ ”…””}”(hjÑhžhhŸNh Nubah}”(h]”h ]”j#ah"]”h$]”h&]”uh1jhj¾hžhhŸjÐh KJubj()”}”(hŒcn_del_callback”h]”j.)”}”(hŒcn_del_callback”h]”hŒcn_del_callback”…””}”(hjãhžhhŸNh Nubah}”(h]”h ]”j:ah"]”h$]”h&]”uh1j-hjßubah}”(h]”h ]”(jAjBeh"]”h$]”h&]”h±h²uh1j'hj¾hžhhŸjÐh KJubjG)”}”(hŒ(const struct cb_id *id)”h]”jM)”}”(hŒconst struct cb_id *id”h]”(jS)”}”(hjVh]”hŒconst”…””}”(hjÿhžhhŸNh Nubah}”(h]”h ]”j_ah"]”h$]”h&]”uh1jRhjûubj)”}”(hŒ ”h]”hŒ ”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”j#ah"]”h$]”h&]”uh1jhjûubjS)”}”(hjsh]”hŒstruct”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”j_ah"]”h$]”h&]”uh1jRhjûubj)”}”(hŒ ”h]”hŒ ”…””}”(hj'hžhhŸNh Nubah}”(h]”h ]”j#ah"]”h$]”h&]”uh1jhjûubh)”}”(hhh]”j.)”}”(hŒcb_id”h]”hŒcb_id”…””}”(hj8hžhhŸNh Nubah}”(h]”h ]”j:ah"]”h$]”h&]”uh1j-hj5ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”j¥Œreftype”j§Œ reftarget”j:Œmodname”NŒ classname”Nj«j®)”}”j±]”j´)”}”j§jåsbŒc.cn_del_callback”†”asbuh1hhjûubj)”}”(hŒ ”h]”hŒ ”…””}”(hjXhžhhŸNh Nubah}”(h]”h ]”j#ah"]”h$]”h&]”uh1jhjûubjÈ)”}”(hjËh]”hŒ*”…””}”(hjfhžhhŸNh Nubah}”(h]”h ]”jÔah"]”h$]”h&]”uh1jÇhjûubj.)”}”(hŒid”h]”hŒid”…””}”(hjshžhhŸNh Nubah}”(h]”h ]”j:ah"]”h$]”h&]”uh1j-hjûubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆh±h²uh1jLhj÷ubah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1jFhj¾hžhhŸjÐh KJubeh}”(h]”h ]”h"]”h$]”h&]”h±h²j|ˆuh1jþj}j~hjºhžhhŸjÐh KJubah}”(h]”jµah ]”(j‚jƒeh"]”h$]”h&]”j‡ˆjˆ)j‰huh1jøhŸjÐh KJhj·hžhubj‹)”}”(hhh]”hÊ)”}”(hŒ-Unregisters new callback with connector core.”h]”hŒ-Unregisters new callback with connector core.”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸŒ^/var/lib/git/docbuild/linux/Documentation/driver-api/connector:59: ./include/linux/connector.h”h KFhjšhžhubah}”(h]”h ]”h"]”h$]”h&]”uh1jŠhj·hžhhŸjÐh KJubeh}”(h]”h ]”(j¥Œfunction”eh"]”h$]”h&]”j«j¥j¬jµjjµj®‰j¯‰j°‰uh1jóhžhhjÞubj²)”}”(hŒP**Parameters** ``const struct cb_id *id`` unique connector's user identifier.”h]”(hÊ)”}”(hŒ**Parameters**”h]”j¼)”}”(hj¿h]”hŒ Parameters”…””}”(hjÁhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j»hj½ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸŒ^/var/lib/git/docbuild/linux/Documentation/driver-api/connector:59: ./include/linux/connector.h”h KJhj¹ubjÒ)”}”(hhh]”j×)”}”(hŒ>``const struct cb_id *id`` unique connector's user identifier.”h]”(jÝ)”}”(hŒ``const struct cb_id *id``”h]”jã)”}”(hjÞh]”hŒconst struct cb_id *id”…””}”(hjàhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhjÜubah}”(h]”h ]”h"]”h$]”h&]”uh1jÜhŸŒ^/var/lib/git/docbuild/linux/Documentation/driver-api/connector:59: ./include/linux/connector.h”h KLhjØubjù)”}”(hhh]”hÊ)”}”(hŒ#unique connector's user identifier.”h]”hŒ%unique connectorâ€™s user identifier.”…””}”(hj÷hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸŒ^/var/lib/git/docbuild/linux/Documentation/driver-api/connector:59: ./include/linux/connector.h”h KHhjôubah}”(h]”h ]”h"]”h$]”h&]”uh1jøhjØubeh}”(h]”h ]”h"]”h$]”h&]”uh1jÖhŸjóh KLhjÕubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhj¹ubeh}”(h]”h ]”Œkernelindent”ah"]”h$]”h&]”uh1j±hjÞubjã)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œentries”]”(jïŒ!cn_netlink_send_mult (C function)”Œc.cn_netlink_send_mult”hNt”auh1jâhjÞubjô)”}”(hhh]”(jù)”}”(hŒŠint cn_netlink_send_mult (struct cn_msg *msg, u16 len, u32 portid, u32 group, gfp_t gfp_mask, netlink_filter_fn filter, void *filter_data)”h]”jÿ)”}”(hŒ‰int cn_netlink_send_mult(struct cn_msg *msg, u16 len, u32 portid, u32 group, gfp_t gfp_mask, netlink_filter_fn filter, void *filter_data)”h]”(j)”}”(hŒint”h]”hŒint”…””}”(hj8hžhhŸNh Nubah}”(h]”h ]”jah"]”h$]”h&]”uh1jhj4hžhhŸŒ^/var/lib/git/docbuild/linux/Documentation/driver-api/connector:59: ./include/linux/connector.h”h Keubj)”}”(hŒ ”h]”hŒ ”…””}”(hjGhžhhŸNh Nubah}”(h]”h ]”j#ah"]”h$]”h&]”uh1jhj4hžhhŸjFh Keubj()”}”(hŒcn_netlink_send_mult”h]”j.)”}”(hŒcn_netlink_send_mult”h]”hŒcn_netlink_send_mult”…””}”(hjYhžhhŸNh Nubah}”(h]”h ]”j:ah"]”h$]”h&]”uh1j-hjUubah}”(h]”h ]”(jAjBeh"]”h$]”h&]”h±h²uh1j'hj4hžhhŸjFh KeubjG)”}”(hŒq(struct cn_msg *msg, u16 len, u32 portid, u32 group, gfp_t gfp_mask, netlink_filter_fn filter, void *filter_data)”h]”(jM)”}”(hŒstruct cn_msg *msg”h]”(jS)”}”(hjsh]”hŒstruct”…””}”(hjuhžhhŸNh Nubah}”(h]”h ]”j_ah"]”h$]”h&]”uh1jRhjqubj)”}”(hŒ ”h]”hŒ ”…””}”(hj‚hžhhŸNh Nubah}”(h]”h ]”j#ah"]”h$]”h&]”uh1jhjqubh)”}”(hhh]”j.)”}”(hŒcn_msg”h]”hŒcn_msg”…””}”(hj“hžhhŸNh Nubah}”(h]”h ]”j:ah"]”h$]”h&]”uh1j-hjubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”j¥Œreftype”j§Œ reftarget”j•Œmodname”NŒ classname”Nj«j®)”}”j±]”j´)”}”j§j[sbŒc.cn_netlink_send_mult”†”asbuh1hhjqubj)”}”(hŒ ”h]”hŒ ”…””}”(hj³hžhhŸNh Nubah}”(h]”h ]”j#ah"]”h$]”h&]”uh1jhjqubjÈ)”}”(hjËh]”hŒ*”…””}”(hjÁhžhhŸNh Nubah}”(h]”h ]”jÔah"]”h$]”h&]”uh1jÇhjqubj.)”}”(hŒmsg”h]”hŒmsg”…””}”(hjÎhžhhŸNh Nubah}”(h]”h ]”j:ah"]”h$]”h&]”uh1j-hjqubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆh±h²uh1jLhjmubjM)”}”(hŒu16 len”h]”(h)”}”(hhh]”j.)”}”(hŒu16”h]”hŒu16”…””}”(hjêhžhhŸNh Nubah}”(h]”h ]”j:ah"]”h$]”h&]”uh1j-hjçubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”j¥Œreftype”j§Œ reftarget”jìŒmodname”NŒ classname”Nj«j®)”}”j±]”j¯Œc.cn_netlink_send_mult”†”asbuh1hhjãubj)”}”(hŒ ”h]”hŒ ”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”j#ah"]”h$]”h&]”uh1jhjãubj.)”}”(hŒlen”h]”hŒlen”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”j:ah"]”h$]”h&]”uh1j-hjãubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆh±h²uh1jLhjmubjM)”}”(hŒ u32 portid”h]”(h)”}”(hhh]”j.)”}”(hŒu32”h]”hŒu32”…””}”(hj2hžhhŸNh Nubah}”(h]”h ]”j:ah"]”h$]”h&]”uh1j-hj/ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”j¥Œreftype”j§Œ reftarget”j4Œmodname”NŒ classname”Nj«j®)”}”j±]”j¯Œc.cn_netlink_send_mult”†”asbuh1hhj+ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjPhžhhŸNh Nubah}”(h]”h ]”j#ah"]”h$]”h&]”uh1jhj+ubj.)”}”(hŒportid”h]”hŒportid”…””}”(hj^hžhhŸNh Nubah}”(h]”h ]”j:ah"]”h$]”h&]”uh1j-hj+ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆh±h²uh1jLhjmubjM)”}”(hŒ u32 group”h]”(h)”}”(hhh]”j.)”}”(hŒu32”h]”hŒu32”…””}”(hjzhžhhŸNh Nubah}”(h]”h ]”j:ah"]”h$]”h&]”uh1j-hjwubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”j¥Œreftype”j§Œ reftarget”j|Œmodname”NŒ classname”Nj«j®)”}”j±]”j¯Œc.cn_netlink_send_mult”†”asbuh1hhjsubj)”}”(hŒ ”h]”hŒ ”…””}”(hj˜hžhhŸNh Nubah}”(h]”h ]”j#ah"]”h$]”h&]”uh1jhjsubj.)”}”(hŒgroup”h]”hŒgroup”…””}”(hj¦hžhhŸNh Nubah}”(h]”h ]”j:ah"]”h$]”h&]”uh1j-hjsubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆh±h²uh1jLhjmubjM)”}”(hŒgfp_t gfp_mask”h]”(h)”}”(hhh]”j.)”}”(hŒgfp_t”h]”hŒgfp_t”…””}”(hjÂhžhhŸNh Nubah}”(h]”h ]”j:ah"]”h$]”h&]”uh1j-hj¿ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”j¥Œreftype”j§Œ reftarget”jÄŒmodname”NŒ classname”Nj«j®)”}”j±]”j¯Œc.cn_netlink_send_mult”†”asbuh1hhj»ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjàhžhhŸNh Nubah}”(h]”h ]”j#ah"]”h$]”h&]”uh1jhj»ubj.)”}”(hŒgfp_mask”h]”hŒgfp_mask”…””}”(hjîhžhhŸNh Nubah}”(h]”h ]”j:ah"]”h$]”h&]”uh1j-hj»ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆh±h²uh1jLhjmubjM)”}”(hŒnetlink_filter_fn filter”h]”(h)”}”(hhh]”j.)”}”(hŒnetlink_filter_fn”h]”hŒnetlink_filter_fn”…””}”(hj hžhhŸNh Nubah}”(h]”h ]”j:ah"]”h$]”h&]”uh1j-hj ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”j¥Œreftype”j§Œ reftarget”j Œmodname”NŒ classname”Nj«j®)”}”j±]”j¯Œc.cn_netlink_send_mult”†”asbuh1hhj ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj( hžhhŸNh Nubah}”(h]”h ]”j#ah"]”h$]”h&]”uh1jhj ubj.)”}”(hŒfilter”h]”hŒfilter”…””}”(hj6 hžhhŸNh Nubah}”(h]”h ]”j:ah"]”h$]”h&]”uh1j-hj ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆh±h²uh1jLhjmubjM)”}”(hŒvoid *filter_data”h]”(j)”}”(hŒvoid”h]”hŒvoid”…””}”(hjO hžhhŸNh Nubah}”(h]”h ]”jah"]”h$]”h&]”uh1jhjK ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj] hžhhŸNh Nubah}”(h]”h ]”j#ah"]”h$]”h&]”uh1jhjK ubjÈ)”}”(hjËh]”hŒ*”…””}”(hjk hžhhŸNh Nubah}”(h]”h ]”jÔah"]”h$]”h&]”uh1jÇhjK ubj.)”}”(hŒfilter_data”h]”hŒfilter_data”…””}”(hjx hžhhŸNh Nubah}”(h]”h ]”j:ah"]”h$]”h&]”uh1j-hjK ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆh±h²uh1jLhjmubeh}”(h]”h ]”h"]”h$]”h&]”h±h²uh1jFhj4hžhhŸjFh Keubeh}”(h]”h ]”h"]”h$]”h&]”h±h²j|ˆuh1jþj}j~hj0hžhhŸjFh Keubah}”(h]”j+ah ]”(j‚jƒeh"]”h$]”h&]”j‡ˆjˆ)j‰huh1jøhŸjFh Kehj-hžhubj‹)”}”(hhh]”hÊ)”}”(hŒ&Sends message to the specified groups.”h]”hŒ&Sends message to the specified groups.”…””}”(hj¢ hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸŒ^/var/lib/git/docbuild/linux/Documentation/driver-api/connector:59: ./include/linux/connector.h”h KNhjŸ hžhubah}”(h]”h ]”h"]”h$]”h&]”uh1jŠhj-hžhhŸjFh Keubeh}”(h]”h ]”(j¥Œfunction”eh"]”h$]”h&]”j«j¥j¬jº jjº j®‰j¯‰j°‰uh1jóhžhhjÞubj²)”}”(hXÔ**Parameters** ``struct cn_msg *msg`` message header(with attached data). ``u16 len`` Number of **msg** to be sent. ``u32 portid`` 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 **portid** 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**. If **group** is not zero, then message will be delivered to the specified group. ``gfp_t gfp_mask`` GFP mask. ``netlink_filter_fn filter`` Filter function to be used at netlink layer. ``void *filter_data`` Filter data to be supplied to the filter function **Description** 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.”h]”(hÊ)”}”(hŒ**Parameters**”h]”j¼)”}”(hjÄ h]”hŒ Parameters”…””}”(hjÆ hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j»hjÂ ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸŒ^/var/lib/git/docbuild/linux/Documentation/driver-api/connector:59: ./include/linux/connector.h”h KRhj¾ ubjÒ)”}”(hhh]”(j×)”}”(hŒ;``struct cn_msg *msg`` message header(with attached data). ”h]”(jÝ)”}”(hŒ``struct cn_msg *msg``”h]”jã)”}”(hjã h]”hŒstruct cn_msg *msg”…””}”(hjå hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhjá ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÜhŸŒ^/var/lib/git/docbuild/linux/Documentation/driver-api/connector:59: ./include/linux/connector.h”h KPhjÝ ubjù)”}”(hhh]”hÊ)”}”(hŒ#message header(with attached data).”h]”hŒ#message header(with attached data).”…””}”(hjü hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸjø h KPhjù ubah}”(h]”h ]”h"]”h$]”h&]”uh1jøhjÝ ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jÖhŸjø h KPhjÚ ubj×)”}”(hŒ*``u16 len`` Number of **msg** to be sent. ”h]”(jÝ)”}”(hŒ``u16 len``”h]”jã)”}”(hj h]”hŒu16 len”…””}”(hj hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhj ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÜhŸŒ^/var/lib/git/docbuild/linux/Documentation/driver-api/connector:59: ./include/linux/connector.h”h KQhj ubjù)”}”(hhh]”hÊ)”}”(hŒNumber of **msg** to be sent.”h]”(hŒ Number of ”…””}”(hj5 hžhhŸNh Nubj¼)”}”(hŒ**msg**”h]”hŒmsg”…””}”(hj= hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j»hj5 ubhŒ to be sent.”…””}”(hj5 hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸj1 h KQhj2 ubah}”(h]”h ]”h"]”h$]”h&]”uh1jøhj ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jÖhŸj1 h KQhjÚ ubj×)”}”(hŒ…``u32 portid`` destination port. If non-zero the message will be sent to the given port, which should be set to the original sender. ”h]”(jÝ)”}”(hŒ``u32 portid``”h]”jã)”}”(hjg h]”hŒ u32 portid”…””}”(hji hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhje ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÜhŸŒ^/var/lib/git/docbuild/linux/Documentation/driver-api/connector:59: ./include/linux/connector.h”h KThja ubjù)”}”(hhh]”hÊ)”}”(hŒudestination port. If non-zero the message will be sent to the given port, which should be set to the original sender.”h]”hŒudestination port. If non-zero the message will be sent to the given port, which should be set to the original sender.”…””}”(hj€ hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸŒ^/var/lib/git/docbuild/linux/Documentation/driver-api/connector:59: ./include/linux/connector.h”h KRhj} ubah}”(h]”h ]”h"]”h$]”h&]”uh1jøhja ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jÖhŸj| h KThjÚ ubj×)”}”(hXM``u32 group`` destination group. If **portid** 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**. If **group** is not zero, then message will be delivered to the specified group. ”h]”(jÝ)”}”(hŒ ``u32 group``”h]”jã)”}”(hj¡ h]”hŒ u32 group”…””}”(hj£ hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhjŸ ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÜhŸŒ^/var/lib/git/docbuild/linux/Documentation/driver-api/connector:59: ./include/linux/connector.h”h K[hj› ubjù)”}”(hhh]”hÊ)”}”(hX>destination group. If **portid** 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**. If **group** is not zero, then message will be delivered to the specified group.”h]”(hŒdestination group. If ”…””}”(hjº hžhhŸNh Nubj¼)”}”(hŒ **portid**”h]”hŒportid”…””}”(hjÂ hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j»hjº ubhŒ and ”…””}”(hjº hžhhŸNh Nubj¼)”}”(hŒ **group**”h]”hŒgroup”…””}”(hjÔ hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j»hjº ubhŒ· 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 ”…””}”(hjº hžhhŸNh Nubj¼)”}”(hŒ**msg**”h]”hŒmsg”…””}”(hjæ hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j»hjº ubhŒ. If ”…””}”(hjº hžhhŸNh Nubj¼)”}”(hŒ **group**”h]”hŒgroup”…””}”(hjø hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j»hjº ubhŒD is not zero, then message will be delivered to the specified group.”…””}”(hjº hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸŒ^/var/lib/git/docbuild/linux/Documentation/driver-api/connector:59: ./include/linux/connector.h”h KUhj· ubah}”(h]”h ]”h"]”h$]”h&]”uh1jøhj› ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jÖhŸj¶ h K[hjÚ ubj×)”}”(hŒ``gfp_t gfp_mask`` GFP mask. ”h]”(jÝ)”}”(hŒ``gfp_t gfp_mask``”h]”jã)”}”(hj#h]”hŒgfp_t gfp_mask”…””}”(hj%hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhj!ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÜhŸŒ^/var/lib/git/docbuild/linux/Documentation/driver-api/connector:59: ./include/linux/connector.h”h K\hjubjù)”}”(hhh]”hÊ)”}”(hŒ GFP mask.”h]”hŒ GFP mask.”…””}”(hj<hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸj8h K\hj9ubah}”(h]”h ]”h"]”h$]”h&]”uh1jøhjubeh}”(h]”h ]”h"]”h$]”h&]”uh1jÖhŸj8h K\hjÚ ubj×)”}”(hŒJ``netlink_filter_fn filter`` Filter function to be used at netlink layer. ”h]”(jÝ)”}”(hŒ``netlink_filter_fn filter``”h]”jã)”}”(hj\h]”hŒnetlink_filter_fn filter”…””}”(hj^hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhjZubah}”(h]”h ]”h"]”h$]”h&]”uh1jÜhŸŒ^/var/lib/git/docbuild/linux/Documentation/driver-api/connector:59: ./include/linux/connector.h”h K]hjVubjù)”}”(hhh]”hÊ)”}”(hŒ,Filter function to be used at netlink layer.”h]”hŒ,Filter function to be used at netlink layer.”…””}”(hjuhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸjqh K]hjrubah}”(h]”h ]”h"]”h$]”h&]”uh1jøhjVubeh}”(h]”h ]”h"]”h$]”h&]”uh1jÖhŸjqh K]hjÚ ubj×)”}”(hŒH``void *filter_data`` Filter data to be supplied to the filter function ”h]”(jÝ)”}”(hŒ``void *filter_data``”h]”jã)”}”(hj•h]”hŒvoid *filter_data”…””}”(hj—hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhj“ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÜhŸŒ^/var/lib/git/docbuild/linux/Documentation/driver-api/connector:59: ./include/linux/connector.h”h K^hjubjù)”}”(hhh]”hÊ)”}”(hŒ1Filter data to be supplied to the filter function”h]”hŒ1Filter data to be supplied to the filter function”…””}”(hj®hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸjªh K^hj«ubah}”(h]”h ]”h"]”h$]”h&]”uh1jøhjubeh}”(h]”h ]”h"]”h$]”h&]”uh1jÖhŸjªh K^hjÚ ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jÑhj¾ ubhÊ)”}”(hŒ**Description**”h]”j¼)”}”(hjÐh]”hŒDescription”…””}”(hjÒhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j»hjÎubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸŒ^/var/lib/git/docbuild/linux/Documentation/driver-api/connector:59: ./include/linux/connector.h”h K`hj¾ ubhÊ)”}”(hŒaIt can be safely called from softirq context, but may silently fail under strong memory pressure.”h]”hŒaIt can be safely called from softirq context, but may silently fail under strong memory pressure.”…””}”(hjæhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸŒ^/var/lib/git/docbuild/linux/Documentation/driver-api/connector:59: ./include/linux/connector.h”h K`hj¾ ubhÊ)”}”(hŒEIf there are no listeners for given group ``-ESRCH`` can be returned.”h]”(hŒ*If there are no listeners for given group ”…””}”(hjõhžhhŸNh Nubjã)”}”(hŒ ``-ESRCH``”h]”hŒ-ESRCH”…””}”(hjýhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhjõubhŒ can be returned.”…””}”(hjõhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸŒ^/var/lib/git/docbuild/linux/Documentation/driver-api/connector:59: ./include/linux/connector.h”h Kchj¾ ubeh}”(h]”h ]”Œkernelindent”ah"]”h$]”h&]”uh1j±hjÞubjã)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œentries”]”(jïŒcn_netlink_send (C function)”Œc.cn_netlink_send”hNt”auh1jâhjÞubjô)”}”(hhh]”(jù)”}”(hŒOint cn_netlink_send (struct cn_msg *msg, u32 portid, u32 group, gfp_t gfp_mask)”h]”jÿ)”}”(hŒNint cn_netlink_send(struct cn_msg *msg, u32 portid, u32 group, gfp_t gfp_mask)”h]”(j)”}”(hŒint”h]”hŒint”…””}”(hj6hžhhŸNh Nubah}”(h]”h ]”jah"]”h$]”h&]”uh1jhj2hžhhŸŒ^/var/lib/git/docbuild/linux/Documentation/driver-api/connector:59: ./include/linux/connector.h”h Kubj)”}”(hŒ ”h]”hŒ ”…””}”(hjEhžhhŸNh Nubah}”(h]”h ]”j#ah"]”h$]”h&]”uh1jhj2hžhhŸjDh Kubj()”}”(hŒcn_netlink_send”h]”j.)”}”(hŒcn_netlink_send”h]”hŒcn_netlink_send”…””}”(hjWhžhhŸNh Nubah}”(h]”h ]”j:ah"]”h$]”h&]”uh1j-hjSubah}”(h]”h ]”(jAjBeh"]”h$]”h&]”h±h²uh1j'hj2hžhhŸjDh KubjG)”}”(hŒ;(struct cn_msg *msg, u32 portid, u32 group, gfp_t gfp_mask)”h]”(jM)”}”(hŒstruct cn_msg *msg”h]”(jS)”}”(hjsh]”hŒstruct”…””}”(hjshžhhŸNh Nubah}”(h]”h ]”j_ah"]”h$]”h&]”uh1jRhjoubj)”}”(hŒ ”h]”hŒ ”…””}”(hj€hžhhŸNh Nubah}”(h]”h ]”j#ah"]”h$]”h&]”uh1jhjoubh)”}”(hhh]”j.)”}”(hŒcn_msg”h]”hŒcn_msg”…””}”(hj‘hžhhŸNh Nubah}”(h]”h ]”j:ah"]”h$]”h&]”uh1j-hjŽubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”j¥Œreftype”j§Œ reftarget”j“Œmodname”NŒ classname”Nj«j®)”}”j±]”j´)”}”j§jYsbŒc.cn_netlink_send”†”asbuh1hhjoubj)”}”(hŒ ”h]”hŒ ”…””}”(hj±hžhhŸNh Nubah}”(h]”h ]”j#ah"]”h$]”h&]”uh1jhjoubjÈ)”}”(hjËh]”hŒ*”…””}”(hj¿hžhhŸNh Nubah}”(h]”h ]”jÔah"]”h$]”h&]”uh1jÇhjoubj.)”}”(hŒmsg”h]”hŒmsg”…””}”(hjÌhžhhŸNh Nubah}”(h]”h ]”j:ah"]”h$]”h&]”uh1j-hjoubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆh±h²uh1jLhjkubjM)”}”(hŒ u32 portid”h]”(h)”}”(hhh]”j.)”}”(hŒu32”h]”hŒu32”…””}”(hjèhžhhŸNh Nubah}”(h]”h ]”j:ah"]”h$]”h&]”uh1j-hjåubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”j¥Œreftype”j§Œ reftarget”jêŒmodname”NŒ classname”Nj«j®)”}”j±]”jŒc.cn_netlink_send”†”asbuh1hhjáubj)”}”(hŒ ”h]”hŒ ”…””}”(hj hžhhŸNh Nubah}”(h]”h ]”j#ah"]”h$]”h&]”uh1jhjáubj.)”}”(hŒportid”h]”hŒportid”…””}”(hj hžhhŸNh Nubah}”(h]”h ]”j:ah"]”h$]”h&]”uh1j-hjáubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆh±h²uh1jLhjkubjM)”}”(hŒ u32 group”h]”(h)”}”(hhh]”j.)”}”(hŒu32”h]”hŒu32”…””}”(hj0 hžhhŸNh Nubah}”(h]”h ]”j:ah"]”h$]”h&]”uh1j-hj- ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”j¥Œreftype”j§Œ reftarget”j2 Œmodname”NŒ classname”Nj«j®)”}”j±]”jŒc.cn_netlink_send”†”asbuh1hhj) ubj)”}”(hŒ ”h]”hŒ ”…””}”(hjN hžhhŸNh Nubah}”(h]”h ]”j#ah"]”h$]”h&]”uh1jhj) ubj.)”}”(hŒgroup”h]”hŒgroup”…””}”(hj\ hžhhŸNh Nubah}”(h]”h ]”j:ah"]”h$]”h&]”uh1j-hj) ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆh±h²uh1jLhjkubjM)”}”(hŒgfp_t gfp_mask”h]”(h)”}”(hhh]”j.)”}”(hŒgfp_t”h]”hŒgfp_t”…””}”(hjx hžhhŸNh Nubah}”(h]”h ]”j:ah"]”h$]”h&]”uh1j-hju ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”j¥Œreftype”j§Œ reftarget”jz Œmodname”NŒ classname”Nj«j®)”}”j±]”jŒc.cn_netlink_send”†”asbuh1hhjq ubj)”}”(hŒ ”h]”hŒ ”…””}”(hj– hžhhŸNh Nubah}”(h]”h ]”j#ah"]”h$]”h&]”uh1jhjq ubj.)”}”(hŒgfp_mask”h]”hŒgfp_mask”…””}”(hj¤ hžhhŸNh Nubah}”(h]”h ]”j:ah"]”h$]”h&]”uh1j-hjq ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆh±h²uh1jLhjkubeh}”(h]”h ]”h"]”h$]”h&]”h±h²uh1jFhj2hžhhŸjDh Kubeh}”(h]”h ]”h"]”h$]”h&]”h±h²j|ˆuh1jþj}j~hj.hžhhŸjDh Kubah}”(h]”j)ah ]”(j‚jƒeh"]”h$]”h&]”j‡ˆjˆ)j‰huh1jøhŸjDh Khj+hžhubj‹)”}”(hhh]”hÊ)”}”(hŒ&Sends message to the specified groups.”h]”hŒ&Sends message to the specified groups.”…””}”(hjÎ hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸŒ^/var/lib/git/docbuild/linux/Documentation/driver-api/connector:59: ./include/linux/connector.h”h KkhjË hžhubah}”(h]”h ]”h"]”h$]”h&]”uh1jŠhj+hžhhŸjDh Kubeh}”(h]”h ]”(j¥Œfunction”eh"]”h$]”h&]”j«j¥j¬jæ jjæ j®‰j¯‰j°‰uh1jóhžhhjÞubj²)”}”(hX**Parameters** ``struct cn_msg *msg`` message header(with attached data). ``u32 portid`` 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 **portid** 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**. If **group** is not zero, then message will be delivered to the specified group. ``gfp_t gfp_mask`` GFP mask. **Description** 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.”h]”(hÊ)”}”(hŒ**Parameters**”h]”j¼)”}”(hjð h]”hŒ Parameters”…””}”(hjò hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j»hjî ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸŒ^/var/lib/git/docbuild/linux/Documentation/driver-api/connector:59: ./include/linux/connector.h”h Kohjê ubjÒ)”}”(hhh]”(j×)”}”(hŒ;``struct cn_msg *msg`` message header(with attached data). ”h]”(jÝ)”}”(hŒ``struct cn_msg *msg``”h]”jã)”}”(hjh]”hŒstruct cn_msg *msg”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhj ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÜhŸŒ^/var/lib/git/docbuild/linux/Documentation/driver-api/connector:59: ./include/linux/connector.h”h Kmhj ubjù)”}”(hhh]”hÊ)”}”(hŒ#message header(with attached data).”h]”hŒ#message header(with attached data).”…””}”(hj(hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸj$h Kmhj%ubah}”(h]”h ]”h"]”h$]”h&]”uh1jøhj ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jÖhŸj$h Kmhjubj×)”}”(hŒ…``u32 portid`` destination port. If non-zero the message will be sent to the given port, which should be set to the original sender. ”h]”(jÝ)”}”(hŒ``u32 portid``”h]”jã)”}”(hjHh]”hŒ u32 portid”…””}”(hjJhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhjFubah}”(h]”h ]”h"]”h$]”h&]”uh1jÜhŸŒ^/var/lib/git/docbuild/linux/Documentation/driver-api/connector:59: ./include/linux/connector.h”h KphjBubjù)”}”(hhh]”hÊ)”}”(hŒudestination port. If non-zero the message will be sent to the given port, which should be set to the original sender.”h]”hŒudestination port. If non-zero the message will be sent to the given port, which should be set to the original sender.”…””}”(hjahžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸŒ^/var/lib/git/docbuild/linux/Documentation/driver-api/connector:59: ./include/linux/connector.h”h Knhj^ubah}”(h]”h ]”h"]”h$]”h&]”uh1jøhjBubeh}”(h]”h ]”h"]”h$]”h&]”uh1jÖhŸj]h Kphjubj×)”}”(hXM``u32 group`` destination group. If **portid** 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**. If **group** is not zero, then message will be delivered to the specified group. ”h]”(jÝ)”}”(hŒ ``u32 group``”h]”jã)”}”(hj‚h]”hŒ u32 group”…””}”(hj„hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhj€ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÜhŸŒ^/var/lib/git/docbuild/linux/Documentation/driver-api/connector:59: ./include/linux/connector.h”h Kwhj|ubjù)”}”(hhh]”hÊ)”}”(hX>destination group. If **portid** 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**. If **group** is not zero, then message will be delivered to the specified group.”h]”(hŒdestination group. If ”…””}”(hj›hžhhŸNh Nubj¼)”}”(hŒ **portid**”h]”hŒportid”…””}”(hj£hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j»hj›ubhŒ and ”…””}”(hj›hžhhŸNh Nubj¼)”}”(hŒ **group**”h]”hŒgroup”…””}”(hjµhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j»hj›ubhŒ· 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 ”…””}”(hj›hžhhŸNh Nubj¼)”}”(hŒ**msg**”h]”hŒmsg”…””}”(hjÇhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j»hj›ubhŒ. If ”…””}”(hj›hžhhŸNh Nubj¼)”}”(hŒ **group**”h]”hŒgroup”…””}”(hjÙhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j»hj›ubhŒD is not zero, then message will be delivered to the specified group.”…””}”(hj›hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸŒ^/var/lib/git/docbuild/linux/Documentation/driver-api/connector:59: ./include/linux/connector.h”h Kqhj˜ubah}”(h]”h ]”h"]”h$]”h&]”uh1jøhj|ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jÖhŸj—h Kwhjubj×)”}”(hŒ``gfp_t gfp_mask`` GFP mask. ”h]”(jÝ)”}”(hŒ``gfp_t gfp_mask``”h]”jã)”}”(hjh]”hŒgfp_t gfp_mask”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhjubah}”(h]”h ]”h"]”h$]”h&]”uh1jÜhŸŒ^/var/lib/git/docbuild/linux/Documentation/driver-api/connector:59: ./include/linux/connector.h”h Kxhjþubjù)”}”(hhh]”hÊ)”}”(hŒ GFP mask.”h]”hŒ GFP mask.”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸjh Kxhjubah}”(h]”h ]”h"]”h$]”h&]”uh1jøhjþubeh}”(h]”h ]”h"]”h$]”h&]”uh1jÖhŸjh Kxhjubeh}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjê ubhÊ)”}”(hŒ**Description**”h]”j¼)”}”(hj?h]”hŒDescription”…””}”(hjAhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j»hj=ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸŒ^/var/lib/git/docbuild/linux/Documentation/driver-api/connector:59: ./include/linux/connector.h”h Kzhjê ubhÊ)”}”(hŒaIt can be safely called from softirq context, but may silently fail under strong memory pressure.”h]”hŒaIt can be safely called from softirq context, but may silently fail under strong memory pressure.”…””}”(hjUhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸŒ^/var/lib/git/docbuild/linux/Documentation/driver-api/connector:59: ./include/linux/connector.h”h Kzhjê ubhÊ)”}”(hŒEIf there are no listeners for given group ``-ESRCH`` can be returned.”h]”(hŒ*If there are no listeners for given group ”…””}”(hjdhžhhŸNh Nubjã)”}”(hŒ ``-ESRCH``”h]”hŒ-ESRCH”…””}”(hjlhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhjdubhŒ can be returned.”…””}”(hjdhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸŒ^/var/lib/git/docbuild/linux/Documentation/driver-api/connector:59: ./include/linux/connector.h”h K}hjê ubeh}”(h]”h ]”Œkernelindent”ah"]”h$]”h&]”uh1j±hjÞubjÒ)”}”(hhh]”j×)”}”(hŒyNote: When registering new callback user, connector core assigns netlink group to the user which is equal to its id.idx. ”h]”(jÝ)”}”(hŒNote:”h]”hŒNote:”…””}”(hj“hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÜhŸh³h K?hjubjù)”}”(hhh]”hÊ)”}”(hŒrWhen registering new callback user, connector core assigns netlink group to the user which is equal to its id.idx.”h]”hŒrWhen registering new callback user, connector core assigns netlink group to the user which is equal to its id.idx.”…””}”(hj¤hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K>hj¡ubah}”(h]”h ]”h"]”h$]”h&]”uh1jøhjubeh}”(h]”h ]”h"]”h$]”h&]”uh1jÖhŸh³h K?hjŒubah}”(h]”h ]”h"]”h$]”h&]”uh1jÑhjÞubeh}”(h]”h ]”h"]”h$]”h&]”uh1hõhŸh³h K;hjÍhžhubeh}”(h]”Œconnector-interfaces”ah ]”h"]”Œconnector interfaces”ah$]”h&]”uh1h´hh¶hžhhŸh³h K9ubhµ)”}”(hhh]”(hº)”}”(hŒProtocol description”h]”hŒProtocol description”…””}”(hjÕhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hjÒhžhhŸh³h KBubhÊ)”}”(hŒ†The current framework offers a transport layer with fixed headers. The recommended protocol which uses such a header is as following:”h]”hŒ†The current framework offers a transport layer with fixed headers. The recommended protocol which uses such a header is as following:”…””}”(hjãhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KDhjÒhžhubhÊ)”}”(hŒàmsg->seq and msg->ack are used to determine message genealogy. When someone sends a message, they use a locally unique sequence and random acknowledge number. The sequence number may be copied into nlmsghdr->nlmsg_seq too.”h]”hŒàmsg->seq and msg->ack are used to determine message genealogy. When someone sends a message, they use a locally unique sequence and random acknowledge number. The sequence number may be copied into nlmsghdr->nlmsg_seq too.”…””}”(hjñhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KGhjÒhžhubhÊ)”}”(hŒ:The sequence number is incremented with each message sent.”h]”hŒ:The sequence number is incremented with each message sent.”…””}”(hjÿhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KLhjÒhžhubhÊ)”}”(hŒ´If you expect a reply to the message, then the sequence number in the received message MUST be the same as in the original message, and the acknowledge number MUST be the same + 1.”h]”hŒ´If you expect a reply to the message, then the sequence number in the received message MUST be the same as in the original message, and the acknowledge number MUST be the same + 1.”…””}”(hj hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KNhjÒhžhubhÊ)”}”(hX4If we receive a message and its sequence number is not equal to one we are expecting, then it is a new message. If we receive a message and its sequence number is the same as one we are expecting, but its acknowledge is not equal to the sequence number in the original message + 1, then it is a new message.”h]”hX4If we receive a message and its sequence number is not equal to one we are expecting, then it is a new message. If we receive a message and its sequence number is the same as one we are expecting, but its acknowledge is not equal to the sequence number in the original message + 1, then it is a new message.”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KRhjÒhžhubhÊ)”}”(hŒ5Obviously, the protocol header contains the above id.”h]”hŒ5Obviously, the protocol header contains the above id.”…””}”(hj)hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KXhjÒhžhubhÊ)”}”(hXDThe connector allows event notification in the following form: kernel driver or userspace process can ask connector to notify it when selected ids will be turned on or off (registered or unregistered its callback). It is done by sending a special command to the connector driver (it also registers itself with id={-1, -1}).”h]”hXDThe connector allows event notification in the following form: kernel driver or userspace process can ask connector to notify it when selected ids will be turned on or off (registered or unregistered its callback). It is done by sending a special command to the connector driver (it also registers itself with id={-1, -1}).”…””}”(hj7hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KZhjÒhžhubhÊ)”}”(hŒ„As example of this usage can be found in the cn_test.c module which uses the connector to request notification and to send messages.”h]”hŒ„As example of this usage can be found in the cn_test.c module which uses the connector to request notification and to send messages.”…””}”(hjEhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K`hjÒhžhubeh}”(h]”Œprotocol-description”ah ]”h"]”Œprotocol description”ah$]”h&]”uh1h´hh¶hžhhŸh³h KBubhµ)”}”(hhh]”(hº)”}”(hŒReliability”h]”hŒReliability”…””}”(hj^hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hj[hžhhŸh³h KdubhÊ)”}”(hX#Netlink itself is not a reliable protocol. That means that messages can be lost due to memory pressure or process' receiving queue overflowed, so caller is warned that it must be prepared. That is why the struct cn_msg [main connector's message header] contains u32 seq and u32 ack fields.”h]”hX'Netlink itself is not a reliable protocol. That means that messages can be lost due to memory pressure or processâ€™ receiving queue overflowed, so caller is warned that it must be prepared. That is why the struct cn_msg [main connectorâ€™s message header] contains u32 seq and u32 ack fields.”…””}”(hjlhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Kfhj[hžhubeh}”(h]”Œreliability”ah ]”h"]”Œreliability”ah$]”h&]”uh1h´hh¶hžhhŸh³h Kdubhµ)”}”(hhh]”(hº)”}”(hŒUserspace usage”h]”hŒUserspace usage”…””}”(hj…hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hj‚hžhhŸh³h KmubhÊ)”}”(hXX2.6.14 has a new netlink socket implementation, which by default does not allow people to send data to netlink groups other than 1. So, if you wish to use a netlink socket (for example using connector) with a different group number, the userspace application must subscribe to that group first. It can be achieved by the following pseudocode::”h]”hXW2.6.14 has a new netlink socket implementation, which by default does not allow people to send data to netlink groups other than 1. So, if you wish to use a netlink socket (for example using connector) with a different group number, the userspace application must subscribe to that group first. It can be achieved by the following pseudocode:”…””}”(hj“hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Kohj‚hžhubj|)”}”(hXcs = socket(PF_NETLINK, SOCK_DGRAM, NETLINK_CONNECTOR); l_local.nl_family = AF_NETLINK; l_local.nl_groups = 12345; l_local.nl_pid = 0; if (bind(s, (struct sockaddr *)&l_local, sizeof(struct sockaddr_nl)) == -1) { perror("bind"); close(s); return -1; } { int on = l_local.nl_groups; setsockopt(s, 270, 1, &on, sizeof(on)); }”h]”hXcs = socket(PF_NETLINK, SOCK_DGRAM, NETLINK_CONNECTOR); l_local.nl_family = AF_NETLINK; l_local.nl_groups = 12345; l_local.nl_pid = 0; if (bind(s, (struct sockaddr *)&l_local, sizeof(struct sockaddr_nl)) == -1) { perror("bind"); close(s); return -1; } { int on = l_local.nl_groups; setsockopt(s, 270, 1, &on, sizeof(on)); }”…””}”hj¡sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1j{hŸh³h Kuhj‚hžhubhÊ)”}”(hŒÝWhere 270 above is SOL_NETLINK, and 1 is a NETLINK_ADD_MEMBERSHIP socket option. To drop a multicast subscription, one should call the above socket option with the NETLINK_DROP_MEMBERSHIP parameter which is defined as 0.”h]”hŒÝWhere 270 above is SOL_NETLINK, and 1 is a NETLINK_ADD_MEMBERSHIP socket option. To drop a multicast subscription, one should call the above socket option with the NETLINK_DROP_MEMBERSHIP parameter which is defined as 0.”…””}”(hj¯hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K†hj‚hžhubhÊ)”}”(hXm2.6.14 netlink code only allows to select a group which is less or equal to the maximum group number, which is used at netlink_kernel_create() time. In case of connector it is CN_NETLINK_USERS + 0xf, so if you want to use group number 12345, you must increment CN_NETLINK_USERS to that number. Additional 0xf numbers are allocated to be used by non-in-kernel users.”h]”hXm2.6.14 netlink code only allows to select a group which is less or equal to the maximum group number, which is used at netlink_kernel_create() time. In case of connector it is CN_NETLINK_USERS + 0xf, so if you want to use group number 12345, you must increment CN_NETLINK_USERS to that number. Additional 0xf numbers are allocated to be used by non-in-kernel users.”…””}”(hj½hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KŠhj‚hžhubhÊ)”}”(hŒ´Due to this limitation, group 0xffffffff does not work now, so one can not use add/remove connector's group notifications, but as far as I know, only cn_test.c test module used it.”h]”hŒ¶Due to this limitation, group 0xffffffff does not work now, so one can not use add/remove connectorâ€™s group notifications, but as far as I know, only cn_test.c test module used it.”…””}”(hjËhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Khj‚hžhubhÊ)”}”(hŒžSome work in netlink area is still being done, so things can be changed in 2.6.15 timeframe, if it will happen, documentation will be updated for that kernel.”h]”hŒžSome work in netlink area is still being done, so things can be changed in 2.6.15 timeframe, if it will happen, documentation will be updated for that kernel.”…””}”(hjÙhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K”hj‚hžhubeh}”(h]”Œuserspace-usage”ah ]”h"]”Œuserspace usage”ah$]”h&]”uh1h´hh¶hžhhŸh³h Kmubhµ)”}”(hhh]”(hº)”}”(hŒCode samples”h]”hŒCode samples”…””}”(hjòhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hjïhžhhŸh³h K™ubhÊ)”}”(hŒšSample code for a connector test module and user space can be found in samples/connector/. To build this code, enable CONFIG_CONNECTOR and CONFIG_SAMPLES.”h]”hŒšSample code for a connector test module and user space can be found in samples/connector/. To build this code, enable CONFIG_CONNECTOR and CONFIG_SAMPLES.”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K›hjïhžhubeh}”(h]”Œcode-samples”ah ]”h"]”Œcode samples”ah$]”h&]”uh1h´hh¶hžhhŸh³h K™ubeh}”(h]”Œkernel-connector”ah ]”h"]”Œkernel connector”ah$]”h&]”uh1h´hhhžhhŸh³h Kubeh}”(h]”h ]”h"]”h$]”h&]”Œsource”h³uh1hŒcurrent_source”NŒcurrent_line”NŒsettings”Œdocutils.frontend”ŒValues”“”)”}”(h¹NŒ generator”NŒ datestamp”NŒsource_link”NŒ source_url”NŒ toc_backlinks”Œentry”Œfootnote_backlinks”KŒ sectnum_xform”KŒstrip_comments”NŒstrip_elements_with_classes”NŒ strip_classes”NŒreport_level”KŒ halt_level”KŒexit_status_level”KŒdebug”NŒwarning_stream”NŒ traceback”ˆŒinput_encoding”Œ utf-8-sig”Œinput_encoding_error_handler”Œstrict”Œoutput_encoding”Œutf-8”Œoutput_encoding_error_handler”jAŒerror_encoding”Œutf-8”Œerror_encoding_error_handler”Œbackslashreplace”Œ language_code”Œen”Œrecord_dependencies”NŒconfig”NŒ id_prefix”hŒauto_id_prefix”Œid”Œ dump_settings”NŒdump_internals”NŒdump_transforms”NŒdump_pseudo_xml”NŒexpose_internals”NŒstrict_visitor”NŒ_disable_config”NŒ_source”h³Œ_destination”NŒ _config_files”]”Œ7/var/lib/git/docbuild/linux/Documentation/docutils.conf”aŒfile_insertion_enabled”ˆŒraw_enabled”KŒline_length_limit”M'Œpep_references”NŒpep_base_url”Œhttps://peps.python.org/”Œpep_file_url_template”Œpep-%04d”Œrfc_references”NŒrfc_base_url”Œ&https://datatracker.ietf.org/doc/html/”Œ tab_width”KŒtrim_footnote_reference_space”‰Œsyntax_highlight”Œlong”Œsmart_quotes”ˆŒsmartquotes_locales”]”Œcharacter_level_inline_markup”‰Œdoctitle_xform”‰Œ docinfo_xform”KŒsectsubtitle_xform”‰Œ image_loading”Œlink”Œembed_stylesheet”‰Œcloak_email_addresses”ˆŒsection_self_link”‰Œenv”NubŒreporter”NŒindirect_targets”]”Œsubstitution_defs”}”Œsubstitution_names”}”Œrefnames”}”Œrefids”}”Œnameids”}”(jjjÏjÌjXjUjj|jìjéjjuŒ nametypes”}”(j‰jÏ‰jX‰j‰jì‰j‰uh}”(jh¶jÌjÍjñjújµjºj+j0j)j.jUjÒj|j[jéj‚jjïuŒ footnote_refs”}”Œ citation_refs”}”Œ autofootnotes”]”Œautofootnote_refs”]”Œsymbol_footnotes”]”Œsymbol_footnote_refs”]”Œ footnotes”]”Œ citations”]”Œautofootnote_start”KŒsymbol_footnote_start”KŒ id_counter”Œcollections”ŒCounter”“”}”…”R”Œparse_messages”]”Œtransform_messages”]”Œtransformer”NŒinclude_log”]”Œ decoration”Nhžhub.