€•SlŒ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”Œ5/translations/zh_CN/networking/devlink/devlink-health”Œmodname”NŒ classname”NŒ refexplicit”ˆuŒtagname”hhh ubh)”}”(hhh]”hŒChinese (Traditional)”…””}”hh2sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ5/translations/zh_TW/networking/devlink/devlink-health”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒItalian”…””}”hhFsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ5/translations/it_IT/networking/devlink/devlink-health”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒJapanese”…””}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ5/translations/ja_JP/networking/devlink/devlink-health”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒKorean”…””}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ5/translations/ko_KR/networking/devlink/devlink-health”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒPortuguese (Brazilian)”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ5/translations/pt_BR/networking/devlink/devlink-health”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒSpanish”…””}”hh–sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ5/translations/sp_SP/networking/devlink/devlink-health”Œ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³ŒO/var/lib/git/docbuild/linux/Documentation/networking/devlink/devlink-health.rst”h´KubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒDevlink Health”h]”hŒDevlink Health”…””}”(hhÏh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhhÊh²hh³hÇh´KubhÉ)”}”(hhh]”(hÎ)”}”(hŒ Background”h]”hŒ Background”…””}”(hhàh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhhÝh²hh³hÇh´KubhŒ paragraph”“”)”}”(hŒ‚The ``devlink`` health mechanism is targeted for Real Time Alerting, in order to know when something bad happened to a PCI device.”h]”(hŒThe ”…””}”(hhðh²hh³Nh´NubhŒliteral”“”)”}”(hŒ ``devlink``”h]”hŒdevlink”…””}”(hhúh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1høhhðubhŒs health mechanism is targeted for Real Time Alerting, in order to know when something bad happened to a PCI device.”…””}”(hhðh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´K hhÝh²hubhŒ block_quote”“”)”}”(hŒ’* Provide alert debug information. * Self healing. * If problem needs vendor support, provide a way to gather all needed debugging information. ”h]”hŒ bullet_list”“”)”}”(hhh]”(hŒ list_item”“”)”}”(hŒ Provide alert debug information.”h]”hï)”}”(hj!h]”hŒ Provide alert debug information.”…””}”(hj#h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´K hjubah}”(h]”h ]”h"]”h$]”h&]”uh1jhjubj)”}”(hŒ Self healing.”h]”hï)”}”(hj8h]”hŒ Self healing.”…””}”(hj:h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´Khj6ubah}”(h]”h ]”h"]”h$]”h&]”uh1jhjubj)”}”(hŒ[If problem needs vendor support, provide a way to gather all needed debugging information. ”h]”hï)”}”(hŒZIf problem needs vendor support, provide a way to gather all needed debugging information.”h]”hŒZIf problem needs vendor support, provide a way to gather all needed debugging information.”…””}”(hjQh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´KhjMubah}”(h]”h ]”h"]”h$]”h&]”uh1jhjubeh}”(h]”h ]”h"]”h$]”h&]”Œbullet”Œ*”uh1jh³hÇh´K hjubah}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´K hhÝh²hubeh}”(h]”Œ background”ah ]”h"]”Œ background”ah$]”h&]”uh1hÈhhÊh²hh³hÇh´KubhÉ)”}”(hhh]”(hÎ)”}”(hŒOverview”h]”hŒOverview”…””}”(hj~h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhj{h²hh³hÇh´Kubhï)”}”(hŒÂThe main idea is to unify and centralize driver health reports in the generic ``devlink`` instance and allow the user to set different attributes of the health reporting and recovery procedures.”h]”(hŒNThe main idea is to unify and centralize driver health reports in the generic ”…””}”(hjŒh²hh³Nh´Nubhù)”}”(hŒ ``devlink``”h]”hŒdevlink”…””}”(hj”h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1høhjŒubhŒi instance and allow the user to set different attributes of the health reporting and recovery procedures.”…””}”(hjŒh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´Khj{h²hubhï)”}”(hX´The ``devlink`` health reporter: Device driver creates a "health reporter" per each error/health type. Error/Health type can be a known/generic (e.g. PCI error, fw error, rx/tx error) or unknown (driver specific). For each registered health reporter a driver can issue error/health reports asynchronously. All health reports handling is done by ``devlink``. Device driver can provide specific callbacks for each "health reporter", e.g.:”h]”(hŒThe ”…””}”(hj¬h²hh³Nh´Nubhù)”}”(hŒ ``devlink``”h]”hŒdevlink”…””}”(hj´h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1høhj¬ubhXN health reporter: Device driver creates a “health reporter†per each error/health type. Error/Health type can be a known/generic (e.g. PCI error, fw error, rx/tx error) or unknown (driver specific). For each registered health reporter a driver can issue error/health reports asynchronously. All health reports handling is done by ”…””}”(hj¬h²hh³Nh´Nubhù)”}”(hŒ ``devlink``”h]”hŒdevlink”…””}”(hjÆh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1høhj¬ubhŒT. Device driver can provide specific callbacks for each “health reporterâ€, e.g.:”…””}”(hj¬h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´Khj{h²hubj)”}”(hŒH* Recovery procedures * Diagnostics procedures * Object dump procedures ”h]”j)”}”(hhh]”(j)”}”(hŒRecovery procedures”h]”hï)”}”(hjçh]”hŒRecovery procedures”…””}”(hjéh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´K!hjåubah}”(h]”h ]”h"]”h$]”h&]”uh1jhjâubj)”}”(hŒDiagnostics procedures”h]”hï)”}”(hjþh]”hŒDiagnostics procedures”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´K"hjüubah}”(h]”h ]”h"]”h$]”h&]”uh1jhjâubj)”}”(hŒObject dump procedures ”h]”hï)”}”(hŒObject dump procedures”h]”hŒObject dump procedures”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´K#hjubah}”(h]”h ]”h"]”h$]”h&]”uh1jhjâubeh}”(h]”h ]”h"]”h$]”h&]”jkjluh1jh³hÇh´K!hjÞubah}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´K!hj{h²hubhï)”}”(hŒdDrivers also provide default values for generic reporter parameters when creating a health reporter.”h]”hŒdDrivers also provide default values for generic reporter parameters when creating a health reporter.”…””}”(hj7h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´K%hj{h²hubhï)”}”(hŒgDifferent parts of the driver can register different types of health reporters with different handlers.”h]”hŒgDifferent parts of the driver can register different types of health reporters with different handlers.”…””}”(hjEh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´K(hj{h²hubeh}”(h]”Œoverview”ah ]”h"]”Œoverview”ah$]”h&]”uh1hÈhhÊh²hh³hÇh´KubhÉ)”}”(hhh]”(hÎ)”}”(hŒActions”h]”hŒActions”…””}”(hj^h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhj[h²hh³hÇh´K,ubhï)”}”(hŒMOnce an error is reported, devlink health will perform the following actions:”h]”hŒMOnce an error is reported, devlink health will perform the following actions:”…””}”(hjlh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´K.hj[h²hubj)”}”(hXò* A log is being send to the kernel trace events buffer * Health status and statistics are being updated for the reporter instance * Object dump is being taken and saved at the reporter instance. This is best effort and skipped when recovery is aborted, auto-dump is disabled, no dump callback is registered, or a dump is already stored. * Auto recovery attempt is being done. Depends on: - Auto-recovery configuration - Grace period (and burst period) vs. time passed since last recover ”h]”j)”}”(hhh]”(j)”}”(hŒ5A log is being send to the kernel trace events buffer”h]”hï)”}”(hjƒh]”hŒ5A log is being send to the kernel trace events buffer”…””}”(hj…h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´K0hjubah}”(h]”h ]”h"]”h$]”h&]”uh1jhj~ubj)”}”(hŒHHealth status and statistics are being updated for the reporter instance”h]”hï)”}”(hjšh]”hŒHHealth status and statistics are being updated for the reporter instance”…””}”(hjœh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´K1hj˜ubah}”(h]”h ]”h"]”h$]”h&]”uh1jhj~ubj)”}”(hŒÌObject dump is being taken and saved at the reporter instance. This is best effort and skipped when recovery is aborted, auto-dump is disabled, no dump callback is registered, or a dump is already stored.”h]”hï)”}”(hŒÌObject dump is being taken and saved at the reporter instance. This is best effort and skipped when recovery is aborted, auto-dump is disabled, no dump callback is registered, or a dump is already stored.”h]”hŒÌObject dump is being taken and saved at the reporter instance. This is best effort and skipped when recovery is aborted, auto-dump is disabled, no dump callback is registered, or a dump is already stored.”…””}”(hj³h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´K2hj¯ubah}”(h]”h ]”h"]”h$]”h&]”uh1jhj~ubj)”}”(hŒ–Auto recovery attempt is being done. Depends on: - Auto-recovery configuration - Grace period (and burst period) vs. time passed since last recover ”h]”(hï)”}”(hŒ0Auto recovery attempt is being done. Depends on:”h]”hŒ0Auto recovery attempt is being done. Depends on:”…””}”(hjËh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´K5hjÇubj)”}”(hhh]”(j)”}”(hŒAuto-recovery configuration”h]”hï)”}”(hjÞh]”hŒAuto-recovery configuration”…””}”(hjàh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´K7hjÜubah}”(h]”h ]”h"]”h$]”h&]”uh1jhjÙubj)”}”(hŒDGrace period (and burst period) vs. time passed since last recover ”h]”hï)”}”(hŒCGrace period (and burst period) vs. time passed since last recover”h]”hŒCGrace period (and burst period) vs. time passed since last recover”…””}”(hj÷h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´K8hjóubah}”(h]”h ]”h"]”h$]”h&]”uh1jhjÙubeh}”(h]”h ]”h"]”h$]”h&]”jkŒ-”uh1jh³hÇh´K7hjÇubeh}”(h]”h ]”h"]”h$]”h&]”uh1jhj~ubeh}”(h]”h ]”h"]”h$]”h&]”jkjluh1jh³hÇh´K0hjzubah}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´K0hj[h²hubeh}”(h]”Œactions”ah ]”h"]”Œactions”ah$]”h&]”uh1hÈhhÊh²hh³hÇh´K,ubhÉ)”}”(hhh]”(hÎ)”}”(hŒDevlink formatted message”h]”hŒDevlink formatted message”…””}”(hj/h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhj,h²hh³hÇh´K;ubhï)”}”(hŒÏTo handle devlink health diagnose and health dump requests, devlink creates a formatted message structure ``devlink_fmsg`` and send it to the driver's callback to fill the data in using the devlink fmsg API.”h]”(hŒjTo handle devlink health diagnose and health dump requests, devlink creates a formatted message structure ”…””}”(hj=h²hh³Nh´Nubhù)”}”(hŒ``devlink_fmsg``”h]”hŒ devlink_fmsg”…””}”(hjEh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1høhj=ubhŒW and send it to the driver’s callback to fill the data in using the devlink fmsg API.”…””}”(hj=h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´K=hj,h²hubhï)”}”(hŒóDevlink fmsg is a mechanism to pass descriptors between drivers and devlink, in json-like format. The API allows the driver to add nested attributes such as object, object pair and value array, in addition to attributes such as name and value.”h]”hŒóDevlink fmsg is a mechanism to pass descriptors between drivers and devlink, in json-like format. The API allows the driver to add nested attributes such as object, object pair and value array, in addition to attributes such as name and value.”…””}”(hj]h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´KAhj,h²hubhï)”}”(hX„Driver should use this API to fill the fmsg context in a format which will be translated by the devlink to the netlink message later. When it needs to send the data using SKBs to the netlink layer, it fragments the data between different SKBs. In order to do this fragmentation, it uses virtual nests attributes, to avoid actual nesting use which cannot be divided between different SKBs.”h]”hX„Driver should use this API to fill the fmsg context in a format which will be translated by the devlink to the netlink message later. When it needs to send the data using SKBs to the netlink layer, it fragments the data between different SKBs. In order to do this fragmentation, it uses virtual nests attributes, to avoid actual nesting use which cannot be divided between different SKBs.”…””}”(hjkh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´KFhj,h²hubeh}”(h]”Œdevlink-formatted-message”ah ]”h"]”Œdevlink formatted message”ah$]”h&]”uh1hÈhhÊh²hh³hÇh´K;ubhÉ)”}”(hhh]”(hÎ)”}”(hŒUser Interface”h]”hŒUser Interface”…””}”(hj„h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhjh²hh³hÇh´KNubhï)”}”(hŒæUser can access/change each reporter's parameters and driver specific callbacks via ``devlink``, e.g. per error type (per health reporter). Reporters may be registered for the whole devlink instance or for a specific devlink port.”h]”(hŒVUser can access/change each reporter’s parameters and driver specific callbacks via ”…””}”(hj’h²hh³Nh´Nubhù)”}”(hŒ ``devlink``”h]”hŒdevlink”…””}”(hjšh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1høhj’ubhŒ‡, e.g. per error type (per health reporter). Reporters may be registered for the whole devlink instance or for a specific devlink port.”…””}”(hj’h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´KPhjh²hubj)”}”(hŒ‹* Configure reporter's generic parameters (like: disable/enable auto recovery) * Invoke recovery procedure * Run diagnostics * Object dump ”h]”j)”}”(hhh]”(j)”}”(hŒLConfigure reporter's generic parameters (like: disable/enable auto recovery)”h]”hï)”}”(hj»h]”hŒNConfigure reporter’s generic parameters (like: disable/enable auto recovery)”…””}”(hj½h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´KThj¹ubah}”(h]”h ]”h"]”h$]”h&]”uh1jhj¶ubj)”}”(hŒInvoke recovery procedure”h]”hï)”}”(hjÒh]”hŒInvoke recovery procedure”…””}”(hjÔh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´KUhjÐubah}”(h]”h ]”h"]”h$]”h&]”uh1jhj¶ubj)”}”(hŒRun diagnostics”h]”hï)”}”(hjéh]”hŒRun diagnostics”…””}”(hjëh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´KVhjçubah}”(h]”h ]”h"]”h$]”h&]”uh1jhj¶ubj)”}”(hŒ Object dump ”h]”hï)”}”(hŒ Object dump”h]”hŒ Object dump”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´KWhjþubah}”(h]”h ]”h"]”h$]”h&]”uh1jhj¶ubeh}”(h]”h ]”h"]”h$]”h&]”jkjluh1jh³hÇh´KThj²ubah}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´KThjh²hubhŒtable”“”)”}”(hhh]”(hÎ)”}”(hŒ!List of devlink health interfaces”h]”hŒ!List of devlink health interfaces”…””}”(hj'h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍh³hÇh´KYhj$ubhŒtgroup”“”)”}”(hhh]”(hŒcolspec”“”)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œcolwidth”K uh1j:hj7ubj;)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”jEKZuh1j:hj7ubhŒtbody”“”)”}”(hhh]”(hŒrow”“”)”}”(hhh]”(hŒentry”“”)”}”(hhh]”hï)”}”(hŒName”h]”hŒName”…””}”(hj^h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´K\hj[ubah}”(h]”h ]”h"]”h$]”h&]”uh1jYhjVubjZ)”}”(hhh]”hï)”}”(hŒ Description”h]”hŒ Description”…””}”(hjuh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´K]hjrubah}”(h]”h ]”h"]”h$]”h&]”uh1jYhjVubeh}”(h]”h ]”h"]”h$]”h&]”uh1jThjQubjU)”}”(hhh]”(jZ)”}”(hhh]”hï)”}”(hŒ#``DEVLINK_CMD_HEALTH_REPORTER_GET``”h]”hù)”}”(hj—h]”hŒDEVLINK_CMD_HEALTH_REPORTER_GET”…””}”(hj™h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1høhj•ubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´K^hj’ubah}”(h]”h ]”h"]”h$]”h&]”uh1jYhjubjZ)”}”(hhh]”hï)”}”(hŒ=Retrieves status and configuration info per DEV and reporter.”h]”hŒ=Retrieves status and configuration info per DEV and reporter.”…””}”(hjµh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´K_hj²ubah}”(h]”h ]”h"]”h$]”h&]”uh1jYhjubeh}”(h]”h ]”h"]”h$]”h&]”uh1jThjQubjU)”}”(hhh]”(jZ)”}”(hhh]”hï)”}”(hŒ#``DEVLINK_CMD_HEALTH_REPORTER_SET``”h]”hù)”}”(hj×h]”hŒDEVLINK_CMD_HEALTH_REPORTER_SET”…””}”(hjÙh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1høhjÕubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´K`hjÒubah}”(h]”h ]”h"]”h$]”h&]”uh1jYhjÏubjZ)”}”(hhh]”hï)”}”(hŒ.Allows reporter-related configuration setting.”h]”hŒ.Allows reporter-related configuration setting.”…””}”(hjõh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´Kahjòubah}”(h]”h ]”h"]”h$]”h&]”uh1jYhjÏubeh}”(h]”h ]”h"]”h$]”h&]”uh1jThjQubjU)”}”(hhh]”(jZ)”}”(hhh]”hï)”}”(hŒ'``DEVLINK_CMD_HEALTH_REPORTER_RECOVER``”h]”hù)”}”(hjh]”hŒ#DEVLINK_CMD_HEALTH_REPORTER_RECOVER”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1høhjubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´Kbhjubah}”(h]”h ]”h"]”h$]”h&]”uh1jYhjubjZ)”}”(hhh]”hï)”}”(hŒ'Triggers reporter's recovery procedure.”h]”hŒ)Triggers reporter’s recovery procedure.”…””}”(hj5h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´Kchj2ubah}”(h]”h ]”h"]”h$]”h&]”uh1jYhjubeh}”(h]”h ]”h"]”h$]”h&]”uh1jThjQubjU)”}”(hhh]”(jZ)”}”(hhh]”hï)”}”(hŒ$``DEVLINK_CMD_HEALTH_REPORTER_TEST``”h]”hù)”}”(hjWh]”hŒ DEVLINK_CMD_HEALTH_REPORTER_TEST”…””}”(hjYh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1høhjUubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´KdhjRubah}”(h]”h ]”h"]”h$]”h&]”uh1jYhjOubjZ)”}”(hhh]”hï)”}”(hŒ‘Triggers a fake health event on the reporter. The effects of the test event in terms of recovery flow should follow closely that of a real event.”h]”hŒ‘Triggers a fake health event on the reporter. The effects of the test event in terms of recovery flow should follow closely that of a real event.”…””}”(hjuh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´Kehjrubah}”(h]”h ]”h"]”h$]”h&]”uh1jYhjOubeh}”(h]”h ]”h"]”h$]”h&]”uh1jThjQubjU)”}”(hhh]”(jZ)”}”(hhh]”hï)”}”(hŒ(``DEVLINK_CMD_HEALTH_REPORTER_DIAGNOSE``”h]”hù)”}”(hj—h]”hŒ$DEVLINK_CMD_HEALTH_REPORTER_DIAGNOSE”…””}”(hj™h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1høhj•ubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´Khhj’ubah}”(h]”h ]”h"]”h$]”h&]”uh1jYhjubjZ)”}”(hhh]”hï)”}”(hŒ7Retrieves current device state related to the reporter.”h]”hŒ7Retrieves current device state related to the reporter.”…””}”(hjµh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´Kihj²ubah}”(h]”h ]”h"]”h$]”h&]”uh1jYhjubeh}”(h]”h ]”h"]”h$]”h&]”uh1jThjQubjU)”}”(hhh]”(jZ)”}”(hhh]”hï)”}”(hŒ(``DEVLINK_CMD_HEALTH_REPORTER_DUMP_GET``”h]”hù)”}”(hj×h]”hŒ$DEVLINK_CMD_HEALTH_REPORTER_DUMP_GET”…””}”(hjÙh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1høhjÕubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´KjhjÒubah}”(h]”h ]”h"]”h$]”h&]”uh1jYhjÏubjZ)”}”(hhh]”hï)”}”(hŒÈRetrieves the last stored dump. Devlink health saves a single dump. If an dump is not already stored by devlink for this reporter, devlink generates a new dump. Dump output is defined by the reporter.”h]”hŒÈRetrieves the last stored dump. Devlink health saves a single dump. If an dump is not already stored by devlink for this reporter, devlink generates a new dump. Dump output is defined by the reporter.”…””}”(hjõh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´Kkhjòubah}”(h]”h ]”h"]”h$]”h&]”uh1jYhjÏubeh}”(h]”h ]”h"]”h$]”h&]”uh1jThjQubjU)”}”(hhh]”(jZ)”}”(hhh]”hï)”}”(hŒ*``DEVLINK_CMD_HEALTH_REPORTER_DUMP_CLEAR``”h]”hù)”}”(hjh]”hŒ&DEVLINK_CMD_HEALTH_REPORTER_DUMP_CLEAR”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1høhjubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´Kohjubah}”(h]”h ]”h"]”h$]”h&]”uh1jYhjubjZ)”}”(hhh]”hï)”}”(hŒ;Clears the last saved dump file for the specified reporter.”h]”hŒ;Clears the last saved dump file for the specified reporter.”…””}”(hj5h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´Kphj2ubah}”(h]”h ]”h"]”h$]”h&]”uh1jYhjubeh}”(h]”h ]”h"]”h$]”h&]”uh1jThjQubeh}”(h]”h ]”h"]”h$]”h&]”uh1jOhj7ubeh}”(h]”h ]”h"]”h$]”h&]”Œcols”Kuh1j5hj$ubeh}”(h]”Œid1”ah ]”Œcolwidths-given”ah"]”h$]”h&]”uh1j"hjh²hh³Nh´Nubhï)”}”(hŒIThe following diagram provides a general overview of ``devlink-health``::”h]”(hŒ5The following diagram provides a general overview of ”…””}”(hjdh²hh³Nh´Nubhù)”}”(hŒ``devlink-health``”h]”hŒdevlink-health”…””}”(hjlh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1høhjdubhŒ:”…””}”(hjdh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´Krhjh²hubhŒ literal_block”“”)”}”(hXò netlink +--------------------------+ | | | + | | | | +--------------------------+ |request for ops |(diagnose, driver devlink |recover, |dump) +--------+ +--------------------------+ | | | reporter| | | | | +---------v----------+ | | | ops execution | | | | | <----------------------------------+ | | | | | | | | | | | + ^------------------+ | | | | | request for ops | | | | | (recover, dump) | | | | | | | | | +-+------------------+ | | | health report | | health handler | | | +-------------------------------> | | | | | +--------------------+ | | | health reporter create | | | +----------------------------> | +--------+ +--------------------------+”h]”hXò netlink +--------------------------+ | | | + | | | | +--------------------------+ |request for ops |(diagnose, driver devlink |recover, |dump) +--------+ +--------------------------+ | | | reporter| | | | | +---------v----------+ | | | ops execution | | | | | <----------------------------------+ | | | | | | | | | | | + ^------------------+ | | | | | request for ops | | | | | (recover, dump) | | | | | | | | | +-+------------------+ | | | health report | | health handler | | | +-------------------------------> | | | | | +--------------------+ | | | health reporter create | | | +----------------------------> | +--------+ +--------------------------+”…””}”hj†sbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1j„h³hÇh´Kthjh²hubeh}”(h]”Œuser-interface”ah ]”h"]”Œuser interface”ah$]”h&]”uh1hÈhhÊh²hh³hÇh´KNubeh}”(h]”Œdevlink-health”ah ]”h"]”Œdevlink health”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”jYŒ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žjxjujXjUj)j&j~j{j™j–uŒ nametypes”}”(j¡‰jx‰jX‰j)‰j~‰j™‰uh}”(jžhÊjuhÝjUj{j&j[j{j,j–jj^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”“”}”jÔKs…”R”Œparse_messages”]”Œtransform_messages”]”Œ transformer”NŒ include_log”]”Œ decoration”Nh²hub.