€•søŒsphinx.addnodes”Œdocument”“”)”}”(Œ rawsource”Œ”Œchildren”]”(Œtranslations”Œ LanguagesNode”“”)”}”(hhh]”(hŒpending_xref”“”)”}”(hhh]”Œdocutils.nodes”ŒText”“”ŒChinese (Simplified)”…””}”(hhŒparent”hubaŒ 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)”…””}”(hhhh2ubah}”(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”…””}”(hhhhFubah}”(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”…””}”(hhhhZubah}”(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”…””}”(hhhhnubah}”(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”…””}”(hhhh‚ubah}”(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”…””}”(hhhh£ubah}”(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½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Í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Û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éhhçhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Khh¶hžhubhŒblock_quote”“”)”}”(hhh]”hŒbullet_list”“”)”}”(hhh]”(hŒ list_item”“”)”}”(hŒ socket();”h]”hÊ)”}”(hjh]”hŒ socket();”…””}”(hjhjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Khjubah}”(h]”h ]”h"]”h$]”h&]”uh1hÿhhüubj)”}”(hŒbind();”h]”hÊ)”}”(hjh]”hŒbind();”…””}”(hjhjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Khjubah}”(h]”h ]”h"]”h$]”h&]”uh1hÿhhüubj)”}”(hŒsend();”h]”hÊ)”}”(hj1h]”hŒsend();”…””}”(hj1hj3hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Khj/ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÿhhüubj)”}”(hŒrecv(); ”h]”hÊ)”}”(hŒrecv();”h]”hŒrecv();”…””}”(hjLhjJhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KhjFubah}”(h]”h ]”h"]”h$]”h&]”uh1hÿhhüubeh}”(h]”h ]”h"]”h$]”h&]”Œbullet”Œ-”uh1húhŸh³h Khh÷ubah}”(h]”h ]”h"]”h$]”h&]”uh1hõhh¶hžhhŸNh NubhÊ)”}”(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:”…””}”(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:”hjlhž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; };”…””}”(hhhj}ubah}”(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. ”…””}”(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 *)”…””}”(hhhj–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 ”…””}”(hŒª 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 *”…””}”(hhhj©hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j”hj‹ubhŒ:”…””}”(hŒ:”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]; };”…””}”(hhhjÂubah}”(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ÕhjÓhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hjÐhžhhŸh³h K9ubhö)”}”(hhh]”(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”…””}”(hhhjhž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 K;ubhŒdesc_sig_space”“”)”}”(hŒ ”h]”hŒ ”…””}”(hhhjhžhhŸNh Nubah}”(h]”h ]”Œw”ah"]”h$]”h&]”uh1jhjhžhhŸjh K;ubhŒ desc_name”“”)”}”(hŒcn_add_callback”h]”hŒ desc_sig_name”“”)”}”(hŒcn_add_callback”h]”hŒcn_add_callback”…””}”(hhhj1hž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 K;ubhŒ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”…””}”(hhhjVhžhhŸNh Nubah}”(h]”h ]”Œk”ah"]”h$]”h&]”uh1jThjPubj)”}”(hŒ ”h]”hŒ ”…””}”(hhhjehžhhŸNh Nubah}”(h]”h ]”j%ah"]”h$]”h&]”uh1jhjPubjU)”}”(hŒstruct”h]”hŒstruct”…””}”(hhhjshžhhŸNh Nubah}”(h]”h ]”jaah"]”h$]”h&]”uh1jThjPubj)”}”(hŒ ”h]”hŒ ”…””}”(hhhjhžhhŸNh Nubah}”(h]”h ]”j%ah"]”h$]”h&]”uh1jhjPubh)”}”(hhh]”j0)”}”(hŒcb_id”h]”hŒcb_id”…””}”(hhhj’hž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©j3sbŒc.cn_add_callback”†”asbuh1hhjPubj)”}”(hŒ ”h]”hŒ ”…””}”(hhhj»hžhhŸNh Nubah}”(h]”h ]”j%ah"]”h$]”h&]”uh1jhjPubhŒdesc_sig_punctuation”“”)”}”(hŒ*”h]”hŒ*”…””}”(hhhjËhžhhŸNh Nubah}”(h]”h ]”Œp”ah"]”h$]”h&]”uh1jÉhjPubj0)”}”(hŒid”h]”hŒid”…””}”(hhhjÚhžhhŸNh Nubah}”(h]”h ]”j<ah"]”h$]”h&]”uh1j/hjPubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆh±h²uh1jNhjJubjO)”}”(hŒconst char *name”h]”(jU)”}”(hjXh]”hŒconst”…””}”(hhhjóhžhhŸNh Nubah}”(h]”h ]”jaah"]”h$]”h&]”uh1jThjïubj)”}”(hŒ ”h]”hŒ ”…””}”(hhhjhžhhŸNh Nubah}”(h]”h ]”j%ah"]”h$]”h&]”uh1jhjïubj)”}”(hŒchar”h]”hŒchar”…””}”(hhhjhžhhŸNh Nubah}”(h]”h ]”jah"]”h$]”h&]”uh1jhjïubj)”}”(hŒ ”h]”hŒ ”…””}”(hhhjhžhhŸNh Nubah}”(h]”h ]”j%ah"]”h$]”h&]”uh1jhjïubjÊ)”}”(hjÍh]”hŒ*”…””}”(hhhj*hžhhŸNh Nubah}”(h]”h ]”jÖah"]”h$]”h&]”uh1jÉhjïubj0)”}”(hŒname”h]”hŒname”…””}”(hhhj7hžhhŸNh Nubah}”(h]”h ]”j<ah"]”h$]”h&]”uh1j/hjïubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆh±h²uh1jNhjJubjO)”}”(hŒ;void (*callback)(struct cn_msg*, struct netlink_skb_parms*)”h]”(j)”}”(hŒvoid”h]”hŒvoid”…””}”(hhhjPhžhhŸNh Nubah}”(h]”h ]”jah"]”h$]”h&]”uh1jhjLubj)”}”(hŒ ”h]”hŒ ”…””}”(hhhj^hžhhŸNh Nubah}”(h]”h ]”j%ah"]”h$]”h&]”uh1jhjLubjÊ)”}”(hŒ(”h]”hŒ(”…””}”(hhhjlhžhhŸNh Nubah}”(h]”h ]”jÖah"]”h$]”h&]”uh1jÉhjLubjÊ)”}”(hjÍh]”hŒ*”…””}”(hhhjzhžhhŸNh Nubah}”(h]”h ]”jÖah"]”h$]”h&]”uh1jÉhjLubj0)”}”(hŒcallback”h]”hŒcallback”…””}”(hhhj‡hžhhŸNh Nubah}”(h]”h ]”j<ah"]”h$]”h&]”uh1j/hjLubjÊ)”}”(hŒ)”h]”hŒ)”…””}”(hhhj•hžhhŸNh Nubah}”(h]”h ]”jÖah"]”h$]”h&]”uh1jÉhjLubjÊ)”}”(hjnh]”hŒ(”…””}”(hhhj£hžhhŸNh Nubah}”(h]”h ]”jÖah"]”h$]”h&]”uh1jÉhjLubjU)”}”(hjuh]”hŒstruct”…””}”(hhhj°hžhhŸNh Nubah}”(h]”h ]”jaah"]”h$]”h&]”uh1jThjLubj)”}”(hŒ ”h]”hŒ ”…””}”(hhhj½hžhhŸNh Nubah}”(h]”h ]”j%ah"]”h$]”h&]”uh1jhjLubh)”}”(hhh]”j0)”}”(hŒcn_msg”h]”hŒcn_msg”…””}”(hhhjÎ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”Njj°)”}”j³]”j·Œc.cn_add_callback”†”asbuh1hhjLubjÊ)”}”(hjÍh]”hŒ*”…””}”(hhhjìhžhhŸNh Nubah}”(h]”h ]”jÖah"]”h$]”h&]”uh1jÉhjLubjÊ)”}”(hŒ,”h]”hŒ,”…””}”(hhhjùhžhhŸNh Nubah}”(h]”h ]”jÖah"]”h$]”h&]”uh1jÉhjLubj)”}”(hŒ ”h]”hŒ ”…””}”(hhhjhžhhŸNh Nubah}”(h]”h ]”j%ah"]”h$]”h&]”uh1jhjLubjU)”}”(hjuh]”hŒstruct”…””}”(hhhjhžhhŸNh Nubah}”(h]”h ]”jaah"]”h$]”h&]”uh1jThjLubj)”}”(hŒ ”h]”hŒ ”…””}”(hhhj"hžhhŸNh Nubah}”(h]”h ]”j%ah"]”h$]”h&]”uh1jhjLubh)”}”(hhh]”j0)”}”(hŒnetlink_skb_parms”h]”hŒnetlink_skb_parms”…””}”(hhhj3hžhhŸNh Nubah}”(h]”h ]”j<ah"]”h$]”h&]”uh1j/hj0ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”j§Œreftype”j©Œ reftarget”j5Œmodname”NŒ classname”Njj°)”}”j³]”j·Œc.cn_add_callback”†”asbuh1hhjLubjÊ)”}”(hjÍh]”hŒ*”…””}”(hhhjQhžhhŸNh Nubah}”(h]”h ]”jÖah"]”h$]”h&]”uh1jÉhjLubjÊ)”}”(hj—h]”hŒ)”…””}”(hhhj^hžhhŸNh Nubah}”(h]”h ]”jÖah"]”h$]”h&]”uh1jÉhjLubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆh±h²uh1jNhjJubeh}”(h]”h ]”h"]”h$]”h&]”h±h²uh1jHhjhžhhŸjh K;ubeh}”(h]”h ]”h"]”h$]”h&]”h±h²Œ add_permalink”ˆuh1jŒsphinx_line_type”Œ declarator”hjühžhhŸjh K;ubah}”(h]”jóah ]”(Œsig”Œ sig-object”eh"]”h$]”h&]”Œis_multiline”ˆuh1júhŸŒ^/var/lib/git/docbuild/linux/Documentation/driver-api/connector:59: ./include/linux/connector.h”h KChj÷hžhubhŒdesc_content”“”)”}”(hhh]”hÊ)”}”(hŒ+Registers new callback with connector core.”h]”hŒ+Registers new callback with connector core.”…””}”(hj’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:hjhžhubah}”(h]”h ]”h"]”h$]”h&]”uh1j‹hj÷hžhhŸjh K;ubeh}”(h]”h ]”(j§Œfunction”eh"]”h$]”h&]”Œdomain”j§Œobjtype”j¨Œdesctype”j¨Œnoindex”‰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”…””}”(hhhj¼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”…””}”(hhhjã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þ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”…””}”(hhhjhž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.”…””}”(hj8hj6hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸj2h K?hj3ubah}”(h]”h ]”h"]”h$]”h&]”uh1j÷hjubeh}”(h]”h ]”h"]”h$]”h&]”uh1jÕhŸj2h 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â)”}”(hjVh]”hŒ=void (*callback)(struct cn_msg *, struct netlink_skb_parms *)”…””}”(hhhjXhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jáhjTubah}”(h]”h ]”h"]”h$]”h&]”uh1jÛhŸŒ^/var/lib/git/docbuild/linux/Documentation/driver-api/connector:59: ./include/linux/connector.h”h K@hjPubjø)”}”(hhh]”hÊ)”}”(hŒLconnector's callback. parameters are ``cn_msg`` and the sender's credentials”h]”(hŒ'connectorâ€™s callback. parameters are ”…””}”(hŒ%connector's callback. parameters are ”hjohžhhŸNh Nubjâ)”}”(hŒ ``cn_msg``”h]”hŒcn_msg”…””}”(hhhjxhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jáhjoubhŒ and the senderâ€™s credentials”…””}”(hŒ and the sender's credentials”hjohžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸjkh K@hjlubah}”(h]”h ]”h"]”h$]”h&]”uh1j÷hjPubeh}”(h]”h ]”h"]”h$]”h&]”uh1jÕhŸjkh 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”…””}”(hhhjÃ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 KGubj)”}”(hŒ ”h]”hŒ ”…””}”(hhhjÒhžhhŸNh Nubah}”(h]”h ]”j%ah"]”h$]”h&]”uh1jhj¿hžhhŸjÑh KGubj*)”}”(hŒcn_del_callback”h]”j0)”}”(hŒcn_del_callback”h]”hŒcn_del_callback”…””}”(hhhjähžhhŸNh Nubah}”(h]”h ]”j<ah"]”h$]”h&]”uh1j/hjàubah}”(h]”h ]”(jCjDeh"]”h$]”h&]”h±h²uh1j)hj¿hžhhŸjÑh KGubjI)”}”(hŒ(const struct cb_id *id)”h]”jO)”}”(hŒconst struct cb_id *id”h]”(jU)”}”(hjXh]”hŒconst”…””}”(hhhjhžhhŸNh Nubah}”(h]”h ]”jaah"]”h$]”h&]”uh1jThjüubj)”}”(hŒ ”h]”hŒ ”…””}”(hhhj hžhhŸNh Nubah}”(h]”h ]”j%ah"]”h$]”h&]”uh1jhjüubjU)”}”(hjuh]”hŒstruct”…””}”(hhhjhžhhŸNh Nubah}”(h]”h ]”jaah"]”h$]”h&]”uh1jThjüubj)”}”(hŒ ”h]”hŒ ”…””}”(hhhj(hžhhŸNh Nubah}”(h]”h ]”j%ah"]”h$]”h&]”uh1jhjüubh)”}”(hhh]”j0)”}”(hŒcb_id”h]”hŒcb_id”…””}”(hhhj9hžhhŸNh Nubah}”(h]”h ]”j<ah"]”h$]”h&]”uh1j/hj6ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”j§Œreftype”j©Œ reftarget”j;Œmodname”NŒ classname”Njj°)”}”j³]”j¶)”}”j©jæsbŒc.cn_del_callback”†”asbuh1hhjüubj)”}”(hŒ ”h]”hŒ ”…””}”(hhhjYhžhhŸNh Nubah}”(h]”h ]”j%ah"]”h$]”h&]”uh1jhjüubjÊ)”}”(hjÍh]”hŒ*”…””}”(hhhjghžhhŸNh Nubah}”(h]”h ]”jÖah"]”h$]”h&]”uh1jÉhjüubj0)”}”(hŒid”h]”hŒid”…””}”(hhhjthžhhŸNh Nubah}”(h]”h ]”j<ah"]”h$]”h&]”uh1j/hjüubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆh±h²uh1jNhjøubah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1jHhj¿hžhhŸjÑh KGubeh}”(h]”h ]”h"]”h$]”h&]”h±h²j~ˆuh1jjj€hj»hžhhŸjÑh KGubah}”(h]”j¶ah ]”(j„j…eh"]”h$]”h&]”j‰ˆuh1júhŸŒ^/var/lib/git/docbuild/linux/Documentation/driver-api/connector:59: ./include/linux/connector.h”h KJhj¸hžhubjŒ)”}”(hhh]”hÊ)”}”(hŒ-Unregisters new callback with connector core.”h]”hŒ-Unregisters new callback with connector core.”…””}”(hj¡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 KFhjœhžhubah}”(h]”h ]”h"]”h$]”h&]”uh1j‹hj¸hžhhŸjÑh KGubeh}”(h]”h ]”(j§Œfunction”eh"]”h$]”h&]”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”…””}”(hhhjÃ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”…””}”(hhhjâ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û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”…””}”(hhhj:hžhhŸNh Nubah}”(h]”h ]”jah"]”h$]”h&]”uh1jhj6hžhhŸŒ^/var/lib/git/docbuild/linux/Documentation/driver-api/connector:59: ./include/linux/connector.h”h KOubj)”}”(hŒ ”h]”hŒ ”…””}”(hhhjIhžhhŸNh Nubah}”(h]”h ]”j%ah"]”h$]”h&]”uh1jhj6hžhhŸjHh KOubj*)”}”(hŒcn_netlink_send_mult”h]”j0)”}”(hŒcn_netlink_send_mult”h]”hŒcn_netlink_send_mult”…””}”(hhhj[hžhhŸNh Nubah}”(h]”h ]”j<ah"]”h$]”h&]”uh1j/hjWubah}”(h]”h ]”(jCjDeh"]”h$]”h&]”h±h²uh1j)hj6hžhhŸjHh KOubjI)”}”(hŒq(struct cn_msg *msg, u16 len, u32 portid, u32 group, gfp_t gfp_mask, netlink_filter_fn filter, void *filter_data)”h]”(jO)”}”(hŒstruct cn_msg *msg”h]”(jU)”}”(hjuh]”hŒstruct”…””}”(hhhjwhžhhŸNh Nubah}”(h]”h ]”jaah"]”h$]”h&]”uh1jThjsubj)”}”(hŒ ”h]”hŒ ”…””}”(hhhj„hžhhŸNh Nubah}”(h]”h ]”j%ah"]”h$]”h&]”uh1jhjsubh)”}”(hhh]”j0)”}”(hŒcn_msg”h]”hŒcn_msg”…””}”(hhhj•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”Njj°)”}”j³]”j¶)”}”j©j]sbŒc.cn_netlink_send_mult”†”asbuh1hhjsubj)”}”(hŒ ”h]”hŒ ”…””}”(hhhjµhžhhŸNh Nubah}”(h]”h ]”j%ah"]”h$]”h&]”uh1jhjsubjÊ)”}”(hjÍh]”hŒ*”…””}”(hhhjÃhžhhŸNh Nubah}”(h]”h ]”jÖah"]”h$]”h&]”uh1jÉhjsubj0)”}”(hŒmsg”h]”hŒmsg”…””}”(hhhjÐhžhhŸNh Nubah}”(h]”h ]”j<ah"]”h$]”h&]”uh1j/hjsubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆh±h²uh1jNhjoubjO)”}”(hŒu16 len”h]”(h)”}”(hhh]”j0)”}”(hŒu16”h]”hŒu16”…””}”(hhhjì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”Njj°)”}”j³]”j±Œc.cn_netlink_send_mult”†”asbuh1hhjåubj)”}”(hŒ ”h]”hŒ ”…””}”(hhhj hžhhŸNh Nubah}”(h]”h ]”j%ah"]”h$]”h&]”uh1jhjåubj0)”}”(hŒlen”h]”hŒlen”…””}”(hhhjhžhhŸNh Nubah}”(h]”h ]”j<ah"]”h$]”h&]”uh1j/hjåubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆh±h²uh1jNhjoubjO)”}”(hŒ u32 portid”h]”(h)”}”(hhh]”j0)”}”(hŒu32”h]”hŒu32”…””}”(hhhj4hžhhŸNh Nubah}”(h]”h ]”j<ah"]”h$]”h&]”uh1j/hj1ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”j§Œreftype”j©Œ reftarget”j6Œmodname”NŒ classname”Njj°)”}”j³]”j±Œc.cn_netlink_send_mult”†”asbuh1hhj-ubj)”}”(hŒ ”h]”hŒ ”…””}”(hhhjRhžhhŸNh Nubah}”(h]”h ]”j%ah"]”h$]”h&]”uh1jhj-ubj0)”}”(hŒportid”h]”hŒportid”…””}”(hhhj`hžhhŸNh Nubah}”(h]”h ]”j<ah"]”h$]”h&]”uh1j/hj-ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆh±h²uh1jNhjoubjO)”}”(hŒ u32 group”h]”(h)”}”(hhh]”j0)”}”(hŒu32”h]”hŒu32”…””}”(hhhj|hžhhŸNh Nubah}”(h]”h ]”j<ah"]”h$]”h&]”uh1j/hjyubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”j§Œreftype”j©Œ reftarget”j~Œmodname”NŒ classname”Njj°)”}”j³]”j±Œc.cn_netlink_send_mult”†”asbuh1hhjuubj)”}”(hŒ ”h]”hŒ ”…””}”(hhhjšhžhhŸNh Nubah}”(h]”h ]”j%ah"]”h$]”h&]”uh1jhjuubj0)”}”(hŒgroup”h]”hŒgroup”…””}”(hhhj¨hžhhŸNh Nubah}”(h]”h ]”j<ah"]”h$]”h&]”uh1j/hjuubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆh±h²uh1jNhjoubjO)”}”(hŒgfp_t gfp_mask”h]”(h)”}”(hhh]”j0)”}”(hŒgfp_t”h]”hŒgfp_t”…””}”(hhhjÄ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”Njj°)”}”j³]”j±Œc.cn_netlink_send_mult”†”asbuh1hhj½ubj)”}”(hŒ ”h]”hŒ ”…””}”(hhhjâhžhhŸNh Nubah}”(h]”h ]”j%ah"]”h$]”h&]”uh1jhj½ubj0)”}”(hŒgfp_mask”h]”hŒgfp_mask”…””}”(hhhjðhžhhŸNh Nubah}”(h]”h ]”j<ah"]”h$]”h&]”uh1j/hj½ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆh±h²uh1jNhjoubjO)”}”(hŒnetlink_filter_fn filter”h]”(h)”}”(hhh]”j0)”}”(hŒnetlink_filter_fn”h]”hŒnetlink_filter_fn”…””}”(hhhj 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”Njj°)”}”j³]”j±Œc.cn_netlink_send_mult”†”asbuh1hhj ubj)”}”(hŒ ”h]”hŒ ”…””}”(hhhj* hžhhŸNh Nubah}”(h]”h ]”j%ah"]”h$]”h&]”uh1jhj ubj0)”}”(hŒfilter”h]”hŒfilter”…””}”(hhhj8 hžhhŸNh Nubah}”(h]”h ]”j<ah"]”h$]”h&]”uh1j/hj ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆh±h²uh1jNhjoubjO)”}”(hŒvoid *filter_data”h]”(j)”}”(hŒvoid”h]”hŒvoid”…””}”(hhhjQ hžhhŸNh Nubah}”(h]”h ]”jah"]”h$]”h&]”uh1jhjM ubj)”}”(hŒ ”h]”hŒ ”…””}”(hhhj_ hžhhŸNh Nubah}”(h]”h ]”j%ah"]”h$]”h&]”uh1jhjM ubjÊ)”}”(hjÍh]”hŒ*”…””}”(hhhjm hžhhŸNh Nubah}”(h]”h ]”jÖah"]”h$]”h&]”uh1jÉhjM ubj0)”}”(hŒfilter_data”h]”hŒfilter_data”…””}”(hhhjz hžhhŸNh Nubah}”(h]”h ]”j<ah"]”h$]”h&]”uh1j/hjM ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆh±h²uh1jNhjoubeh}”(h]”h ]”h"]”h$]”h&]”h±h²uh1jHhj6hžhhŸjHh KOubeh}”(h]”h ]”h"]”h$]”h&]”h±h²j~ˆuh1jjj€hj2hžhhŸjHh KOubah}”(h]”j-ah ]”(j„j…eh"]”h$]”h&]”j‰ˆuh1júhŸŒ^/var/lib/git/docbuild/linux/Documentation/driver-api/connector:59: ./include/linux/connector.h”h Kehj/hžhubjŒ)”}”(hhh]”hÊ)”}”(hŒ&Sends message to the specified groups.”h]”hŒ&Sends message to the specified groups.”…””}”(hj§ 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ŸjHh KOubeh}”(h]”h ]”(j§Œfunction”eh"]”h$]”h&]”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”…””}”(hhhjÉ 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”…””}”(hhhjè 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 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”…””}”(hhhj! 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 ”…””}”(hŒ Number of ”hj8 hžhhŸNh Nubj»)”}”(hŒ**msg**”h]”hŒmsg”…””}”(hhhjA hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jºhj8 ubhŒ to be sent.”…””}”(hŒ to be sent.”hj8 hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸj4 h KQhj5 ubah}”(h]”h ]”h"]”h$]”h&]”uh1j÷hj ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jÕhŸj4 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â)”}”(hjl h]”hŒ u32 portid”…””}”(hhhjn hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jáhjj ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÛhŸŒ^/var/lib/git/docbuild/linux/Documentation/driver-api/connector:59: ./include/linux/connector.h”h KThjf 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‡ 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÷hjf 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”…””}”(hhhj¨ 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 ”…””}”(hŒdestination group. If ”hj¿ hžhhŸNh Nubj»)”}”(hŒ **portid**”h]”hŒportid”…””}”(hhhjÈ hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jºhj¿ ubhŒ and ”…””}”(hŒ and ”hj¿ hžhhŸNh Nubj»)”}”(hŒ **group**”h]”hŒgroup”…””}”(hhhjÛ 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 ”…””}”(hŒ· 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”…””}”(hhhjî hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jºhj¿ ubhŒ. If ”…””}”(hŒ. If ”hj¿ hžhhŸNh Nubj»)”}”(hŒ **group**”h]”hŒgroup”…””}”(hhhjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jºhj¿ ubhŒD is not zero, then message will be delivered to the specified group.”…””}”(hŒ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”…””}”(hhhj/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Ê)”}”(hŒ GFP mask.”h]”hŒ GFP mask.”…””}”(hjHhjFhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸjBh K\hjCubah}”(h]”h ]”h"]”h$]”h&]”uh1j÷hj'ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jÕhŸjBh 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â)”}”(hjfh]”hŒnetlink_filter_fn filter”…””}”(hhhjhhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jáhjdubah}”(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Ê)”}”(hŒ,Filter function to be used at netlink layer.”h]”hŒ,Filter function to be used at netlink layer.”…””}”(hjhjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸj{h K]hj|ubah}”(h]”h ]”h"]”h$]”h&]”uh1j÷hj`ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jÕhŸj{h 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”…””}”(hhhj¡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^hj™ubjø)”}”(hhh]”hÊ)”}”(hŒ1Filter data to be supplied to the filter function”h]”hŒ1Filter data to be supplied to the filter function”…””}”(hjºhj¸hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸj´h K^hjµubah}”(h]”h ]”h"]”h$]”h&]”uh1j÷hj™ubeh}”(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”…””}”(hhhjÜ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ò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 ”…””}”(hŒ*If there are no listeners for given group ”hjÿhžhhŸNh Nubjâ)”}”(hŒ ``-ESRCH``”h]”hŒ-ESRCH”…””}”(hhhjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jáhjÿubhŒ can be returned.”…””}”(hŒ 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”…””}”(hhhjBhž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 Klubj)”}”(hŒ ”h]”hŒ ”…””}”(hhhjQhžhhŸNh Nubah}”(h]”h ]”j%ah"]”h$]”h&]”uh1jhj>hžhhŸjPh Klubj*)”}”(hŒcn_netlink_send”h]”j0)”}”(hŒcn_netlink_send”h]”hŒcn_netlink_send”…””}”(hhhjchžhhŸNh Nubah}”(h]”h ]”j<ah"]”h$]”h&]”uh1j/hj_ubah}”(h]”h ]”(jCjDeh"]”h$]”h&]”h±h²uh1j)hj>hžhhŸjPh KlubjI)”}”(hŒ;(struct cn_msg *msg, u32 portid, u32 group, gfp_t gfp_mask)”h]”(jO)”}”(hŒstruct cn_msg *msg”h]”(jU)”}”(hjuh]”hŒstruct”…””}”(hhhjhžhhŸNh Nubah}”(h]”h ]”jaah"]”h$]”h&]”uh1jThj{ubj)”}”(hŒ ”h]”hŒ ”…””}”(hhhjŒhžhhŸNh Nubah}”(h]”h ]”j%ah"]”h$]”h&]”uh1jhj{ubh)”}”(hhh]”j0)”}”(hŒcn_msg”h]”hŒcn_msg”…””}”(hhhjhž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”Njj°)”}”j³]”j¶)”}”j©jesbŒc.cn_netlink_send”†”asbuh1hhj{ubj)”}”(hŒ ”h]”hŒ ”…””}”(hhhj½hžhhŸNh Nubah}”(h]”h ]”j%ah"]”h$]”h&]”uh1jhj{ubjÊ)”}”(hjÍh]”hŒ*”…””}”(hhhjËhžhhŸNh Nubah}”(h]”h ]”jÖah"]”h$]”h&]”uh1jÉhj{ubj0)”}”(hŒmsg”h]”hŒmsg”…””}”(hhhjØhžhhŸNh Nubah}”(h]”h ]”j<ah"]”h$]”h&]”uh1j/hj{ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆh±h²uh1jNhjwubjO)”}”(hŒ u32 portid”h]”(h)”}”(hhh]”j0)”}”(hŒu32”h]”hŒu32”…””}”(hhhjô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”Njj°)”}”j³]”j¹Œc.cn_netlink_send”†”asbuh1hhjíubj)”}”(hŒ ”h]”hŒ ”…””}”(hhhj hžhhŸNh Nubah}”(h]”h ]”j%ah"]”h$]”h&]”uh1jhjíubj0)”}”(hŒportid”h]”hŒportid”…””}”(hhhj hžhhŸNh Nubah}”(h]”h ]”j<ah"]”h$]”h&]”uh1j/hjíubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆh±h²uh1jNhjwubjO)”}”(hŒ u32 group”h]”(h)”}”(hhh]”j0)”}”(hŒu32”h]”hŒu32”…””}”(hhhj< hžhhŸNh Nubah}”(h]”h ]”j<ah"]”h$]”h&]”uh1j/hj9 ubah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”j§Œreftype”j©Œ reftarget”j> Œmodname”NŒ classname”Njj°)”}”j³]”j¹Œc.cn_netlink_send”†”asbuh1hhj5 ubj)”}”(hŒ ”h]”hŒ ”…””}”(hhhjZ hžhhŸNh Nubah}”(h]”h ]”j%ah"]”h$]”h&]”uh1jhj5 ubj0)”}”(hŒgroup”h]”hŒgroup”…””}”(hhhjh hžhhŸNh Nubah}”(h]”h ]”j<ah"]”h$]”h&]”uh1j/hj5 ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆh±h²uh1jNhjwubjO)”}”(hŒgfp_t gfp_mask”h]”(h)”}”(hhh]”j0)”}”(hŒgfp_t”h]”hŒgfp_t”…””}”(hhhj„ 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”Njj°)”}”j³]”j¹Œc.cn_netlink_send”†”asbuh1hhj} ubj)”}”(hŒ ”h]”hŒ ”…””}”(hhhj¢ hžhhŸNh Nubah}”(h]”h ]”j%ah"]”h$]”h&]”uh1jhj} ubj0)”}”(hŒgfp_mask”h]”hŒgfp_mask”…””}”(hhhj° hžhhŸNh Nubah}”(h]”h ]”j<ah"]”h$]”h&]”uh1j/hj} ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆh±h²uh1jNhjwubeh}”(h]”h ]”h"]”h$]”h&]”h±h²uh1jHhj>hžhhŸjPh Klubeh}”(h]”h ]”h"]”h$]”h&]”h±h²j~ˆuh1jjj€hj:hžhhŸjPh Klubah}”(h]”j5ah ]”(j„j…eh"]”h$]”h&]”j‰ˆuh1júhŸŒ^/var/lib/git/docbuild/linux/Documentation/driver-api/connector:59: ./include/linux/connector.h”h Khj7hžhubjŒ)”}”(hhh]”hÊ)”}”(hŒ&Sends message to the specified groups.”h]”hŒ&Sends message to the specified groups.”…””}”(hjÝ 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‹hj7hžhhŸjPh Klubeh}”(h]”h ]”(j§Œfunction”eh"]”h$]”h&]”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”…””}”(hhhjÿ 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”…””}”(hhhjhž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 Kmhjubjø)”}”(hhh]”hÊ)”}”(hŒ#message header(with attached data).”h]”hŒ#message header(with attached data).”…””}”(hj7hj5hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸj1h Kmhj2ubah}”(h]”h ]”h"]”h$]”h&]”uh1j÷hjubeh}”(h]”h ]”h"]”h$]”h&]”uh1jÕhŸj1h 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â)”}”(hjUh]”hŒ u32 portid”…””}”(hhhjWhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jáhjSubah}”(h]”h ]”h"]”h$]”h&]”uh1jÛhŸŒ^/var/lib/git/docbuild/linux/Documentation/driver-api/connector:59: ./include/linux/connector.h”h KphjOubjø)”}”(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.”…””}”(hjphjnhž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 Knhjkubah}”(h]”h ]”h"]”h$]”h&]”uh1j÷hjOubeh}”(h]”h ]”h"]”h$]”h&]”uh1jÕhŸjjh 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â)”}”(hjh]”hŒ u32 group”…””}”(hhhj‘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 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 ”…””}”(hŒdestination group. If ”hj¨hžhhŸNh Nubj»)”}”(hŒ **portid**”h]”hŒportid”…””}”(hhhj±hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jºhj¨ubhŒ and ”…””}”(hŒ and ”hj¨hžhhŸNh Nubj»)”}”(hŒ **group**”h]”hŒgroup”…””}”(hhhjÄ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 ”…””}”(hŒ· 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”…””}”(hhhj×hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jºhj¨ubhŒ. If ”…””}”(hŒ. If ”hj¨hžhhŸNh Nubj»)”}”(hŒ **group**”h]”hŒgroup”…””}”(hhhjê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.”…””}”(hŒ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”…””}”(hhhjhž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 Kxhjubjø)”}”(hhh]”hÊ)”}”(hŒ GFP mask.”h]”hŒ GFP mask.”…””}”(hj1hj/hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸj+h Kxhj,ubah}”(h]”h ]”h"]”h$]”h&]”uh1j÷hjubeh}”(h]”h ]”h"]”h$]”h&]”uh1jÕhŸj+h Kxhjubeh}”(h]”h ]”h"]”h$]”h&]”uh1jÐhj÷ ubhÊ)”}”(hŒ**Description**”h]”j»)”}”(hjQh]”hŒDescription”…””}”(hhhjShžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jºhjOubah}”(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.”…””}”(hjihjghž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 ”…””}”(hŒ*If there are no listeners for given group ”hjvhžhhŸNh Nubjâ)”}”(hŒ ``-ESRCH``”h]”hŒ-ESRCH”…””}”(hhhjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jáhjvubhŒ can be returned.”…””}”(hŒ can be returned.”hjvhž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©hj§hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÛhŸh³h K?hj£ubjø)”}”(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ºhj¸hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K>hjµubah}”(h]”h ]”h"]”h$]”h&]”uh1j÷hj£ubeh}”(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õhjÐhžhhŸNh Nubeh}”(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ë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ù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.”…””}”(hjhjhž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.”…””}”(hjhjhž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#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.”…””}”(hj1hj/hž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?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}).”…””}”(hjMhjKhž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.”…””}”(hj[hjYhž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”…””}”(hjthjrhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hjohž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.”…””}”(hj‚hj€hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Kfhjohž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›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:”…””}”(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)); }”…””}”(hhhj¶ubah}”(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Æ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Ô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â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ð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 hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hjhž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.”…””}”(hjhjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K›hjhž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”jVŒ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Œ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”‰Œfile_insertion_enabled”ˆŒraw_enabled”KŒline_length_limit”M'Œ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”‰Œembed_images”‰Œenv”NubŒreporter”NŒindirect_targets”]”Œsubstitution_defs”}”Œsubstitution_names”}”Œrefnames”}”Œrefids”}”Œnameids”}”(j0j-jãjàjljij“jjjþj(j%uŒ nametypes”}”(j0NjãNjlNj“NjNj(Nuh}”(j-h¶jàjÐjójüj¶j»j-j2j5j:jijæjjojþj–j%juŒ 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.