6 |
|
|
7 |
DISCLAIMER: |
DISCLAIMER: |
8 |
AOL is a registered trademark of America Online, Inc. |
AOL is a registered trademark of America Online, Inc. |
9 |
Penggy is not endorsed by or affiliated with AOL trademark. |
Penggy is not endorsed by or affiliated with the AOL trademark. |
10 |
|
|
11 |
Penggy is a free Linux client for AOL. It allows Linux users to connect |
Penggy is a free Linux client for AOL. It allows Linux users to connect |
12 |
to the Internet using AOL, through an IP tunneling system. |
to the Internet using AOL, through an IP tunneling system. |
27 |
=============== |
=============== |
28 |
|
|
29 |
2.1. Universal TUN/TAP device driver |
2.1. Universal TUN/TAP device driver |
30 |
=================================== |
==================================== |
31 |
|
|
32 |
Penggy uses the Universal TUN/TAP device driver, written by |
Penggy uses the Universal TUN/TAP device driver, written by |
33 |
Maxim Krasnyansky. |
Maxim Krasnyansky. |
35 |
Make sure that "Universal TUN/TAP device driver support" is enabled in |
Make sure that "Universal TUN/TAP device driver support" is enabled in |
36 |
your kernel. |
your kernel. |
37 |
|
|
38 |
If TUN/TAP support is already present and penggy always have trouble with |
If TUN/TAP support is already present and penggy still has trouble with |
39 |
it, follow these instructions: |
it, follow these instructions: |
40 |
|
|
41 |
Create device node: |
Create device node: |
42 |
# mknod /dev/net/tun c 10 200 |
# mknod /dev/net/tun c 10 200 |
43 |
|
|
44 |
Driver module autoloading |
Driver module autoloading : |
45 |
Make sure that "Kernel module loader" - module auto-loading support is |
Make sure that "Kernel module loader" - module auto-loading support is |
46 |
enabled in your kernel. |
enabled in your kernel. |
47 |
|
|
48 |
Add following line to the /etc/modules.conf: |
Add the following line to the /etc/modules.conf: |
49 |
alias char-major-10-200 tun |
alias char-major-10-200 tun |
50 |
|
|
51 |
Run: |
Run: |
52 |
# depmod -a |
# depmod -a |
53 |
|
|
54 |
Driver will be automatically loaded when application |
The driver will be automatically loaded whenever the application |
55 |
access /dev/net/tun. |
tries to access /dev/net/tun. |
56 |
|
|
57 |
2.2. Guile, Project GNU's extension language library |
2.2. Guile, Project GNU's extension language library |
58 |
==================================================== |
==================================================== |
59 |
|
|
60 |
You must install libguile and libguile-dev packages on your system in |
You must install libguile and libguile-dev packages on your system in |
61 |
order to run and compile penggy. |
order to be able to run and compile penggy. |
62 |
|
|
63 |
The Guile WWW page is at |
The Guile WWW page is at |
64 |
http://www.gnu.org/software/guile/guile.html |
http://www.gnu.org/software/guile/guile.html |
72 |
3. Installation |
3. Installation |
73 |
=============== |
=============== |
74 |
|
|
75 |
Penggyk can be obtained at https://savannah.nongnu.org/projects/pengfork/ |
Penggy can be obtained at https://savannah.nongnu.org/projects/pengfork/ |
76 |
|
|
77 |
Make sure to download the last stable version. If you feel more |
Make sure to download the last stable version. If you feel more |
78 |
adventurous, you can try the CVS version, but this is not guaranteed |
adventurous, you can try the CVS version, but this is not guaranteed |
83 |
uncompress and untar the files contained within the archive. That can be |
uncompress and untar the files contained within the archive. That can be |
84 |
done very simply (we'll assume your archive is version 0.1.0) |
done very simply (we'll assume your archive is version 0.1.0) |
85 |
|
|
86 |
$ tar xvzf penggy-0.1.0.tar.gz |
# tar xvzf penggy-0.1.0.tar.gz |
87 |
|
|
88 |
The files should have been decompressed to a directory called penggy-0.1.0 |
The files should have been decompressed to a directory called penggy-0.1.0 |
89 |
You now need to go to that directory and compile the program : |
You now need to go to that directory and compile the program : |
90 |
|
|
91 |
$ cd penggy-0.1.0 |
# cd penggy-0.1.0 |
92 |
$ ./configure |
# ./configure |
93 |
$ make |
# make |
94 |
# make install |
# make install |
95 |
|
|
96 |
If you need any particular option, such as cross-compiling, you can get |
If you need any particular option, such as cross-compiling, you can get |
104 |
4. Configuration |
4. Configuration |
105 |
================ |
================ |
106 |
|
|
107 |
In the install process, the directory /etc/penggy had been created with |
During the install process, the /etc/penggy directory was created, and it |
108 |
several files within it. |
has withing it several files we need to look at. |
109 |
|
|
110 |
If files were previously installed on your system, the install process |
If these files were previously installed on your system, the install process |
111 |
will not overwrite them but will create files with .new suffixes instead. |
will not overwrite them but will create files with .new suffixes instead. |
112 |
|
|
113 |
Last step is configuration. Quite many options are available here. |
Last step is configuration. Quite many options are available here. |
114 |
|
|
115 |
You need to modify your configuration files and make it look like as |
You need to modify your configuration files and make them look like as |
116 |
follows : |
follows : |
117 |
|
|
118 |
In /etc/penggy/aol-secrets put your AOL account infos: |
In /etc/penggy/aol-secrets put your AOL account(s) information : |
119 |
[YourScreenName] [YourPassword] |
[YourScreenName] [YourPassword] |
120 |
[AnotherScreenName] [AnotherPassword] |
[AnotherScreenName] [AnotherPassword] |
121 |
.... |
.... |
122 |
|
|
123 |
The file /etc/penggy/penggy.cfg is self-documented but commonly used |
The file /etc/penggy/penggy.cfg is self-documented but the most commonly |
124 |
options are: |
used options are: |
125 |
|
|
126 |
screen_name = [YourScreenName] |
screen_name = [YourScreenName] |
127 |
# auto_reconnect = yes |
# auto_reconnect = yes |
128 |
# daemon = yes |
# daemon = yes |
141 |
5. Usage |
5. Usage |
142 |
======== |
======== |
143 |
|
|
144 |
Near all options specified in the config file might changed on the |
Most of the options available in the congiguration file can be overidden |
145 |
command line. For more information run: |
from the command line. For more information type : |
146 |
$ penggy --help |
$ penggy --help |
147 |
|
|
148 |
The last step after compiling, installing and configuring is running the |
The last step after compiling, installing and configuring is running the |
149 |
software, and praying for it to work : |
software, and praying for it to work : |
150 |
# penggy |
# penggy |
151 |
|
|
152 |
Penggy must be run as root, if you're looking for a way to run it as user |
Penggy must be run as root. If you're looking for a way to run it as a user |
153 |
the use of sudo is greatly recommended (see sudo(8) and sudoers(5)) |
the use of sudo is greatly recommended (see sudo(8) and sudoers(5)) |
154 |
|
|
155 |
Have fun! |
Have fun! |
167 |
|
|
168 |
The program itself was coded by Jean-Charles Salzeber <jc@varspool.net>. |
The program itself was coded by Jean-Charles Salzeber <jc@varspool.net>. |
169 |
Greetings to him and to his genius :) |
Greetings to him and to his genius :) |
170 |
|
|
171 |
|
Last update : Nov 8th, 2002. |
172 |
|
Reviewed by Jean-Charles |