source: networking/netutils/networkmanager.xml@ 419252e

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts krejzi/svn lazarus lxqt nosym perl-modules plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition systemd-11177 systemd-13485 trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since 419252e was 419252e, checked in by Krejzi <krejzi@…>, 12 years ago

More upstream fixes for NetworkManager

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@10257 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 11.4 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/0.9/NetworkManager-&NetworkManager-version;.tar.xz">
9 <!ENTITY NetworkManager-download-ftp
10 "&gnome-download-ftp;/NetworkManager/0.9/NetworkManager-&NetworkManager-version;.tar.xz">
11 <!ENTITY NetworkManager-md5sum "66a54b51a4998c484613911b72a7e6ff">
12 <!ENTITY NetworkManager-size "1.8 MB">
13 <!ENTITY NetworkManager-buildsize "65 MB">
14 <!ENTITY NetworkManager-time "1.0 SBU">
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 its available.
40 </para>
41
42 &lfs70_checked;
43
44 <bridgehead renderas="sect3">Package Information</bridgehead>
45 <itemizedlist spacing="compact">
46 <listitem>
47 <para>
48 Download (HTTP): <ulink url="&NetworkManager-download-http;"/>
49 </para>
50 </listitem>
51 <listitem>
52 <para>
53 Download (FTP): <ulink url="&NetworkManager-download-ftp;"/>
54 </para>
55 </listitem>
56 <listitem>
57 <para>
58 Download MD5 sum: &NetworkManager-md5sum;
59 </para>
60 </listitem>
61 <listitem>
62 <para>
63 Download size: &NetworkManager-size;
64 </para>
65 </listitem>
66 <listitem>
67 <para>
68 Estimated disk space required: &NetworkManager-buildsize;
69 </para>
70 </listitem>
71 <listitem>
72 <para>
73 Estimated build time: &NetworkManager-time;
74 </para>
75 </listitem>
76 </itemizedlist>
77
78 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
79 <itemizedlist spacing='compact'>
80 <listitem>
81 <para>
82 Required Patch:
83 <ulink url="&patch-root;/NetworkManager-&NetworkManager-version;-upstream-fixes-2.patch"/>
84 </para>
85 </listitem>
86 <listitem>
87 <para>
88 Required Patch:
89 <ulink url="&patch-root;/NetworkManager-&NetworkManager-version;-lfs-1.patch"/>
90 </para>
91 </listitem>
92 </itemizedlist>
93
94 <bridgehead renderas="sect3">NetworkManager Dependencies</bridgehead>
95
96 <bridgehead renderas="sect4">Required</bridgehead>
97 <para role="required">
98 <xref linkend="dbus-glib"/>,
99 <xref linkend="iptables"/>,
100 <xref linkend="libnl"/>,
101 <xref linkend="nss"/>,
102 <xref linkend="udev"/> and
103 <xref linkend="wireless_tools"/>
104 </para>
105
106 <bridgehead renderas="sect4">Recommended</bridgehead>
107 <para role="recommended">
108 <xref linkend="consolekit"/>,
109 <xref linkend="dhcpcd"/> or
110 <xref linkend="dhcp-client"/>,
111 <xref linkend="gobject-introspection"/>,
112 <xref linkend="libsoup"/> and
113 <xref linkend="polkit"/>
114 </para>
115
116 <bridgehead renderas="sect4">Optional</bridgehead>
117 <para role="optional">
118 <xref linkend="gtk-doc"/>,
119 <ulink url="http://ftp.gnome.org/pub/gnome/sources/ModemManager/">
120 ModemManager</ulink>,
121 <xref linkend="ppp"/> and
122 <xref linkend="wpa_supplicant"/> (Built with DBus support).
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 following
135 commands:
136 </para>
137
138<screen><userinput>patch -Np1 -i ../NetworkManager-&NetworkManager-version;-upstream-fixes-2.patch &amp;&amp;
139patch -Np1 -i ../NetworkManager-&NetworkManager-version;-lfs-1.patch &amp;&amp;
140./configure --prefix=/usr \
141 --sysconfdir=/etc \
142 --libexecdir=/usr/lib/NetworkManager \
143 --localstatedir=/var \
144 --with-systemdsystemunitdir=no \
145 --disable-ppp &amp;&amp;
146make</userinput></screen>
147
148 <para>
149 To test the results, issue: <command>make check</command>.
150 </para>
151
152 <para>
153 Now, as the <systemitem class="username">root</systemitem> user:
154 </para>
155
156<screen role="root"><userinput>make install</userinput></screen>
157
158 </sect2>
159
160 <sect2 role="commands">
161 <title>Command Explanations</title>
162
163 <para>
164 <parameter>--with-systemdsystemunitdir=no</parameter>: This parameter is
165 needed to avoid <application>systemd</application> files being installed.
166 </para>
167
168 <para>
169 <option>--disable-ppp</option>: This parameter disables optional
170 <application>PPP</application> support in <application>NetworkManager</application>.
171 Omit if you have <xref linkend="ppp"/> installed.
172 </para>
173
174 <para>
175 <parameter>--with-distro=lfs</parameter>: This parameter is only needed if you
176 failed to create <filename>/etc/lfs-release</filename> when you installed LFS.
177 </para>
178
179 </sect2>
180
181 <sect2 role="configuration">
182 <title>Configuring NetworkManager</title>
183
184 <sect3 id="NetworkManager-config">
185 <title>Config Files</title>
186 <para>
187 <filename>/etc/NetworkManager/NetworkManager.conf</filename>
188 </para>
189
190 <indexterm zone="NetworkManager NetworkManager-config">
191 <primary
192 sortas="e-etc-NetworkManager-NetworkManager.conf">
193 /etc/NetworkManager/NetworkManager.conf</primary>
194 </indexterm>
195
196 </sect3>
197
198 <sect3><title>Configuration Information</title>
199
200 <para>
201 For <application>NetworkManager</application> to work, at least
202 minimal configuration file must be present. Such file is not
203 installed with <command>make install</command>. Issue following
204 command as the
205 <systemitem class="username">root</systemitem> user to create
206 minimal <filename>NetworkManager.conf</filename> file:
207 </para>
208
209<screen role="root"><userinput>cat &gt;&gt; /etc/NetworkManager/NetworkManager.conf &lt;&lt; "EOF"
210<literal>[main]
211plugins=keyfile</literal>
212EOF</userinput></screen>
213
214 <para>
215 See <command>man 5 NetworkManager.conf</command> for any additional options.
216 </para>
217
218 </sect3>
219
220 <sect3 id="NetworkManager-init">
221 <title>Boot Script</title>
222
223 <para>
224 To automatically start the <command>NetworkManager</command> daemon when the
225 system is rebooted, install the
226 <filename>/etc/rc.d/init.d/networkmanager</filename> bootscript from the
227 <xref linkend="bootscripts"/> package.
228 </para>
229
230 <indexterm zone="NetworkManager NetworkManager-init">
231 <primary sortas="f-NetworkManager">NetworkManager</primary>
232 </indexterm>
233
234<screen role="root"><userinput>make install-networkmanager</userinput></screen>
235 </sect3>
236
237 </sect2>
238
239 <sect2 role="content">
240 <title>Contents</title>
241
242 <segmentedlist>
243 <segtitle>Installed Programs</segtitle>
244 <segtitle>Installed Libraries</segtitle>
245 <segtitle>Installed Directories</segtitle>
246
247 <seglistitem>
248 <seg>
249 nmcli, nm-online, nm-tool and NetworkManager
250 </seg>
251 <seg>
252 libnm-glib.so, libnm-glib-vpn.so and libnm-util.so
253 </seg>
254 <seg>
255 /etc/NetworkManager,
256 /usr/include/libnm-glib,
257 /usr/include/NetworkManager,
258 /usr/lib/NetworkManager,
259 /usr/share/NetworkManager,
260 /var/lib/NetworkManager and
261 /var/run/NetworkManager
262 </seg>
263 </seglistitem>
264 </segmentedlist>
265
266 <variablelist>
267 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
268 <?dbfo list-presentation="list"?>
269 <?dbhtml list-presentation="table"?>
270
271 <varlistentry id="nmcli">
272 <term><command>nmcli</command></term>
273 <listitem>
274 <para>
275 is a command-line tool for controlling
276 <application>NetworkManager</application>
277 and getting its status.
278 </para>
279 <indexterm zone="NetworkManager nmcli">
280 <primary sortas="b-nmcli">nmcli</primary>
281 </indexterm>
282 </listitem>
283 </varlistentry>
284
285 <varlistentry id="nm-online">
286 <term><command>nm-online</command></term>
287 <listitem>
288 <para>
289 is a utility to find out whether you are online.
290 </para>
291 <indexterm zone="NetworkManager nm-online">
292 <primary sortas="b-nm-online">nm-online</primary>
293 </indexterm>
294 </listitem>
295 </varlistentry>
296
297 <varlistentry id="nm-tool">
298 <term><command>nm-tool</command></term>
299 <listitem>
300 <para>
301 is used to provide information about
302 <application>NetworkManager</application>,
303 device, and wireless networks.
304 </para>
305 <indexterm zone="NetworkManager nm-tool">
306 <primary sortas="b-nm-tool">nm-tool</primary>
307 </indexterm>
308 </listitem>
309 </varlistentry>
310
311 <varlistentry id="NetworkManager-prog">
312 <term><command>NetworkManager</command></term>
313 <listitem>
314 <para>
315 is the network management daemon.
316 </para>
317 <indexterm zone="NetworkManager NetworkManager-prog">
318 <primary sortas="b-NetworkManager">NetworkManager</primary>
319 </indexterm>
320 </listitem>
321 </varlistentry>
322
323 <varlistentry id="libnm-glib">
324 <term><filename class='libraryfile'>libnm-glib.so</filename></term>
325 <listitem>
326 <para>
327 contains functions used by <application>NetworkManager</application>.
328 </para>
329 <indexterm zone="NetworkManager libnm-glib">
330 <primary sortas="c-libnm-glib">libnm-glib.so</primary>
331 </indexterm>
332 </listitem>
333 </varlistentry>
334
335 <varlistentry id="libnm-glib-vpn">
336 <term><filename class='libraryfile'>libnm-glib-vpn.so</filename></term>
337 <listitem>
338 <para>
339 contains functions used by <application>NetworkManager</application>
340 VPN plugins.
341 </para>
342 <indexterm zone="NetworkManager libnm-glib-vpn">
343 <primary sortas="c-libnm-glib-vpn">libnm-glib-vpn.so</primary>
344 </indexterm>
345 </listitem>
346 </varlistentry>
347
348 <varlistentry id="libnm-util">
349 <term><filename class='libraryfile'>libnm-util.so</filename></term>
350 <listitem>
351 <para>
352 contains functions used by <application>NetworkManager</application>
353 utils.
354 </para>
355 <indexterm zone="NetworkManager libnm-util">
356 <primary sortas="c-libnm-util">libnm-util.so</primary>
357 </indexterm>
358 </listitem>
359 </varlistentry>
360
361 </variablelist>
362
363 </sect2>
364
365</sect1>
Note: See TracBrowser for help on using the repository browser.