source: networking/netutils/networkmanager.xml@ 096492a

systemd-13485
Last change on this file since 096492a was 1ef4048, checked in by Douglas R. Reno <renodr@…>, 8 years ago

Updated to Qt-5.6.0 (merged from trunk... not tested yet)
Added qtwebkit5 page from trunk
Force gst-plugins-base to use Qt5
Added qt5 as a dependency for gst-plugins-bad
Forced wpa_supplicant to use Qt5
Removed the Qt4 dependency from NetworkManager
Forced VLC to use Qt5
Archived qtchooser
Archived Amarok (will probably be readded when an official Qt5/KF5 ready release is provided)
Archived k3b (will probably be readded whan an official Qt5/KF5 ready release is made)
Dependency changes to Qt5

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/branches/systemd@17355 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 14.2 KB
Line 
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
7 <!ENTITY NetworkManager-download-http
8 "&gnome-download-http;/NetworkManager/1.0/NetworkManager-&NetworkManager-version;.tar.xz">
9 <!ENTITY NetworkManager-download-ftp
10 "&gnome-download-ftp;/NetworkManager/1.0/NetworkManager-&NetworkManager-version;.tar.xz">
11 <!ENTITY NetworkManager-md5sum "a8f54460a4708efd840358f32d0968fd">
12 <!ENTITY NetworkManager-size "3.4 MB">
13 <!ENTITY NetworkManager-buildsize "358 MB (with tests)">
14 <!ENTITY NetworkManager-time "2.5 SBU (with tests)">
15]>
16
17<sect1 id="NetworkManager" xreflabel="NetworkManager-&NetworkManager-version;">
18 <?dbhtml filename="networkmanager.html"?>
19
20 <sect1info>
21 <othername>$LastChangedBy$</othername>
22 <date>$Date$</date>
23 </sect1info>
24
25 <title>NetworkManager-&NetworkManager-version;</title>
26
27 <indexterm zone="NetworkManager">
28 <primary sortas="a-NetworkManager">NetworkManager</primary>
29 </indexterm>
30
31 <sect2 role="package">
32 <title>Introduction to NetworkManager</title>
33
34 <para>
35 <application>NetworkManager</application> is a set of co-operative
36 tools that make networking simple and straightforward. Whether WiFi, wired,
37 3G, or Bluetooth, NetworkManager allows you to quickly move from one network
38 to another: Once a network has been configured and joined once, it can be
39 detected and re-joined automatically the next time it's available.
40 </para>
41
42 &lfs78_checked;
43
44 <note>
45 <para>
46 Make sure that you disable the <command>systemd-networkd</command> service
47 or configure it not to manage the interfaces you want to manage with
48 <application>NetworkManager</application>.
49 </para>
50 </note>
51
52 <bridgehead renderas="sect3">Package Information</bridgehead>
53 <itemizedlist spacing="compact">
54 <listitem>
55 <para>
56 Download (HTTP): <ulink url="&NetworkManager-download-http;"/>
57 </para>
58 </listitem>
59 <listitem>
60 <para>
61 Download (FTP): <ulink url="&NetworkManager-download-ftp;"/>
62 </para>
63 </listitem>
64 <listitem>
65 <para>
66 Download MD5 sum: &NetworkManager-md5sum;
67 </para>
68 </listitem>
69 <listitem>
70 <para>
71 Download size: &NetworkManager-size;
72 </para>
73 </listitem>
74 <listitem>
75 <para>
76 Estimated disk space required: &NetworkManager-buildsize;
77 </para>
78 </listitem>
79 <listitem>
80 <para>
81 Estimated build time: &NetworkManager-time;
82 </para>
83 </listitem>
84 </itemizedlist>
85
86 <bridgehead renderas="sect3">NetworkManager Dependencies</bridgehead>
87
88 <bridgehead renderas="sect4">Required</bridgehead>
89 <para role="required">
90 <xref linkend="dbus-glib"/>,
91 <xref linkend="libgudev"/>,
92 <xref linkend="libndp"/>,
93 <xref linkend="libnl"/>, and
94 <xref linkend="nss"/>
95 </para>
96
97 <bridgehead renderas="sect4">Recommended</bridgehead>
98 <para role="recommended">
99<!-- <xref linkend="consolekit"/>, -->
100 <xref linkend="dhcpcd"/> or
101 <xref linkend="dhcp"/> (client only),
102 <xref linkend="gobject-introspection"/>,
103 <xref linkend="iptables"/>,
104 <xref linkend="libsoup"/>,
105 <xref linkend="newt"/> (for <command>nmtui</command>),
106 <xref linkend="polkit"/>,
107 <xref linkend="systemd"/>,
108 <xref linkend="upower"/>,
109 <xref linkend="vala"/>, and
110 <xref linkend="wpa_supplicant"/> (built with D-Bus support),
111 </para>
112
113 <bridgehead renderas="sect4">Optional</bridgehead>
114 <para role="optional">
115 <xref linkend="bluez"/> (runtime),
116 <xref linkend="gtk-doc"/>,
117 <xref linkend="ModemManager"/>,
118 <xref linkend="pygobject3"/>,
119 <xref linkend="valgrind"/>,
120 <ulink url="http://libteam.org/">libteam</ulink>,
121 <ulink url="https://www.samba.org/ftp/ppp/">PPP</ulink> and
122 <ulink url="https://www.roaringpenguin.com/products/pppoe">RP-PPPoE</ulink>
123 </para>
124
125 <para condition="html" role="usernotes">User Notes:
126 <ulink url="&blfs-wiki;/NetworkManager"/>
127 </para>
128 </sect2>
129
130 <sect2 role="installation">
131 <title>Installation of NetworkManager</title>
132
133 <para>
134 Install <application>NetworkManager</application> by running the
135 following commands:
136 </para>
137
138<screen><userinput>./configure --prefix=/usr \
139 --sysconfdir=/etc \
140 --localstatedir=/var \
141 --with-nmtui \
142 --disable-ppp \
143 --with-session-tracking=systemd \
144 --with-systemdsystemunitdir=/lib/systemd/system \
145 --docdir=/usr/share/doc/NetworkManager-&NetworkManager-version; &amp;&amp;
146make</userinput></screen>
147
148 <para>
149 An already active graphical session with bus address is necessary to run
150 the tests. To test the results, issue: <command>make check</command>.
151 </para>
152
153 <para>
154 Now, as the <systemitem class="username">root</systemitem> user:
155 </para>
156
157<screen role="root"><userinput>make install</userinput></screen>
158
159 </sect2>
160
161 <sect2 role="commands">
162 <title>Command Explanations</title>
163
164 <para>
165 <parameter>--with-nmtui</parameter>: This switch enables building
166 of the <command>nmtui</command> program. Remove it if you have
167 not installed <xref linkend="newt"/>.
168 </para>
169
170 <para>
171 <parameter>--disable-ppp</parameter>: This switch disables
172 <application>PPP</application> support in
173 <application>NetworkManager</application>. Remove it if you have
174 installed <application>PPP</application>.
175 </para>
176
177 <para>
178 <parameter>--with-session-tracking=systemd</parameter>: This switch
179 is used to set <command>systemd-logind</command> as the default
180 program for session tracking.
181 </para>
182
183 <para>
184 <parameter>--with-systemdsystemunitdir=/lib/systemd/system</parameter>:
185 This switch is used to set the correct installation directory for
186 systemd units.
187 </para>
188
189 <para>
190 <option>--enable-gtk-doc</option>: Use this switch if you have installed
191 <xref linkend="gtk-doc"/> and wish to build the API manuals.
192 </para>
193
194 <para>
195 <option>--without-iptables</option>: Use this switch if you don't have
196 <application>Iptables</application> installed.
197 </para>
198
199 </sect2>
200
201 <sect2 role="configuration">
202 <title>Configuring NetworkManager</title>
203
204 <sect3 id="NetworkManager-config">
205 <title>Config Files</title>
206 <para>
207 <filename>/etc/NetworkManager/NetworkManager.conf</filename>
208 </para>
209
210 <indexterm zone="NetworkManager NetworkManager-config">
211 <primary sortas="e-etc-NetworkManager-NetworkManager.conf">
212 /etc/NetworkManager/NetworkManager.conf</primary>
213 </indexterm>
214
215 </sect3>
216
217 <sect3><title>Configuration Information</title>
218
219 <para>
220 For <application>NetworkManager</application> to work, at least a
221 minimal configuration file must be present. Such file is not
222 installed with <command>make install</command>. Issue the following
223 command as the
224 <systemitem class="username">root</systemitem> user to create a
225 minimal <filename>NetworkManager.conf</filename> file:
226 </para>
227
228<screen role="root"><userinput>cat &gt;&gt; /etc/NetworkManager/NetworkManager.conf &lt;&lt; "EOF"
229<literal>[main]
230plugins=keyfile</literal>
231EOF</userinput></screen>
232
233 <para>
234 You can add <option>dns=none</option> to suppress changes to
235 <filename>/etc/resolv.conf</filename>. See
236 <command>man 5 NetworkManager.conf</command>
237 for any additional options.
238 </para>
239
240 </sect3>
241
242 <sect3 id="NetworkManager-init">
243 <title>Systemd Units</title>
244
245 <para>
246 To start the <command>NetworkManager</command> daemon at boot, enable
247 the previously installed systemd unit by running the following command
248 as the <systemitem class="username">root</systemitem> user:
249 </para>
250
251 <indexterm zone="NetworkManager NetworkManager-init">
252 <primary sortas="f-NetworkManager">NetworkManager</primary>
253 </indexterm>
254
255<screen role="root"><userinput>systemctl enable NetworkManager</userinput></screen>
256
257 <para>
258 <application>NetworkManager</application> also ships a systemd unit
259 called <filename>NetworkManager-wait-online.service</filename> which
260 can be used to prevent services that require network connectivity
261 from starting until <application>NetworkManager</application> has
262 established the connection. To enable it, run the following command
263 as the <systemitem class="username">root</systemitem> user:
264 </para>
265
266<screen role="root"><userinput>systemctl enable NetworkManager-wait-online</userinput></screen>
267
268 </sect3>
269
270 </sect2>
271
272 <sect2 role="content">
273 <title>Contents</title>
274
275 <segmentedlist>
276 <segtitle>Installed Programs</segtitle>
277 <segtitle>Installed Libraries</segtitle>
278 <segtitle>Installed Directories</segtitle>
279
280 <seglistitem>
281 <seg>
282 NetworkManager, nmcli, nm-online, and, hardlinked to each other:
283 nmtui, nmtui-connect, nmtui-edit, and nmtui-hostname
284 </seg>
285 <seg>
286 libnm-glib.so, libnm-glib-vpn.so, libnm.so, libnm-util.so, and
287 modules under /usr/lib/NetworkManager
288 </seg>
289 <seg>
290 /etc/NetworkManager,
291 /usr/include/{libnm,libnm-glib,NetworkManager},
292 /usr/lib/NetworkManager,
293 /usr/share/doc/NetworkManager-&NetworkManager-version;,
294 /usr/share/gtk-doc/html/{libnm,libnm-glib,libnm-util,NetworkManager},
295 and
296 /var/{lib,run}/NetworkManager
297 </seg>
298 </seglistitem>
299 </segmentedlist>
300
301 <variablelist>
302 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
303 <?dbfo list-presentation="list"?>
304 <?dbhtml list-presentation="table"?>
305
306 <varlistentry id="nmcli">
307 <term><command>nmcli</command></term>
308 <listitem>
309 <para>
310 is a command-line tool for controlling
311 <application>NetworkManager</application>
312 and getting its status.
313 </para>
314 <indexterm zone="NetworkManager nmcli">
315 <primary sortas="b-nmcli">nmcli</primary>
316 </indexterm>
317 </listitem>
318 </varlistentry>
319
320 <varlistentry id="nm-online">
321 <term><command>nm-online</command></term>
322 <listitem>
323 <para>
324 is a utility to find out whether you are online.
325 </para>
326 <indexterm zone="NetworkManager nm-online">
327 <primary sortas="b-nm-online">nm-online</primary>
328 </indexterm>
329 </listitem>
330 </varlistentry>
331
332 <varlistentry id="nmtui">
333 <term><command>nmtui</command></term>
334 <listitem>
335 <para>
336 interactive ncurses based interface for
337 <application>nmcli</application>.
338 </para>
339 <indexterm zone="NetworkManager nmtui">
340 <primary sortas="b-nmtui">nmtui</primary>
341 </indexterm>
342 </listitem>
343 </varlistentry>
344
345 <varlistentry id="nmtui-connect">
346 <term><command>nmtui-connect</command></term>
347 <listitem>
348 <para>
349 interactive ncurses based interface connection activate/deactivate.
350 </para>
351 <indexterm zone="NetworkManager nmtui-connect">
352 <primary sortas="b-nmtui-connect">nmtui-connect</primary>
353 </indexterm>
354 </listitem>
355 </varlistentry>
356
357 <varlistentry id="nmtui-edit">
358 <term><command>nmtui-edit</command></term>
359 <listitem>
360 <para>
361 interactive ncurses based interface connection editor.
362 </para>
363 <indexterm zone="NetworkManager nmtui-edit">
364 <primary sortas="b-nmtui-edit">nmtui-edit</primary>
365 </indexterm>
366 </listitem>
367 </varlistentry>
368
369 <varlistentry id="nmtui-hostname">
370 <term><command>nmtui-hostname</command></term>
371 <listitem>
372 <para>
373 interactive ncurses based interface hostname editor.
374 </para>
375 <indexterm zone="NetworkManager nmtui-hostname">
376 <primary sortas="b-nmtui-hostname">nmtui-hostname</primary>
377 </indexterm>
378 </listitem>
379 </varlistentry>
380
381 <varlistentry id="NetworkManager-prog">
382 <term><command>NetworkManager</command></term>
383 <listitem>
384 <para>
385 is the network management daemon.
386 </para>
387 <indexterm zone="NetworkManager NetworkManager-prog">
388 <primary sortas="b-NetworkManager">NetworkManager</primary>
389 </indexterm>
390 </listitem>
391 </varlistentry>
392
393 <varlistentry id="libnm-glib">
394 <term><filename class="libraryfile">libnm-glib.so</filename></term>
395 <listitem>
396 <para>
397 contains functions used by <application>NetworkManager</application>.
398 </para>
399 <indexterm zone="NetworkManager libnm-glib">
400 <primary sortas="c-libnm-glib">libnm-glib.so</primary>
401 </indexterm>
402 </listitem>
403 </varlistentry>
404
405 <varlistentry id="libnm-glib-vpn">
406 <term><filename class="libraryfile">libnm-glib-vpn.so</filename></term>
407 <listitem>
408 <para>
409 contains functions used by <application>NetworkManager</application>
410 VPN plugins.
411 </para>
412 <indexterm zone="NetworkManager libnm-glib-vpn">
413 <primary sortas="c-libnm-glib-vpn">libnm-glib-vpn.so</primary>
414 </indexterm>
415 </listitem>
416 </varlistentry>
417
418 <varlistentry id="libnm-util">
419 <term><filename class="libraryfile">libnm-util.so</filename></term>
420 <listitem>
421 <para>
422 contains functions used by <application>NetworkManager</application>
423 utils.
424 </para>
425 <indexterm zone="NetworkManager libnm-util">
426 <primary sortas="c-libnm-util">libnm-util.so</primary>
427 </indexterm>
428 </listitem>
429 </varlistentry>
430
431 </variablelist>
432
433 </sect2>
434
435</sect1>
Note: See TracBrowser for help on using the repository browser.