<chapter id="faq">
<title>Questions and Answers</title>

&reporting.bugs;

<qandaset id="faqlist">

<qandadiv id="faq-dialling">
<title>Questions about Dialling</title>
<qandaentry>
<question><para>I can't get &kppp; to work.  &kppp; tells me
<application>pppd</application> has died or that a timeout has expired.  What's
going on?</para></question>

<answer><para>Did you read this manual carefully?  Here are once more the most common pitfalls:</para>

<itemizedlist>

<listitem><para> Click on the <guibutton>Details</guibutton> button. &kppp; will
you give an excerpt from the <acronym>PPP</acronym> log messages (may not work
on non-&Linux; systems, or even on some &Linux; distributions). The log will
help you to track down the bug.</para></listitem>

<listitem><para> Make sure that <application>pppd</application> is the actual
<application>pppd</application> binary not a script</para></listitem>

<listitem><para> Make sure that <application>pppd</application> is setuid
<systemitem>root</systemitem>. You may set this mode by issuing
<userinput><command>chmod</command> <option>u+s pppd</option></userinput> as
<systemitem>root</systemitem>. </para></listitem>

<listitem><para> Make sure that your <filename>/etc/ppp/options</filename> file
exists and that it doesn't contain any conflicting entries. If in doubt: Leave
this file empty. </para></listitem>

<listitem><para> Make sure that you <emphasis>don't</emphasis> use the option
<option>lock</option> as an argument for <application>pppd</application> (&kppp;
is already taking care of device locking).</para></listitem>

<listitem><para> Remove the <option>lock</option> option from
<emphasis>both</emphasis> your <filename>/etc/ppp/options</filename>
<emphasis>and</emphasis> <filename>&tilde;/.ppprc</filename>
files!</para></listitem>
<listitem><para> Using the symbolic link <filename
class="symlink">/dev/modem</filename> may cause some conflicts. Eliminate this
source of trouble by using the real device, &ie; <filename>/dev/cuaX</filename>
or <filename>/dev/ttySX</filename>. </para>
<note><para><hardware>COM1</hardware> equals <filename>ttyS0</filename>,
<hardware>COM2</hardware> is <filename>ttyS1</filename> and so
on. </para></note></listitem>

<listitem><para>Make sure you set the right permission. In case of trouble you
might want to run it as root first and then later, when everything is working
fine give it less harmful permission if you can not afford to run &kppp; setuid
<systemitem>root</systemitem>. The proper way to proceed would
probably be creating a <systemitem>modem</systemitem>
group.</para></listitem>

<listitem><para>You might be launching <application>pppd</application> too
early, &ie; before the remote server is ready to negotiate a
<acronym>PPP</acronym> connection. If you are using a login script, you should
use the built-in terminal to verify your login procedure. Some providers will
require you to issue a simple <command>Send</command> or <command>Send
ppp</command> to launch <acronym>PPP</acronym>. Some users even reported, that
they had to append <command>Pause 1</command> or <command>Pause 2</command> to
their script to solve timing conflicts.</para></listitem>

</itemizedlist>

<para>If nothing helps, you might obtain some debugging info from your systems
log by issuing:</para>

<screen><prompt>#</prompt> <userinput><command>tail</command> <filename>/var/log/messages</filename></userinput></screen>

</answer>
</qandaentry>

<qandaentry>
<question><para>Why does &kppp; tell me <errorname>Unable to open the
modem</errorname>?</para></question>

<answer><para>This means that &kppp; doesn't have permissions to open the modem
device or that you selected a modem device on the <guilabel>Modem</guilabel> Tab
Dialog that is not valid. First make sure you selected the right modem
device. Once you are sure you have selected the right modem device, you must
give &kppp; the right permission to access the modem device and to be able to
modify <filename>/etc/resolv.conf</filename> in case you want &kppp; to
configure <acronym>DNS</acronym> correctly for you. If you can afford to run
&kppp; setuid <systemitem>root</systemitem> this would solve all access problems
for you, if not you will have to figure out what the right permissions are for
your purposes. In order to give &kppp; setuid <systemitem>root</systemitem>
permissions do the following:</para>

<screen><prompt>%</prompt> <userinput><command>su</command> <option>root</option></userinput>
<prompt>#</prompt> <userinput><command>chown</command> <option>root:root &dollar;KDEDIR/bin/kppp</option></userinput>
<prompt>#</prompt> <userinput><command>chmod</command> <option>+s &dollar;KDEDIR/bin/kppp</option></userinput>
<prompt>#</prompt> <userinput><command>exit</command></userinput>
</screen>
</answer>
</qandaentry>

