source: networking/netutils/networkmanager.xml@ 939040e0

12.0 12.1 12.2 gimp3 ken/TL2024 ken/tuningfonts lazarus lxqt 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 939040e0 was b3867c5, checked in by Bruce Dubbs <bdubbs@…>, 14 months ago

Add qt5-components page.

Also create an ENTITY for qt5 or qt5-alternate and use that
to specify the qt5 dependenies.

The complete KF5/plasma packages should use the full qt5 build, but
the lxqt kf5/plasma components only need qt5-alternate.

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