source: networking/netutils/wicd.xml@ 5e82e717

10.0 10.1 11.0 11.1 11.2 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind lazarus perl-modules qt5new trunk upgradedb xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since 5e82e717 was 5e82e717, checked in by Pierre Labastie <pieere@…>, 6 years ago

Last tags

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@18402 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 11.8 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 wicd-download-http "https://launchpad.net/wicd/&wicd-major-version;/&wicd-version;/+download/wicd-&wicd-version;.tar.gz">
8 <!ENTITY wicd-download-ftp " ">
9 <!ENTITY wicd-md5sum "aaa2e9f5320849e0b5d053099a6f0007">
10 <!ENTITY wicd-size "536 KB">
11 <!ENTITY wicd-buildsize "4.2 MB">
12 <!ENTITY wicd-time "less than 0.1 SBU">
13]>
14
15<sect1 id="wicd" xreflabel="Wicd-&wicd-version;">
16 <?dbhtml filename="wicd.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>Wicd-&wicd-version;</title>
24
25 <indexterm zone="wicd">
26 <primary sortas="a-wicd">wicd</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to Wicd</title>
31
32 <para><application>Wicd</application> is a network manager written in
33 Python. It simplifies network setup by automatically detecting and
34 connecting to wireless and wired networks. Wicd includes support for WPA
35 authentication and DHCP configuration. It provides Curses- and GTK-based
36 graphical frontends for user-friendly control. An excellent KDE-based
37 frontend is also available
38 <ulink url="http://projects.kde.org/projects/extragear/network/wicd-kde">
39 http://projects.kde.org/projects/extragear/network/wicd-kde</ulink>.
40 </para>
41
42 &lfs80_checked;
43
44 <bridgehead renderas="sect3">Package Information</bridgehead>
45 <itemizedlist spacing="compact">
46 <listitem>
47 <para>Download (HTTP): <ulink url="&wicd-download-http;"/></para>
48 </listitem>
49 <listitem>
50 <para>Download (FTP): <ulink url="&wicd-download-ftp;"/></para>
51 </listitem>
52 <listitem>
53 <para>Download MD5 sum: &wicd-md5sum;</para>
54 </listitem>
55 <listitem>
56 <para>Download size: &wicd-size;</para>
57 </listitem>
58 <listitem>
59 <para>Estimated disk space required: &wicd-buildsize;</para>
60 </listitem>
61 <listitem>
62 <para>Estimated build time: &wicd-time;</para>
63 </listitem>
64 </itemizedlist>
65
66 <bridgehead renderas="sect3">Wicd Dependencies</bridgehead>
67
68 <bridgehead renderas="sect4">Required</bridgehead>
69 <para role="required">
70 <xref linkend="python2"/>,
71 <xref linkend="dbus-python"/>,
72 <xref linkend="wireless_tools"/>, and
73 <xref linkend="net-tools"/>
74 (Wicd needs <command>mii-tool</command> from this package)
75 </para>
76
77 <bridgehead renderas="sect4">Recommended</bridgehead>
78 <para role="recommended">
79 <xref linkend="pygtk"/> (for the GTK frontend),
80 <xref linkend="wpa_supplicant"/> (for WPA support), and
81 <xref linkend="dhcpcd"/> or <xref linkend="dhcp"/> (for DHCP support)
82 </para>
83
84 <bridgehead renderas="sect4">Optional</bridgehead>
85 <para role="optional">
86 <xref linkend="pm-utils"/> (for suspend/resume integration),
87 <ulink url="http://urwid.org/">Urwid</ulink>
88 (for the Curses-based frontend), and
89 <ulink url="http://babel.edgewall.org/">Babel</ulink>
90 (for internationalization)
91 </para>
92
93 <para condition="html" role="usernotes">User Notes:
94 <ulink url="&blfs-wiki;/wicd"/></para>
95
96 </sect2>
97
98 <sect2 role="installation">
99 <title>Installation of Wicd</title>
100
101 <para>Install <application>Wicd</application> by running the following
102 commands:</para>
103
104<screen revision="sysv"><userinput>sed -e "/wpath.logrotate\|wpath.systemd/d" \
105 -e "/detection failed/ a\ self.init=\'init\/default\/wicd\'" \
106 -i.orig setup.py &amp;&amp;
107
108rm po/*.po &amp;&amp;
109
110python setup.py configure --no-install-kde \
111 --no-install-acpi \
112 --no-install-pmutils \
113 --no-install-init \
114 --no-install-gnome-shell-extensions \
115 --docdir=/usr/share/doc/wicd-&wicd-version;</userinput></screen>
116
117<screen revision="systemd"><userinput>sed "/detection failed/ a\ self.init=\'init\/default\/wicd\'" \
118 -i.orig setup.py &amp;&amp;
119
120rm po/*.po &amp;&amp;
121
122python setup.py configure --no-install-kde \
123 --no-install-acpi \
124 --no-install-pmutils \
125 --no-install-init \
126 --no-install-gnome-shell-extensions \
127 --docdir=/usr/share/doc/wicd-&wicd-version;</userinput></screen>
128
129 <para>This package does not come with a test suite.</para>
130
131 <para>Now, as the <systemitem class="username">root</systemitem> user,
132 install the package:</para>
133
134<screen role="root"><userinput>python setup.py install</userinput></screen>
135
136 </sect2>
137
138 <sect2 role="commands">
139 <title>Command Explanations</title>
140
141 <para revision="sysv"><command>sed -e ... -i setup.py</command>: The first
142 expression in this <command>sed</command> command prevents installation of
143 logrotate and systemd configuration files. You may omit it if you use these
144 utilities. The second one fixes building with BLFS.</para>
145
146 <para revision="systemd"><command>sed -e ... -i setup.py</command>: Fix
147 and issue while building with BLFS.</para>
148
149 <para><command>rm po/*.po</command>: This command removes the international
150 messages associated with this package. The command is required unless Babel
151 is installed. If it is installed, po/ast.po still needs to be removed in
152 order for the build to complete.</para>
153
154 <para><option>--no-install-kde</option>: Prevent installation of an
155 autostart desktop file for KDE. If you use KDE, you should instead install
156 the
157 <ulink url="http://projects.kde.org/projects/extragear/network/wicd-kde">Wicd
158 KDE Client</ulink>.</para>
159
160 <para><option>--no-install-acpi</option>: Prevent installation of
161 <command>suspend</command> and <command>resume</command> scripts for acpid.
162 Omit this option if you use acpid.</para>
163
164 <para><option>--no-install-pmutils</option>: Prevent installation of hooks
165 for pm-utils. Omit this option if you use pm-utils.</para>
166
167 <para><option>--no-install-init</option>: Prevent installation of any init
168 scripts, as a bootscript is installed later in the instructions.</para>
169
170 <para><option>--no-install-gnome-shell-extensions</option>: Prevent
171 installation of the respective extensions. Remove this switch, if you are
172 using Gnome Shell.</para>
173
174 <para><option>--wicdgroup=<replaceable>&lt;group&gt;</replaceable></option>:
175 The group that will have permission to use the Wicd client (default is the
176 <systemitem class="groupname">users</systemitem> group).</para>
177
178 </sect2>
179
180 <sect2 role="configuration">
181 <title>Configuring Wicd</title>
182
183 <sect3 id="wicd-config">
184 <title>Config Files</title>
185
186 <para><filename>/etc/wicd/manager-settings.conf</filename>,
187 <filename>/etc/wicd/wired-settings.conf</filename> and
188 <filename>/etc/wicd/wireless-settings.conf</filename></para>
189
190 </sect3>
191
192 <sect3 id="wicd-init">
193 <title>Configuration Information</title>
194
195 <note revision="systemd">
196 <para>
197 Make sure that you disable the <command>systemd-networkd</command>
198 service or configure it not to manage the interfaces you want to
199 manage with <application>Wicd</application>.
200 </para>
201 </note>
202
203 <para>To automatically start Wicd at boot time, you need to first install
204 the Wicd bootscript,<phrase revision="sysv">
205 <filename>/etc/rc.d/init.d/wicd</filename></phrase>
206 <phrase revision="systemd"><filename>wicd.service</filename></phrase>,
207 included in the <xref linkend="bootscripts" revision="sysv"/>
208 <xref linkend="systemd-units" revision="systemd"/> package
209 (as user <systemitem class="username">root</systemitem>):</para>
210
211 <indexterm zone="wicd wicd-init">
212 <primary sortas="f-wicd">wicd (bootscript)</primary>
213 </indexterm>
214
215 <screen role='root'><userinput>make install-wicd</userinput></screen>
216
217 <para revision="sysv">Since Wicd will now handle all configuration of
218 network devices, the network bootscript installed by LFS should be
219 disabled. This can be achieved by either removing any
220 <filename>S*network</filename> and <filename>K*network</filename>
221 symlinks in the <filename>/etc/rc*.d</filename> directories or by setting
222 <literal>ONBOOT=no</literal> in any
223 <filename>/etc/sysconfig/ifconfig.*</filename> files.</para>
224
225 <para>No manual configuration of Wicd is needed if you use the graphical
226 frontends. If you are only going to use Wicd from command-line, you can
227 configure it using the configuration files in
228 <filename>/etc/wicd</filename>. For a list of available options, look at
229 the man-pages for: wicd-manager-settings.conf, wicd-wired-settings.conf
230 and wicd-wireless-settings.conf.</para>
231
232 <para>Be sure to add all users who are to have rights to open and close
233 network connections with Wicd to the
234 <systemitem class="groupname">users</systemitem> group (or the group
235 specified with the <option>--wicdgroup</option> configuration
236 option).</para>
237
238 </sect3>
239
240 </sect2>
241
242 <sect2 role="content">
243 <title>Contents</title>
244
245 <segmentedlist>
246 <segtitle>Installed Programs</segtitle>
247 <segtitle>Installed Libraries</segtitle>
248 <segtitle>Installed Directories</segtitle>
249
250 <seglistitem>
251 <seg>wicd, wicd-cli, wicd-client, wicd-curses (not functional if <ulink
252 url="http://urwid.org/">Urwid</ulink> is not installed), and
253 wicd-gtk</seg>
254 <seg>None</seg>
255 <seg>/{etc,usr/share,var/lib,var/log,var/run}/wicd,
256 /usr/lib/python2.7/site-packages/wicd and
257 /usr/share/doc/wicd-&wicd-version;</seg>
258 </seglistitem>
259 </segmentedlist>
260
261 <variablelist>
262 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
263 <?dbfo list-presentation="list"?>
264 <?dbhtml list-presentation="table"?>
265
266 <varlistentry id="wicdd">
267 <term><command>wicd</command></term>
268 <listitem>
269 <para>is the wicd daemon.</para>
270 <indexterm zone="wicd wicdd">
271 <primary sortas="b-wicdd">wicd</primary>
272 </indexterm>
273 </listitem>
274 </varlistentry>
275
276 <varlistentry id="wicd-cli">
277 <term><command>wicd-cli</command></term>
278 <listitem>
279 <para>is a command line interface for configuring the wicd daemon.</para>
280 <indexterm zone="wicd wicd-cli">
281 <primary sortas="b-wicd-cli">wicd-cli</primary>
282 </indexterm>
283 </listitem>
284 </varlistentry>
285
286 <varlistentry id="wicd-client">
287 <term><command>wicd-client</command></term>
288 <listitem>
289 <para>is the wicd client. This script attempts to automatically choose
290 the relevant configuration interface.</para>
291 <indexterm zone="wicd wicd-client">
292 <primary sortas="b-wicd-client">wicd-client</primary>
293 </indexterm>
294 </listitem>
295 </varlistentry>
296
297 <varlistentry id="wicd-curses">
298 <term><command>wicd-curses</command></term>
299 <listitem>
300 <para>is a curses interface for configuring the wicd daemon.</para>
301 <indexterm zone="wicd wicd-curses">
302 <primary sortas="b-wicd-curses">wicd-curses</primary>
303 </indexterm>
304 </listitem>
305 </varlistentry>
306
307 <varlistentry id="wicd-gtk">
308 <term><command>wicd-gtk</command></term>
309 <listitem>
310 <para>is a GTK interface for configuring the wicd daemon</para>
311 <indexterm zone="wicd wicd-gtk">
312 <primary sortas="b-wicd-gtk">wicd-gtk</primary>
313 </indexterm>
314 </listitem>
315 </varlistentry>
316
317 </variablelist>
318
319 </sect2>
320
321</sect1>
Note: See TracBrowser for help on using the repository browser.