source: networking/netutils/networkmanager.xml@ 1685f47

12.0 12.1 gimp3 ken/TL2024 ken/tuningfonts lazarus plabs/newcss python3.11 rahul/power-profiles-daemon renodr/vulkan-addition trunk xry111/for-12.3 xry111/llvm18 xry111/spidermonkey128
Last change on this file since 1685f47 was e77c478, checked in by Bruce Dubbs <bdubbs@…>, 14 months ago

Merge branch 'trunk' into lxqt

  • Property mode set to 100644
File size: 25.6 KB
RevLine 
[e33ddee]1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
[0d7900a]7 <!ENTITY NetworkManager-download-http
[eae0d6d1]8"&gnome-download-http;/NetworkManager/&NetworkManager-minor;/NetworkManager-&NetworkManager-version;.tar.xz">
[0d7900a]9 <!ENTITY NetworkManager-download-ftp
[eae0d6d1]10"&gnome-download-ftp;/NetworkManager/&NetworkManager-minor;/NetworkManager-&NetworkManager-version;.tar.xz">
[faacea4]11 <!ENTITY NetworkManager-md5sum "e496a6af920e788fd39710799f88721a">
[06d900b]12 <!ENTITY NetworkManager-size "6.4 MB">
[faacea4]13 <!ENTITY NetworkManager-buildsize "257 MB (with tests and documentation)">
14 <!ENTITY NetworkManager-time "0.7 SBU (with tests, using parallelism=4)">
[e33ddee]15]>
16
17<sect1 id="NetworkManager" xreflabel="NetworkManager-&NetworkManager-version;">
18 <?dbhtml filename="networkmanager.html"?>
19
20
21 <title>NetworkManager-&NetworkManager-version;</title>
22
23 <indexterm zone="NetworkManager">
24 <primary sortas="a-NetworkManager">NetworkManager</primary>
25 </indexterm>
26
27 <sect2 role="package">
28 <title>Introduction to NetworkManager</title>
29
[7ded7e3]30 <para>
31 <application>NetworkManager</application> is a set of co-operative
[e130fead]32 tools that make networking simple and straightforward. Whether you use WiFi,
[8df33ae3]33 wired, 3G, or Bluetooth, NetworkManager allows you to quickly move from
34 one network to another: Once a network has been configured and joined
35 once, it can be detected and re-joined automatically the next time it's
36 available.
[7ded7e3]37 </para>
[e33ddee]38
[4b6e2b2]39 &lfs113_checked;
[e33ddee]40
[cec6657e]41 <note revision="systemd">
42 <para>
43 Make sure that you disable the <command>systemd-networkd</command>
44 service or configure it not to manage the interfaces you want to manage
45 with <application>NetworkManager</application>.
46 </para>
47 </note>
48
[e33ddee]49 <bridgehead renderas="sect3">Package Information</bridgehead>
50 <itemizedlist spacing="compact">
51 <listitem>
[7ded7e3]52 <para>
53 Download (HTTP): <ulink url="&NetworkManager-download-http;"/>
54 </para>
[e33ddee]55 </listitem>
56 <listitem>
[7ded7e3]57 <para>
58 Download (FTP): <ulink url="&NetworkManager-download-ftp;"/>
59 </para>
[e33ddee]60 </listitem>
61 <listitem>
[7ded7e3]62 <para>
63 Download MD5 sum: &NetworkManager-md5sum;
64 </para>
[e33ddee]65 </listitem>
66 <listitem>
[7ded7e3]67 <para>
68 Download size: &NetworkManager-size;
69 </para>
[e33ddee]70 </listitem>
71 <listitem>
[7ded7e3]72 <para>
73 Estimated disk space required: &NetworkManager-buildsize;
74 </para>
[e33ddee]75 </listitem>
76 <listitem>
[7ded7e3]77 <para>
78 Estimated build time: &NetworkManager-time;
79 </para>
[e33ddee]80 </listitem>
81 </itemizedlist>
82
83 <bridgehead renderas="sect3">NetworkManager Dependencies</bridgehead>
84
85 <bridgehead renderas="sect4">Required</bridgehead>
[d497e89]86 <para role="required">
[7be78b9a]87 <xref linkend="jansson"/> and
[d267a13]88 <xref linkend="libndp"/>
[d497e89]89 </para>
90
91 <bridgehead renderas="sect4">Recommended</bridgehead>
92 <para role="recommended">
[c4ae27ab]93 <xref linkend="curl"/>,
[194d47b]94 <xref linkend="dhcpcd"/>
[4b3c4b2]95 <xref linkend="gobject-introspection"/>,
[b7d1d2b]96 <xref linkend="iptables"/>,
[696fed8]97 <xref linkend="newt"/> (for <command>nmtui</command>),
[d267a13]98 <xref linkend="nss"/>,
[6e1616e2]99 <xref linkend="polkit"/>,
[b528d0f4]100 <xref linkend="pygobject3"/>,
[51dfb3e]101 <phrase revision="sysv"><xref linkend="elogind"/>,</phrase>
[cec6657e]102 <phrase revision="systemd"><xref linkend="systemd"/>,</phrase>
[f3429309]103 <xref linkend="upower"/>,
[626bb04]104 <xref linkend="vala"/>, and
[9a381c8]105 <xref linkend="wpa_supplicant"/> (runtime, built with D-Bus support)
[d497e89]106 </para>
[e33ddee]107
[d0880dfa]108 <bridgehead renderas="sect4">Optional</bridgehead>
[d497e89]109 <para role="optional">
[d4f4107]110 <xref linkend="bluez"/>,
[e64cabd]111 <xref linkend="dbus-python"/> (for the test suite),
[4a9054a8]112 <!-- <xref linkend="firewalld"/> (For whenever firewalld is reintroduced) -->
[261fdeb]113 <xref linkend="gnutls"/> (can be used instead of <xref linkend="nss"/>),
[d497e89]114 <xref linkend="gtk-doc"/>,
[1ad3510e]115 <xref linkend="libpsl"/>,
[b3867c5]116 (<xref linkend="qt5"/> or
117 <xref role="node" linkend="qt5-components"/> with qtdoc) (for examples),
[7d645679]118 <xref linkend="ModemManager"/>,
[acb3e9f]119 <xref linkend="valgrind"/>,
[75e3e09]120 <ulink url="https://thekelleys.org.uk/dnsmasq/doc.html">dnsmasq</ulink>,
[365c6fb]121 <ulink url="https://firewalld.org/">firewalld</ulink>,
[262a108]122 <ulink url="https://github.com/Distrotech/libaudit">libaudit</ulink>,
[4f5369a]123 <ulink url="https://github.com/jpirko/libteam">libteam</ulink>,
[01701da9]124 <ulink url="&gnome-download-http;/mobile-broadband-provider-info/">mobile-broadband-provider-info</ulink>,
[cec6657e]125 <ulink url="https://www.samba.org/ftp/ppp/">PPP</ulink>, and
[e130fead]126 <ulink url="https://dianne.skoll.ca/projects/rp-pppoe/">RP-PPPoE</ulink>
[d497e89]127 </para>
[d0880dfa]128
[e33ddee]129 </sect2>
130
[13b116c]131 <sect2 role="kernel" id="NetworkManager-kernel">
132 <title>Kernel Configuration</title>
133
134 <para>
[fc88f1f]135 If you wish to run the tests, check that at least the following options
136 are enabled in the kernel configuration. Those options have been
137 determined to be necessary, but may not be sufficient. Recompile the
138 kernel if necessary:
[13b116c]139 </para>
140
[8558044]141 <!-- Ethernet Teaming support is potentially optional, but I didn't
[13b116c]142 run the tests again to test that. It was needed to convince one of
143 the Linux Platform tests to move farther along because otherwise
144 RTNETLINK would respond with an Error 95 - unknown device type.
[fc88f1f]145 This would cause the test to fail early on in the process.
146
147 [pierre, Nov 2022]: I cannot tell whether these options are
148 the only ones that are needed. They are the options I had to add
149 in order to have some tests pass. But I already had some other
150 options set for packet filtering (iptables), that may not be
151 available by default and may be necessary. Even with the options
152 below still one test (test-route) fails.-->
153
[7ea158e]154<screen><literal>[*] Networking support---&gt; [CONFIG_NET]
[fc88f1f]155 Networking options---&gt;
156 [*] TCP/IP networking [CONFIG_INET]
157 &lt;*/M&gt; IP: tunelling [CONFIG_NET_IPIP]
158 &lt;*/M&gt; IP: GRE demultiplexer [CONFIG_NET_IPGRE_DEMUX]
159 &lt;*/M&gt; IP: GRE tunnels over IP [CONFIG_NET_IPGRE]
160 &lt;*&gt; The IPv6 protocol ---&gt; [CONFIG_IPV6]
161 &lt;*/M&gt; IPv6: IPv6-in-IPv4 tunnel (SIT driver) [CONFIG_IPV6_SIT]
162 &lt;*/M&gt; IPv6: GRE tunnel [CONFIG_IPV6_GRE]
163 [*] IPv6: Multiple Routing Tables [CONFIG_IPV6_MULTIPLE_TABLES]
164 [*] MPTCP: Multipath TCP [CONFIG_MPTCP]
165 [*] MPTCP: IPv6 support for Multipath TCP [CONFIG_MPTCP_IPV6]
166 &lt;*/M&gt; 802.1Q/802.1ad VLAN Support [CONFIG_VLAN_8021Q]
167 [*] QoS and/or fair queueing ---&gt; [CONFIG_NET_SCHED]
168 &lt;*/M&gt; Stochastic Fairness Queueing (SFQ) [CONFIG_NET_SCH_SFQ]
169 &lt;*/M&gt; Token Bucket Filter (TBF) [CONFIG_NET_SCH_TBF]
170 &lt;*/M&gt; Fair Queue Controlled Delay AQM (FQ_CODEL) [CONFIG_NET_SCH_FQ_CODEL]
171 &lt;*/M&gt; Ingress/classifier-action Qdisc [CONFIG_NET_SCH_INGRESS]
172 Device Drivers ---&gt;
173 [*] Network device support ---&gt; [CONFIG_NETDEVICES]
174 [*] Network core driver support [CONFIG_NET_CORE]
175 &lt;*&gt; Bonding driver support [CONFIG_BONDING]
176 &lt;*&gt; Dummy net driver support [CONFIG_DUMMY]
177 &lt;*&gt; Ethernet team driver support ---&gt; [CONFIG_NET_TEAM]
178 &lt;*&gt; MAC-VLAN support [CONFIG_MACVLAN]
179 &lt;*&gt; MAC-VLAN based tap driver [CONFIG_MACVTAP]
180 &lt;*&gt; IP-VLAN support [CONFIG_IPVLAN]
181 &lt;*&gt; Virtual eXtensible Local Area Network (VXLAN) [CONFIG_VXLAN]
182 &lt;*&gt; Virtual ethernet pair device [CONFIG_VETH]
[7ea158e]183 &lt;*&gt; Virtual Routing and Forwarding (Lite) [CONFIG_VRF]</literal></screen>
[13b116c]184
185 <indexterm zone="NetworkManager NetworkManager-kernel">
186 <primary sortas="d-NetworkManager">NetworkManager</primary>
187 </indexterm>
188 </sect2>
189
[e33ddee]190 <sect2 role="installation">
191 <title>Installation of NetworkManager</title>
192
[7c56ece]193 <para>
[8558044]194 If <xref linkend="qt5"/> is installed and the Qt based
[7c56ece]195 examples are desired, fix two meson.build files:
196 </para>
[e4d2b8d]197
[e022b07]198<screen><userinput>sed -e 's/-qt4/-qt5/' \
[e4d2b8d]199 -e 's/moc_location/host_bins/' \
[6573fc3]200 -i examples/C/qt/meson.build &amp;&amp;
[40d141f]201
[6573fc3]202sed -e 's/Qt/&amp;5/' \
203 -i meson.build</userinput></screen>
[d267a13]204
[f61c18e]205<!--
[d267a13]206 <para>
207 Fix a missing meson.build file for initrd hooks (not used in BLFS):
208 </para>
209
[4da49b9]210<screen><userinput>sed '/initrd/d' -i src/core/meson.build</userinput></screen>
[f61c18e]211-->
[e4d2b8d]212
[fdbfe39]213 <para>
214 Fix the python scripts so that they use <application>Python
215 3</application>:
216 </para>
217
218<screen><userinput>grep -rl '^#!.*python$' | xargs sed -i '1s/python/&amp;3/'</userinput></screen>
219
[7ded7e3]220 <para>
[7c4f32b]221 Install <application>NetworkManager</application> by running the
222 following commands:
[7ded7e3]223 </para>
[e33ddee]224
[d267a13]225<screen revision="sysv"><userinput>mkdir build &amp;&amp;
[7d07abd]226cd build &amp;&amp;
[d267a13]227
228CXXFLAGS+="-O2 -fPIC" \
[91318eb]229meson setup .. \
[4b6e2b2]230 --prefix=/usr \
[adf17153]231 --buildtype=release \
[d267a13]232 -Dlibaudit=no \
[39100371]233 -Dlibpsl=false \
234 -Dnmtui=true \
235 -Dovs=false \
236 -Dppp=false \
[d267a13]237 -Dselinux=false \
[51dfb3e]238 -Dsession_tracking=elogind \
[39100371]239 -Dmodem_manager=false \
[d267a13]240 -Dsystemdsystemunitdir=no \
241 -Dsystemd_journal=false \
[91318eb]242 -Dqt=false &amp;&amp;
[d267a13]243ninja</userinput></screen>
244
245<screen revision="systemd"><userinput>mkdir build &amp;&amp;
[7d07abd]246cd build &amp;&amp;
[d267a13]247
248CXXFLAGS+="-O2 -fPIC" \
[91318eb]249meson setup .. \
[4b6e2b2]250 --prefix=/usr \
[adf17153]251 --buildtype=release \
[d267a13]252 -Dlibaudit=no \
[39100371]253 -Dlibpsl=false \
254 -Dnmtui=true \
255 -Dovs=false \
256 -Dppp=false \
[d267a13]257 -Dselinux=false \
258 -Dqt=false \
259 -Dsession_tracking=systemd \
[91318eb]260 -Dmodem_manager=false &amp;&amp;
[d267a13]261ninja</userinput></screen>
[cec6657e]262
[7ded7e3]263 <para>
[0bfaca0]264 An already active graphical session with a bus address is necessary
265 to run the tests. To test the results, issue
266 <command>ninja test</command>.
[fc88f1f]267 </para>
268
269 <para>
270 A few tests may fail, depending on enabled kernel options.
[7ded7e3]271 </para>
[e33ddee]272
[7ded7e3]273 <para>
274 Now, as the <systemitem class="username">root</systemitem> user:
275 </para>
[e33ddee]276
[d267a13]277<screen role="root"><userinput>ninja install &amp;&amp;
278mv -v /usr/share/doc/NetworkManager{,-&NetworkManager-version;}</userinput></screen>
[e33ddee]279
[4d6a0e2]280 <para>
281 If you have not passed the <option>-Ddocs=true</option> option to
282 <command>meson</command>, you can install the pregenerated manual pages
283 with (as the &root; user):
284 </para>
285
286<screen role="root"><userinput>for file in $(echo ../man/*.[1578]); do
287 section=${file##*.} &amp;&amp;
288 install -vdm 755 /usr/share/man/man$section
289 install -vm 644 $file /usr/share/man/man$section/
290done</userinput></screen>
291
292 <para>
293 Still in case you have not used <option>-Ddocs=true</option>, the
294 pregenerated HTML documentation can also be installed with (as
295 the &root; user):
296 </para>
297
298<screen role="root"
299 remap="doc"><userinput>cp -Rv ../docs/{api,libnm} /usr/share/doc/NetworkManager-&NetworkManager-version;</userinput></screen>
300
[e33ddee]301 </sect2>
302
303 <sect2 role="commands">
304 <title>Command Explanations</title>
305
[e4d2b8d]306 <para>
[8558044]307 <envar>CXXFLAGS="-O2 -fPIC"</envar>: These compiler options are
[e4d2b8d]308 necessary to build the Qt5 based examples.
309 </para>
310
[adf17153]311 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
312 href="../../xincludes/meson-buildtype-release.xml"/>
313
[e64cabd]314 <para>
[fdbfe39]315 <option>-Ddocs=true</option>: Use this switch to enable building
[39100371]316 man pages and documentation if <xref linkend="gtk-doc"/> is installed.
[e64cabd]317 </para>
318
[7ded7e3]319 <para>
[d267a13]320 <parameter>-Dnmtui=true</parameter>: This parameter enables building
[acb3e9f]321 <command>nmtui</command>.
322 </para>
323
[d267a13]324 <para revision="sysv">
[51dfb3e]325 <parameter>-Dsystemdsystemunitdir=no</parameter> and
[d267a13]326 <parameter>-Dsystemd_journal=false</parameter>: systemd is not
327 used for sysv init systems.
328 </para>
329
[39100371]330 <para>
[21d18f7e]331 <parameter>-Dlibpsl=false</parameter> and
[e130fead]332 <parameter>-Dovs=false</parameter>: These switches disable building with the
[39100371]333 respective libraries. Remove if you have the needed libraries installed.
334 </para>
[8558044]335
[52c95143]336<!--
[39100371]337 <para>
[f759a25]338 <parameter>-Dlibpsl=false</parameter>: This switch is required if
339 <application>libpsl</application> is not installed. Omit this switch if
340 you have built <application>libpsl</application>.
341 </para>
[52c95143]342-->
[f759a25]343
344 <para>
[2c87187]345 <parameter>-Dmodem_manager=false</parameter>: This switch is required if
[39100371]346 <application>ModemManager</application> is not installed. Omit if you
[a406810]347 have built <application>ModemManager</application> and
348 <application>mobile-broadband-provider-info</application>.
[39100371]349 </para>
350
[51dfb3e]351 <para revision="sysv">
352 <parameter>-Dsession_tracking=elogind</parameter>: This switch
353 is used to set <command>elogind</command> as the default
354 program for session tracking.
355 </para>
356
[cec6657e]357 <para revision="systemd">
[d267a13]358 <parameter>-Dsession_tracking=systemd</parameter>: This switch
[cec6657e]359 is used to set <command>systemd-logind</command> as the default
360 program for session tracking.
361 </para>
362
363 <para revision="systemd">
[d267a13]364 <parameter>-Dsystemdsystemunitdir=/lib/systemd/system</parameter>:
[cec6657e]365 This switch is used to set the correct installation directory for
366 systemd units.
367 </para>
368
[acb3e9f]369 <para>
[d267a13]370 <parameter>-Dppp=false</parameter>: This parameter disables
[6e1616e2]371 <application>PPP</application> support in
372 <application>NetworkManager</application>.
[7ded7e3]373 </para>
[e33ddee]374
[8c7390c]375 <para>
[d267a13]376 <parameter>-Dlibaudit=no</parameter> and
377 <parameter>-Dselinux=false</parameter>: libaudit and SELinux are not used
378 in BLFS.
[d6e164b]379 </para>
[e33ddee]380
[b528d0f4]381 <para>
[d267a13]382 <parameter>-Dqt=false</parameter>: disables the
383 <application>QT</application> examples. Omit if you have
384 <application>QT</application> available and wish to install the examples.
[b528d0f4]385 </para>
386
[261fdeb]387 <para>
388 <option>-Dcrypto=gnutls</option>: Use this switch if you have GnuTLS
389 installed and want to use it for certificate and key operations in
390 NetworkManager, instead of using NSS (the default).
391 </para>
392
393 <para>
394 <option>-Dcrypto=null</option>: Use this switch if neither NSS nor
395 GnuTLS is installed but you want to build NetworkManager anyway. This
396 switch will make NetworkManager lack some features (for example
397 802.1X).
398 </para>
399
[e33ddee]400 </sect2>
401
[d497e89]402 <sect2 role="configuration">
403 <title>Configuring NetworkManager</title>
404
405 <sect3 id="NetworkManager-config">
406 <title>Config Files</title>
407 <para>
408 <filename>/etc/NetworkManager/NetworkManager.conf</filename>
409 </para>
410
411 <indexterm zone="NetworkManager NetworkManager-config">
412 <primary
413 sortas="e-etc-NetworkManager-NetworkManager.conf">
414 /etc/NetworkManager/NetworkManager.conf</primary>
415 </indexterm>
416
417 </sect3>
418
419 <sect3><title>Configuration Information</title>
420
421 <para>
422 For <application>NetworkManager</application> to work, at least
[21d18f7e]423 a minimal configuration file must be present. Such a file is not
[8df33ae3]424 installed with <command>make install</command>. Issue the following
425 command as the <systemitem class="username">root</systemitem> user to
[21d18f7e]426 create a minimal <filename>NetworkManager.conf</filename> file:
[d497e89]427 </para>
428
429<screen role="root"><userinput>cat &gt;&gt; /etc/NetworkManager/NetworkManager.conf &lt;&lt; "EOF"
430<literal>[main]
431plugins=keyfile</literal>
432EOF</userinput></screen>
433
434 <para>
[7fd06b0]435 This file should not be modified directly by users of the system.
436 Instead, system specific changes should be made using configuration
437 files in the
438 <filename class="directory">/etc/NetworkManager/conf.d</filename>
[21d18f7e]439 directory.
[7fd06b0]440 </para>
441
442 <para>
443 To allow polkit to manage authorizations, add the following
444 configuration file:
445 </para>
446
447<screen role="root"><userinput>cat &gt; /etc/NetworkManager/conf.d/polkit.conf &lt;&lt; "EOF"
448<literal>[main]
449auth-polkit=true</literal>
450EOF</userinput></screen>
451
452 <para>
453 To use something other than the built-in dhcp client (recommended if
454 using only <command>nmcli</command>), use the following configuration
[194d47b]455 (valid values include either dhcpcd or internal):
[7fd06b0]456 </para>
457
458<screen role="nodump"><userinput>cat &gt; /etc/NetworkManager/conf.d/dhcp.conf &lt;&lt; "EOF"
459<literal>[main]
[194d47b]460dhcp=</literal><replaceable>dhcpcd</replaceable>
[7fd06b0]461EOF</userinput></screen>
462
463 <para>
464 To prevent <application>NetworkManager</application> from updating the
465 <filename>/etc/resolv.conf</filename> file, add the following
466 configuration file:
467 </para>
468
469<screen role="nodump"><userinput>cat &gt; /etc/NetworkManager/conf.d/no-dns-update.conf &lt;&lt; "EOF"
470<literal>[main]
471dns=none</literal>
472EOF</userinput></screen>
473
474 <para>
[5f729f8]475 For additional configuration options, see
[7fd06b0]476 <command>man 5 NetworkManager.conf</command>.
[0d7900a]477 </para>
[d497e89]478
[8df33ae3]479 <para>
[21d18f7e]480 To allow regular users to configure network connections,
[8df33ae3]481 you should add them to the
482 <systemitem class="groupname">netdev</systemitem>
483 group, and create a <application>polkit</application> rule that grants
484 access. Run the following commands as the
485 <systemitem class="username">root</systemitem> user:
486 </para>
487
[a581662]488<screen role="root"><userinput>groupadd -fg 86 netdev &amp;&amp;
[b88584a]489/usr/sbin/usermod -a -G netdev <replaceable>&lt;username&gt;</replaceable>
[8df33ae3]490
491cat &gt; /usr/share/polkit-1/rules.d/org.freedesktop.NetworkManager.rules &lt;&lt; "EOF"
492<literal>polkit.addRule(function(action, subject) {
493 if (action.id.indexOf("org.freedesktop.NetworkManager.") == 0 &amp;&amp; subject.isInGroup("netdev")) {
494 return polkit.Result.YES;
495 }
496});</literal>
497EOF</userinput></screen>
498
[d497e89]499 </sect3>
500
501 <sect3 id="NetworkManager-init">
[cec6657e]502 <title><phrase revision="sysv">Boot Script</phrase>
503 <phrase revision="systemd">Systemd Unit</phrase></title>
504
505 <para revision="sysv">
506 To automatically start the <command>NetworkManager</command> daemon
507 when the system is rebooted, install the
[8558044]508 <filename>/etc/rc.d/init.d/networkmanager</filename>bootscript from the
[cec6657e]509 <xref linkend="bootscripts"/> package.
510 </para>
[d497e89]511
[cec6657e]512 <para revision="systemd">
513 To start the <command>NetworkManager</command> daemon at boot, enable
514 the previously installed systemd unit by running the following command
515 as the <systemitem class="username">root</systemitem> user:
[d497e89]516 </para>
517
[8df33ae3]518 <note>
519 <para>
520 If using <application>Network Manager</application> to manage
521 an interface, any previous configuration for that interface should be
522 removed, and the interface brought down prior to starting
523 <application>Network Manager</application>.
524 </para>
525 </note>
[8558044]526
[d497e89]527 <indexterm zone="NetworkManager NetworkManager-init">
528 <primary sortas="f-NetworkManager">NetworkManager</primary>
529 </indexterm>
530
[cec6657e]531<screen role="root" revision="sysv"><userinput>make install-networkmanager</userinput></screen>
532
533<screen role="root" revision="systemd"><userinput>systemctl enable NetworkManager</userinput></screen>
[e2a1442]534<!-- The below instruction is obsolete. NetworkManager-wait-online is now
535 enabled by default when enabling NetworkManager. -->
536<!--
[cec6657e]537 <para revision="systemd">
538 <application>NetworkManager</application> also ships a systemd unit
539 called <filename>NetworkManager-wait-online.service</filename> which
540 can be used to prevent services that require network connectivity
541 from starting until <application>NetworkManager</application> has
542 established the connection. To enable it, run the following command
543 as the <systemitem class="username">root</systemitem> user:
544 </para>
545
546<screen role="root" revision="systemd"><userinput>systemctl enable NetworkManager-wait-online</userinput></screen>
[e2a1442]547 -->
548 <!-- As such, let's now provide instructions on how to disable that
549 behavior, for those who wish to do so. -->
550 <para revision="systemd">
551 Starting in version 1.11.2 of <application>NetworkManager</application>,
552 a systemd unit named <filename>NetworkManager-wait-online.service</filename>
553 is enabled, which is used to prevent services that require network
554 connectivity from starting until <application>NetworkManager</application>
555 establishes a connection. To disable this behavior, run the following
556 command as the <systemitem class="username">root</systemitem> user:
557 </para>
558
559<screen role="root" revision="systemd"><userinput>systemctl disable NetworkManager-wait-online</userinput></screen>
[2cd1071]560
[d497e89]561 </sect3>
562
563 </sect2>
564
[e33ddee]565 <sect2 role="content">
566 <title>Contents</title>
567
568 <segmentedlist>
569 <segtitle>Installed Programs</segtitle>
570 <segtitle>Installed Libraries</segtitle>
571 <segtitle>Installed Directories</segtitle>
572
573 <seglistitem>
[d497e89]574 <seg>
[8c7390c]575 NetworkManager, nmcli, nm-online, nmtui, and, symlinked to nmtui:
576 nmtui-connect, nmtui-edit, and nmtui-hostname
[d497e89]577 </seg>
578 <seg>
[b9f17a8]579 libnm.so
[52c95143]580 and several modules under /usr/lib/NetworkManager
[d497e89]581 </seg>
582 <seg>
[5aa7dce]583 /etc/NetworkManager,
[05a433b]584 /usr/include/libnm,
[5aa7dce]585 /usr/lib/NetworkManager,
586 /usr/share/doc/NetworkManager-&NetworkManager-version;,
[b9f17a8]587 /usr/share/gtk-doc/html/{libnm,NetworkManager}
588 (if the documentation is built),
[5aa7dce]589 and
[262a108]590 /var/lib/NetworkManager
[d497e89]591 </seg>
[e33ddee]592 </seglistitem>
593 </segmentedlist>
594
595 <variablelist>
596 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
597 <?dbfo list-presentation="list"?>
598 <?dbhtml list-presentation="table"?>
599
[d497e89]600 <varlistentry id="nmcli">
601 <term><command>nmcli</command></term>
[e33ddee]602 <listitem>
[7ded7e3]603 <para>
604 is a command-line tool for controlling
[0d7900a]605 <application>NetworkManager</application>
[4c24eb0a]606 and getting its status
[7ded7e3]607 </para>
[d497e89]608 <indexterm zone="NetworkManager nmcli">
609 <primary sortas="b-nmcli">nmcli</primary>
[e33ddee]610 </indexterm>
611 </listitem>
612 </varlistentry>
613
614 <varlistentry id="nm-online">
615 <term><command>nm-online</command></term>
616 <listitem>
[7ded7e3]617 <para>
[4c24eb0a]618 is an utility to determine whether you are online
[7ded7e3]619 </para>
[e33ddee]620 <indexterm zone="NetworkManager nm-online">
621 <primary sortas="b-nm-online">nm-online</primary>
622 </indexterm>
623 </listitem>
624 </varlistentry>
625
[acb3e9f]626 <varlistentry id="nmtui">
627 <term><command>nmtui</command></term>
628 <listitem>
629 <para>
[21d18f7e]630 is an interactive ncurses-based user interface for
[4c24eb0a]631 <application>nmcli</application>
[acb3e9f]632 </para>
633 <indexterm zone="NetworkManager nmtui">
634 <primary sortas="b-nmtui">nmtui</primary>
635 </indexterm>
636 </listitem>
637 </varlistentry>
638
639 <varlistentry id="nmtui-connect">
640 <term><command>nmtui-connect</command></term>
641 <listitem>
642 <para>
[21d18f7e]643 is an interactive ncurses-based user interface to
[4c24eb0a]644 activate/deactivate connections
[acb3e9f]645 </para>
646 <indexterm zone="NetworkManager nmtui-connect">
647 <primary sortas="b-nmtui-connect">nmtui-connect</primary>
648 </indexterm>
649 </listitem>
650 </varlistentry>
651
652 <varlistentry id="nmtui-edit">
653 <term><command>nmtui-edit</command></term>
654 <listitem>
655 <para>
[4c24eb0a]656 is an interactive ncurses-based user interface to edit connections
[acb3e9f]657 </para>
658 <indexterm zone="NetworkManager nmtui-edit">
659 <primary sortas="b-nmtui-edit">nmtui-edit</primary>
660 </indexterm>
661 </listitem>
662 </varlistentry>
663
664 <varlistentry id="nmtui-hostname">
665 <term><command>nmtui-hostname</command></term>
[e33ddee]666 <listitem>
[7ded7e3]667 <para>
[4c24eb0a]668 is an interactive ncurses-based user interface to edit the hostname
[7ded7e3]669 </para>
[acb3e9f]670 <indexterm zone="NetworkManager nmtui-hostname">
671 <primary sortas="b-nmtui-hostname">nmtui-hostname</primary>
[e33ddee]672 </indexterm>
673 </listitem>
674 </varlistentry>
675
[d497e89]676 <varlistentry id="NetworkManager-prog">
677 <term><command>NetworkManager</command></term>
[e33ddee]678 <listitem>
[7ded7e3]679 <para>
[4c24eb0a]680 is the network management daemon
[7ded7e3]681 </para>
[d497e89]682 <indexterm zone="NetworkManager NetworkManager-prog">
[7ded7e3]683 <primary sortas="b-NetworkManager">NetworkManager</primary>
[e33ddee]684 </indexterm>
685 </listitem>
686 </varlistentry>
687
[262a108]688 <varlistentry id="libnm">
689 <term><filename class="libraryfile">libnm.so</filename></term>
[e33ddee]690 <listitem>
[7ded7e3]691 <para>
[4c24eb0a]692 contains functions used by <application>NetworkManager</application>
[7ded7e3]693 </para>
[262a108]694 <indexterm zone="NetworkManager libnm">
695 <primary sortas="c-libnm">libnm.so</primary>
[e33ddee]696 </indexterm>
697 </listitem>
698 </varlistentry>
699 </variablelist>
700
701 </sect2>
702
703</sect1>
Note: See TracBrowser for help on using the repository browser.