source: networking/netutils/wicd.xml@ 7c0425c

10.0 10.1 11.0 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind ken/refactor-virt lazarus perl-modules qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 7c0425c was 7c0425c, checked in by Bruce Dubbs <bdubbs@…>, 4 years ago

Fix sed command in wicd

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

  • Property mode set to 100644
File size: 12.1 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 &lfs81_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 -e "/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 ... -i.orig 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 revision="sysv"><option>--no-install-init</option>: Prevent
168 installation of any init scripts, as a bootscript is installed later in the
169 instructions.</para>
170
171 <para revision="systemd"><option>--no-install-init</option>: Prevent
172 installation of service files twice. They are installed as a part of
173 the sed to setup.py.</para>
174
175 <para><option>--no-install-gnome-shell-extensions</option>: Prevent
176 installation of the respective extensions. Remove this switch, if you are
177 using Gnome Shell.</para>
178
179 <para><option>--wicdgroup=<replaceable>&lt;group&gt;</replaceable></option>:
180 The group that will have permission to use the Wicd client (default is the
181 <systemitem class="groupname">users</systemitem> group).</para>
182
183 </sect2>
184
185 <sect2 role="configuration">
186 <title>Configuring Wicd</title>
187
188 <sect3 id="wicd-config">
189 <title>Config Files</title>
190
191 <para><filename>/etc/wicd/manager-settings.conf</filename>,
192 <filename>/etc/wicd/wired-settings.conf</filename> and
193 <filename>/etc/wicd/wireless-settings.conf</filename></para>
194
195 </sect3>
196
197 <sect3 id="wicd-init">
198 <title>Configuration Information</title>
199
200 <note revision="systemd">
201 <para>
202 Make sure that you disable the <command>systemd-networkd</command>
203 service or configure it not to manage the interfaces you want to
204 manage with <application>Wicd</application>.
205 </para>
206 </note>
207
208 <para revision="sysv">To automatically start Wicd at boot time, you need
209 to first install the Wicd bootscript,
210 <filename>/etc/rc.d/init.d/wicd</filename> included in the <xref
211 linkend="bootscripts"/> package (as user <systemitem
212 class="username">root</systemitem>):</para>
213
214 <indexterm zone="wicd wicd-init" revision="sysv">
215 <primary sortas="f-wicd">wicd (bootscript)</primary>
216 </indexterm>
217
218 <screen role='root' revision="sysv"><userinput>make install-wicd</userinput></screen>
219
220 <para revision="sysv">Since Wicd will now handle all configuration of
221 network devices, the network bootscript installed by LFS should be
222 disabled. This can be achieved by either removing any
223 <filename>S*network</filename> and <filename>K*network</filename>
224 symlinks in the <filename>/etc/rc*.d</filename> directories or by setting
225 <literal>ONBOOT=no</literal> in any
226 <filename>/etc/sysconfig/ifconfig.*</filename> files.</para>
227
228 <para revision="systemd">To enable wicd at boot time, as the
229 <systemitem class="username">root</systemitem> user, run:</para>
230
231 <screen role='root' revision="systemd"><userinput>systemctl enable wicd</userinput></screen>
232
233 <para>No manual configuration of Wicd is needed if you use the graphical
234 frontends. If you are only going to use Wicd from command-line, you can
235 configure it using the configuration files in
236 <filename>/etc/wicd</filename>. For a list of available options, look at
237 the man-pages for: wicd-manager-settings.conf, wicd-wired-settings.conf
238 and wicd-wireless-settings.conf.</para>
239
240 <para>Be sure to add all users who are to have rights to open and close
241 network connections with Wicd to the
242 <systemitem class="groupname">users</systemitem> group (or the group
243 specified with the <option>--wicdgroup</option> configuration
244 option).</para>
245
246 </sect3>
247
248 </sect2>
249
250 <sect2 role="content">
251 <title>Contents</title>
252
253 <segmentedlist>
254 <segtitle>Installed Programs</segtitle>
255 <segtitle>Installed Libraries</segtitle>
256 <segtitle>Installed Directories</segtitle>
257
258 <seglistitem>
259 <seg>wicd, wicd-cli, wicd-client, wicd-curses (not functional if <ulink
260 url="http://urwid.org/">Urwid</ulink> is not installed), and
261 wicd-gtk</seg>
262 <seg>None</seg>
263 <seg>/{etc,usr/share,var/lib,var/log,var/run}/wicd,
264 /usr/lib/python2.7/site-packages/wicd and
265 /usr/share/doc/wicd-&wicd-version;</seg>
266 </seglistitem>
267 </segmentedlist>
268
269 <variablelist>
270 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
271 <?dbfo list-presentation="list"?>
272 <?dbhtml list-presentation="table"?>
273
274 <varlistentry id="wicdd">
275 <term><command>wicd</command></term>
276 <listitem>
277 <para>is the wicd daemon.</para>
278 <indexterm zone="wicd wicdd">
279 <primary sortas="b-wicdd">wicd</primary>
280 </indexterm>
281 </listitem>
282 </varlistentry>
283
284 <varlistentry id="wicd-cli">
285 <term><command>wicd-cli</command></term>
286 <listitem>
287 <para>is a command line interface for configuring the wicd daemon.</para>
288 <indexterm zone="wicd wicd-cli">
289 <primary sortas="b-wicd-cli">wicd-cli</primary>
290 </indexterm>
291 </listitem>
292 </varlistentry>
293
294 <varlistentry id="wicd-client">
295 <term><command>wicd-client</command></term>
296 <listitem>
297 <para>is the wicd client. This script attempts to automatically choose
298 the relevant configuration interface.</para>
299 <indexterm zone="wicd wicd-client">
300 <primary sortas="b-wicd-client">wicd-client</primary>
301 </indexterm>
302 </listitem>
303 </varlistentry>
304
305 <varlistentry id="wicd-curses">
306 <term><command>wicd-curses</command></term>
307 <listitem>
308 <para>is a curses interface for configuring the wicd daemon.</para>
309 <indexterm zone="wicd wicd-curses">
310 <primary sortas="b-wicd-curses">wicd-curses</primary>
311 </indexterm>
312 </listitem>
313 </varlistentry>
314
315 <varlistentry id="wicd-gtk">
316 <term><command>wicd-gtk</command></term>
317 <listitem>
318 <para>is a GTK interface for configuring the wicd daemon</para>
319 <indexterm zone="wicd wicd-gtk">
320 <primary sortas="b-wicd-gtk">wicd-gtk</primary>
321 </indexterm>
322 </listitem>
323 </varlistentry>
324
325 </variablelist>
326
327 </sect2>
328
329</sect1>
Note: See TracBrowser for help on using the repository browser.