File: function.libvirt-node-get-info.html

package info (click to toggle)
libvirt-php 0.5.2~30-g64dca6f-3
  • links: PTS, VCS
  • area: main
  • in suites: stretch
  • size: 4,460 kB
  • ctags: 5,538
  • sloc: cpp: 11,159; ansic: 8,250; xml: 3,999; php: 1,604; sh: 580; makefile: 189; perl: 97
file content (123 lines) | stat: -rw-r--r-- 4,930 bytes parent folder | download 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
 
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
 <head>
  <meta http-equiv="content-type" content="text/html; charset=UTF-8">
  <title>Extract hardware information about the node</title>
 </head>
 <body><div class="manualnavbar" style="text-align: center;">
 <div class="prev" style="text-align: left; float: left;"><a href="function.libvirt-list-volumes.html">libvirt_list_volumes</a></div>
 <div class="next" style="text-align: right; float: right;"><a href="function.libvirt-storagepool-get-info.html">libvirt_storagepool_get_info</a></div>
 <div class="up"><a href="ref.libvirt.html">Libvirt Functions</a></div>
 <div class="home"><a href="index.html">PHP Manual</a></div>
</div><hr /><div id="function.libvirt-node-get-info" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">libvirt_node_get_info</h1>
  <p class="verinfo">(php-libvirt 0.1)</p><p class="refpurpose"><span class="refname">libvirt_node_get_info</span> &mdash; <span class="dc-title">Extract hardware information about the node</span></p>

 </div>

 <a name="function.libvirt-node-get-info.description"></a><div class="refsect1 description">
  <h3 class="title">Description</h3>
  <div class="methodsynopsis dc-description">
   <span class="type">Array</span> <span class="methodname"><b>libvirt_node_get_info</b></span>
    ( <span class="methodparam"><span class="type">resource</span> <tt class="parameter">$connection</tt></span>
   )</div>

  <p class="para rdfs-comment">
   Extract hardware information about the node (machine running the hypervisor).
  </p>


 </div>


 <a name="function.libvirt-node-get-info.parameters"></a><div class="refsect1 parameters">
  <h3 class="title">Parameters</h3>
 <p class="para">
   </p><dl>

    <dt class="varlistentry">

     <span class="term"><i><tt class="parameter">connection</tt></i>
</span>

     </dt><dd class="listitem">

      <p class="para">
       Connection resource of hypervisor. 
      </p>
     </dd>

    
   </dl>
<p>
  </p>
 </div>


 <a name="function.libvirt-node-get-info.returnvalues"></a><div class="refsect1 returnvalues">
  <h3 class="title">Return Values</h3>
  
  <p class="para">
   <b><tt class="constant">FALSE</tt></b> is returned on failure. On success associative array containing information is returned.
  </p>
  <p class="para">
  The array contains these values:
   </p><ul class="simplelist">
   <li class="member">model - string indicating the CPU model</li>
   <li class="member">memory - memory size in kilobytes</li>
   <li class="member">cpus - the number of active CPUs</li>
   <li class="member">mhz - expected CPU frequency</li>
   <li class="member">nodes - the number of NUMA cell, 1 for uniform mem access</li>
   <li class="member">sockets - number of CPU socket per node</li>
   <li class="member">cores - number of core per socket</li>
   <li class="member">threads - number of threads per core</li>
   </ul><p>
  </p>
 </div>


 

<a name="function.libvirt-node-get-info.examples"></a><div class="refsect1 examples">
  <h3 class="title">Examples</h3>
  <p class="para">
   </p><div class="example">
    <p><b>Example #1 <b>libvirt_node_get_info()</b> example</b></p>
    <div class="example-contents para"><p>
Example of getting hardware info for active hypervisor.
    </p></div>
    <div class="example-contents programlisting">
<div class="phpcode"><code><span style="color: #000000">
<span style="color: #0000BB">&lt;?php<br /><br />&nbsp;&nbsp;&nbsp;&nbsp;$nodeinfo</span><span style="color: #007700">=</span><span style="color: #0000BB">libvirt_node_get_info</span><span style="color: #007700">(</span><span style="color: #0000BB">$res</span><span style="color: #007700">);<br />&nbsp;&nbsp;&nbsp;&nbsp;</span><span style="color: #0000BB">print_r</span><span style="color: #007700">(</span><span style="color: #0000BB">$nodeinfo</span><span style="color: #007700">);<br /><br /></span><span style="color: #0000BB">?&gt;</span>
</span>
</code></div>
    </div>

    <div class="example-contents para"><p>The above example will output 
something similar to:</p></div>
    <div class="example-contents screen">
<div class="cdata"><pre>
(
    [model] =&gt; x86_64
    [memory] =&gt; 3077804
    [cpus] =&gt; 2
    [nodes] =&gt; 1
    [sockets] =&gt; 1
    [cores] =&gt; 2
    [threads] =&gt; 1
    [mhz] =&gt; 1700
)
</pre></div>
    </div>
   </div><p>
  </p>
 </div>


</div><hr /><div class="manualnavbar" style="text-align: center;">
 <div class="prev" style="text-align: left; float: left;"><a href="function.libvirt-list-volumes.html">libvirt_list_volumes</a></div>
 <div class="next" style="text-align: right; float: right;"><a href="function.libvirt-storagepool-get-info.html">libvirt_storagepool_get_info</a></div>
 <div class="up"><a href="ref.libvirt.html">Libvirt Functions</a></div>
 <div class="home"><a href="index.html">PHP Manual</a></div>
</div></body></html>