<qandaentry>
<question><para>Why does &kppp; tell me it can't create a modem lock
file?</para></question>

<answer><para>This in most instances means that you have installed &kppp;
without SETUID bit on while you, the person executing &kppp;, doesn't have write
access to the lock file directory which by default is <filename
class="directory">/var/lock</filename>. This for example is the case on &RedHat;
systems. Check the modem dialog for the precise location you have chosen. The
solution is easy -- either run &kppp; SETUID if you can afford to, or give
regular users write access to <filename class="directory">/var/lock</filename>
or create a modem group that will have access to the <filename
class="directory">/var/lock</filename> file.</para></answer>
</qandaentry>

<qandaentry>
<question><para>Why is &kppp; installed with the SETUID bit
on?</para></question>

<answer><para>para>There is no need for the SETUID bit, if you know a bit of
&UNIX; systems administration. Simply create a <systemitem>modem</systemitem>
group, add all users that you want to give access to the modem to that group and
make the modem device read/writable for that group. Also if you want
<acronym>DNS</acronym> configuration to work with &kppp;, then
<filename>/etc/resolv.conf</filename> must be read/writable by the members of
that group. The same counts for <filename>/etc/ppp/pap-secrets</filename> and
<filename>/etc/ppp/chap-secrets</filename> if you want to use the built-in
<acronym>PAP</acronym> or <acronym>CHAP</acronym> support, respectively.</para>

<para>The &kppp; team has lately done a lot of work to make
&kppp; setuid-safe. But it's up to you to decide if you 
install and how you install it.</para>

<para>You might also want to read the <link linkend="security">Security</link>
section.</para></answer>
</qandaentry>

<qandaentry>
<question><para>What do I do when &kppp; just sits there and waits with the
message: <computeroutput>Expecting OK</computeroutput></para></question>

<answer><para>Have you played with the CR/LF setting? Try CR, LF or
CR/LF.</para>

<para>Alternatively, your modem might need some time to respond to its
intialization.  Open the <guilabel>Modem Commands</guilabel> dialog on the
<guilabel>Modem</guilabel> tab and adjust the <guilabel>Pre-Init</guilabel> and
<guilabel>Post-Init</guilabel> delays.  See if you are successful when
drastically increasing their values, and then do some fine-tuning
later.</para></answer>
</qandaentry>

<qandaentry>
<question><para>The connection works fine, but I can't start any
applications!</para></question>

