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
|
<?xml version="1.0"?>
<!DOCTYPE manpage SYSTEM "xmltoman.dtd">
<?xml-stylesheet type="text/xsl" href="xmltoman.xsl" ?>
<!-- $Id$ -->
<!--
This file is part of ifplugd.
ifplugd is free software; you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free
Software Foundation; either version 2 of the License, or (at your
option) any later version.
ifplugd is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
for more details.
You should have received a copy of the GNU General Public License
along with ifplugd; if not, write to the Free Software Foundation,
Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
-->
<manpage name="ifstatus" section="8" desc="A link beat detection tool">
<synopsis>
<cmd>ifstatus [<arg>options</arg>] [<arg>INTERFACE</arg>]</cmd>
</synopsis>
<description>
<p>ifstatus is an utility which may be used to detect the link
status of a local Linux ethernet device, much in the same way
mii-diag, mii-tool and ethtool work. In fact it supports all
three different APIs these three tools use. Thus, it provides
maximal compatibility. The newest API (ethtool) is used first,
than the next older (mii-diag) and at last the oldest
(mii-tool). It may be used in shell script since it returns the
current status as return value. It is especially useful to
detect the available APIs on the used network driver. (Option
<opt>-v</opt>)</p>
</description>
<options>
<p>You may speicify an ethernet device on the command
line. Otherwise ifstatus will check for eth0..eth9
automatically.</p>
<option>
<p><opt>-a | --auto</opt></p>
<optdesc><p>
Enable interface automatically before querying (default: off)
</p></optdesc>
</option>
<option>
<p><opt>-h | --help</opt></p>
<optdesc><p>
Show help
</p></optdesc>
</option>
<option>
<p><opt>-q | --quiet</opt></p> <optdesc><p>Decrease verbosity
by one. If the verbosity is < 0, no text will be shown,
only the return value is relevant; if the verbosity is = 0, a
terse status will be shown; If the verbosity is > 0,
detailed information about the used API is returned. (By
default the verbosity is 0)</p></optdesc>
</option>
<option>
<p><opt>-v | --verbose</opt></p>
<optdesc><p>
Increase verbosity by one. See option <opt>-q</opt>.
</p></optdesc>
</option>
<option>
<p><opt>-V | --version</opt></p>
<optdesc><p>
Show version
</p></optdesc>
</option>
</options>
<section name="Return values">
<p><arg>0</arg> Success</p>
<p><arg>1</arg> Failure</p>
<p><arg>2</arg> Link beat detected (only available when an interface is specified)</p>
<p><arg>3</arg> Unplugged (same here)</p>
</section>
<section name="Author">
<p>ifplugd was written by Lennart Poettering
<@PACKAGE_BUGREPORT@>. ifplugd is available
at <url
href="@PACKAGE_URL@"/>
</p>
</section>
<section name="See also">
<p>
<manref name="mii-diag" section="8"/>, <manref name="mii-tool"
section="8"/>, <manref name="ethtool" section="8"/>
</p>
</section>
<section name="Comments">
<p>This man page was written using <manref name="xml2man" section="1"
href="http://masqmail.cx/xml2man/"/> by Oliver Kurth.</p>
</section>
</manpage>
|
