source: networking/netutils/wicd.xml@ 96316eb

10.0 10.1 11.0 11.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 krejzi/svn lazarus nosym perl-modules qt5new systemd-11177 systemd-13485 trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since 96316eb was 96316eb, checked in by Bruce Dubbs <bdubbs@…>, 9 years ago

Update to p11-kit-0.18.5
Update to openobex-1.7.1
Update to libpng-1.6.3
Tag wicd for lfs-7.3 with minor build changes.

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

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