wmail: added breaks and explicit fall-through comments to switches.
[dockapps.git] / yawmppp / FAQ
bloba7a2df45c7879234a2d710d72395c1a3526f0b0d
2 YAWMPPP FAQ
3 $Id: FAQ,v 1.2 2001/04/21 18:29:33 bergo Exp $
5 1 Generic
6 1.1 How can I see what is going on with my connection ?
8 1.2 Nothing happens when I hit the "V" button.
10 1.3 Yawmppp/pppd complain about not having root privileges.
12 1.4 Why doesn't it shows with the NeXTSTEP(tm) look
13     in my system as it does in the screenshots ?
15 1.X Where can I get more info ?
18 2 Specific
19 2.1 How do I setup PAP/CHAP ?
21 2.2 My modem dials, connects, but hangs up some seconds later.
22     What is happening ?
24 ---------------------------------------------------------------------------
26 Q1.1: How can I see what is going on with my connection ?
28 A1.1: The ppp daemon throws lots of logging information (if asked to),
29       but some of this information may get lost.
30       Change your /etc/syslog.conf file so that is has a line
32         daemon,local2.debug,daemon.notice          /etc/ppp/log
34       (the separation is made out of *tabs*, NOT spaces!)
36       and create a zero-sized log file:
38         touch /etc/ppp/log
40       Then restart the syslog daemon (e.g.: send a SIGHUP to it as root).
41       Then enable the debug and kdebug options at yawmppp.pref's PPP options
42       notebook page.
44       The log file should give more information than you actually need.
45       Even if you don't want to change your logging configuration, some of
46       pppd's log output may go to /var/log/messages.
50 Q1.2: Nothing happens when I hit the "V" button.
52 A1.2: The pppd daemon requires root privileges to run. The solution here is
53       to set the setuid bit on pppd's executable:
55         chmod 4755 `which pppd`
57       You must run this as root. Notice that the quotes are backticks.
61 Q1.3: Yawmppp/pppd complain about not having root privileges.
63 A1.3: Maybe you're trying a noauth connection with a non-setuid pppd. If you
64       really need to keep pppd non-setuid root, add the
66        noauth
68       line to your
70        /etc/ppp/options
72       file.
74 Q1.4: Why doesn't it shows with the NeXTSTEP(tm) look
75       in my system as it does in the screenshots ?
77 A1.4: The GTK+ GUI toolkit allows themeing. It means that you may turn
78       your GTK+ applications to look like Macintosh(tm), Aqua(tm),
79       NeXT(tm) or whatever you want. Even Windows(tm) if you're sick
80       enough for it.
81       You can make your themes or download ready ones (faster).
83       There are lots of GTK+ themes at
85       http://gtk.themes.org
87       You can browse documentation on how to add the themes at the same
88       site. To use gtk.themes.org pixmap themes you'll probably need
89       the gtk-engines and imlib packages, you can find them perusing
90       the site.
92       The NeXT look seen in the screenshots at yawmppp.seul.org is
93       provided by the Xenophilia engine:
95       http://www.obsession.se/johan/gtk.html
97       (if this link ever gets broken, search for Xenophilia at
98        freshmeat.net)
100 Q1.X: Where can I get more info ?
102 A1.X: You can read the PPP-HOWTO and ISP-Hookup-HOWTO from the LDP
103       (Linux Documentation Project), available from
105        http://sunsite.unc.edu/LDP/HOWTO/
107       (Linux distributions may have it installed under /usr/doc/HOWTO)
110       You can also read the ppp FAQ that comes with ppp's source, which
111       can be downloaded from:
113        ftp://cs.anu.edu.au/pub/software/ppp
116 Q2.1: How do I setup PAP/CHAP ?
118 A2.1: PAP and CHAP are authentication protocols and some ISPs require them to
119       be used. Their purpose is to confirm identity throughout the connection.
120       Unless you're afraid of someone tapping your phone line and transmitting
121       "bogus" data through YOUR PPP link, you should not worry about it, unless
122       your ISP does.
124       First, you'll have to set yawmppp.pref's local PPP options on your
125       ISP entry to reflect the desired behaviour about CHAP/PAP.
126       If your ISP doesn't even present a login prompt, you'll want to
127       check the "don't generate login/password pairs" in the "More Settings"
128       dialog.
130       Then, as root, edit /etc/ppp/chap-secrets and/or /etc/ppp/pap-secrets
131       as desired.
132       The ppp FAQ (included in the source distribution of ppp) tells the nitty
133       gritty, but basically you'll have a set of lines, one for each ISP that
134       reads like this:
136         username * password
138       where username is your username, password is your password. The
139       first * means the server (any) and the second * means the allowed IPs
140       (any). The log output of ppp may help you if you still can't get a
141       conection. Read Q1.1 for instructions to get the most of ppp's log.
145 Q2.2: My modem dials, connects, but hangs up some seconds later.
146       What is happening ?
148 A2.2: There are several possibilities, which you will only be sure by reading the
149       logs. Here they are:
151       1. bad login/password, or your ISP is under maintenance and refused login
153       2. the ISP required CHAP/PAP authentication and you either didn't have
154          a proper secret to give in the secret files (read Q2.1), or
155          has the refuse-chap/refuse-pap options on, or had a bad (wrong) secret.
156          If this is the case, asking help from your ISP is a good idea.
158       3. your ISP is taking too long to answer for the initial PPP requests.
159          It may be busy, buggy, bad configured, or gone BSOD (Q2.3).
160          You can try setting on the "passive" option or increase the
161          lcp-max-configure number.