source: networking/netutils/network-manager-applet.xml@ d8e1be0

12.0 12.1 kea ken/TL2024 ken/tuningfonts lazarus lxqt plabs/newcss python3.11 rahul/power-profiles-daemon renodr/vulkan-addition trunk xry111/llvm18 xry111/xf86-video-removal
Last change on this file since d8e1be0 was 03c63ad, checked in by Douglas R. Reno <renodr@…>, 15 months ago

Update to network-manager-applet-1.32.0
  • Property mode set to 100644
File size: 8.3 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 network-manager-applet-download-http
8 "&gnome-download-http;/network-manager-applet/&network-manager-applet-minor;/network-manager-applet-&network-manager-applet-version;.tar.xz">
9 <!ENTITY network-manager-applet-download-ftp
10 "&gnome-download-ftp;/network-manager-applet/&network-manager-applet-minor;/network-manager-applet-&network-manager-applet-version;.tar.xz">
11 <!ENTITY network-manager-applet-md5sum "ba0de3589b2975a181a21a74bcb62447">
12 <!ENTITY network-manager-applet-size "1.8 MB">
13 <!ENTITY network-manager-applet-buildsize "40 MB (with tests)">
14 <!ENTITY network-manager-applet-time "0.2 SBU (with tests)">
15]>
16
17<sect1 id="network-manager-applet" xreflabel="network-manager-applet-&network-manager-applet-version;">
18 <?dbhtml filename="network-manager-applet.html"?>
19
20
21 <title>network-manager-applet-&network-manager-applet-version;</title>
22
23 <indexterm zone="network-manager-applet">
24 <primary sortas="a-network-manager-applet">network-manager-applet</primary>
25 </indexterm>
26
27 <sect2 role="package">
28 <title>Introduction to NetworkManager Applet</title>
29
30 <para>
31 The <application>NetworkManager Applet</application> provides a tool and
32 a panel applet used to configure wired and wireless network connections
33 through GUI. It's designed for use with any desktop environment that uses
34 <application>GTK+</application>, such as <application>Xfce</application>
35 and <application>LXDE</application>.
36 </para>
37
38 &lfs113_checked;
39
40 <bridgehead renderas="sect3">Package Information</bridgehead>
41 <itemizedlist spacing="compact">
42 <listitem>
43 <para>
44 Download (HTTP): <ulink url="&network-manager-applet-download-http;"/>
45 </para>
46 </listitem>
47 <listitem>
48 <para>
49 Download (FTP): <ulink url="&network-manager-applet-download-ftp;"/>
50 </para>
51 </listitem>
52 <listitem>
53 <para>
54 Download MD5 sum: &network-manager-applet-md5sum;
55 </para>
56 </listitem>
57 <listitem>
58 <para>
59 Download size: &network-manager-applet-size;
60 </para>
61 </listitem>
62 <listitem>
63 <para>
64 Estimated disk space required: &network-manager-applet-buildsize;
65 </para>
66 </listitem>
67 <listitem>
68 <para>
69 Estimated build time: &network-manager-applet-time;
70 </para>
71 </listitem>
72 </itemizedlist>
73
74 <bridgehead renderas="sect3">NetworkManager Applet Dependencies</bridgehead>
75
76 <bridgehead renderas="sect4">Required</bridgehead>
77 <para role="required">
78 <xref linkend="gtk3"/>,
79 <xref linkend="libnma"/>, and
80 <!--<xref linkend="libnotify"/>, and-->
81 <xref linkend="libsecret"/>
82 </para>
83
84 <bridgehead renderas="sect4">Recommended</bridgehead>
85 <para role="recommended">
86 <xref linkend="gobject-introspection"/> and
87 <xref linkend="ModemManager"/>
88 </para>
89
90 <bridgehead renderas="sect4">Required (Runtime)</bridgehead>
91 <para role="required">
92 Since this package uses
93 <xref role="nodep" linkend="polkit"/> for authorization,
94 one <xref role="runtime" linkend="polkit-agent"/> should be
95 running when the functionality of this package is used.
96 </para>
97
98 <bridgehead renderas="sect4">Optional</bridgehead>
99 <para role="optional">
100 <xref linkend="gnome-bluetooth"/> and
101 <ulink url="https://launchpad.net/libappindicator">libindicator</ulink>
102 </para>
103
104 <para condition="html" role="usernotes">User Notes:
105 <ulink url="&blfs-wiki;/network-manager-applet"/>
106 </para>
107
108 </sect2>
109
110 <sect2 role="installation">
111 <title>Installation of NetworkManager Applet</title>
112
113 <para>
114 Install <application>NetworkManager Applet</application> by running
115 the following commands:
116 </para>
117
118<screen><userinput>mkdir build &amp;&amp;
119cd build &amp;&amp;
120
121meson setup .. \
122 --prefix=/usr \
123 --buildtype=release \
124 -Dappindicator=no \
125 -Dselinux=false &amp;&amp;
126ninja</userinput></screen>
127
128 <para>
129 To test the results, issue: <command>ninja test</command>.
130 </para>
131
132 <para>
133 Now, as the <systemitem class="username">root</systemitem> user:
134 </para>
135
136<screen role="root"><userinput>ninja install</userinput></screen>
137
138 </sect2>
139
140 <sect2 role="commands">
141 <title>Command Explanations</title>
142
143 <para>
144 <parameter>-Dappindicator=no</parameter>: This switch disables
145 AppIndicator support in network-manager-applet because it
146 requires libindicator, which is not in BLFS. The build will fail
147 without this option.
148 </para>
149
150 <!-- Jansson is now included in NM as Required
151 <para>
152 <parameter>-Dteam=false</parameter>: This switch disables the team
153 configuration editor since it requires <xref linkend="jansson"/>. If
154 you have Jansson installed, remove this option or set it to "true".
155 </para>
156 -->
157
158 <para>
159 <parameter>-Dselinux=false</parameter>: This switch forcibly
160 disables <application>SELinux</application> support since it is not
161 currently in BLFS and the build will fail without it.
162 </para>
163
164 <!-- no longer needed as of 1.16.0
165 <para>
166 <parameter>-Dmobile_broadband_provider_info=false</parameter>: This
167 switch forcibly disables Mobile Broadband Provider support because it
168 is not currently available in BLFS.
169 </para>
170 <para>
171 <parameter>-Dgtk_doc=false</parameter>: Remove this if you have
172 <xref linkend="gtk-doc"/> installed and want to rebuild the
173 documentation with it.
174 </para>
175 -->
176
177 <para>
178 <option>-Dwwan=false</option>: This switch disables WWAN support.
179 Use this if you do not have <xref linkend="ModemManager"/> installed.
180 </para>
181
182 <!-- Same as above
183 <para>
184 <option>-Dintrospection=false</option>: Use this if you do not have <xref linkend="gobject-introspection"/> installed.
185 </para>
186 -->
187
188 </sect2>
189
190 <sect2 role="content">
191 <title>Contents</title>
192
193 <segmentedlist>
194 <segtitle>Installed Programs</segtitle>
195 <segtitle>Installed Libraries</segtitle>
196 <segtitle>Installed Directories</segtitle>
197
198 <seglistitem>
199 <seg>
200 nm-applet and nm-connection-editor
201 </seg>
202 <seg>
203 <!--libnma.so-->
204 None
205 </seg>
206 <seg>
207 <!--/usr/include/{libnma,libnm-gtk},-->
208 <!--/usr/include/libnma and /usr/share/gtk-doc/libnma-->
209 None
210 </seg>
211 </seglistitem>
212 </segmentedlist>
213
214 <variablelist>
215 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
216 <?dbfo list-presentation="list"?>
217 <?dbhtml list-presentation="table"?>
218
219 <varlistentry id="nm-connection-editor">
220 <term><command>nm-connection-editor</command></term>
221 <listitem>
222 <para>
223 allows users to view and edit network connection settings
224 </para>
225 <indexterm zone="network-manager-applet nm-connection-editor">
226 <primary sortas="b-nm-connection-editor">nm-connection-editor</primary>
227 </indexterm>
228 </listitem>
229 </varlistentry>
230
231 <!--
232 <varlistentry id="libnma">
233 <term><filename class="libraryfile">libnma.so</filename></term>
234 <listitem>
235 <para>
236 contains internal functions for the
237 <application>Network Manager GTK+ Interface</application>.
238 </para>
239 <indexterm zone="network-manager-applet libnma">
240 <primary sortas="c-libnma">libnma.so</primary>
241 </indexterm>
242 </listitem>
243 </varlistentry>
244Moved to a separate library, libnma, in 1.16.0
245-->
246<!--
247 <varlistentry id="libnm-gtk">
248 <term><filename class="libraryfile">libnm-gtk.so</filename></term>
249 <listitem>
250 <para>
251 contains the <application>NetworkManager</application>
252 <application>GTK+</application> bindings.
253 </para>
254 <indexterm zone="network-manager-applet libnm-gtk">
255 <primary sortas="c-libnm-gtk">libnm-gtk.so</primary>
256 </indexterm>
257 </listitem>
258 </varlistentry>
259-->
260
261 </variablelist>
262
263 </sect2>
264
265</sect1>
Note: See TracBrowser for help on using the repository browser.