<answer><para>You have probably selected the <link
linkend="auto-configure-hostname">Auto Configure Host Name</link> option, and
the X Server has problems connecting to your newly named host.  If you really
need this option (and chances are you really don't), you are unfortunately on
your own to set up the appropriate authorisations.  Issuing
<userinput><command>xhost</command> <option>+</option></userinput> before
starting the connection would do the job, but be warned of the security risks
involved, since this effectively gives everyone else access to your X
Server.</para></answer>
</qandaentry>

<qandaentry>
<question><para>&kppp; reports a successful connection, but &konqueror; just says
<errorname>Unknown host <replaceable>hostname</replaceable></errorname>, and
&Netscape; reports <errorname>The server does not have a DNS
entry</errorname>.</para></question>

<answer><para>Try pinging another server by its <acronym>IP</acronym> number,
&eg; <userinput><command>ping</command>
<option>195.0.254.76</option></userinput>.  If that works, you could try the
following:</para>

<itemizedlist>
<listitem><para>Check if you have provided &kppp; with at least one
<acronym>DNS</acronym> address.</para></listitem>

<listitem><para>Check the contents of <filename>/etc/host.conf</filename>.  There
should be a line saying something similar to <literal>order hosts,
bind</literal>.  The <option>bind</option> keyword advises the resolver library
to include a name server query when performing an address lookup.  If such a
line is not there, try adding it.</para></listitem>
</itemizedlist></answer>
</qandaentry>

<qandaentry>
<question><para>How do I make &kppp; send a <keysym>\n</keysym> or a
<keysym>\r</keysym></para></question>

<answer><para>Just send an empty string such as in the following script:</para>

<informalexample>
<screen>
Send                            # send an empty string
Expect           ID:            
Send             itsme
Expect           word:
Send             forgot
Expect           granted
Send             ppp
</screen>
</informalexample>
</answer>
</qandaentry>

<qandaentry>
<question><para>How can I stop &kppp; complaining: <errorname>Can't create lock
file</errorname>?</para></question>
<answer><para>This happens because you don't have permissions to create a lock
file.  If you chose to use a lock file, you must have write permision to the
directory (typically <filename class="directory">/var/lock</filename>).  This is
of course no problem if you have given &kppp; setuid permissions.  Please read
the section on <link linkend="lock-files">Lock files</link>.</para></answer>
</qandaentry>

<qandaentry>
<question><para>Why is my modem making so much noise when
dialling?</para></question>

<answer><para>Click on <guibutton>Setup</guibutton>, then
<guilabel>Modem</guilabel>.  You can control the modem volume here in three
steps: Off, medium and high.  For most modems, medium or high result in the same
volume.  If changing this setting doesn't work, make sure the correct settings
for your modem are specified in <guibutton>Setup</guibutton>,
<guilabel>Modem</guilabel>, <guibutton>Modem
Commands</guibutton>.</para></answer>
</qandaentry>

<qandaentry>
<question><para>I turned the modem volume to <quote>Off</quote> and verified the
modem commands, but I still hear that awful noise during dialling.
Why?</para></question>

<answer><para>The volume initialisation string can get lost if your modem can't
cope with the speed it is receiving commands from &kppp;.  Increase the value of
<guilabel>Post-Init Delay</guilabel> in <guibutton>Setup</guibutton>,
<guilabel>Modem</guilabel>, <guibutton>Modem
Commands</guibutton>.</para></answer>
</qandaentry>

<qandaentry>
<question><para>&kppp; keeps reporting unusual modem speeds like
<quote>115200</quote> or <quote>57600</quote></para></question>

<answer><para>Many modems only report the speed of the serial line and not the
speed over the telephone line as default.  You must configure these modems to
report the true line speed by adding some commands to the modem init or dial
strings.  For many modems this command is <command>ATW2</command>.  If you want
to add it to the dial string (which normally starts with
<command>ATD</command>), the new dial string would be
<command>ATW2D</command>.</para></answer>
</qandaentry>

<qandaentry>
<question><para>Why does &kppp; report <quote>Unknown
speed</quote></para></question>

<answer><para>New modems often have very complex connection messages like
<computeroutput>CONNECT LAP.M/V42.bis/115000:RX/31200:TX</computeroutput>, and
&kppp; cannot parse this message correctly. Turn on <guibutton>Show
Log</guibutton> and you'll see the connection speed.</para></answer>
</qandaentry>

<qandaentry>
<question><para>I get a slow connection speed</para></question>

<answer><para>If you are not satisfied with the modem speed, make sure you've
set the connection speed (you can reach it by clicking on
<guibutton>Setup</guibutton>, <guilabel>Device</guilabel>, <guibutton>Connection
Speed</guibutton>) to 57600 or higher.  Make sure your serial ports support
higher speeds.  Many older systems based on i486 do not work correctly if you
set the speed to 115200.  If you have an old <hardware>8250 UART</hardware>
chip, it won't work.  If you have a <hardware>16550</hardware> or
<hardware>16550A</hardware> it should work flawlessly.</para>

<para>Additionally, you should consult your modem manual to look for init
strings that enable a high speed mode.</para></answer>
</qandaentry>

<qandaentry>
<question><para>I get a <emphasis>REALLY</emphasis> slow connection
speed!</para></question>

<answer><para>If data drips on at a rate of just a few bytes per second, you
should check your hardware setup.  If moving your mouse speeds up the
transmission this is definitely a hardware issue!</para>

<para>You can obtain some information about your serial port with
<userinput><command>setserial</command> <option>-a
<replaceable>/dev/ttySx</replaceable></option></userinput> and check for interrupt
conflicts with other components of your system.  The &kcontrol; module
<guilabel>Information</guilabel> might also be of help here.</para></answer>
</qandaentry>

<qandaentry>
<question><para>My phone line needs pulse dialling instead of tone dialling (or
vice-versa).  How do I change that?</para></question>
<answer><para>You must modify your modem dial string.  Nearly all modems support
the following AT commands:</para>

<variablelist>
<varlistentry>
<term><command>ATDT</command></term>
<listitem><para><action>Selects tone dialling</action></para></listitem>
</varlistentry>
<varlistentry>
<term><command>ATDP</command></term>
<listitem><para><action>Selects pulse dialling</action></para></listitem>
</varlistentry>
</variablelist>
</answer>
</qandaentry>

</qandadiv>

<qandadiv id="faq-telephone-cost-rules">
<title>Questions about Telephone Cost Rules</title>
<qandaentry>
<question><para>How do I write a telephones cost rules file?</para></question>
<answer><para>Just follow the <filename>TEMPLATE</filename> rules file supplied
with &kppp;.  You should be able to find a copy in <filename
class="directory">$KDEDIR/doc/HTML/<replaceable>yourlang</replaceable>/kppp/</filename>.
Use the <option>-r</option> &kppp; command line option to check the syntax of
your proposed rules file.</para></answer>
</qandaentry>

<qandaentry>
<question><para>I have written a telephone cost rules for my region.  Where can
I submit it so that others can make use of it?</para></question>
<answer><!-- LW: Find out -->
<!-- lukas: the answer is: send it to the kppp maintainer, Harri Porten --></answer>
</qandaentry>

<qandaentry>
<question><para>Can my phone cost rulefile contain fractional time units like
"(0.17, 45.5)"?</para></question>
<answer><para>Yes this is possible.  But you shouldn't use unusually small time
units below a tenth of a second, because this would result in higher
<acronym>CPU</acronym> load, although you probably won't notice on a modern
<acronym>CPU</acronym>.</para></answer>
</qandaentry>

<qandaentry>
<question><para>My country observes other <quote>moving</quote> holidays than
Easter.</para></question>
<answer><para>In that case, you need to write new code that allows for the
computation of that holiday.  Please have a look at
<filename>ruleset.cpp</filename> and emulate the <quote>easter</quote> example.
Then send in the patches!.</para></answer>
</qandaentry>
</qandadiv>

<qandadiv id="faq-system-logs">
<title>Questions about the System Logs</title>
<qandaentry>
<question><para>I see a message saying <errorname>Serial line is looped
back</errorname>.  What does this mean?</para></question>

<answer><para>Short answer: You didn't start the <acronym>PPP</acronym> software
on the peer system.</para>

<!-- this doc doesn't exist.. help -->
<!-- http://www.dejanews.com/getdoc.xp?AN="184945314" -->

</answer>
</qandaentry>

<qandaentry>
<question><para>The logs show <errorname>Signal 15</errorname></para></question>
<answer><para>If you see the following lines, you've probably just received a
timeout error from &kppp;.  &kppp; has been waiting for the
<acronym>PPP</acronym> interface to come up and gave up after the specified
timeout. <application>pppd</application> was signalled to shut down, with signal
number 15, &ie; <errorcode>SIGTERM</errorcode>.</para>

<informalexample>
<screen><computeroutput>
pppd[26921]: pppd 2.3.5 started by me, uid 500
pppd[26921]: Using interface ppp0
pppd[26921]: Connect: ppp0 &lt;--&gt; /dev/ttyS0
pppd[26921]: Terminating on signal 15.
pppd[26921]: Connection terminated.
pppd[26921]: Exit.
</computeroutput></screen>
</informalexample>
</answer>
</qandaentry>

<qandaentry>
<question><para>What about <errorname>Receive serial link is not 8-bit
clean</errorname></para></question>
<answer><para>The <acronym>PPP</acronym> daemon is alarmed by the fact that all the
data it receives has bit 8 set to zero.  In most cases this simply indicates
that the remote <acronym>PPP</acronym> server isn't running yet.  You might
still be confronted by a login prompt that echoes back all the data sent by your
<application>pppd</application>.</para></answer>
</qandaentry>

<qandaentry>
<question><para>and <errorname>can't locate module ppp-compress</errorname>?
What's this?</para></question>
<answer><para>Do you see the following messages?</para>

<informalexample>
<screen><computeroutput>
modprobe: can't locate module ppp-compress-21 
modprobe: can't locate module ppp-compress-26 
modprobe: can't locate module ppp-compress-24
</computeroutput></screen>
</informalexample>

<para>Just add the lines:</para>

<screen><userinput>
alias ppp-compress-21 bsd_comp 
alias ppp-compress-24 ppp_deflate 
alias ppp-compress-26 ppp_deflate </userinput></screen>

<para> to your <filename>/etc/conf.modules</filename> file.</para>
</answer>
</qandaentry>

</qandadiv>

</qandaset>

</chapter>
