/[pengfork]/pengfork/INSTALL
ViewVC logotype

Diff of /pengfork/INSTALL

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1.4 by chupa, Sat Dec 7 16:52:49 2002 UTC revision 1.5 by chupa, Sun Dec 8 14:26:54 2002 UTC
# Line 6  penggy 0.1.0 INSTALL instructions Line 6  penggy 0.1.0 INSTALL instructions
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.
# Line 27  penggy 0.1.0 INSTALL instructions Line 27  penggy 0.1.0 INSTALL instructions
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.
# Line 35  penggy 0.1.0 INSTALL instructions Line 35  penggy 0.1.0 INSTALL instructions
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
# Line 72  penggy 0.1.0 INSTALL instructions Line 72  penggy 0.1.0 INSTALL instructions
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
# Line 83  penggy 0.1.0 INSTALL instructions Line 83  penggy 0.1.0 INSTALL instructions
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
# Line 104  penggy 0.1.0 INSTALL instructions Line 104  penggy 0.1.0 INSTALL instructions
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
# Line 140  penggy 0.1.0 INSTALL instructions Line 141  penggy 0.1.0 INSTALL instructions
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!
# Line 166  penggy 0.1.0 INSTALL instructions Line 167  penggy 0.1.0 INSTALL instructions
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

Legend:
Removed from v.1.4  
changed lines
  Added in v.1.5

savannah-hackers-public@gnu.org
ViewVC Help
Powered by ViewVC 1.1.26