Debian Codegraph @

doc/doxygen-doc/html/a00219.html

raw
1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
2 <html xmlns="http://www.w3.org/1999/xhtml" lang="en-US">
3 <head>
4 <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
5 <meta http-equiv="X-UA-Compatible" content="IE=11"/>
6 <meta name="generator" content="Doxygen 1.15.0"/>
7 <meta name="viewport" content="width=device-width, initial-scale=1"/>
8 <title>Hardware Locality (hwloc): Components and Plugins: finding PCI objects during other discoveries</title>
9 <link href="tabs.css" rel="stylesheet" type="text/css"/>
10 <script type="text/javascript" src="jquery.js"></script>
11 <script type="text/javascript" src="dynsections.js"></script>
12 <script type="text/javascript" src="clipboard.js"></script>
13 <link href="doxygen.css" rel="stylesheet" type="text/css" />
14 </head>
15 <body>
16 <div id="top"><!-- do not remove this div, it is closed by doxygen! -->
17 <div id="titlearea">
18 <table cellspacing="0" cellpadding="0">
19 <tbody>
20 <tr id="projectrow">
21 <td id="projectalign">
22 <div id="projectname">Hardware Locality (hwloc)<span id="projectnumber">&#160;2.14.0</span>
23 </div>
24 </td>
25 </tr>
26 </tbody>
27 </table>
28 </div>
29 <!-- end header part -->
30 <!-- Generated by Doxygen 1.15.0 -->
31 <script type="text/javascript">
32 $(function() { codefold.init(); });
33 </script>
34 <script type="text/javascript" src="menudata.js"></script>
35 <script type="text/javascript" src="menu.js"></script>
36 <script type="text/javascript">
37 $(function() {
38 initMenu('',false,false,'search.php','Search',false);
39 });
40 </script>
41 <div id="main-nav"></div>
42 </div><!-- top -->
43 <div id="doc-content">
44 <div class="header">
45 <div class="summary">
46 <a href="#func-members">Functions</a> </div>
47 <div class="headertitle"><div class="title">Components and Plugins: finding PCI objects during other discoveries </div></div>
48 </div><!--header-->
49 <div class="contents">
50 <table class="memberdecls">
51 <tr class="heading"><td colspan="2"><h2 id="header-func-members" class="groupheader"><a id="func-members" name="func-members"></a>
52 Functions</h2></td></tr>
53 <tr class="memitem:ga5062f8cb07418b9cb01657d363d0f969" id="r_ga5062f8cb07418b9cb01657d363d0f969"><td class="memItemLeft" align="right" valign="top">struct <a class="el" href="a00224.html">hwloc_obj</a> *&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="#ga5062f8cb07418b9cb01657d363d0f969">hwloc_pci_find_parent_by_busid</a> (struct hwloc_topology *topology, unsigned domain, unsigned bus, unsigned dev, unsigned func)</td></tr>
54 <tr class="memitem:ga1779bc839369b3edcea1545a04ea123c" id="r_ga1779bc839369b3edcea1545a04ea123c"><td class="memItemLeft" align="right" valign="top">struct <a class="el" href="a00224.html">hwloc_obj</a> *&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="#ga1779bc839369b3edcea1545a04ea123c">hwloc_pci_find_by_busid</a> (struct hwloc_topology *topology, unsigned domain, unsigned bus, unsigned dev, unsigned func)</td></tr>
55 </table>
56 <a name="details" id="details"></a><h2 id="header-details" class="groupheader">Detailed Description</h2>
57 <dl class="section note"><dt>Note</dt><dd>These structures and functions may change when <a class="el" href="a00165.html#gaac5bc1f46f55e10ef0141a68ce70e21f" title="Current component and plugin ABI version (see hwloc/plugins.h).">HWLOC_COMPONENT_ABI</a> is modified. </dd></dl>
58 <a name="doc-func-members" id="doc-func-members"></a><h2 id="header-doc-func-members" class="groupheader">Function Documentation</h2>
59 <a id="ga1779bc839369b3edcea1545a04ea123c" name="ga1779bc839369b3edcea1545a04ea123c"></a>
60 <h2 class="memtitle"><span class="permalink"><a href="#ga1779bc839369b3edcea1545a04ea123c">&#9670;&#160;</a></span>hwloc_pci_find_by_busid()</h2>
61
62 <div class="memitem">
63 <div class="memproto">
64 <table class="memname">
65 <tr>
66 <td class="memname">struct <a class="el" href="a00224.html">hwloc_obj</a> * hwloc_pci_find_by_busid </td>
67 <td>(</td>
68 <td class="paramtype">struct hwloc_topology *</td> <td class="paramname"><span class="paramname"><em>topology</em></span>, </td>
69 </tr>
70 <tr>
71 <td class="paramkey"></td>
72 <td></td>
73 <td class="paramtype">unsigned</td> <td class="paramname"><span class="paramname"><em>domain</em></span>, </td>
74 </tr>
75 <tr>
76 <td class="paramkey"></td>
77 <td></td>
78 <td class="paramtype">unsigned</td> <td class="paramname"><span class="paramname"><em>bus</em></span>, </td>
79 </tr>
80 <tr>
81 <td class="paramkey"></td>
82 <td></td>
83 <td class="paramtype">unsigned</td> <td class="paramname"><span class="paramname"><em>dev</em></span>, </td>
84 </tr>
85 <tr>
86 <td class="paramkey"></td>
87 <td></td>
88 <td class="paramtype">unsigned</td> <td class="paramname"><span class="paramname"><em>func</em></span>&#160;)</td>
89 </tr>
90 </table>
91 </div><div class="memdoc">
92
93 <p>Find the PCI device or bridge matching a PCI bus ID exactly. </p>
94 <p>This is useful for adding specific information about some objects based on their PCI id. When it comes to attaching objects based on PCI locality, <a class="el" href="#ga5062f8cb07418b9cb01657d363d0f969" title="Find the object or a parent of a PCI bus ID.">hwloc_pci_find_parent_by_busid()</a> should be preferred. </p>
95
96 </div>
97 </div>
98 <a id="ga5062f8cb07418b9cb01657d363d0f969" name="ga5062f8cb07418b9cb01657d363d0f969"></a>
99 <h2 class="memtitle"><span class="permalink"><a href="#ga5062f8cb07418b9cb01657d363d0f969">&#9670;&#160;</a></span>hwloc_pci_find_parent_by_busid()</h2>
100
101 <div class="memitem">
102 <div class="memproto">
103 <table class="memname">
104 <tr>
105 <td class="memname">struct <a class="el" href="a00224.html">hwloc_obj</a> * hwloc_pci_find_parent_by_busid </td>
106 <td>(</td>
107 <td class="paramtype">struct hwloc_topology *</td> <td class="paramname"><span class="paramname"><em>topology</em></span>, </td>
108 </tr>
109 <tr>
110 <td class="paramkey"></td>
111 <td></td>
112 <td class="paramtype">unsigned</td> <td class="paramname"><span class="paramname"><em>domain</em></span>, </td>
113 </tr>
114 <tr>
115 <td class="paramkey"></td>
116 <td></td>
117 <td class="paramtype">unsigned</td> <td class="paramname"><span class="paramname"><em>bus</em></span>, </td>
118 </tr>
119 <tr>
120 <td class="paramkey"></td>
121 <td></td>
122 <td class="paramtype">unsigned</td> <td class="paramname"><span class="paramname"><em>dev</em></span>, </td>
123 </tr>
124 <tr>
125 <td class="paramkey"></td>
126 <td></td>
127 <td class="paramtype">unsigned</td> <td class="paramname"><span class="paramname"><em>func</em></span>&#160;)</td>
128 </tr>
129 </table>
130 </div><div class="memdoc">
131
132 <p>Find the object or a parent of a PCI bus ID. </p>
133 <p>When attaching a new object (typically an OS device) whose locality is specified by PCI bus ID, this function returns the PCI object to use as a parent for attaching.</p>
134 <p>If the exact PCI device with this bus ID exists, it is returned. Otherwise (for instance if it was filtered out), the function returns another object with similar locality (for instance a parent bridge, or the local CPU Package). </p>
135
136 </div>
137 </div>
138 </div><!-- contents -->
139 <!-- start footer part -->
140 <hr class="footer"/><address class="footer"><small>
141 Generated by&#160;<a href="https://www.doxygen.org/index.html"><img class="footer" src="doxygen.svg" width="104" height="31" alt="doxygen"/></a> 1.15.0
142 </small></address>
143 </div><!-- doc-content -->
144 </body>
145 </html>