1
<?xml version="1.0" encoding="ascii"?>
2
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
3
"DTD/xhtml1-transitional.dtd">
4
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
6
<title>interface</title>
7
<link rel="stylesheet" href="epydoc.css" type="text/css" />
8
<script type="text/javascript" src="epydoc.js"></script>
11
<body bgcolor="white" text="black" link="blue" vlink="#204080"
13
<!-- ==================== NAVIGATION BAR ==================== -->
14
<table class="navbar" border="0" width="100%" cellpadding="0"
15
bgcolor="#a0c0ff" cellspacing="0">
19
<th> <a
20
href="module-tree.html">Trees</a> </th>
23
<th> <a
24
href="identifier-index.html">Indices</a> </th>
27
<th> <a
28
href="help.html">Help</a> </th>
30
<!-- Project homepage -->
31
<th class="navbar" align="right" width="100%">
32
<table border="0" cellpadding="0" cellspacing="0">
33
<tr><th class="navbar" align="center"
34
><a href="http://www.ntop.org/">Ntop</a></th>
38
<table width="100%" cellpadding="0" cellspacing="0">
41
<span class="breadcrumbs">
46
<table cellpadding="0" cellspacing="0">
47
<!-- hide/show private -->
48
<tr><td align="right"><span class="options"
49
>[<a href="frames.html" target="_top">frames</a
50
>] | <a href="interface-module.html"
51
target="_top">no frames</a>]</span></td></tr>
56
<!-- ==================== MODULE DESCRIPTION ==================== -->
57
<h1 class="epydoc">Module interface</h1><p class="nomargin-top"></p>
58
<p>Module that exposes functions to get information on the current
59
interfaces enabled in ntop.</p>
61
<!-- ==================== FUNCTIONS ==================== -->
62
<a name="section-Functions"></a>
63
<table class="summary" border="1" cellpadding="3"
64
cellspacing="0" width="100%" bgcolor="white">
65
<tr bgcolor="#70b0f0" class="table-header">
66
<td align="left" colspan="2" class="table-header">
67
<span class="table-header">Functions</span></td>
70
<td width="15%" align="right" valign="top" class="summary">
71
<span class="summary-type"> </span>
72
</td><td class="summary">
73
<table width="100%" cellpadding="0" cellspacing="0" border="0">
75
<td><span class="summary-sig"><a name="numInterfaces"></a><span class="summary-sig-name">numInterfaces</span>()</span><br />
76
Get number of configured interfaces</td>
77
<td align="right" valign="top">
87
<td width="15%" align="right" valign="top" class="summary">
88
<span class="summary-type">String @return the name of the interface</span>
89
</td><td class="summary">
90
<table width="100%" cellpadding="0" cellspacing="0" border="0">
92
<td><span class="summary-sig"><a name="name"></a><span class="summary-sig-name">name</span>()</span><br />
93
Get interface name</td>
94
<td align="right" valign="top">
104
<td width="15%" align="right" valign="top" class="summary">
105
<span class="summary-type">String @return the unique name of the interface</span>
106
</td><td class="summary">
107
<table width="100%" cellpadding="0" cellspacing="0" border="0">
109
<td><span class="summary-sig"><a name="uniqueName"></a><span class="summary-sig-name">uniqueName</span>()</span><br />
110
Get unique interface name</td>
111
<td align="right" valign="top">
121
<td width="15%" align="right" valign="top" class="summary">
122
<span class="summary-type">String @return the human-friendly name of the interface</span>
123
</td><td class="summary">
124
<table width="100%" cellpadding="0" cellspacing="0" border="0">
126
<td><span class="summary-sig"><a name="humanName"></a><span class="summary-sig-name">humanName</span>()</span><br />
127
Get human-friendly interface name</td>
128
<td align="right" valign="top">
138
<td width="15%" align="right" valign="top" class="summary">
139
<span class="summary-type">string</span>
140
</td><td class="summary">
141
<table width="100%" cellpadding="0" cellspacing="0" border="0">
143
<td><span class="summary-sig"><a href="interface-module.html#ipv4" class="summary-sig-name">ipv4</a>(<span class="summary-sig-arg">interfaceId</span>)</span><br />
144
Get interface address (IPv4)</td>
145
<td align="right" valign="top">
155
<td width="15%" align="right" valign="top" class="summary">
156
<span class="summary-type">string</span>
157
</td><td class="summary">
158
<table width="100%" cellpadding="0" cellspacing="0" border="0">
160
<td><span class="summary-sig"><a href="interface-module.html#network" class="summary-sig-name">network</a>(<span class="summary-sig-arg">interfaceId</span>)</span><br />
161
Get network and mask to which the interface belongs</td>
162
<td align="right" valign="top">
172
<td width="15%" align="right" valign="top" class="summary">
173
<span class="summary-type">number</span>
174
</td><td class="summary">
175
<table width="100%" cellpadding="0" cellspacing="0" border="0">
177
<td><span class="summary-sig"><a href="interface-module.html#numHosts" class="summary-sig-name">numHosts</a>(<span class="summary-sig-arg">interfaceId</span>)</span><br />
178
Get the number of hosts active on this interface</td>
179
<td align="right" valign="top">
189
<td width="15%" align="right" valign="top" class="summary">
190
<span class="summary-type">string</span>
191
</td><td class="summary">
192
<table width="100%" cellpadding="0" cellspacing="0" border="0">
194
<td><span class="summary-sig"><a href="interface-module.html#ipv6" class="summary-sig-name">ipv6</a>(<span class="summary-sig-arg">interfaceId</span>)</span><br />
195
Get interface address (IPv6)</td>
196
<td align="right" valign="top">
206
<td width="15%" align="right" valign="top" class="summary">
207
<span class="summary-type">dictionary @return {'startTime':number, 'firstSeen': number,
208
'lastSeen': number}</span>
209
</td><td class="summary">
210
<table width="100%" cellpadding="0" cellspacing="0" border="0">
212
<td><span class="summary-sig"><a href="interface-module.html#time" class="summary-sig-name">time</a>(<span class="summary-sig-arg">interfaceId</span>)</span><br />
213
Get interface time</td>
214
<td align="right" valign="top">
224
<td width="15%" align="right" valign="top" class="summary">
225
<span class="summary-type"> </span>
226
</td><td class="summary">
227
<table width="100%" cellpadding="0" cellspacing="0" border="0">
229
<td><span class="summary-sig"><a name="virtual"></a><span class="summary-sig-name">virtual</span>()</span><br />
230
Check if this is a virtual interface</td>
231
<td align="right" valign="top">
241
<td width="15%" align="right" valign="top" class="summary">
242
<span class="summary-type"> </span>
243
</td><td class="summary">
244
<table width="100%" cellpadding="0" cellspacing="0" border="0">
246
<td><span class="summary-sig"><a name="speed"></a><span class="summary-sig-name">speed</span>()</span><br />
247
Interface speed (0 if unknown)</td>
248
<td align="right" valign="top">
258
<td width="15%" align="right" valign="top" class="summary">
259
<span class="summary-type"> </span>
260
</td><td class="summary">
261
<table width="100%" cellpadding="0" cellspacing="0" border="0">
263
<td><span class="summary-sig"><a name="mtu"></a><span class="summary-sig-name">mtu</span>()</span><br />
264
Get interface MTU size</td>
265
<td align="right" valign="top">
275
<td width="15%" align="right" valign="top" class="summary">
276
<span class="summary-type"> </span>
277
</td><td class="summary">
278
<table width="100%" cellpadding="0" cellspacing="0" border="0">
280
<td><span class="summary-sig"><a name="bpf"></a><span class="summary-sig-name">bpf</span>()</span><br />
281
Get BPF filter set for this interface (if any)</td>
282
<td align="right" valign="top">
292
<td width="15%" align="right" valign="top" class="summary">
293
<span class="summary-type"> </span>
294
</td><td class="summary">
295
<table width="100%" cellpadding="0" cellspacing="0" border="0">
297
<td><span class="summary-sig"><a name="pktsStats"></a><span class="summary-sig-name">pktsStats</span>()</span><br />
298
Get packet statistics</td>
299
<td align="right" valign="top">
309
<td width="15%" align="right" valign="top" class="summary">
310
<span class="summary-type"> </span>
311
</td><td class="summary">
312
<table width="100%" cellpadding="0" cellspacing="0" border="0">
314
<td><span class="summary-sig"><a name="fcPktsStats"></a><span class="summary-sig-name">fcPktsStats</span>()</span><br />
315
Get FC pkts stats</td>
316
<td align="right" valign="top">
326
<td width="15%" align="right" valign="top" class="summary">
327
<span class="summary-type"> </span>
328
</td><td class="summary">
329
<table width="100%" cellpadding="0" cellspacing="0" border="0">
331
<td><span class="summary-sig"><a name="fcBytesStats"></a><span class="summary-sig-name">fcBytesStats</span>()</span><br />
332
Get FC byte stats</td>
333
<td align="right" valign="top">
343
<td width="15%" align="right" valign="top" class="summary">
344
<span class="summary-type"> </span>
345
</td><td class="summary">
346
<table width="100%" cellpadding="0" cellspacing="0" border="0">
348
<td><span class="summary-sig"><a name="bytesStats"></a><span class="summary-sig-name">bytesStats</span>()</span><br />
349
Get bytes statistics</td>
350
<td align="right" valign="top">
360
<td width="15%" align="right" valign="top" class="summary">
361
<span class="summary-type"> </span>
362
</td><td class="summary">
363
<table width="100%" cellpadding="0" cellspacing="0" border="0">
365
<td><span class="summary-sig"><a name="throughputStats"></a><span class="summary-sig-name">throughputStats</span>()</span></td>
366
<td align="right" valign="top">
376
<td width="15%" align="right" valign="top" class="summary">
377
<span class="summary-type"> </span>
378
</td><td class="summary">
379
<table width="100%" cellpadding="0" cellspacing="0" border="0">
381
<td><span class="summary-sig"><a name="tcpStats"></a><span class="summary-sig-name">tcpStats</span>()</span><br />
383
<td align="right" valign="top">
393
<td width="15%" align="right" valign="top" class="summary">
394
<span class="summary-type"> </span>
395
</td><td class="summary">
396
<table width="100%" cellpadding="0" cellspacing="0" border="0">
398
<td><span class="summary-sig"><a name="udpStats"></a><span class="summary-sig-name">udpStats</span>()</span><br />
400
<td align="right" valign="top">
410
<td width="15%" align="right" valign="top" class="summary">
411
<span class="summary-type"> </span>
412
</td><td class="summary">
413
<table width="100%" cellpadding="0" cellspacing="0" border="0">
415
<td><span class="summary-sig"><a name="icmpStats"></a><span class="summary-sig-name">icmpStats</span>()</span><br />
417
<td align="right" valign="top">
427
<td width="15%" align="right" valign="top" class="summary">
428
<span class="summary-type"> </span>
429
</td><td class="summary">
430
<table width="100%" cellpadding="0" cellspacing="0" border="0">
432
<td><span class="summary-sig"><a name="ipStats"></a><span class="summary-sig-name">ipStats</span>()</span><br />
434
<td align="right" valign="top">
444
<td width="15%" align="right" valign="top" class="summary">
445
<span class="summary-type"> </span>
446
</td><td class="summary">
447
<table width="100%" cellpadding="0" cellspacing="0" border="0">
449
<td><span class="summary-sig"><a name="securityPkts"></a><span class="summary-sig-name">securityPkts</span>()</span><br />
450
Get information about security packets</td>
451
<td align="right" valign="top">
461
<td width="15%" align="right" valign="top" class="summary">
462
<span class="summary-type"> </span>
463
</td><td class="summary">
464
<table width="100%" cellpadding="0" cellspacing="0" border="0">
466
<td><span class="summary-sig"><a name="netflowStats"></a><span class="summary-sig-name">netflowStats</span>()</span><br />
467
Get NetFlow interface information</td>
468
<td align="right" valign="top">
478
<td width="15%" align="right" valign="top" class="summary">
479
<span class="summary-type"> </span>
480
</td><td class="summary">
481
<table width="100%" cellpadding="0" cellspacing="0" border="0">
483
<td><span class="summary-sig"><a name="sflowStats"></a><span class="summary-sig-name">sflowStats</span>()</span><br />
484
Get sFlow interface information</td>
485
<td align="right" valign="top">
495
<td width="15%" align="right" valign="top" class="summary">
496
<span class="summary-type"> </span>
497
</td><td class="summary">
498
<table width="100%" cellpadding="0" cellspacing="0" border="0">
500
<td><span class="summary-sig"><a name="cpacketStats"></a><span class="summary-sig-name">cpacketStats</span>()</span><br />
501
Get cPacket counter information</td>
502
<td align="right" valign="top">
512
<!-- ==================== VARIABLES ==================== -->
513
<a name="section-Variables"></a>
514
<table class="summary" border="1" cellpadding="3"
515
cellspacing="0" width="100%" bgcolor="white">
516
<tr bgcolor="#70b0f0" class="table-header">
517
<td align="left" colspan="2" class="table-header">
518
<span class="table-header">Variables</span></td>
521
<td width="15%" align="right" valign="top" class="summary">
522
<span class="summary-type"> </span>
523
</td><td class="summary">
524
<a name="__package__"></a><span class="summary-name">__package__</span> = <code title="None">None</code>
528
<!-- ==================== FUNCTION DETAILS ==================== -->
529
<a name="section-FunctionDetails"></a>
530
<table class="details" border="1" cellpadding="3"
531
cellspacing="0" width="100%" bgcolor="white">
532
<tr bgcolor="#70b0f0" class="table-header">
533
<td align="left" colspan="2" class="table-header">
534
<span class="table-header">Function Details</span></td>
539
<table class="details" border="1" cellpadding="3"
540
cellspacing="0" width="100%" bgcolor="white">
542
<table width="100%" cellpadding="0" cellspacing="0" border="0">
543
<tr valign="top"><td>
544
<h3 class="epydoc"><span class="sig"><span class="sig-name">ipv4</span>(<span class="sig-arg">interfaceId</span>)</span>
546
</td><td align="right" valign="top"
551
<p>Get interface address (IPv4)</p>
554
<dd><ul class="nomargin-top">
555
<li><strong class="pname"><code>interfaceId</code></strong> (int) - the id number for the specified interface</li>
557
<dt>Returns: string</dt>
558
<dd>the ipv4 address of the interfeceId passed. Empty string if none.
559
Null if no interface passed</dd>
563
<a name="network"></a>
565
<table class="details" border="1" cellpadding="3"
566
cellspacing="0" width="100%" bgcolor="white">
568
<table width="100%" cellpadding="0" cellspacing="0" border="0">
569
<tr valign="top"><td>
570
<h3 class="epydoc"><span class="sig"><span class="sig-name">network</span>(<span class="sig-arg">interfaceId</span>)</span>
572
</td><td align="right" valign="top"
577
<p>Get network and mask to which the interface belongs</p>
580
<dd><ul class="nomargin-top">
581
<li><strong class="pname"><code>interfaceId</code></strong> (int) - the id number for the specified interface</li>
583
<dt>Returns: string</dt>
584
<dd>the network and the network mask for the specified interfaceId</dd>
588
<a name="numHosts"></a>
590
<table class="details" border="1" cellpadding="3"
591
cellspacing="0" width="100%" bgcolor="white">
593
<table width="100%" cellpadding="0" cellspacing="0" border="0">
594
<tr valign="top"><td>
595
<h3 class="epydoc"><span class="sig"><span class="sig-name">numHosts</span>(<span class="sig-arg">interfaceId</span>)</span>
597
</td><td align="right" valign="top"
602
<p>Get the number of hosts active on this interface</p>
605
<dd><ul class="nomargin-top">
606
<li><strong class="pname"><code>interfaceId</code></strong> (int) - the id number for the specified interface</li>
608
<dt>Returns: number</dt>
609
<dd>the number of hosts for the specified interfaceId</dd>
615
<table class="details" border="1" cellpadding="3"
616
cellspacing="0" width="100%" bgcolor="white">
618
<table width="100%" cellpadding="0" cellspacing="0" border="0">
619
<tr valign="top"><td>
620
<h3 class="epydoc"><span class="sig"><span class="sig-name">ipv6</span>(<span class="sig-arg">interfaceId</span>)</span>
622
</td><td align="right" valign="top"
627
<p>Get interface address (IPv6)</p>
630
<dd><ul class="nomargin-top">
631
<li><strong class="pname"><code>interfaceId</code></strong> (int) - the id number for the specified interface</li>
633
<dt>Returns: string</dt>
634
<dd>the ipv6 address of the interfeceId passed. Empty string if none.
635
Null if no interface passed</dd>
641
<table class="details" border="1" cellpadding="3"
642
cellspacing="0" width="100%" bgcolor="white">
644
<table width="100%" cellpadding="0" cellspacing="0" border="0">
645
<tr valign="top"><td>
646
<h3 class="epydoc"><span class="sig"><span class="sig-name">time</span>(<span class="sig-arg">interfaceId</span>)</span>
648
</td><td align="right" valign="top"
653
<p>Get interface time</p>
656
<dd><ul class="nomargin-top">
657
<li><strong class="pname"><code>interfaceId</code></strong> (int) - the id number for the specified interface</li>
659
<dt>Returns: dictionary @return {'startTime':number, 'firstSeen': number,
660
'lastSeen': number}</dt>
665
<!-- ==================== NAVIGATION BAR ==================== -->
666
<table class="navbar" border="0" width="100%" cellpadding="0"
667
bgcolor="#a0c0ff" cellspacing="0">
671
<th> <a
672
href="module-tree.html">Trees</a> </th>
675
<th> <a
676
href="identifier-index.html">Indices</a> </th>
679
<th> <a
680
href="help.html">Help</a> </th>
682
<!-- Project homepage -->
683
<th class="navbar" align="right" width="100%">
684
<table border="0" cellpadding="0" cellspacing="0">
685
<tr><th class="navbar" align="center"
686
><a href="http://www.ntop.org/">Ntop</a></th>
690
<table border="0" cellpadding="0" cellspacing="0" width="100%%">
692
<td align="left" class="footer">
693
Generated by Epydoc 3.0.1
694
on Thu May 6 14:42:18 2010
696
<td align="right" class="footer">
697
<a target="mainFrame" href="http://epydoc.sourceforge.net"
698
>http://epydoc.sourceforge.net</a>
703
<script type="text/javascript">
705
// Private objects are initially displayed (because if
706
// javascript is turned off then we want them to be
707
// visible); but by default, we want to hide them. So hide
708
// them unless we have a cookie that says to show them.