14/04/2001 Benoit PAPILLAULT <benoit.papillault@free.fr>
26/04/2001 Updated.
22/07/2001 Updated. 
05/11/2001 Updated.

Configuration
 1.1 Which linux kernel version was used to develop this software
 1.2 What configurations have been tested?
 1.3 Do I need to patch the kernel or pppd?
 1.4 What about the HDLC BUG?
 1.5 What to do about USB messages
 1.6 USB messages are filling up my log.
 1.7 I'd like to start my connection when linux is started. How to do that?

ISP Settings
 2.1 What login I should use with Club Internet (ISP)?
 2.2 Which vpi.vci should I use? 

Known Problems
 3.1. I have heard about upload problems. What is the current status?
 
Troubleshooting
 4.1 pppd says that there is no PPP support.
 4.2 I get the message "ADSL line is blocked?" and modem run just terminates - Why?
 4.3 I have seen messages like "usbdevfs: process 833 (pppoa2) did not claim interface 1 before use".
 4.4 When I got disconnect by my Internet provider, pppd is unable to reconnect automatically...
 4.5 pppoa3 is not closing when a ppp session fails?
 4.6 pppd can't load some modules!
 4.8 What interesting files I should look at in case of problems?
 4.9 I've tried everything you said and it still does not work.


Configuration Questions
=======================

1.1 Which linux kernel version was used to develop this software:
	linux kernel version 2.4.3 >=

1.2 What configurations have been tested?
  (and what kernel version is known to work?)

  See the file results.txt for some systems that have been tested.

  2.2.x series : 2.2.17, 2.2.17-21mdk, 2.2.19-5mdk
  2.4.x series : 2.4.0, 2.4.2, 2.4.3, 2.4.4, 2.4.5
                 2.4.6, 2.4.7

  Kernel older than 2.2.17 does not work
  Kernel 2.4.1 freezes.

1.3. Does it need kernel patches or pppd patches to work?

This solution uses a standard kernel ppp and all the ATM handling is done
outside of the kernel. There is another driver that uses a patched kernel
(for ATM support) and patched pppd (for the pppoa bit). They are not required
for this solution they may even be incompatible with this driver. 

1.4 What about the HDLC BUG?

Well ok you may need a kernel patch for that, see HDLC_BUG for more details.

1.5 I can see a lot of line like
  "usbdevfs: USBDEVFS_BULK failed dev 2 ep 0x81 len 16 ret -110", what's that?

There are "normal" error messages output by your linux kernel.
Don't worry too much about them. It may be fixed in a future release.

1.6 I can see a lot of line like:
  "usbdevfs: async_completed: status -2 errcount 0 actlen 0 pipe 0xc0008280"

This is entirely normal message output by your kernel. If this is a worry
for you (log file are too big), there is only one solution :

  - go to /usr/src/linux/drivers/usb/devio.c 
  - change #if 1 to #if 0 in async_completed() function
  - compile/install your new usbcore.o module.


1.7 I'd like to start my connection when linux is started. How to do that?

Just copy adsl.sh to /etc/rc.d/init.d (exact path may vary according to your
distribution):

[example for Mandrake 7.2]
cp adsl.sh /etc/rc.d/init.d/
cd /etc/rc.d/init.d
chkconfig adsl.sh on


ISP Settings
============

2.1 What login I should use with Club Internet (ISP)?

Use : login@clubadsl1

2.2 Which vpi.vci should I use? 

Here are some working values for some people, your configuration may differ

vpi.vci = 8.48 for netherlands
          8.35 or 8.67 for france
          8.35 for Belgium
          8.35 for Italy
          0.38 for UK

Known Problems
==============
(this bit may be out of date)

3.1. I have heard about upload problems. What is the current status?

This problem is solved by using the HDLC line discipline. No upload or
download limits are hardcoded in the driver. The upstream/downstream speed 
messages is purely informationnal and is not use in any part of this driver.




Troubleshooting
===============

4.1 pppd says that there is no PPP support.

=> look at /dev/ppp. "ls -la"  should give
crw-rw----    1 root     root     108,   0 sep 27  2000 /dev/ppp

If not, create /dev/ppp with the following commands:
mknod /dev/ppp c 108 0

4.2  I get the message "ADSL line is blocked?" and modem run just
terminates - Why?

Perhaps you have missed the -m flag off the modem_run command line?

4.3 I have seen messages like:
"usbdevfs: process 833 (pppoa2) did not claim interface 1 before use".
Does it mean that something is wrong?

No. It is just a programmer error in the source code of the program. It has
no consequence on the behaviour of the driver. Just signal them to the 
maintainer.

4.4 When I got disconnect by my Internet provider, pppd is unable to
reconnect automatically, saying "Modem hangup". If I look at /tmp/pppoa2.log
files, it shows the following messages

"usbfs_claimintf: Device or resource busy".

This is a known pb. See the file HDLC_BUG for instructions on how to patch
your kernel sources. If the problem persist, get in touch.


4.5 pppoa3 is not closing when a ppp session fails?

On some versions of pppd it fails to signal to its pty's to let them know to close
down. I think this is a bug in the version of pppd, if anyone can work out who
the maintainer is then let me know. This can cause a new instance of pppoa to
start not get anywhere (and lock up your machine if pppd is setup for infinate retries).

The workaround is to invoke pppoa with the -c option and it will clean up any rougue
pppoa's before attemptiing to access the previosly locked resources.

4.6 pppd can't load some modules!

Example:
> May 18 01:53:43 panoramix pppd[908]: pppd 2.4.0 started by Stephane, uid 0
> May 18 01:53:43 panoramix pppd[908]: ioctl(PPPIOCSDEBUG): Invalid argument
> May 18 01:53:43 panoramix pppd[908]: ioctl(PPPIOCGFLAGS): Invalid argument
> May 18 01:53:43 panoramix pppd[908]: Exit.
> May 18 01:53:43 panoramix modprobe: modprobe: Can't locate module
> tty-ldisc-13

Have you set your aliases up in modules.conf?


4.8 What interesting files I should look at in case of problems?

/var/log/messages
/var/log/syslog
/var/log/daemong.log
/tmp/pppoa2.log

If /var/log/daemon.log does not exist, you can create it by adding
"daemon.* /var/log/daemon.log" at the end of "/etc/syslog.conf"
Next, restart syslog with '/etc/rc.d/init.d/syslog restart'


4.9 I've tried everything you said and it still does not work.

You may get some help from the mailing list speedtouch@ml.free.fr or directly
from the author (benoit.papillault@free.fr). The mailing list archive is at 
http://www.mail-archive.com/speedtouch@ml.free.fr/.

However, you must give as many details about your configuration as possible.

- your USB controller : cat /proc/pci
- your kernel version : uname -a
- your pppd version   : pppd -V
- your driver version : modem_run --help
- your vpi/vci
- your ADSL provider & ISP name
- relevant section of /var/log/messages & /var/log/kern/info & /tmp/pppoa2.log
  you can modify your ppp option file to run the pppoa2 program with option -v 2
  This will result in a more detailed pppoa2.log
- your problem description : crash, can't connect, poor performance
- anything you think it might be usefull

You are of course encourage to modify the source code yourself & post
your working modification to the list.

