€•BNŒ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Œ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”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K hjubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj ubj)”}”(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 hj ubj)”}”(hhh]”hÊ)”}”(hŒ Description”h]”hŒ Description”…””}”(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&]”uh1jhjubah}”(h]”h ]”h"]”h$]”h&]”uh1jhhàubhŒtbody”“”)”}”(hhh]”(j )”}”(hhh]”(j)”}”(hhh]”hÊ)”}”(hŒgnet_stats_basic”h]”hŒgnet_stats_basic”…””}”(hjkhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K hjhubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjeubj)”}”(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 hjubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjeubj)”}”(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 hjeubeh}”(h]”h ]”h"]”h$]”h&]”uh1jhjbubj )”}”(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&]”uh1jhjbubj )”}”(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”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Khjubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjubj)”}”(hhh]”hÊ)”}”(hŒQueue statistics”h]”hŒQueue statistics”…””}”(hj5hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Khj2ubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjubeh}”(h]”h ]”h"]”h$]”h&]”uh1jhjbubj )”}”(hhh]”(j)”}”(hhh]”hÊ)”}”(hŒnone”h]”hŒnone”…””}”(hjUhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KhjRubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjOubj)”}”(hhh]”hÊ)”}”(hŒ TCA_STATS_APP”h]”hŒ TCA_STATS_APP”…””}”(hjlhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Khjiubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjOubj)”}”(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 hjOubeh}”(h]”h ]”h"]”h$]”h&]”uh1jhjbubeh}”(h]”h ]”h"]”h$]”h&]”uh1j`hhà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;”…””}”hjísbah}”(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; ... }”…””}”hjsbah}”(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:”…””}”(hj-hž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; ... }”…””}”hjIsbah}”(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.”…””}”(hjWhž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Ê)”}”(hjxh]”(hŒ Thomas Graf <”…””}”(hjzhž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”uh1jhjzubhŒ>”…””}”(hjzhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K€hjvubah}”(h]”h ]”h"]”h$]”h&]”uh1jªhjshž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”uh1jhj§ubhŒ>”…””}”(hj§hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Khj£ubah}”(h]”h ]”h"]”h$]”h&]”uh1jªhjshžhhŸh³h Nubeh}”(h]”h ]”h"]”h$]”h&]”Œbullet”Œ-”uh1jqhŸh³h K€hj`hž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àjjýj'j$jjjgj‘jŽj]jZjÛjØuŒ nametypes”}”(jã‰j‰j'‰jj‰j‘‰j]‰jÛ‰uh}”(jàh¶jýj°j$jjgj*jŽjmjZj”jØj`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”]”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)”…””}”(hjohžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhjlubah}”(h]”h ]”h"]”h$]”h&]”Œlevel”KŒtype”ŒINFO”Œsource”h³Œline”Kuh1jjhj”hžhhŸh³h K[ubaŒtransform_messages”]”Œ transformer”NŒ include_log”]”Œ decoration”Nhžhub.