source: networking/netutils/wicd.xml@ 70727c9

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 70727c9 was 70727c9, checked in by Igor Živković <igor@…>, 9 years ago

Few fixes to pm-utils as noted by Armin

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

  • Property mode set to 100644
File size: 10.4 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 &lfs72_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;
118python setup.py configure --no-install-kde \
119 --no-install-acpi \
120 --no-install-pmutils \
121 --no-install-init</userinput></screen>
122
123 <para>This package does not come with a test suite.</para>
124
125 <para>Now, as the <systemitem class="username">root</systemitem> user, install the package:</para>
126
127<screen role="root"><userinput>python setup.py install</userinput></screen>
128
129 </sect2>
130
131
132 <sect2 role="commands">
133 <title>Command Explanations</title>
134
135 <para><command>sed -i '/wpath...</command>: This <command>sed</command>
136 prevents installation of <command>logrotate</command> and systemd
137 configuration files. You may omit it if you use these utilities.</para>
138
139 <para><option>--no-install-kde</option>: Prevent installation of an
140 autostart desktop file for KDE. If you use KDE, you should instead install the
141 <ulink url="http://projects.kde.org/projects/extragear/network/wicd-kde">Wicd KDE Client</ulink>.
142 </para>
143
144 <para><option>--no-install-acpi</option>: Prevent installation of
145 <command>suspend</command> and <command>resume</command> scripts for acpid.
146 Omit this option if you use acpid.</para>
147
148 <para><option>--no-install-pmutils</option>: Prevent installation of hooks for
149 pm-utils. Omit this option if you use pm-utils.</para>
150
151 <para><option>--no-install-init</option>: Prevent installation of any init scripts,
152 as a bootscript is installed later in the instructions.</para>
153
154 <para><option>--wicdgroup=<replaceable>&lt;group&gt;</replaceable></option>:
155 The group that will have permission to use the Wicd client (default is the
156 <systemitem class="groupname">users</systemitem> group).</para>
157 </sect2>
158
159 <sect2 role="configuration">
160 <title>Configuring Wicd</title>
161
162 <sect3 id="wicd-config">
163 <title>Config Files</title>
164
165 <para><filename>/etc/wicd/manager-settings.conf</filename>,
166 <filename>/etc/wicd/wired-settings.conf</filename> and
167 <filename>/etc/wicd/wireless-settings.conf</filename></para>
168
169 </sect3>
170
171 <sect3 id="wicd-init">
172 <title>Configuration Information</title>
173
174 <para>To automatically start Wicd at boot time, you need to first install
175 the Wicd bootscript,
176 <filename>/etc/rc.d/init.d/wicd</filename>,
177 included in the <xref linkend="bootscripts"/> package
178 (as user <systemitem class="username">root</systemitem>):</para>
179
180 <indexterm zone="wicd wicd-init">
181 <primary sortas="f-wicd">wicd (bootscript)</primary>
182 </indexterm>
183
184 <screen role='root'><userinput>make install-wicd</userinput></screen>
185
186 <para>Since Wicd will now handle all configuration of network devices,
187 the network bootscript installed by LFS should be disabled. This can be
188 achieved by either removing any <filename>S*network</filename> and
189 <filename>K*network</filename> symlinks in the <filename>/etc/rc*.d</filename>
190 directories or by setting <literal>ONBOOT=no</literal> in any
191 <filename>/etc/sysconfig/ifconfig.*</filename> files.</para>
192
193 <para>No manual configuration of Wicd is needed if you use the graphical
194 frontends. If you are only going to use Wicd from command-line, you can configure
195 it using the configuration files in <filename>/etc/wicd</filename>. For a list of
196 available options, look at the man-pages for: wicd-manager-settings.conf,
197 wicd-wired-settings.conf and wicd-wireless-settings.conf.</para>
198
199 <para>Be sure to add all users who are to have rights to open and close network
200 connections with Wicd to the <systemitem class="groupname">users</systemitem>
201 group (or the group specified with the <option>--wicdgroup</option> configuration
202 option).</para>
203
204 </sect3>
205
206 </sect2>
207
208 <sect2 role="content">
209 <title>Contents</title>
210
211 <segmentedlist>
212 <segtitle>Installed Programs</segtitle>
213 <segtitle>Installed Libraries</segtitle>
214 <segtitle>Installed Directories</segtitle>
215
216 <seglistitem>
217 <seg>wicd, wicd-cli, wicd-client, wicd-curses and wicd-gtk</seg>
218 <seg>none</seg>
219 <seg>/etc/wicd, /usr/lib/python2.7/site-packages/wicd, /usr/share/doc/wicd,
220 /usr/share/pixmaps/wicd, /usr/share/wicd, /var/lib/wicd and /var/log/wicd</seg>
221 </seglistitem>
222 </segmentedlist>
223
224 <variablelist>
225 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
226 <?dbfo list-presentation="list"?>
227 <?dbhtml list-presentation="table"?>
228
229 <varlistentry id="wicdd">
230 <term><command>wicd</command></term>
231 <listitem>
232 <para>is the wicd daemon.</para>
233 <indexterm zone="wicd wicdd">
234 <primary sortas="b-wicdd">wicd</primary>
235 </indexterm>
236 </listitem>
237 </varlistentry>
238
239 <varlistentry id="wicd-cli">
240 <term><command>wicd-cli</command></term>
241 <listitem>
242 <para>is a command line interface for configuring the wicd daemon.</para>
243 <indexterm zone="wicd wicd-cli">
244 <primary sortas="b-wicd-cli">wicd-cli</primary>
245 </indexterm>
246 </listitem>
247 </varlistentry>
248
249 <varlistentry id="wicd-client">
250 <term><command>wicd-client</command></term>
251 <listitem>
252 <para>is the wicd client. This script attempts to automatically choose
253 the relevant configuration interface.</para>
254 <indexterm zone="wicd wicd-client">
255 <primary sortas="b-wicd-client">wicd-client</primary>
256 </indexterm>
257 </listitem>
258 </varlistentry>
259
260 <varlistentry id="wicd-curses">
261 <term><command>wicd-curses</command></term>
262 <listitem>
263 <para>is a curses interface for configuring the wicd daemon.</para>
264 <indexterm zone="wicd wicd-curses">
265 <primary sortas="b-wicd-curses">wicd-curses</primary>
266 </indexterm>
267 </listitem>
268 </varlistentry>
269
270 <varlistentry id="wicd-gtk">
271 <term><command>wicd-gtk</command></term>
272 <listitem>
273 <para>is a GTK interface for configuring the wicd daemon</para>
274 <indexterm zone="wicd wicd-gtk">
275 <primary sortas="b-wicd-gtk">wicd-gtk</primary>
276 </indexterm>
277 </listitem>
278 </varlistentry>
279
280 </variablelist>
281
282 </sect2>
283
284</sect1>
Note: See TracBrowser for help on using the repository browser.