man/networkctl.html

   1 <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>
   2     a.headerlink {
   3       color: #c60f0f;
   4       font-size: 0.8em;
   5       padding: 0 4px 0 4px;
   6       text-decoration: none;
   7       visibility: hidden;
   8     }
   9
  10     a.headerlink:hover {
  11       background-color: #c60f0f;
  12       color: white;
  13     }
  14
  15     h1:hover > a.headerlink, h2:hover > a.headerlink, h3:hover > a.headerlink, dt:hover > a.headerlink {
  16       visibility: visible;
  17     }
  18   </style><a href="index.html">Index </a>·
  19   <a href="systemd.directives.html">Directives </a>·
  20   <a href="../python-systemd/index.html">Python </a>·
  21   <a href="../libudev/index.html">libudev </a>·
  22   <a href="../libudev/index.html">gudev </a><span style="float:right">systemd 220</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="idm140301908538160"></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
  23     state of the network links as seen by
  24     <span class="command"><strong>systemd-networkd</strong></span>.  Please refer to
  25     <a href="systemd-networkd.service.html"><span class="citerefentry"><span class="refentrytitle">systemd-networkd.service</span>(8)</span></a>
  26     for an introduction to the the basic concepts, functionality, and
  27     configuration syntax.</p></div><div class="refsect1"><a name="idm140301908534720"></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="
  28           -a
  29           --all
  30         "><span class="term">
  31           <code class="option">-a</code>
  32           <code class="option">--all</code>
  33         </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.
  34     </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="idm140301903912448"></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="
  35           list
  36         "><span class="term">
  37           <span class="command"><strong>list</strong></span>
  38         </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
  39           status. Produces output similar to </p><pre class="programlisting">
  40 IDX LINK         TYPE     OPERATIONAL SETUP
  41   1 lo           loopback carrier     unmanaged
  42   2 eth0         ether    routable    configured
  43   3 virbr0       ether    no-carrier  unmanaged
  44   4 virbr0-nic   ether    off         unmanaged
  45
  46 4 links listed.</pre></dd><dt id="
  47           status
  48           LINK...
  49         "><span class="term">
  50           <span class="command"><strong>status</strong></span>
  51           [<span class="optional"><em class="replaceable"><code>LINK...</code></em></span>]
  52         </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,
  53           state, kernel module driver, hardware and IP address,
  54           configured DNS servers, etc.</p><p>When no links are specified, routable links are
  55           shown. See also option <code class="option">--all</code>.</p><p>Produces output similar to
  56           </p><pre class="programlisting">
  57 ●      State: routable
  58      Address: 10.193.76.5 on eth0
  59               192.168.122.1 on virbr0
  60               169.254.190.105 on eth0
  61               fe80::5054:aa:bbbb:cccc on eth0
  62      Gateway: 10.193.11.1 (CISCO SYSTEMS, INC.) on eth0
  63          DNS: 8.8.8.8
  64               8.8.4.4</pre></dd><dt id="
  65           lldp
  66         "><span class="term">
  67           <span class="command"><strong>lldp</strong></span>
  68         </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)
  69           status.</p></dd></dl></div></div><div class="refsect1"><a name="idm140301903900560"></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
  70     code otherwise.</p></div><div class="refsect1"><a name="idm140301903899408"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
  71       <a href="systemd-networkd.service.html"><span class="citerefentry"><span class="refentrytitle">systemd-networkd.service</span>(8)</span></a>,
  72       <a href="systemd.network.html"><span class="citerefentry"><span class="refentrytitle">systemd.network</span>(5)</span></a>,
  73       <a href="systemd.netdev.html"><span class="citerefentry"><span class="refentrytitle">systemd.netdev</span>(5)</span></a>
  74     </p></div></div></body></html>