<?xml version="1.0"?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
	"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd">
<chapter id="feature-networkmanager">
  <title>NetworkManager</title>

  <para>If available on the system, Cockpit uses
    <ulink url="https://wiki.gnome.org/Projects/NetworkManager">NetworkManager</ulink>
    and the DBus APIs it provides to interact with the system's network configuration.</para>

  <para>For non root users, NetworkManager controls access to its APIs via
    <link linkend="privileges">Policy Kit</link> and a user logged into Cockpit will have
    the same permissions as they do from the command line.</para>

  <para>To perform similar tasks from the command line, use the
    <ulink url="https://fedoraproject.org/wiki/Networking/CLI">nmcli</ulink> command:</para>

<programlisting>
$ <command>nmcli general status</command>
STATE      CONNECTIVITY  WIFI-HW  WIFI     WWAN-HW  WWAN
connected  full          enabled  enabled  enabled  enabled
</programlisting>

  <para>Devices marked as "not managed" with the <code>NM_CONTROLLED=no</code> setting
    will not be displayed in the interface.</para>

</chapter>
