source: archive/wicd.xml@ fa91d2e

11.0 ken/refactor-virt lazarus qt5new trunk
Last change on this file since fa91d2e was 45ab6c7, checked in by Xi Ruoyao <xry111@…>, 5 months ago

more SVN prop clean up

Remove "$LastChanged$" everywhere, and also some unused $Date$

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