sphinx.addnodesdocument)}( rawsourcechildren]( translations LanguagesNode)}(hhh](h pending_xref)}(hhh]docutils.nodesTextEnglish}parenthsba attributes}(ids]classes]names]dupnames]backrefs] refdomainstdreftypedoc reftarget/PCI/msi-howtomodnameN classnameN refexplicitutagnamehhh ubh)}(hhh]hChinese (Traditional)}hh2sbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget!/translations/zh_TW/PCI/msi-howtomodnameN classnameN refexplicituh1hhh ubh)}(hhh]hItalian}hhFsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget!/translations/it_IT/PCI/msi-howtomodnameN classnameN refexplicituh1hhh ubh)}(hhh]hJapanese}hhZsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget!/translations/ja_JP/PCI/msi-howtomodnameN classnameN refexplicituh1hhh ubh)}(hhh]hKorean}hhnsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget!/translations/ko_KR/PCI/msi-howtomodnameN classnameN refexplicituh1hhh ubh)}(hhh]hSpanish}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget!/translations/sp_SP/PCI/msi-howtomodnameN classnameN refexplicituh1hhh ubeh}(h]h ]h"]h$]h&]current_languageChinese (Simplified)uh1h hh _documenthsourceNlineNubhcomment)}(h SPDX-License-Identifier: GPL-2.0h]h SPDX-License-Identifier: GPL-2.0}hhsbah}(h]h ]h"]h$]h&] xml:spacepreserveuh1hhhhhhN/var/lib/git/docbuild/linux/Documentation/translations/zh_CN/PCI/msi-howto.rsthKubh)}(h4This data file has been placed in the public domain.h]h4This data file has been placed in the public domain.}hhsbah}(h]h ]h"]h$]h&]hhuh1hhhhhho/srv/docbuild/lib/venvs/build-kernel-docs/lib64/python3.9/site-packages/docutils/parsers/rst/include/isonum.txthKubh)}(hDerived from the Unicode character mappings available from . Processed by unicode2rstsubs.py, part of Docutils: .h]hDerived from the Unicode character mappings available from . Processed by unicode2rstsubs.py, part of Docutils: .}hhsbah}(h]h ]h"]h$]h&]hhuh1hhhhhhhhKubhsubstitution_definition)}(h*.. |amp| unicode:: U+00026 .. AMPERSANDh]h&}hhsbah}(h]h ]h"]ampah$]h&]uh1hhhhKhhhhubh)}(h+.. |apos| unicode:: U+00027 .. APOSTROPHEh]h'}hhsbah}(h]h ]h"]aposah$]h&]uh1hhhhKhhhhubh)}(h).. |ast| unicode:: U+0002A .. ASTERISKh]h*}hhsbah}(h]h ]h"]astah$]h&]uh1hhhhK hhhhubh)}(h+.. |brvbar| unicode:: U+000A6 .. BROKEN BARh]h¦}hjsbah}(h]h ]h"]brvbarah$]h&]uh1hhhhK hhhhubh)}(h0.. |bsol| unicode:: U+0005C .. REVERSE SOLIDUSh]h\}hjsbah}(h]h ]h"]bsolah$]h&]uh1hhhhK hhhhubh)}(h*.. |cent| unicode:: U+000A2 .. CENT SIGNh]h¢}hjsbah}(h]h ]h"]centah$]h&]uh1hhhhK hhhhubh)}(h&.. |colon| unicode:: U+0003A .. COLONh]h:}hj-sbah}(h]h ]h"]colonah$]h&]uh1hhhhK hhhhubh)}(h&.. |comma| unicode:: U+0002C .. COMMAh]h,}hj<sbah}(h]h ]h"]commaah$]h&]uh1hhhhKhhhhubh)}(h... |commat| unicode:: U+00040 .. COMMERCIAL ATh]h@}hjKsbah}(h]h ]h"]commatah$]h&]uh1hhhhKhhhhubh)}(h/.. |copy| unicode:: U+000A9 .. COPYRIGHT SIGNh]h©}hjZsbah}(h]h ]h"]copyah$]h&]uh1hhhhKhhhhubh)}(h... |curren| unicode:: U+000A4 .. CURRENCY SIGNh]h¤}hjisbah}(h]h ]h"]currenah$]h&]uh1hhhhKhhhhubh)}(h0.. |darr| unicode:: U+02193 .. DOWNWARDS ARROWh]h↓}hjxsbah}(h]h ]h"]darrah$]h&]uh1hhhhKhhhhubh)}(h,.. |deg| unicode:: U+000B0 .. DEGREE SIGNh]h°}hjsbah}(h]h ]h"]degah$]h&]uh1hhhhKhhhhubh)}(h... |divide| unicode:: U+000F7 .. DIVISION SIGNh]h÷}hjsbah}(h]h ]h"]divideah$]h&]uh1hhhhKhhhhubh)}(h,.. |dollar| unicode:: U+00024 .. DOLLAR SIGNh]h$}hjsbah}(h]h ]h"]dollarah$]h&]uh1hhhhKhhhhubh)}(h,.. |equals| unicode:: U+0003D .. EQUALS SIGNh]h=}hjsbah}(h]h ]h"]equalsah$]h&]uh1hhhhKhhhhubh)}(h1.. |excl| unicode:: U+00021 .. EXCLAMATION MARKh]h!}hjsbah}(h]h ]h"]exclah$]h&]uh1hhhhKhhhhubh)}(h9.. |frac12| unicode:: U+000BD .. VULGAR FRACTION ONE HALFh]h½}hjsbah}(h]h ]h"]frac12ah$]h&]uh1hhhhKhhhhubh)}(h<.. |frac14| unicode:: U+000BC .. VULGAR FRACTION ONE QUARTERh]h¼}hjsbah}(h]h ]h"]frac14ah$]h&]uh1hhhhKhhhhubh)}(h;.. |frac18| unicode:: U+0215B .. VULGAR FRACTION ONE EIGHTHh]h⅛}hjsbah}(h]h ]h"]frac18ah$]h&]uh1hhhhKhhhhubh)}(h?.. |frac34| unicode:: U+000BE .. VULGAR FRACTION THREE QUARTERSh]h¾}hjsbah}(h]h ]h"]frac34ah$]h&]uh1hhhhKhhhhubh)}(h>.. |frac38| unicode:: U+0215C .. VULGAR FRACTION THREE EIGHTHSh]h⅜}hjsbah}(h]h ]h"]frac38ah$]h&]uh1hhhhKhhhhubh)}(h=.. |frac58| unicode:: U+0215D .. VULGAR FRACTION FIVE EIGHTHSh]h⅝}hjsbah}(h]h ]h"]frac58ah$]h&]uh1hhhhKhhhhubh)}(h>.. |frac78| unicode:: U+0215E .. VULGAR FRACTION SEVEN EIGHTHSh]h⅞}hj,sbah}(h]h ]h"]frac78ah$]h&]uh1hhhhKhhhhubh)}(h2.. |gt| unicode:: U+0003E .. GREATER-THAN SIGNh]h>}hj;sbah}(h]h ]h"]gtah$]h&]uh1hhhhKhhhhubh)}(h9.. |half| unicode:: U+000BD .. VULGAR FRACTION ONE HALFh]h½}hjJsbah}(h]h ]h"]halfah$]h&]uh1hhhhK hhhhubh)}(h/.. |horbar| unicode:: U+02015 .. HORIZONTAL BARh]h―}hjYsbah}(h]h ]h"]horbarah$]h&]uh1hhhhK!hhhhubh)}(h'.. |hyphen| unicode:: U+02010 .. HYPHENh]h‐}hjhsbah}(h]h ]h"]hyphenah$]h&]uh1hhhhK"hhhhubh)}(h:.. |iexcl| unicode:: U+000A1 .. INVERTED EXCLAMATION MARKh]h¡}hjwsbah}(h]h ]h"]iexclah$]h&]uh1hhhhK#hhhhubh)}(h7.. |iquest| unicode:: U+000BF .. INVERTED QUESTION MARKh]h¿}hjsbah}(h]h ]h"]iquestah$]h&]uh1hhhhK$hhhhubh)}(hJ.. |laquo| unicode:: U+000AB .. LEFT-POINTING DOUBLE ANGLE QUOTATION MARKh]h«}hjsbah}(h]h ]h"]laquoah$]h&]uh1hhhhK%hhhhubh)}(h0.. |larr| unicode:: U+02190 .. LEFTWARDS ARROWh]h←}hjsbah}(h]h ]h"]larrah$]h&]uh1hhhhK&hhhhubh)}(h3.. |lcub| unicode:: U+0007B .. LEFT CURLY BRACKETh]h{}hjsbah}(h]h ]h"]lcubah$]h&]uh1hhhhK'hhhhubh)}(h;.. |ldquo| unicode:: U+0201C .. LEFT DOUBLE QUOTATION MARKh]h“}hjsbah}(h]h ]h"]ldquoah$]h&]uh1hhhhK(hhhhubh)}(h).. |lowbar| unicode:: U+0005F .. LOW LINEh]h_}hjsbah}(h]h ]h"]lowbarah$]h&]uh1hhhhK)hhhhubh)}(h1.. |lpar| unicode:: U+00028 .. LEFT PARENTHESISh]h(}hjsbah}(h]h ]h"]lparah$]h&]uh1hhhhK*hhhhubh)}(h4.. |lsqb| unicode:: U+0005B .. LEFT SQUARE BRACKETh]h[}hjsbah}(h]h ]h"]lsqbah$]h&]uh1hhhhK+hhhhubh)}(h;.. |lsquo| unicode:: U+02018 .. LEFT SINGLE QUOTATION MARKh]h‘}hjsbah}(h]h ]h"]lsquoah$]h&]uh1hhhhK,hhhhubh)}(h/.. |lt| unicode:: U+0003C .. LESS-THAN SIGNh]h<}hj sbah}(h]h ]h"]ltah$]h&]uh1hhhhK-hhhhubh)}(h+.. |micro| unicode:: U+000B5 .. MICRO SIGNh]hµ}hjsbah}(h]h ]h"]microah$]h&]uh1hhhhK.hhhhubh)}(h+.. |middot| unicode:: U+000B7 .. MIDDLE DOTh]h·}hj+sbah}(h]h ]h"]middotah$]h&]uh1hhhhK/hhhhubh)}(h/.. |nbsp| unicode:: U+000A0 .. NO-BREAK SPACEh]h }hj:sbah}(h]h ]h"]nbspah$]h&]uh1hhhhK0hhhhubh)}(h).. |not| unicode:: U+000AC .. NOT SIGNh]h¬}hjIsbah}(h]h ]h"]notah$]h&]uh1hhhhK1hhhhubh)}(h,.. |num| unicode:: U+00023 .. NUMBER SIGNh]h#}hjXsbah}(h]h ]h"]numah$]h&]uh1hhhhK2hhhhubh)}(h).. |ohm| unicode:: U+02126 .. OHM SIGNh]hΩ}hjgsbah}(h]h ]h"]ohmah$]h&]uh1hhhhK3hhhhubh)}(h;.. |ordf| unicode:: U+000AA .. FEMININE ORDINAL INDICATORh]hª}hjvsbah}(h]h ]h"]ordfah$]h&]uh1hhhhK4hhhhubh)}(h<.. |ordm| unicode:: U+000BA .. MASCULINE ORDINAL INDICATORh]hº}hjsbah}(h]h ]h"]ordmah$]h&]uh1hhhhK5hhhhubh)}(h-.. |para| unicode:: U+000B6 .. PILCROW SIGNh]h¶}hjsbah}(h]h ]h"]paraah$]h&]uh1hhhhK6hhhhubh)}(h-.. |percnt| unicode:: U+00025 .. PERCENT SIGNh]h%}hjsbah}(h]h ]h"]percntah$]h&]uh1hhhhK7hhhhubh)}(h*.. |period| unicode:: U+0002E .. FULL STOPh]h.}hjsbah}(h]h ]h"]periodah$]h&]uh1hhhhK8hhhhubh)}(h*.. |plus| unicode:: U+0002B .. PLUS SIGNh]h+}hjsbah}(h]h ]h"]plusah$]h&]uh1hhhhK9hhhhubh)}(h0.. |plusmn| unicode:: U+000B1 .. PLUS-MINUS SIGNh]h±}hjsbah}(h]h ]h"]plusmnah$]h&]uh1hhhhK:hhhhubh)}(h+.. |pound| unicode:: U+000A3 .. POUND SIGNh]h£}hjsbah}(h]h ]h"]poundah$]h&]uh1hhhhK;hhhhubh)}(h... |quest| unicode:: U+0003F .. QUESTION MARKh]h?}hjsbah}(h]h ]h"]questah$]h&]uh1hhhhKhhhhubh)}(h1.. |rarr| unicode:: U+02192 .. RIGHTWARDS ARROWh]h→}hjsbah}(h]h ]h"]rarrah$]h&]uh1hhhhK?hhhhubh)}(h4.. |rcub| unicode:: U+0007D .. RIGHT CURLY BRACKETh]h}}hj*sbah}(h]h ]h"]rcubah$]h&]uh1hhhhK@hhhhubh)}(h<.. |rdquo| unicode:: U+0201D .. RIGHT DOUBLE QUOTATION MARKh]h”}hj9sbah}(h]h ]h"]rdquoah$]h&]uh1hhhhKAhhhhubh)}(h0.. |reg| unicode:: U+000AE .. REGISTERED SIGNh]h®}hjHsbah}(h]h ]h"]regah$]h&]uh1hhhhKBhhhhubh)}(h2.. |rpar| unicode:: U+00029 .. RIGHT PARENTHESISh]h)}hjWsbah}(h]h ]h"]rparah$]h&]uh1hhhhKChhhhubh)}(h5.. |rsqb| unicode:: U+0005D .. RIGHT SQUARE BRACKETh]h]}hjfsbah}(h]h ]h"]rsqbah$]h&]uh1hhhhKDhhhhubh)}(h<.. |rsquo| unicode:: U+02019 .. RIGHT SINGLE QUOTATION MARKh]h’}hjusbah}(h]h ]h"]rsquoah$]h&]uh1hhhhKEhhhhubh)}(h-.. |sect| unicode:: U+000A7 .. SECTION SIGNh]h§}hjsbah}(h]h ]h"]sectah$]h&]uh1hhhhKFhhhhubh)}(h*.. |semi| unicode:: U+0003B .. SEMICOLONh]h;}hjsbah}(h]h ]h"]semiah$]h&]uh1hhhhKGhhhhubh)}(h,.. |shy| unicode:: U+000AD .. SOFT HYPHENh]h­}hjsbah}(h]h ]h"]shyah$]h&]uh1hhhhKHhhhhubh)}(h(.. |sol| unicode:: U+0002F .. SOLIDUSh]h/}hjsbah}(h]h ]h"]solah$]h&]uh1hhhhKIhhhhubh)}(h,.. |sung| unicode:: U+0266A .. EIGHTH NOTEh]h♪}hjsbah}(h]h ]h"]sungah$]h&]uh1hhhhKJhhhhubh)}(h0.. |sup1| unicode:: U+000B9 .. SUPERSCRIPT ONEh]h¹}hjsbah}(h]h ]h"]sup1ah$]h&]uh1hhhhKKhhhhubh)}(h0.. |sup2| unicode:: U+000B2 .. SUPERSCRIPT TWOh]h²}hjsbah}(h]h ]h"]sup2ah$]h&]uh1hhhhKLhhhhubh)}(h2.. |sup3| unicode:: U+000B3 .. SUPERSCRIPT THREEh]h³}hjsbah}(h]h ]h"]sup3ah$]h&]uh1hhhhKMhhhhubh)}(h4.. |times| unicode:: U+000D7 .. MULTIPLICATION SIGNh]h×}hjsbah}(h]h ]h"]timesah$]h&]uh1hhhhKNhhhhubh)}(h0.. |trade| unicode:: U+02122 .. TRADE MARK SIGNh]h™}hj sbah}(h]h ]h"]tradeah$]h&]uh1hhhhKOhhhhubh)}(h... |uarr| unicode:: U+02191 .. UPWARDS ARROWh]h↑}hjsbah}(h]h ]h"]uarrah$]h&]uh1hhhhKPhhhhubh)}(h... |verbar| unicode:: U+0007C .. VERTICAL LINEh]h|}hj)sbah}(h]h ]h"]verbarah$]h&]uh1hhhhKQhhhhubh)}(h*.. |yen| unicode:: U+000A5 .. YEN SIGN h]h¥}hj8sbah}(h]h ]h"]yenah$]h&]uh1hhhhKRhhhhubhnote)}(hX{此文件的目的是为让中文读者更容易阅读和理解,而不是作为一个分支。 因此, 如果您对此文件有任何意见或更新,请先尝试更新原始英文文件。 如果您发现本文档与原始文件有任何不同或者有翻译问题,请发建议或者补丁给 该文件的译者,或者请求中文文档维护者和审阅者的帮助。h]h paragraph)}(hX{此文件的目的是为让中文读者更容易阅读和理解,而不是作为一个分支。 因此, 如果您对此文件有任何意见或更新,请先尝试更新原始英文文件。 如果您发现本文档与原始文件有任何不同或者有翻译问题,请发建议或者补丁给 该文件的译者,或者请求中文文档维护者和审阅者的帮助。h]hX{此文件的目的是为让中文读者更容易阅读和理解,而不是作为一个分支。 因此, 如果您对此文件有任何意见或更新,请先尝试更新原始英文文件。 如果您发现本文档与原始文件有任何不同或者有翻译问题,请发建议或者补丁给 该文件的译者,或者请求中文文档维护者和审阅者的帮助。}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1jMh5Documentation/translations/zh_CN/disclaimer-zh_CN.rsthKhjIubah}(h]h ]h"]h$]h&]uh1jGhhhhhj]hNubh field_list)}(hhh](hfield)}(hhh](h field_name)}(hOriginalh]hOriginal}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1jnhjkhhhKubh field_body)}(h Documentation/PCI/msi-howto.rst h]jN)}(hDocumentation/PCI/msi-howto.rsth]hDocumentation/PCI/msi-howto.rst}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jMhhhKhjubah}(h]h ]h"]h$]h&]uh1j~hjkubeh}(h]h ]h"]h$]h&]uh1jihhhKhjfhhubjj)}(hhh](jo)}(h翻译h]h翻译}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jnhjhhhKubj)}(h-司延腾 Yanteng Si h]jN)}(h,司延腾 Yanteng Si h](h司延腾 Yanteng Si <}(hjhhhNhNubh reference)}(hsiyanteng@loongson.cnh]hsiyanteng@loongson.cn}(hjhhhNhNubah}(h]h ]h"]h$]h&]refurimailto:siyanteng@loongson.cnuh1jhjubh>}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jMhhhK hjubah}(h]h ]h"]h$]h&]uh1j~hjubeh}(h]h ]h"]h$]h&]uh1jihhhKhjfhhubjj)}(hhh](jo)}(h校译h]h校译}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jnhjhhhKubj)}(hhh]h}(h]h ]h"]h$]h&]uh1j~hjubeh}(h]h ]h"]h$]h&]uh1jihhhK hjfhhubeh}(h]h ]h"]h$]h&]uh1jdhhhhhhhKubhsection)}(hhh](htitle)}(hMSI驱动指南h]hMSI驱动指南}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj hhhhhKubje)}(hhh](jj)}(hhh](jo)}(h作者h]h作者}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jnhj!hhhKubj)}(h1Tom L Nguyen; Martine Silbermann; Matthew Wilcox h]jN)}(h0Tom L Nguyen; Martine Silbermann; Matthew Wilcoxh]h0Tom L Nguyen; Martine Silbermann; Matthew Wilcox}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jMhhhKhj2ubah}(h]h ]h"]h$]h&]uh1j~hj!ubeh}(h]h ]h"]h$]h&]uh1jihhhKhjhhubjj)}(hhh](jo)}(h版权h]h版权}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1jnhjPhhhKubj)}(h2003, 2008 Intel Corporation h]jN)}(h2003, 2008 Intel Corporationh]h2003, 2008 Intel Corporation}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1jMhhhKhjaubah}(h]h ]h"]h$]h&]uh1j~hjPubeh}(h]h ]h"]h$]h&]uh1jihhhKhjhhubeh}(h]h ]h"]h$]h&]uh1jdhj hhhhhKubj )}(hhh](j)}(h关于本指南h]h关于本指南}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjhhhhhKubjN)}(h本指南介绍了消息标记中断(MSI)的基本知识,使用MSI相对于传统中断机制的优势,如何 改变你的驱动程序以使用MSI或MSI-X,以及在设备不支持MSI时可以尝试的一些基本诊断方法。h]h本指南介绍了消息标记中断(MSI)的基本知识,使用MSI相对于传统中断机制的优势,如何 改变你的驱动程序以使用MSI或MSI-X,以及在设备不支持MSI时可以尝试的一些基本诊断方法。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jMhhhKhjhhubeh}(h]id1ah ]h"]关于本指南ah$]h&]uh1j hj hhhhhKubj )}(hhh](j)}(h 什么是MSI?h]h 什么是MSI?}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjhhhhhKubjN)}(h`信息信号中断是指从设备写到一个特殊的地址,导致CPU接收到一个中断。h]h`信息信号中断是指从设备写到一个特殊的地址,导致CPU接收到一个中断。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jMhhhK!hjhhubjN)}(hMSI能力首次在PCI 2.2中规定,后来在PCI 3.0中得到增强,允许对每个中断进行单独屏蔽。 MSI-X功能也随着PCI 3.0被引入。它比MSI支持每个设备更多的中断,并允许独立配置中断。h]hMSI能力首次在PCI 2.2中规定,后来在PCI 3.0中得到增强,允许对每个中断进行单独屏蔽。 MSI-X功能也随着PCI 3.0被引入。它比MSI支持每个设备更多的中断,并允许独立配置中断。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jMhhhK#hjhhubjN)}(hD设备可以同时支持MSI和MSI-X,但一次只能启用一个。h]hD设备可以同时支持MSI和MSI-X,但一次只能启用一个。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jMhhhK&hjhhubeh}(h]id2ah ]h"] 什么是msi?ah$]h&]uh1j hj hhhhhKubj )}(hhh](j)}(h为什么用MSI?h]h为什么用MSI?}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjhhhhhK*ubjN)}(hZ有三个原因可以说明为什么使用MSI比传统的基于针脚的中断有优势。h]hZ有三个原因可以说明为什么使用MSI比传统的基于针脚的中断有优势。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jMhhhK,hjhhubjN)}(h基于针脚的PCI中断通常在几个设备之间共享。为了支持这一点,内核必须调用每个与中断相 关的中断处理程序,这导致了整个系统性能的降低。MSI从不共享,所以这个问题不会出现。h]h基于针脚的PCI中断通常在几个设备之间共享。为了支持这一点,内核必须调用每个与中断相 关的中断处理程序,这导致了整个系统性能的降低。MSI从不共享,所以这个问题不会出现。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jMhhhK.hjhhubjN)}(hX`当一个设备将数据写入内存,然后引发一个基于引脚的中断时,有可能在所有的数据到达内存 之前,中断就已经到达了(这在PCI-PCI桥后面的设备中变得更有可能)。为了确保所有的数 据已经到达内存中,中断处理程序必须在引发中断的设备上读取一个寄存器。PCI事务排序规 则要求所有的数据在返回寄存器的值之前到达内存。使用MSI可以避免这个问题,因为中断产 生的写入不能通过数据写入,所以当中断发生时,驱动程序知道所有的数据已经到达内存中。h]hX`当一个设备将数据写入内存,然后引发一个基于引脚的中断时,有可能在所有的数据到达内存 之前,中断就已经到达了(这在PCI-PCI桥后面的设备中变得更有可能)。为了确保所有的数 据已经到达内存中,中断处理程序必须在引发中断的设备上读取一个寄存器。PCI事务排序规 则要求所有的数据在返回寄存器的值之前到达内存。使用MSI可以避免这个问题,因为中断产 生的写入不能通过数据写入,所以当中断发生时,驱动程序知道所有的数据已经到达内存中。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jMhhhK1hjhhubjN)}(hX>PCI设备每个功能只能支持一个基于引脚的中断。通常情况下,驱动程序必须查询设备以找出 发生了什么事件,这就减慢了对常见情况的中断处理。有了MSI,设备可以支持更多的中断, 允许每个中断被专门用于不同的目的。一种可能的设计是给不经常发生的情况(如错误)提供 自己的中断,这使得驱动程序可以更有效地处理正常的中断处理路径。其他可能的设计包括给 网卡的每个数据包队列或存储控制器的每个端口提供一个中断。h]hX>PCI设备每个功能只能支持一个基于引脚的中断。通常情况下,驱动程序必须查询设备以找出 发生了什么事件,这就减慢了对常见情况的中断处理。有了MSI,设备可以支持更多的中断, 允许每个中断被专门用于不同的目的。一种可能的设计是给不经常发生的情况(如错误)提供 自己的中断,这使得驱动程序可以更有效地处理正常的中断处理路径。其他可能的设计包括给 网卡的每个数据包队列或存储控制器的每个端口提供一个中断。}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1jMhhhK7hjhhubeh}(h]id3ah ]h"]为什么用msi?ah$]h&]uh1j hj hhhhhK*ubj )}(hhh](j)}(h如何使用MSIh]h如何使用MSI}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1jhj@hhhhhK?ubjN)}(hXPCI设备被初始化为使用基于引脚的中断。设备驱动程序必须将设备设置为使用MSI或MSI-X。 并非所有的机器都能正确地支持MSI,对于这些机器,下面描述的API将简单地失败,设备将 继续使用基于引脚的中断。h]hXPCI设备被初始化为使用基于引脚的中断。设备驱动程序必须将设备设置为使用MSI或MSI-X。 并非所有的机器都能正确地支持MSI,对于这些机器,下面描述的API将简单地失败,设备将 继续使用基于引脚的中断。}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jMhhhKAhj@hhubj )}(hhh](j)}(h加入内核对MSI的支持h]h加入内核对MSI的支持}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj_hhhhhKFubjN)}(hX为了支持MSI或MSI-X,内核在构建时必须启用CONFIG_PCI_MSI选项。这个选项只在某些架 构上可用,而且它可能取决于其他一些选项的设置。例如,在x86上,你必须同时启用X86_UP_APIC 或SMP,才能看到CONFIG_PCI_MSI选项。h]hX为了支持MSI或MSI-X,内核在构建时必须启用CONFIG_PCI_MSI选项。这个选项只在某些架 构上可用,而且它可能取决于其他一些选项的设置。例如,在x86上,你必须同时启用X86_UP_APIC 或SMP,才能看到CONFIG_PCI_MSI选项。}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1jMhhhKHhj_hhubeh}(h]id5ah ]h"]加入内核对msi的支持ah$]h&]uh1j hj@hhhhhKFubj )}(hhh](j)}(h 使用MSIh]h 使用MSI}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjhhhhhKMubjN)}(h大部分沉重的工作是在PCI层为驱动程序完成的。驱动程序只需要请求PCI层为这个设备设置 MSI功能。h]h大部分沉重的工作是在PCI层为驱动程序完成的。驱动程序只需要请求PCI层为这个设备设置 MSI功能。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jMhhhKOhjhhubjN)}(h@要自动使用MSI或MSI-X中断向量,请使用以下函数::h]h?要自动使用MSI或MSI-X中断向量,请使用以下函数:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jMhhhKRhjhhubh literal_block)}(hint pci_alloc_irq_vectors(struct pci_dev *dev, unsigned int min_vecs, unsigned int max_vecs, unsigned int flags);h]hint pci_alloc_irq_vectors(struct pci_dev *dev, unsigned int min_vecs, unsigned int max_vecs, unsigned int flags);}hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhKThjhhubjN)}(hX0它为一个PCI设备分配最多至max_vecs的中断向量。它返回分配的向量数量或一个负的错误。 如果设备对最小数量的向量有要求,驱动程序可以传递一个min_vecs参数,设置为这个限制, 如果PCI核不能满足最小数量的向量,将返回-ENOSPC。h]hX0它为一个PCI设备分配最多至max_vecs的中断向量。它返回分配的向量数量或一个负的错误。 如果设备对最小数量的向量有要求,驱动程序可以传递一个min_vecs参数,设置为这个限制, 如果PCI核不能满足最小数量的向量,将返回-ENOSPC。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jMhhhKWhjhhubjN)}(hXCflags参数用来指定设备和驱动程序可以使用哪种类型的中断(PCI_IRQ_INTX, PCI_IRQ_MSI, PCI_IRQ_MSIX)。一个方便的短语(PCI_IRQ_ALL_TYPES)也可以用来要求任何可能的中断类型。 如果PCI_IRQ_AFFINITY标志被设置,pci_alloc_irq_vectors()将把中断分散到可用的CPU上。h]hXCflags参数用来指定设备和驱动程序可以使用哪种类型的中断(PCI_IRQ_INTX, PCI_IRQ_MSI, PCI_IRQ_MSIX)。一个方便的短语(PCI_IRQ_ALL_TYPES)也可以用来要求任何可能的中断类型。 如果PCI_IRQ_AFFINITY标志被设置,pci_alloc_irq_vectors()将把中断分散到可用的CPU上。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jMhhhK[hjhhubjN)}(ha要获得传递给require_irq()和free_irq()的Linux IRQ号码和向量,请使用以下函数::h]h`要获得传递给require_irq()和free_irq()的Linux IRQ号码和向量,请使用以下函数:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jMhhhK_hjhhubj)}(h9int pci_irq_vector(struct pci_dev *dev, unsigned int nr);h]h9int pci_irq_vector(struct pci_dev *dev, unsigned int nr);}hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhKahjhhubjN)}(hM在删除设备之前,应使用以下功能释放任何已分配的资源::h]hL在删除设备之前,应使用以下功能释放任何已分配的资源:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jMhhhKchjhhubj)}(h/void pci_free_irq_vectors(struct pci_dev *dev);h]h/void pci_free_irq_vectors(struct pci_dev *dev);}hj sbah}(h]h ]h"]h$]h&]hhuh1jhhhKehjhhubjN)}(hX如果一个设备同时支持MSI-X和MSI功能,这个API将优先使用MSI-X,而不是MSI。MSI-X支 持1到2048之间的任何数量的中断。相比之下,MSI被限制为最多32个中断(而且必须是2的幂)。 此外,MSI中断向量必须连续分配,所以系统可能无法为MSI分配像MSI-X那样多的向量。在一 些平台上,MSI中断必须全部针对同一组CPU,而MSI-X中断可以全部针对不同的CPU。h]hX如果一个设备同时支持MSI-X和MSI功能,这个API将优先使用MSI-X,而不是MSI。MSI-X支 持1到2048之间的任何数量的中断。相比之下,MSI被限制为最多32个中断(而且必须是2的幂)。 此外,MSI中断向量必须连续分配,所以系统可能无法为MSI分配像MSI-X那样多的向量。在一 些平台上,MSI中断必须全部针对同一组CPU,而MSI-X中断可以全部针对不同的CPU。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jMhhhKghjhhubjN)}(he如果一个设备既不支持MSI-X,也不支持MSI,它就会退回到一个传统的IRQ向量。h]he如果一个设备既不支持MSI-X,也不支持MSI,它就会退回到一个传统的IRQ向量。}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jMhhhKlhjhhubjN)}(hMSI或MSI-X中断的典型用法是分配尽可能多的向量,可能达到设备支持的极限。如果nvec大于 设备支持的数量,它将自动被限制在支持的限度内,所以没有必要事先查询支持的向量的数量。::h]hMSI或MSI-X中断的典型用法是分配尽可能多的向量,可能达到设备支持的极限。如果nvec大于 设备支持的数量,它将自动被限制在支持的限度内,所以没有必要事先查询支持的向量的数量。:}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jMhhhKnhjhhubj)}(hbnvec = pci_alloc_irq_vectors(pdev, 1, nvec, PCI_IRQ_ALL_TYPES) if (nvec < 0) goto out_err;h]hbnvec = pci_alloc_irq_vectors(pdev, 1, nvec, PCI_IRQ_ALL_TYPES) if (nvec < 0) goto out_err;}hjAsbah}(h]h ]h"]h$]h&]hhuh1jhhhKqhjhhubjN)}(h如果一个驱动程序不能或不愿意处理可变数量的MSI中断,它可以要求一个特定数量的中断,将该 数量作为“min_vecs“和“max_vecs“参数传递给pci_alloc_irq_vectors()函数。::h]h如果一个驱动程序不能或不愿意处理可变数量的MSI中断,它可以要求一个特定数量的中断,将该 数量作为“min_vecs“和“max_vecs“参数传递给pci_alloc_irq_vectors()函数。:}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1jMhhhKuhjhhubj)}(hdret = pci_alloc_irq_vectors(pdev, nvec, nvec, PCI_IRQ_ALL_TYPES); if (ret < 0) goto out_err;h]hdret = pci_alloc_irq_vectors(pdev, nvec, nvec, PCI_IRQ_ALL_TYPES); if (ret < 0) goto out_err;}hj]sbah}(h]h ]h"]h$]h&]hhuh1jhhhKxhjhhubjN)}(h上述请求类型的最臭名昭著的例子是为一个设备启用单一的MSI模式。它可以通过传递两个1作为 'min_vecs'和'max_vecs'来实现::h]h上述请求类型的最臭名昭著的例子是为一个设备启用单一的MSI模式。它可以通过传递两个1作为 ‘min_vecs’和’max_vecs’来实现:}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1jMhhhK|hjhhubj)}(h^ret = pci_alloc_irq_vectors(pdev, 1, 1, PCI_IRQ_ALL_TYPES); if (ret < 0) goto out_err;h]h^ret = pci_alloc_irq_vectors(pdev, 1, 1, PCI_IRQ_ALL_TYPES); if (ret < 0) goto out_err;}hjysbah}(h]h ]h"]h$]h&]hhuh1jhhhKhjhhubjN)}(h一些设备可能不支持使用传统的线路中断,在这种情况下,驱动程序可以指定只接受MSI或MSI-X。::h]h~一些设备可能不支持使用传统的线路中断,在这种情况下,驱动程序可以指定只接受MSI或MSI-X。:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jMhhhKhjhhubj)}(hlnvec = pci_alloc_irq_vectors(pdev, 1, nvec, PCI_IRQ_MSI | PCI_IRQ_MSIX); if (nvec < 0) goto out_err;h]hlnvec = pci_alloc_irq_vectors(pdev, 1, nvec, PCI_IRQ_MSI | PCI_IRQ_MSIX); if (nvec < 0) goto out_err;}hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhKhjhhubeh}(h]id6ah ]h"] 使用msiah$]h&]uh1j hj@hhhhhKMubj )}(hhh](j)}(h 传统APIh]h 传统API}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjhhhhhKubjN)}(hU以下用于启用和禁用MSI或MSI-X中断的旧API不应该在新代码中使用::h]hT以下用于启用和禁用MSI或MSI-X中断的旧API不应该在新代码中使用:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jMhhhKhjhhubj)}(hpci_enable_msi() /* deprecated */ pci_disable_msi() /* deprecated */ pci_enable_msix_range() /* deprecated */ pci_enable_msix_exact() /* deprecated */ pci_disable_msix() /* deprecated */h]hpci_enable_msi() /* deprecated */ pci_disable_msi() /* deprecated */ pci_enable_msix_range() /* deprecated */ pci_enable_msix_exact() /* deprecated */ pci_disable_msix() /* deprecated */}hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhKhjhhubjN)}(hX此外,还有一些API来提供支持的MSI或MSI-X向量的数量:pci_msi_vec_count()和 pci_msix_vec_count()。一般来说,应该避免使用这些方法,而是让pci_alloc_irq_vectors() 来限制向量的数量。如果你对向量的数量有合法的特殊用例,我们可能要重新审视这个决定, 并增加一个pci_nr_irq_vectors()助手,透明地处理MSI和MSI-X。h]hX此外,还有一些API来提供支持的MSI或MSI-X向量的数量:pci_msi_vec_count()和 pci_msix_vec_count()。一般来说,应该避免使用这些方法,而是让pci_alloc_irq_vectors() 来限制向量的数量。如果你对向量的数量有合法的特殊用例,我们可能要重新审视这个决定, 并增加一个pci_nr_irq_vectors()助手,透明地处理MSI和MSI-X。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jMhhhKhjhhubeh}(h]apiah ]h"] 传统apiah$]h&]uh1j hj@hhhhhKubj )}(hhh](j)}(h!使用MSI时需要考虑的因素h]h!使用MSI时需要考虑的因素}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjhhhhhKubj )}(hhh](j)}(h 自旋锁h]h 自旋锁}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjhhhhhKubjN)}(hXA大多数设备驱动程序都有一个每的自旋锁,在中断处理程序中被占用。对于基于引脚的中断 或单一的MSI,没有必要禁用中断(Linux保证同一中断不会被重新输入)。如果一个设备 使用多个中断,驱动程序必须在锁被持有的时候禁用中断。如果设备发出一个不同的中断, 驱动程序将死锁,试图递归地获取自旋锁。这种死锁可以通过使用spin_lock_irqsave() 或spin_lock_irq()来避免,它们可以禁用本地中断并获取锁(见《不可靠的锁定指南》)。h]hXA大多数设备驱动程序都有一个每的自旋锁,在中断处理程序中被占用。对于基于引脚的中断 或单一的MSI,没有必要禁用中断(Linux保证同一中断不会被重新输入)。如果一个设备 使用多个中断,驱动程序必须在锁被持有的时候禁用中断。如果设备发出一个不同的中断, 驱动程序将死锁,试图递归地获取自旋锁。这种死锁可以通过使用spin_lock_irqsave() 或spin_lock_irq()来避免,它们可以禁用本地中断并获取锁(见《不可靠的锁定指南》)。}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jMhhhKhjhhubeh}(h]id8ah ]h"] 自旋锁ah$]h&]uh1j hjhhhhhKubeh}(h]id7ah ]h"]!使用msi时需要考虑的因素ah$]h&]uh1j hj@hhhhhKubj )}(hhh](j)}(h3如何判断一个设备上是否启用了MSI/MSI-Xh]h3如何判断一个设备上是否启用了MSI/MSI-X}(hj1 hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj. hhhhhKubjN)}(hX使用“lspci -v“(以root身份)可能会显示一些具有“MSI“、“Message Signalled Interrupts“ 或“MSI-X“功能的设备。这些功能中的每一个都有一个“启用“标志,后面是“+“(启用) 或“-“(禁用)。h]hX使用“lspci -v“(以root身份)可能会显示一些具有“MSI“、“Message Signalled Interrupts“ 或“MSI-X“功能的设备。这些功能中的每一个都有一个“启用“标志,后面是“+“(启用) 或“-“(禁用)。}(hj? hhhNhNubah}(h]h ]h"]h$]h&]uh1jMhhhKhj. hhubeh}(h] msi-msi-xah ]h"]3如何判断一个设备上是否启用了msi/msi-xah$]h&]uh1j hj@hhhhhKubeh}(h]id4ah ]h"]如何使用msiah$]h&]uh1j hj hhhhhK?ubj )}(hhh](j)}(h MSI特性h]h MSI特性}(hj` hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj] hhhhhKubjN)}(hg众所周知,一些PCI芯片组或设备不支持MSI。PCI协议栈提供了三种禁用MSI的方法:h]hg众所周知,一些PCI芯片组或设备不支持MSI。PCI协议栈提供了三种禁用MSI的方法:}(hjn hhhNhNubah}(h]h ]h"]h$]h&]uh1jMhhhKhj] hhubhenumerated_list)}(hhh](h list_item)}(h 全局的h]jN)}(hj h]h 全局的}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jMhhhKhj ubah}(h]h ]h"]h$]h&]uh1j hj~ hhhhhNubj )}(h-在一个特定的桥后面的所有设备上h]jN)}(hj h]h-在一个特定的桥后面的所有设备上}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jMhhhKhj ubah}(h]h ]h"]h$]h&]uh1j hj~ hhhhhNubj )}(h在单一设备上 h]jN)}(h在单一设备上h]h在单一设备上}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jMhhhKhj ubah}(h]h ]h"]h$]h&]uh1j hj~ hhhhhNubeh}(h]h ]h"]h$]h&]enumtypearabicprefixhsuffix.uh1j| hj] hhhhhKubj )}(hhh](j)}(h全局禁用MSIh]h全局禁用MSI}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj hhhhhKubjN)}(hXt一些主控芯片组根本无法正确支持MSI。如果我们幸运的话,制造商知道这一点,并在 ACPI FADT表中指明了它。在这种情况下,Linux会自动禁用MSI。有些板卡在表中没 有包括这一信息,因此我们必须自己检测它们。完整的列表可以在drivers/pci/quirks.c 中的quirk_disable_all_msi()函数附近找到。h]hXt一些主控芯片组根本无法正确支持MSI。如果我们幸运的话,制造商知道这一点,并在 ACPI FADT表中指明了它。在这种情况下,Linux会自动禁用MSI。有些板卡在表中没 有包括这一信息,因此我们必须自己检测它们。完整的列表可以在drivers/pci/quirks.c 中的quirk_disable_all_msi()函数附近找到。}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jMhhhKhj hhubjN)}(hX 如果你有一块有MSI问题的板子,你可以在内核命令行中传递pci=nomsi来禁用所有设 备上的MSI。你最好把问题报告给linux-pci@vger.kernel.org,包括完整的 “lspci -v“,这样我们就可以把这些怪癖添加到内核中。h](h如果你有一块有MSI问题的板子,你可以在内核命令行中传递pci=nomsi来禁用所有设 备上的MSI。你最好把问题报告给linux-}(hj hhhNhNubj)}(hpci@vger.kernel.orgh]hpci@vger.kernel.org}(hj hhhNhNubah}(h]h ]h"]h$]h&]refurimailto:pci@vger.kernel.orguh1jhj ubh],包括完整的 “lspci -v“,这样我们就可以把这些怪癖添加到内核中。}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1jMhhhKhj hhubeh}(h]id10ah ]h"]全局禁用msiah$]h&]uh1j hj] hhhhhKubj )}(hhh](j)}(h禁用桥下的MSIh]h禁用桥下的MSI}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj hhhhhKubjN)}(h一些PCI桥接器不能在总线之间正确地路由MSI。在这种情况下,必须在桥接器后面的所 有设备上禁用MSI。h]h一些PCI桥接器不能在总线之间正确地路由MSI。在这种情况下,必须在桥接器后面的所 有设备上禁用MSI。}(hj. hhhNhNubah}(h]h ]h"]h$]h&]uh1jMhhhKhj hhubjN)}(hX一些桥接器允许你通过改变PCI配置空间的一些位来启用MSI(特别是Hypertransport 芯片组,如nVidia nForce和Serverworks HT2000)。与主机芯片组一样,Linux大 多知道它们,如果可以的话,会自动启用MSI。如果你有一个Linux不知道的网桥,你可以 用你知道的任何方法在配置空间中启用MSI,然后通过以下方式在该网桥上启用MSI::h]hX一些桥接器允许你通过改变PCI配置空间的一些位来启用MSI(特别是Hypertransport 芯片组,如nVidia nForce和Serverworks HT2000)。与主机芯片组一样,Linux大 多知道它们,如果可以的话,会自动启用MSI。如果你有一个Linux不知道的网桥,你可以 用你知道的任何方法在配置空间中启用MSI,然后通过以下方式在该网桥上启用MSI:}(hj< hhhNhNubah}(h]h ]h"]h$]h&]uh1jMhhhKhj hhubj)}(h-echo 1 > /sys/bus/pci/devices/$bridge/msi_bush]h-echo 1 > /sys/bus/pci/devices/$bridge/msi_bus}hjJ sbah}(h]h ]h"]h$]h&]hhuh1jhhhKhj hhubjN)}(hI其中$bridge是你所启用的桥的PCI地址(例如0000:00:0e.0)。h]hI其中$bridge是你所启用的桥的PCI地址(例如0000:00:0e.0)。}(hjX hhhNhNubah}(h]h ]h"]h$]h&]uh1jMhhhKhj hhubjN)}(h要禁用MSI,请回显0而不是1。改变这个值应该谨慎进行,因为它可能会破坏这个桥下面所 有设备的中断处理。h]h要禁用MSI,请回显0而不是1。改变这个值应该谨慎进行,因为它可能会破坏这个桥下面所 有设备的中断处理。}(hjf hhhNhNubah}(h]h ]h"]h$]h&]uh1jMhhhKhj hhubjN)}(hN同样,请通知 linux-pci@vger.kernel.org 任何需要特殊处理的桥。h](h同样,请通知 }(hjt hhhNhNubj)}(hlinux-pci@vger.kernel.orgh]hlinux-pci@vger.kernel.org}(hj| hhhNhNubah}(h]h ]h"]h$]h&]refuri mailto:linux-pci@vger.kernel.orguh1jhjt ubh" 任何需要特殊处理的桥。}(hjt hhhNhNubeh}(h]h ]h"]h$]h&]uh1jMhhhKhj hhubeh}(h]id11ah ]h"]禁用桥下的msiah$]h&]uh1j hj] hhhhhKubj )}(hhh](j)}(h在单一设备上关闭MSIsh]h在单一设备上关闭MSIs}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj hhhhhKubjN)}(hXp众所周知,有些设备的MSI实现是有问题的。通常情况下,这是在单个设备驱动程序中处理的, 但偶尔也有必要用一个古怪的方法来处理。一些驱动程序有一个选项可以禁用MSI的使用。虽然 这对驱动程序的作者来说是一个方便的变通办法,但这不是一个好的做法,不应该被模仿。h]hXp众所周知,有些设备的MSI实现是有问题的。通常情况下,这是在单个设备驱动程序中处理的, 但偶尔也有必要用一个古怪的方法来处理。一些驱动程序有一个选项可以禁用MSI的使用。虽然 这对驱动程序的作者来说是一个方便的变通办法,但这不是一个好的做法,不应该被模仿。}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jMhhhKhj hhubeh}(h]msisah ]h"]在单一设备上关闭msisah$]h&]uh1j hj] hhhhhKubj )}(hhh](j)}(h$寻找设备上MSI被禁用的原因h]h$寻找设备上MSI被禁用的原因}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj hhhhhKubjN)}(hX 从以上三个部分,你可以看到有许多原因导致MSI没有在某个设备上被启用。你的第一步应该是 仔细检查你的dmesg以确定你的机器是否启用了MSI。你还应该检查你的.config以确定你已经 启用了CONFIG_PCI_MSI。h]hX 从以上三个部分,你可以看到有许多原因导致MSI没有在某个设备上被启用。你的第一步应该是 仔细检查你的dmesg以确定你的机器是否启用了MSI。你还应该检查你的.config以确定你已经 启用了CONFIG_PCI_MSI。}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jMhhhKhj hhubjN)}(hX然后,“lspci -t“给出一个设备上面的网列表。读取 ``/sys/bus/pci/devices/*/msi_bus`` 将告诉你MSI是否被启用(1)或禁用(0)。如果在任何属于PCI根和设备之间的桥的msi_bus 文件中发现0,说明MSI被禁用。h](hE然后,“lspci -t“给出一个设备上面的网列表。读取 }(hj hhhNhNubhliteral)}(h"``/sys/bus/pci/devices/*/msi_bus``h]h/sys/bus/pci/devices/*/msi_bus}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j hj ubh 将告诉你MSI是否被启用(1)或禁用(0)。如果在任何属于PCI根和设备之间的桥的msi_bus 文件中发现0,说明MSI被禁用。}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1jMhhhKhj hhubjN)}(h也需要检查设备驱动程序,看它是否支持MSI。例如,它可能包含对带有PCI_IRQ_MSI或 PCI_IRQ_MSIX标志的pci_alloc_irq_vectors()的调用。h]h也需要检查设备驱动程序,看它是否支持MSI。例如,它可能包含对带有PCI_IRQ_MSI或 PCI_IRQ_MSIX标志的pci_alloc_irq_vectors()的调用。}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jMhhhKhj hhubeh}(h]id12ah ]h"]$寻找设备上msi被禁用的原因ah$]h&]uh1j hj] hhhhhKubeh}(h]id9ah ]h"] msi特性ah$]h&]uh1j hj hhhhhKubj )}(hhh](j)}(h$MSI(-X) APIs设备驱动程序列表h]h$MSI(-X) APIs设备驱动程序列表}(hj' hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj$ hhhhhKubjN)}(hPCI/MSI子系统有一个专门的C文件,用于其导出的设备驱动程序APIs - `drivers/pci/msi/api.c` 。 以下是导出的函数:h](hWPCI/MSI子系统有一个专门的C文件,用于其导出的设备驱动程序APIs - }(hj5 hhhNhNubhtitle_reference)}(h`drivers/pci/msi/api.c`h]hdrivers/pci/msi/api.c}(hj? hhhNhNubah}(h]h ]h"]h$]h&]uh1j= hj5 ubh 。 以下是导出的函数:}(hj5 hhhNhNubeh}(h]h ]h"]h$]h&]uh1jMhhhKhj$ hhubjN)}(h该API在以下内核代码中:h]h该API在以下内核代码中:}(hjW hhhNhNubah}(h]h ]h"]h$]h&]uh1jMhhhKhj$ hhubjN)}(hdrivers/pci/msi/api.ch]hdrivers/pci/msi/api.c}(hje hhhNhNubah}(h]h ]h"]h$]h&]uh1jMhhhKhj$ hhubeh}(h] msi-x-apisah ]h"]$msi(-x) apis设备驱动程序列表ah$]h&]uh1j hj hhhhhKubeh}(h]msiah ]h"]msi驱动指南ah$]h&]uh1j hhhhhhhKubeh}(h]h ]h"]h$]h&]sourcehuh1hcurrent_sourceN current_lineNsettingsdocutils.frontendValues)}(jN generatorN datestampN source_linkN source_urlN toc_backlinksentryfootnote_backlinksK sectnum_xformKstrip_commentsNstrip_elements_with_classesN strip_classesN report_levelK halt_levelKexit_status_levelKdebugNwarning_streamN tracebackinput_encoding utf-8-siginput_encoding_error_handlerstrictoutput_encodingutf-8output_encoding_error_handlerj error_encodingutf-8error_encoding_error_handlerbackslashreplace language_codeenrecord_dependenciesNconfigN id_prefixhauto_id_prefixid dump_settingsNdump_internalsNdump_transformsNdump_pseudo_xmlNexpose_internalsNstrict_visitorN_disable_configN_sourceh _destinationN _config_files]7/var/lib/git/docbuild/linux/Documentation/docutils.confafile_insertion_enabled raw_enabledKline_length_limitM'pep_referencesN pep_base_urlhttps://peps.python.org/pep_file_url_templatepep-%04drfc_referencesN rfc_base_url&https://datatracker.ietf.org/doc/html/ tab_widthKtrim_footnote_reference_spacesyntax_highlightlong smart_quotessmartquotes_locales]character_level_inline_markupdoctitle_xform docinfo_xformKsectsubtitle_xform image_loadinglinkembed_stylesheetcloak_email_addressessection_self_linkenvNubreporterNindirect_targets]substitution_defs}(hhhhhhj jjjj*jj9j-jHj<jWjKjfjZjujijjxjjjjjjjjjjjjjjjjj jjjj)jj8j,jGj;jVjJjejYjtjhjjwjjjjjjjjjjjjjjjjj jjj j(jj7j+jFj:jUjIjdjXjsjgjjvjjjjjjjjjjjjjjjjj jjj j'jj6j*jEj9jTjHjcjWjrjfjjujjjjjjjjjjjjjjjjjjjj j&jj5j)jDj8usubstitution_names}(amphߌaposhasthbrvbarj bsoljcentj*colonj9commajHcommatjWcopyjfcurrenjudarrjdegjdividejdollarjequalsjexcljfrac12jfrac14jfrac18jfrac34j frac38jfrac58j)frac78j8gtjGhalfjVhorbarjehyphenjtiexcljiquestjlaquojlarrjlcubjldquojlowbarjlparjlsqbjlsquoj ltjmicroj(middotj7nbspjFnotjUnumjdohmjsordfjordmjparajpercntjperiodjplusjplusmnjpoundjquestjquotj raquojrarrj'rcubj6rdquojEregjTrparjcrsqbjrrsquojsectjsemijshyjsoljsungjsup1jsup2jsup3jtimesjtradejuarrj&verbarj5yenjDurefnames}refids}nameids}(j j} jjjjj=j:jZ jW jjjjjjj+ j( j# j jR jO j! j j j j j j j j j jx ju u nametypes}(j jjj=jZ jjjj+ j# jR j! j j j j jx uh}(j} j jjjjj:jjW j@jj_jjjjj( jj jjO j. j j] j j j j j j j j ju j$ u footnote_refs} citation_refs} autofootnotes]autofootnote_refs]symbol_footnotes]symbol_footnote_refs] footnotes] citations]autofootnote_startKsymbol_footnote_startK id_counter collectionsCounter}j K sRparse_messages]transform_messages] transformerN include_log]2Documentation/translations/zh_CN/PCI/msi-howto.rst(NNNNta decorationNhhub.