Apirc v1.0 - Java (c) IRC applet
--------------------------------

Apirc is a Java (c) IRC multi-threaded applet with private msg,
channel, nickname control, channel list, ban windows, that allow
people visiting a web site to connect to irc servers. Aprelay is
an IRC relay only necessary if you want to allow people to connect
to outside irc servers, because of the Java security.

- Up to 128 simultaneous connections on the relay (P133 40Mo)
- Default parameters can easily be set in the html page (servers,
  channels, ..)
- Advantages of the multi OS compatibility of the applet (Macintosh,
  Windows, Unix)
- The relay (not required to connect to your own irc server) works
  on Linux, Win NT4, Win 95
- Up to 5 simultaneous server connections and 10 open channels on
  the user side

If you want to run your own irc server, this server and the http
web server must reside on the same machine to avoid the Aprelay
installation.

You must have the original compressed file :
 apirc-1.0.zip    (254904 bytes) for Windows NT-95
 apirc-1.0.tar.gz (37111  bytes) for Unix/Linux

Some irc servers for Windows NT, Windows95, and Unix/Linux :
 W95+NT: http://members.xoom.com/ircdc/
 W95+NT: http://www.storer.net/ircd.html
 UNIXes: ftp://ftp.funet.fi/pub/unix/irc/server/irc2.9.x.tgz

This applet was successfully tested on Netscape Windows95 3.01
 & 4.03 and on IE Windows95 3.01 & 4.01.
It works correctly on MSIE Macintosh 3.01 beta but some menus are
 curiously disabled.
It works well on Netscape Macintosh 3.01, but with a slow Java 
It works well on Netscape Linux 4.04.

Installation without aprelay (you must have your own IRC server)
----------------------------------------------------------------
This IRC server and the http web server must reside on the same
machine. In your web directory, create a subdirectory called for
instance 'apirc' and install all the Java classes (*.class) in it.

The html file could include :

<applet codebase="apirc" code=apirc.class width=240
 height=150 align=center>
<param name=defaultnickname value="ApircUser">
<param name=server1 value="irc.franet.org">
<param name=defaultserver value="irc.franet.org">
<param name=port1 value="6666">
<param name=port2 value="6667">
<param name=port3 value="6668">
<param name=port4 value="6669">
<param name=port5 value="6670">
<param name=defaultport value="6667">
<param name=channel1 value="#Geneva">
<param name=channel2 value="#France">
<param name=channel3 value="#Quebec">
<param name=defaultchannel value="#Geneva">
</applet>

You must change some values according to your own irc server, and
channel+port configuration.

You should add aprelay[.exe] in your Startup folder to make it
restarting after a reboot.

Installation with aprelay
-------------------------
This allow people to connect to all IRC servers.
E.g. Efnet, Undernet, Ircnet, ... IRC networks without limitations.
The relay has been tested on Windows NT, Windows 95, Linux 2.0.x,
and can be easily compiled on other platforms.

If you downloaded 'apirc-1.0.zip', the binary file is available
Win95+NT); As it was compiled with the gcc Cygnus compiler
(http://www.cygnus.com), the file cygwin[.dll] and the binary
aprelay[.exe] must be placed together in the same directory, and
aprelay[.exe] started.

If you downloaded 'apirc-1.0.tar.gz', you must compile it. On most
Unix platforms, 'cc -o aprelay aprelay.c' or 'gcc -o aprelay aprelay.c'
will work. However this relay is not supported, if you have problems
we will try to help you, but without any garantee.

You can start it directly by typing 'aprelay', but we recommand using
a newly created username to start the process: create a new user in
your /etc/passwd file (not directly on some OSes, see your manuals)
named 'apircuser' for instance. Then aprelay will be called this way:
'/bin/su apircuser -c /usr/marc/apirc/aprelay' (paths must be adapted).

In /etc/rc.d/rc.local or equivalent, you should add this line to make
aprelay restarting after a reboot.

 In your web directory, create a subdirectory called for instance 'apirc'
and install all the Java classes (*.class) in it.

The html file could include :

<applet codebase="apirc" code=apirc.class width=240
 height=150 align=center>
<param name=defaultnickname value="ApircUser">
<param name=server1 value="irc.franet.org">
<param name=server3 value="irc.efnetserver2.net">
<param name=server5 value="irc.dalnetserver3.com">
<param name=defaultserver value="irc.franet.org">
<param name=port1 value="6666">
<param name=port2 value="6667">
<param name=port3 value="6668">
<param name=port4 value="6669">
<param name=port5 value="6670">
<param name=defaultport value="6667">
<param name=channel1 value="#Geneva">
<param name=channel2 value="#Texas">
<param name=channel3 value="#France">
<param name=channel4 value="#Friendly">
<param name=channel5 value="#Quebec">
<param name=defaultchannel value="#Geneva">
<param name=relay value="machine.domain.com">
<param name=relayport value="8888">
</applet>

The relayport must be 8888, except if you modify the port number in
the aprelay source file. The relay value is the exact machine name or
IP number where resides aprelay.

You can filter incoming users on aprelay by IP number :
- 'aprelay' called without arguments will allow incoming users from everywhere.
- 'aprelay 192.168.0.0' will allow all incoming IPs beginning with 192.168
- 'aprelay 192.168.115.17' will only allow the host 192.168.115.17.

Downloading & demo :
--------------------
http://www.id-net.fr/prgs

Other demo (in french) :
------------------------
http://www.franet.org

If you are from a country where french is spoken, and want to add freely your
own irc server to the Franet IRC Network, please visit http://www.franet.org

Copyrights :
------------
- Apirc is copyrighted P.Toilon IdNet (http://www.id-net.fr)
- Java is a trademark of Sun Microsystems, Inc. (http://www.sun.com)
- Windows and Microsoft Internet Explorer (MSIE) are copyrighted
  Microsoft Corporation (http://www.microsoft.com)
- Cygnus gcc compiler is copyrighted by Cygnus Solutions (http://www.cygnus.com)
- Netscape is copyrighted by Netscape Communications Corporation
  (http://www.netscape.com)

