mirror of
https://git.proxmox.com/git/systemd
synced 2025-06-02 21:38:04 +00:00
75 lines
6.4 KiB
HTML
75 lines
6.4 KiB
HTML
<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>networkctl</title><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><style>
|
|
a.headerlink {
|
|
color: #c60f0f;
|
|
font-size: 0.8em;
|
|
padding: 0 4px 0 4px;
|
|
text-decoration: none;
|
|
visibility: hidden;
|
|
}
|
|
|
|
a.headerlink:hover {
|
|
background-color: #c60f0f;
|
|
color: white;
|
|
}
|
|
|
|
h1:hover > a.headerlink, h2:hover > a.headerlink, h3:hover > a.headerlink, dt:hover > a.headerlink {
|
|
visibility: visible;
|
|
}
|
|
</style><a href="index.html">Index </a>·
|
|
<a href="systemd.directives.html">Directives </a>·
|
|
<a href="../python-systemd/index.html">Python </a>·
|
|
<a href="../libudev/index.html">libudev </a>·
|
|
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 219</span><hr><div class="refentry"><a name="networkctl"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>networkctl — Query the status of network links</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">networkctl</code> [OPTIONS...] COMMAND [LINK...]</p></div></div><div class="refsect1"><a name="idm139915897189136"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p><span class="command"><strong>networkctl</strong></span> may be used to introspect the
|
|
state of the network links as seen by
|
|
<span class="command"><strong>systemd-networkd</strong></span>. Please refer to
|
|
<a href="systemd-networkd.service.html"><span class="citerefentry"><span class="refentrytitle">systemd-networkd.service</span>(8)</span></a>
|
|
for an introduction to the the basic concepts, functionality, and
|
|
configuration syntax.</p></div><div class="refsect1"><a name="idm139915893402560"></a><h2 id="Options">Options<a class="headerlink" title="Permalink to this headline" href="#Options">¶</a></h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt id="
|
|
-a
|
|
--all
|
|
"><span class="term">
|
|
<code class="option">-a</code>
|
|
<code class="option">--all</code>
|
|
</span><a class="headerlink" title="Permalink to this term" href="#%0A%20%20%20%20%20%20%20%20%20%20-a%0A%20%20%20%20%20%20%20%20%20%20--all%0A%20%20%20%20%20%20%20%20">¶</a></dt><dd><p>Show all links with <span class="command"><strong>status</strong></span>.</p></dd><dt id="-h"><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span><a class="headerlink" title="Permalink to this term" href="#-h">¶</a></dt><dd><p><a name="help-text"></a>Print a short help text and exit.
|
|
</p></dd><dt id="--version"><span class="term"><code class="option">--version</code></span><a class="headerlink" title="Permalink to this term" href="#--version">¶</a></dt><dd><p><a name="version-text"></a>Print a short version string and exit.</p></dd><dt id="--no-pager"><span class="term"><code class="option">--no-pager</code></span><a class="headerlink" title="Permalink to this term" href="#--no-pager">¶</a></dt><dd><p>Do not pipe output into a pager.</p></dd></dl></div></div><div class="refsect1"><a name="idm139915893395296"></a><h2 id="Commands">Commands<a class="headerlink" title="Permalink to this headline" href="#Commands">¶</a></h2><p>The following commands are understood:</p><div class="variablelist"><dl class="variablelist"><dt id="
|
|
list
|
|
"><span class="term">
|
|
<span class="command"><strong>list</strong></span>
|
|
</span><a class="headerlink" title="Permalink to this term" href="#%0A%20%20%20%20%20%20%20%20%20%20list%0A%20%20%20%20%20%20%20%20">¶</a></dt><dd><p>Show a list of existing links and their
|
|
status. Produces output similar to </p><pre class="programlisting">
|
|
IDX LINK TYPE OPERATIONAL SETUP
|
|
1 lo loopback carrier unmanaged
|
|
2 eth0 ether routable configured
|
|
3 virbr0 ether no-carrier unmanaged
|
|
4 virbr0-nic ether off unmanaged
|
|
|
|
4 links listed.</pre></dd><dt id="
|
|
status
|
|
LINK...
|
|
"><span class="term">
|
|
<span class="command"><strong>status</strong></span>
|
|
[<span class="optional"><em class="replaceable"><code>LINK...</code></em></span>]
|
|
</span><a class="headerlink" title="Permalink to this term" href="#%0A%20%20%20%20%20%20%20%20%20%20status%0A%20%20%20%20%20%20%20%20%20%20LINK...%0A%20%20%20%20%20%20%20%20">¶</a></dt><dd><p>Show information about the specified links: type,
|
|
state, kernel module driver, hardware and IP address,
|
|
configured DNS servers, etc.</p><p>When no links are specified, routable links are
|
|
shown. See also option <code class="option">--all</code>.</p><p>Produces output similar to
|
|
</p><pre class="programlisting">
|
|
● State: routable
|
|
Address: 10.193.76.5 on eth0
|
|
192.168.122.1 on virbr0
|
|
169.254.190.105 on eth0
|
|
fe80::5054:aa:bbbb:cccc on eth0
|
|
Gateway: 10.193.11.1 (CISCO SYSTEMS, INC.) on eth0
|
|
DNS: 8.8.8.8
|
|
8.8.4.4</pre></dd><dt id="
|
|
lldp
|
|
"><span class="term">
|
|
<span class="command"><strong>lldp</strong></span>
|
|
</span><a class="headerlink" title="Permalink to this term" href="#%0A%20%20%20%20%20%20%20%20%20%20lldp%0A%20%20%20%20%20%20%20%20">¶</a></dt><dd><p>Show LLDP (Link Layer Discovery Protocol)
|
|
status.</p></dd></dl></div></div><div class="refsect1"><a name="idm139915897284688"></a><h2 id="Exit status">Exit status<a class="headerlink" title="Permalink to this headline" href="#Exit%20status">¶</a></h2><p>On success, 0 is returned, a non-zero failure
|
|
code otherwise.</p></div><div class="refsect1"><a name="idm139915897283504"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
|
|
<a href="systemd-networkd.service.html"><span class="citerefentry"><span class="refentrytitle">systemd-networkd.service</span>(8)</span></a>,
|
|
<a href="systemd.network.html"><span class="citerefentry"><span class="refentrytitle">systemd.network</span>(5)</span></a>,
|
|
<a href="systemd.netdev.html"><span class="citerefentry"><span class="refentrytitle">systemd.netdev</span>(5)</span></a>
|
|
</p></div></div></body></html>
|