source: networking/netutils/networkmanager-systemd.xml@ 2d984f84

systemd-13485
Last change on this file since 2d984f84 was 2d984f84, checked in by Christopher Gregory <cjg@…>, 9 years ago

Updated to NetworkManager-1.0.0.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/branches/systemd@15242 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 14.5 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 "71cae8707a90fa92e28cafbc9262b548">
12 <!ENTITY NetworkManager-size "3.0 MB">
13 <!ENTITY NetworkManager-buildsize "232.3 MB (includes building documentation and tests.)">
14 <!ENTITY NetworkManager-time "2.9 SBU (includes building documentation and 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 &lfs76_checked;
43
44 <note>
45 <para>
46 Make sure you disable <command>systemd-networkd</command> service
47 or make it not configure the connections 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="libndp"/>,
92 <xref linkend="libnl"/>,
93 <xref linkend="nss"/>,
94 (or <xref linkend="gnutls"/>), and
95 <xref linkend="systemd"/> (for GUdev and Logind)
96 </para>
97
98 <bridgehead renderas="sect4">Recommended</bridgehead>
99 <para role="recommended">
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"/>, and
107 <xref linkend="vala"/>
108 </para>
109
110 <bridgehead renderas="sect4">Optional</bridgehead>
111 <para role="optional">
112 <xref linkend="bluez"/> (runtime),
113 <xref linkend="gtk-doc"/>,
114 <xref linkend="ModemManager"/>,
115 <xref linkend="pygobject3"/>,
116 <xref linkend="qt4"/>,
117 <xref linkend="valgrind"/>,
118 <xref linkend="wpa_supplicant"/> (built with D-Bus support),
119 <ulink url="http://libteam.org/">libteam</ulink>, and
120 <ulink url="http://search.cpan.org/~ingy/YAML-1.13/">YAML</ulink> (perl module to build documentation)
121 </para>
122
123 <para condition="html" role="usernotes">User Notes:
124 <ulink url="&blfs-wiki;/NetworkManager"/>
125 </para>
126 </sect2>
127
128 <sect2 role="installation">
129 <title>Installation of NetworkManager</title>
130
131<screen><userinput>./configure --prefix=/usr \
132 --sysconfdir=/etc \
133 --localstatedir=/var \
134 --disable-ppp \
135 --with-nmtui \
136 --with-session-tracking=systemd \
137 --with-systemdsystemunitdir=/lib/systemd/system &amp;&amp;
138make</userinput></screen>
139
140 <para>
141 An already active graphical session with bus address is necessary to run
142 the tests. To test the results, issue: <command>make check</command>.
143 </para>
144
145 <para>
146 Now, as the <systemitem class="username">root</systemitem> user:
147 </para>
148
149<screen role="root"><userinput>make install</userinput></screen>
150
151 </sect2>
152
153 <sect2 role="commands">
154 <title>Command Explanations</title>
155
156 <para>
157 <parameter>--disable-ppp</parameter>: This switch disables
158 <application>PPP</application> support in
159 <application>NetworkManager</application> because
160 <application>PPP</application> isn't part of BLFS.
161 </para>
162
163 <para>
164 <parameter>--with-nmtui</parameter>: This switch enables building
165 of the <command>nmtui</command> program. Remove it if you have
166 not installed <xref linkend="newt"/>.
167 </para>
168
169 <para>
170 <parameter>--with-session-tracking=systemd</parameter>: This switch
171 is used to set <command>systemd-logind</command> as the default
172 program for session tracking.
173 </para>
174
175 <para>
176 <parameter>--with-systemdsystemunitdir=/lib/systemd/system</parameter>:
177 This switch is used to set the correct installation directory for
178 systemd units.
179 </para>
180
181 <para>
182 <option>--enable-gtk-doc</option>: Use this switch if you have installed
183 <xref linkend="gtk-doc"/> and wish to build the API manuals.
184 </para>
185
186 <para>
187 <option>--without-iptables</option>: Use this switch if you don't have
188 <application>Iptables</application> installed.
189 </para>
190
191 </sect2>
192
193 <sect2 role="configuration">
194 <title>Configuring NetworkManager</title>
195
196 <sect3 id="NetworkManager-config">
197 <title>Config Files</title>
198 <para>
199 <filename>/etc/NetworkManager/NetworkManager.conf</filename>
200 </para>
201
202 <indexterm zone="NetworkManager NetworkManager-config">
203 <primary sortas="e-etc-NetworkManager-NetworkManager.conf">
204 /etc/NetworkManager/NetworkManager.conf</primary>
205 </indexterm>
206
207 </sect3>
208
209 <sect3><title>Configuration Information</title>
210
211 <para>
212 For <application>NetworkManager</application> to work, at least a
213 basic configuration file must be present. Such file is not
214 installed with <command>make install</command>. Run the following
215 command as the
216 <systemitem class="username">root</systemitem> user to create a
217 basic <filename>NetworkManager.conf</filename> file:
218 </para>
219
220<screen role="root"><userinput>cat &gt;&gt; /etc/NetworkManager/NetworkManager.conf &lt;&lt; "EOF"
221<literal>[main]
222plugins=keyfile</literal>
223EOF</userinput></screen>
224
225 <para>
226 You can add <option>dns=none</option> to suppress changes to
227 <filename>/etc/resolv.conf</filename>. See
228 <command>man 5 NetworkManager.conf</command>
229 for any additional options.
230 </para>
231
232 </sect3>
233
234 <sect3 id="NetworkManager-init">
235 <title>Systemd Units</title>
236
237 <para>
238 To start the <command>NetworkManager</command> daemon at boot, enable
239 the previously installed systemd unit by running the following command
240 as the <systemitem class="username">root</systemitem> user:
241 </para>
242
243 <indexterm zone="NetworkManager NetworkManager-init">
244 <primary sortas="f-NetworkManager">NetworkManager</primary>
245 </indexterm>
246
247<screen role="root"><userinput>systemctl enable NetworkManager</userinput></screen>
248
249 <para>
250 <application>NetworkManager</application> also ships a systemd unit
251 called <filename>NetworkManager-wait-online.service</filename> which
252 can be used to prevent services that require network connectivity
253 from starting until <application>NetworkManager</application> has
254 established the connection. To enable it, run the following command
255 as the <systemitem class="username">root</systemitem> user:
256 </para>
257
258<screen role="root"><userinput>systemctl enable NetworkManager-wait-online</userinput></screen>
259
260 </sect3>
261
262 </sect2>
263
264 <sect2 role="content">
265 <title>Contents</title>
266
267 <segmentedlist>
268 <segtitle>Installed Programs</segtitle>
269 <segtitle>Installed Libraries</segtitle>
270 <segtitle>Installed Directories</segtitle>
271
272 <seglistitem>
273 <seg>
274 NetworkManager, nm-online, nmcli, nmtui, nmtui-connect,
275 nmtui-edit, and nmtui-hostname
276 </seg>
277 <seg>
278 libnm-glib.so, libnm-glib-vpn.so, libnm-util.so and libnm.so
279 </seg>
280 <seg>
281 /etc/NetworkManager,
282 /usr/include/libnm-glib,
283 /usr/include/NetworkManager,
284 /usr/lib/NetworkManager,
285 /usr/share/doc/NetworkManager,
286 /usr/share/gtk-doc/html/libnm-glib,
287 /usr/share/gtk-doc/html/libnm-util,
288 /usr/share/gtk-doc/html/NetworkManager,
289 /var/lib/NetworkManager, and
290 /var/run/NetworkManager
291 </seg>
292 </seglistitem>
293 </segmentedlist>
294
295 <variablelist>
296 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
297 <?dbfo list-presentation="list"?>
298 <?dbhtml list-presentation="table"?>
299
300 <varlistentry id="nmcli">
301 <term><command>nmcli</command></term>
302 <listitem>
303 <para>
304 is a command-line tool for controlling
305 <application>NetworkManager</application>
306 and getting its status.
307 </para>
308 <indexterm zone="NetworkManager nmcli">
309 <primary sortas="b-nmcli">nmcli</primary>
310 </indexterm>
311 </listitem>
312 </varlistentry>
313
314 <varlistentry id="nm-online">
315 <term><command>nm-online</command></term>
316 <listitem>
317 <para>
318 is a utility to find out whether you are online.
319 </para>
320 <indexterm zone="NetworkManager nm-online">
321 <primary sortas="b-nm-online">nm-online</primary>
322 </indexterm>
323 </listitem>
324 </varlistentry>
325
326 <varlistentry id="nmtui">
327 <term><command>nmtui</command></term>
328 <listitem>
329 <para>
330 is an interactive ncurses based interface for
331 <application>nmcli</application>.
332 </para>
333 <indexterm zone="NetworkManager nmtui">
334 <primary sortas="b-nmtui">nmtui</primary>
335 </indexterm>
336 </listitem>
337 </varlistentry>
338
339 <varlistentry id="nmtui-connect">
340 <term><command>nmtui-connect</command></term>
341 <listitem>
342 <para>
343 is an interactive ncurses based interface connection
344 activate/deactivate.
345 </para>
346 <indexterm zone="NetworkManager nmtui-connect">
347 <primary sortas="b-nmtui-connect">nmtui-connect</primary>
348 </indexterm>
349 </listitem>
350 </varlistentry>
351
352 <varlistentry id="nmtui-edit">
353 <term><command>nmtui-edit</command></term>
354 <listitem>
355 <para>
356 is an interactive ncurses based interface connection
357 editor.
358 </para>
359 <indexterm zone="NetworkManager nmtui-edit">
360 <primary sortas="b-nmtui-edit">nmtui-edit</primary>
361 </indexterm>
362 </listitem>
363 </varlistentry>
364
365 <varlistentry id="nmtui-hostname">
366 <term><command>nmtui-hostname</command></term>
367 <listitem>
368 <para>
369 is an interactive ncurses based interface hostname
370 editor.
371 </para>
372 <indexterm zone="NetworkManager nmtui-hostname">
373 <primary sortas="b-nmtui-hostname">nmtui-hostname</primary>
374 </indexterm>
375 </listitem>
376 </varlistentry>
377
378 <varlistentry id="NetworkManager-prog">
379 <term><command>NetworkManager</command></term>
380 <listitem>
381 <para>
382 is the network management daemon.
383 </para>
384 <indexterm zone="NetworkManager NetworkManager-prog">
385 <primary sortas="b-NetworkManager">NetworkManager</primary>
386 </indexterm>
387 </listitem>
388 </varlistentry>
389
390 <varlistentry id="libnm-glib">
391 <term><filename class="libraryfile">libnm-glib.so</filename></term>
392 <listitem>
393 <para>
394 contains functions used by <application>NetworkManager</application>.
395 </para>
396 <indexterm zone="NetworkManager libnm-glib">
397 <primary sortas="c-libnm-glib">libnm-glib.so</primary>
398 </indexterm>
399 </listitem>
400 </varlistentry>
401
402 <varlistentry id="libnm-glib-vpn">
403 <term><filename class="libraryfile">libnm-glib-vpn.so</filename></term>
404 <listitem>
405 <para>
406 contains functions used by <application>NetworkManager</application>
407 VPN plugins.
408 </para>
409 <indexterm zone="NetworkManager libnm-glib-vpn">
410 <primary sortas="c-libnm-glib-vpn">libnm-glib-vpn.so</primary>
411 </indexterm>
412 </listitem>
413 </varlistentry>
414
415 <varlistentry id="libnm-util">
416 <term><filename class="libraryfile">libnm-util.so</filename></term>
417 <listitem>
418 <para>
419 contains functions used by <application>NetworkManager</application>
420 utils.
421 </para>
422 <indexterm zone="NetworkManager libnm-util">
423 <primary sortas="c-libnm-util">libnm-util.so</primary>
424 </indexterm>
425 </listitem>
426 </varlistentry>
427
428 <varlistentry id="libnm">
429 <term><filename class="libraryfile">libnm.so</filename></term>
430 <listitem>
431 <para>
432 contains functions used by <application>NetworkManager</application>
433 utils.
434 </para>
435 <indexterm zone="NetworkManager libnm">
436 <primary sortas="c-libnm">libnm.so</primary>
437 </indexterm>
438 </listitem>
439 </varlistentry>
440 </variablelist>
441
442 </sect2>
443
444</sect1>
Note: See TracBrowser for help on using the repository browser.