Bumped copyright dates for 2013
[barry.git] / ppp / README
bloba7256da8e508b6fcd173e958f7611b5aba12ec75
1 This directory contains sample options files for pppd, as well as their
2 associated chatscript files.  They are named for the various Blackberry
3 vendors that have different connect sequences for tethered modems.
5 Each file is tagged with the name "barry" as well, so they can be
6 installed in /etc/ppp/peers someday, to make all this automated
7 and easy.
9 It is a good idea to review these options files to make sure they
10 suit your system.  Particularly the defaultroute options, and their
11 various security implications.  You may wish to read the following URLs
13         http://fixunix.com/ppp/62469-dial-up-route-problem-2.html
14         http://groups.google.com/group/comp.os.linux.misc/browse_thread/thread/11fb49a3c035573/7d7e19b2e4820b0c
15         http://linuxgazette.net/issue77/lechnyr.html
17 Other options can be found at:
18     http://wiki.colar.net/tethering_with_blackberry_pearl_on_linux
20 The original peer files were based on the XmBlackBerry peer file, but
21 many have been added over the years for various ISPs.
23 Please send all working peer files to cdfrey@foursquare.net, so we can
24 build a library of peer files for different carriers.
26 Peer File Option Notes:
27 -----------------------
30 # the chat script and the USB link
32 connect "/usr/sbin/chat -f /etc/chatscripts/barry-rogers.chat"
33 pty "/usr/sbin/pppob"
36 # decide the level of debug output you need
38 debug
39 #debug debug debug
42 # authentication options - no need for ISP to authenticate to us, but
43 #                          we may need a login here: user/password/name
45 # Rogers style:
46 noauth
47 user wapuser
48 password wap
49 name wapuser
51 # or:
53 # T-Mobile style:
54 # You may not need to auth.  If you do, use your user/pass
55 # from www.t-mobile.com.
56 user ""
57 password ""
62 # routing options
64 #nodefaultroute         # the safest, but least useful
65 defaultroute
66 usepeerdns
69 # options that are usually unsupported, so disable them
71 noipdefault
72 nodetach
73 # note that there's a new option on the scene: updetach
74 #updetach
75 nodeflate
76 nobsdcomp
77 noaccomp
78 nocrtscts
79 nopcomp
80 nomagic
81 #default-asyncmap       # does not usually need to be specified
83 # This is disabled by default for a Barry config, but this
84 # has caused connection issues in the past.  If you are unable
85 # to get an ip with your provider, try commenting this out.
86 # See:
87 # http://www.mail-archive.com/barry-devel@lists.sourceforge.net/msg01871.html
88 novj
90 #nomultilink
91 ipcp-restart 7
92 ipcp-accept-local
93 ipcp-accept-remote
94 # need lcp-echo turned off, at least for tmobile, otherwise c0onnectin
95 # disconnects after few mn of inactivity.
96 # thanks to loon for this info
97 lcp-echo-interval 0
98 lcp-echo-failure 999
101 # limit size of packets, misc. options
103 passive
104 mtu 1492
107 # unused options... modem and local are opposites, and determine how
108 #               far pppd goes to use the line like a modem
110 #modem
111 #local