€•OŒ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/networking/gen_stats”Œmodname”NŒ classname”NŒ refexplicit”ˆuŒtagname”hhh ubh)”}”(hhh]”hŒChinese (Traditional)”…””}”hh2sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ(/translations/zh_TW/networking/gen_stats”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒItalian”…””}”hhFsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ(/translations/it_IT/networking/gen_stats”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒJapanese”…””}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ(/translations/ja_JP/networking/gen_stats”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒKorean”…””}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ(/translations/ko_KR/networking/gen_stats”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒPortuguese (Brazilian)”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ(/translations/pt_BR/networking/gen_stats”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒSpanish”…””}”hh–sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ(/translations/sp_SP/networking/gen_stats”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubeh}”(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/networking/gen_stats.rst”h´KubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒ/Generic networking statistics for netlink users”h]”hŒ/Generic networking statistics for netlink users”…””}”(hhÏh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhhÊh²hh³hÇh´KubhŒ paragraph”“”)”}”(hŒ,Statistic counters are grouped into structs:”h]”hŒ,Statistic counters are grouped into structs:”…””}”(hhßh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´KhhÊh²hubhŒtable”“”)”}”(hhh]”hŒtgroup”“”)”}”(hhh]”(hŒcolspec”“”)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œcolwidth”Kuh1h÷hhôubhø)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œcolwidth”Kuh1h÷hhôubhø)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œcolwidth”Kuh1h÷hhôubhŒthead”“”)”}”(hhh]”hŒrow”“”)”}”(hhh]”(hŒentry”“”)”}”(hhh]”hÞ)”}”(hŒStruct”h]”hŒStruct”…””}”(hj&h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K hj#ubah}”(h]”h ]”h"]”h$]”h&]”uh1j!hjubj")”}”(hhh]”hÞ)”}”(hŒTLV type”h]”hŒTLV type”…””}”(hj=h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K hj:ubah}”(h]”h ]”h"]”h$]”h&]”uh1j!hjubj")”}”(hhh]”hÞ)”}”(hŒ Description”h]”hŒ Description”…””}”(hjTh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K hjQubah}”(h]”h ]”h"]”h$]”h&]”uh1j!hjubeh}”(h]”h ]”h"]”h$]”h&]”uh1jhjubah}”(h]”h ]”h"]”h$]”h&]”uh1jhhôubhŒtbody”“”)”}”(hhh]”(j)”}”(hhh]”(j")”}”(hhh]”hÞ)”}”(hŒgnet_stats_basic”h]”hŒgnet_stats_basic”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K hj|ubah}”(h]”h ]”h"]”h$]”h&]”uh1j!hjyubj")”}”(hhh]”hÞ)”}”(hŒTCA_STATS_BASIC”h]”hŒTCA_STATS_BASIC”…””}”(hj–h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K hj“ubah}”(h]”h ]”h"]”h$]”h&]”uh1j!hjyubj")”}”(hhh]”hÞ)”}”(hŒBasic statistics”h]”hŒBasic statistics”…””}”(hj­h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K hjªubah}”(h]”h ]”h"]”h$]”h&]”uh1j!hjyubeh}”(h]”h ]”h"]”h$]”h&]”uh1jhjvubj)”}”(hhh]”(j")”}”(hhh]”hÞ)”}”(hŒgnet_stats_rate_est”h]”hŒgnet_stats_rate_est”…””}”(hjÍh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K hjÊubah}”(h]”h ]”h"]”h$]”h&]”uh1j!hjÇubj")”}”(hhh]”hÞ)”}”(hŒTCA_STATS_RATE_EST”h]”hŒTCA_STATS_RATE_EST”…””}”(hjäh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K hjáubah}”(h]”h ]”h"]”h$]”h&]”uh1j!hjÇubj")”}”(hhh]”hÞ)”}”(hŒRate estimator”h]”hŒRate estimator”…””}”(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&]”uh1jhjvubj)”}”(hhh]”(j")”}”(hhh]”hÞ)”}”(hŒgnet_stats_queue”h]”hŒgnet_stats_queue”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´Khjubah}”(h]”h ]”h"]”h$]”h&]”uh1j!hjubj")”}”(hhh]”hÞ)”}”(hŒTCA_STATS_QUEUE”h]”hŒTCA_STATS_QUEUE”…””}”(hj2h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´Khj/ubah}”(h]”h ]”h"]”h$]”h&]”uh1j!hjubj")”}”(hhh]”hÞ)”}”(hŒQueue statistics”h]”hŒQueue statistics”…””}”(hjIh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´KhjFubah}”(h]”h ]”h"]”h$]”h&]”uh1j!hjubeh}”(h]”h ]”h"]”h$]”h&]”uh1jhjvubj)”}”(hhh]”(j")”}”(hhh]”hÞ)”}”(hŒnone”h]”hŒnone”…””}”(hjih²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´Khjfubah}”(h]”h ]”h"]”h$]”h&]”uh1j!hjcubj")”}”(hhh]”hÞ)”}”(hŒ TCA_STATS_APP”h]”hŒ TCA_STATS_APP”…””}”(hj€h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´Khj}ubah}”(h]”h ]”h"]”h$]”h&]”uh1j!hjcubj")”}”(hhh]”hÞ)”}”(hŒApplication specific”h]”hŒApplication specific”…””}”(hj—h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´Khj”ubah}”(h]”h ]”h"]”h$]”h&]”uh1j!hjcubeh}”(h]”h ]”h"]”h$]”h&]”uh1jhjvubeh}”(h]”h ]”h"]”h$]”h&]”uh1jthhôubeh}”(h]”h ]”h"]”h$]”h&]”Œcols”Kuh1hòhhïubah}”(h]”h ]”h"]”h$]”h&]”uh1híhhÊh²hh³hÇh´NubhÉ)”}”(hhh]”(hÎ)”}”(hŒ Collecting:”h]”hŒ Collecting:”…””}”(hjÇh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhjÄh²hh³hÇh´KubhÞ)”}”(hŒ(Declare the statistic structs you need::”h]”hŒ'Declare the statistic structs you need:”…””}”(hjÕh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´KhjÄh²hubhŒ literal_block”“”)”}”(hŒpstruct mystruct { struct gnet_stats_basic bstats; struct gnet_stats_queue qstats; ... };”h]”hŒpstruct mystruct { struct gnet_stats_basic bstats; struct gnet_stats_queue qstats; ... };”…””}”hjåsbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1jãh³hÇh´KhjÄh²hubhÞ)”}”(hŒMUpdate statistics, in dequeue() methods only, (while owning qdisc->running)::”h]”hŒLUpdate statistics, in dequeue() methods only, (while owning qdisc->running):”…””}”(hjóh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´KhjÄh²hubjä)”}”(hŒDmystruct->tstats.packet++; mystruct->qstats.backlog += skb->pkt_len;”h]”hŒDmystruct->tstats.packet++; mystruct->qstats.backlog += skb->pkt_len;”…””}”hjsbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1jãh³hÇh´K hjÄh²hubeh}”(h]”Œ collecting”ah ]”h"]”Œ collecting:”ah$]”h&]”uh1hÈhhÊh²hh³hÇh´KubhÉ)”}”(hhh]”(hÎ)”}”(hŒExport to userspace (Dump):”h]”hŒExport to userspace (Dump):”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhjh²hh³hÇh´K%ubjä)”}”(hXDmy_dumping_routine(struct sk_buff *skb, ...) { struct gnet_dump dump; if (gnet_stats_start_copy(skb, TCA_STATS2, &mystruct->lock, &dump, TCA_PAD) < 0) goto rtattr_failure; if (gnet_stats_copy_basic(&dump, &mystruct->bstats) < 0 || gnet_stats_copy_queue(&dump, &mystruct->qstats) < 0 || gnet_stats_copy_app(&dump, &xstats, sizeof(xstats)) < 0) goto rtattr_failure; if (gnet_stats_finish_copy(&dump) < 0) goto rtattr_failure; ... }”h]”hXDmy_dumping_routine(struct sk_buff *skb, ...) { struct gnet_dump dump; if (gnet_stats_start_copy(skb, TCA_STATS2, &mystruct->lock, &dump, TCA_PAD) < 0) goto rtattr_failure; if (gnet_stats_copy_basic(&dump, &mystruct->bstats) < 0 || gnet_stats_copy_queue(&dump, &mystruct->qstats) < 0 || gnet_stats_copy_app(&dump, &xstats, sizeof(xstats)) < 0) goto rtattr_failure; if (gnet_stats_finish_copy(&dump) < 0) goto rtattr_failure; ... }”…””}”hj(sbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1jãh³hÇh´K)hjh²hubeh}”(h]”Œexport-to-userspace-dump”ah ]”h"]”Œexport to userspace (dump):”ah$]”h&]”uh1hÈhhÊh²hh³hÇh´K%ubhÉ)”}”(hhh]”(hÎ)”}”(hŒ,TCA_STATS/TCA_XSTATS backward compatibility:”h]”hŒ,TCA_STATS/TCA_XSTATS backward compatibility:”…””}”(hjAh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhj>h²hh³hÇh´Khj>h²hubjä)”}”(hXmy_dumping_routine(struct sk_buff *skb, ...) { if (gnet_stats_start_copy_compat(skb, TCA_STATS2, TCA_STATS, TCA_XSTATS, &mystruct->lock, &dump, TCA_PAD) < 0) goto rtattr_failure; ... }”h]”hXmy_dumping_routine(struct sk_buff *skb, ...) { if (gnet_stats_start_copy_compat(skb, TCA_STATS2, TCA_STATS, TCA_XSTATS, &mystruct->lock, &dump, TCA_PAD) < 0) goto rtattr_failure; ... }”…””}”hj]sbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1jãh³hÇh´KBhj>h²hubhÞ)”}”(hŒ–A struct tc_stats will be filled out during gnet_stats_copy_* calls and appended to the skb. TCA_XSTATS is provided if gnet_stats_copy_app was called.”h]”hŒ–A struct tc_stats will be filled out during gnet_stats_copy_* calls and appended to the skb. TCA_XSTATS is provided if gnet_stats_copy_app was called.”…””}”(hjkh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´KKhj>h²hubeh}”(h]”Œ+tca-stats-tca-xstats-backward-compatibility”ah ]”h"]”Œ,tca_stats/tca_xstats backward compatibility:”ah$]”h&]”uh1hÈhhÊh²hh³hÇh´K”h]”hÞ)”}”(hjŒh]”(hŒ Thomas Graf <”…””}”(hjŽh²hh³Nh´NubhŒ reference”“”)”}”(hŒ tgraf@suug.ch”h]”hŒ tgraf@suug.ch”…””}”(hj—h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”Œmailto:tgraf@suug.ch”uh1j•hjŽubhŒ>”…””}”(hjŽh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K€hjŠubah}”(h]”h ]”h"]”h$]”h&]”uh1j¾hj‡h²hh³hÇh´Nubj¿)”}”(hŒ"Jamal Hadi Salim ”h]”hÞ)”}”(hj¹h]”(hŒJamal Hadi Salim <”…””}”(hj»h²hh³Nh´Nubj–)”}”(hŒhadi@cyberus.ca”h]”hŒhadi@cyberus.ca”…””}”(hjÂh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”Œmailto:hadi@cyberus.ca”uh1j•hj»ubhŒ>”…””}”(hj»h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´Khj·ubah}”(h]”h ]”h"]”h$]”h&]”uh1j¾hj‡h²hh³hÇh´Nubeh}”(h]”h ]”h"]”h$]”h&]”Œbullet”Œ-”uh1j…h³hÇh´K€hjth²hubeh}”(h]”Œauthors”ah ]”h"]”Œauthors:”ah$]”h&]”uh1hÈhhÊh²hh³hÇh´Kubeh}”(h]”Œ/generic-networking-statistics-for-netlink-users”ah ]”h"]”Œ/generic networking statistics for netlink users”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”j!Œ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”jŒ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”}”(j÷jôjjj;j8j~j{j¥j¢jqjnjïjìuŒ nametypes”}”(j÷‰j‰j;‰j~‰j¥‰jq‰jï‰uh}”(jôhÊjjÄj8jj{j>j¢jjnj¨jìjtuŒ 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”]”hŒsystem_message”“”)”}”(hhh]”hÞ)”}”(hŒ:Enumerated list start value not ordinal-1: "0" (ordinal 0)”h]”hŒ>Enumerated list start value not ordinal-1: “0†(ordinal 0)”…””}”(hjƒh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝhj€ubah}”(h]”h ]”h"]”h$]”h&]”Œlevel”KŒtype”ŒINFO”Œsource”hÇŒline”Kuh1j~hj¨h²hh³hÇh´K[ubaŒtransform_messages”]”Œ transformer”NŒ include_log”]”Œ decoration”Nh²hub.