add more spacing
[personal-kdebase.git] / runtime / doc / userguide / troubleshooting-network-x.docbook
blob040bf8109dddf22d8cc5cc2af271d81bf6677cf1
1 <sect1 id="troubleshooting-network-x">
2 <sect1info>
3 <authorgroup>
4 <author>&J.Hall;</author>
5 </authorgroup>
6 </sect1info>
7 <title>Networking and X</title>
8 <para>
9 Misconfigured networking can often be the cause of &kde; applications launching slowly, or in the worst case not launching at all. Your &X-Server; has a very powerful client/server interface and is very network aware.
10 </para>
11 <para>
12  X uses the hostname to create both a unique key for authorization, and to figure out where (via $<envar>DISPLAY</envar>) to send
13  the actual windows it's drawing on screen. If your computer doesn't know its own name, it will spend inordinate amounts of time
14  trying to look itself up, a fate you can avoid by simply teaching your computer what its own name is.
15 </para>
16 <para>
17 Check your <filename>/etc/hosts</filename> file and ensure there is an entry for localhost that looks
18 something like this at the top of the file (after any comments).
19 </para>
20 <screen>
21 127.0.0.1       localhost
22 </screen>
23 <para>
24 You also should add your computer's fully qualified domain name, short name, and its usual IP address if it has a static IP. If your IP address is assigned dynamically using <acronym>DHCP</acronym> you can simply use the address for the loopback device.
25 </para>
26 <screen>
27 127.0.0.1       hal.btl         hal             (for dhcp)
28 192.168.0.1     hal.btl         hal             (static)
29 </screen>
30 <para>
31 Make sure that your firewall is not so restrictive that it stops packets to the loopback device. For example in iptables if the default rule on the <parameter>INPUT</parameter> chain for this device is set to anything other than <parameter>>ACCEPT</parameter> this will cause performance problems in X. To check this, you can type in:
32 </para>
33 <screen>
34 <prompt>&percnt;</prompt><userinput><command>iptables-save</command> <literal>|</literal> <command>grep</command> <option>lo</option></userinput>
35 <computeroutput><option>-A</option> <parameter>INPUT</parameter> <option>-i</option> <parameter>lo</parameter> <option>-j</option>  <parameter>ACCEPT</parameter> 
36 </computeroutput>
37 </screen>
38 <para>
39 The rule <computeroutput><option>-A</option> <parameter>INPUT</parameter> <option>-i</option> <parameter>lo</parameter> <option>-j</option> <parameter>ACCEPT</parameter></computeroutput> should always work, unless there are other misconfigured rules (Such as a <parameter>DROP</parameter> on the <parameter>OUTPUT</parameter> chain)
40 </para>
41 </sect1>