diff --git a/.RELEASE.NOTES b/.RELEASE.NOTES index 06254bafd..98bd363c1 100644 --- a/.RELEASE.NOTES +++ b/.RELEASE.NOTES @@ -1,3 +1,42 @@ Unreal3.2-Selene (BETA1) RELEASE NOTES -====================================== \ No newline at end of file +====================================== + + I M P O R T A N T R E A D I N G + + +* Unreal3.2-Selene is a lot different than Unreal3.1.1. Forget all you have + learnt about setting up Unreal3.1.1 - this is a lot different. We have got + a new configuration format that intregrates all the former config files, + ircd.conf, vhost.conf, chrestrict.conf, unrealircd.conf, into to one new + unrealircd.conf (what the ircd.conf is called now). See doc/ for more + information on the configuration format + +* We have introduced a new cloaking algoritm (+x), which makes it + incompatible with Unreal3.1.1 - these can however still link, but the + hostname will look different. This is made of three big numbers, + configured in the config file - and these MUST be the same on all servers + on the network. Keep these numbers secret, and the cloaking algoritm is + uncrackable (within 55 years, that is) + +* We use autoconf to help with compiliation, and this should make us able + to a lot more platform (we have even ported to BeOS). + +* We require a pthreads library for the SOCKS scan now - and this is now + done in the background (no more waiting!). + +* The IRCd is now modularized, and you load modules with the loadmodule + command. You will most likely want to add these lines: + + loadmodule "src/modules/commands.so"; + loadmodule "src/modules/scan.so"; + loadmodule "src/modules/scan_socks.so"; + + If you would like to code a module, doc/ will contain a module guide, + and we got an example module in src/modules/m_dummy.c. + +* We got limited IPv6 support, and there are some minor bugs in it. + +* THIS IS A BETA VERSION. THINGS MAY NOT WORK. REPORT ANY BUGS TO THESE + ADDRESSES: + * coders@lists.unrealircd.org and bugs@lists.unrealircd.org \ No newline at end of file diff --git a/doc/services-install-guide b/doc/services-install-guide index b6450d45c..f4e4c8552 100644 --- a/doc/services-install-guide +++ b/doc/services-install-guide @@ -1,83 +1,83 @@ - Services Install Guide For Unreal 3.2 by zyrorl (zyrorl@unrealircd.com) - ======================================================================= - - last updated: 4/5/2001 (4th May 2001) - - -First of all you will be required to download a services package for your -network. - -A few of the most popular services are: - - IRCServices - http://www.ircservices.za.net/ - Epona - http://www.pegsoft.net/epona/ - Wrecked - http://www.wrecked.net/services/index.html - Magick - http://www.magick.tm/ - Sirius - http://ircsystems.net/sirius - -After you have downloaded the appropriate services package, you will have to -upload it to your shell, and untar and un-gzip the file by typing: tar -zxvf -services.x.x.tar.gz - -Then you will need to enter the directory created by your services package (for -a listing type ls -a) and type ./configure . This will run the configure script -to setup your services. The script will ask you questions regarding the path -want to install your services to, where you want the services data files to be -installed to, encryption options, and the type of ircd that you are using (Most -probably Unreal). If you have previously used any other services package, it -may also ask you if you would like to convert their databases. It may also ask -you if you would like the services to dump a core file when a segmentation fault -occurs so that you can find out the cause of the problem and bug report to the -developers of the ircd services. - -Then you will be required to compile your services package by typing "make" or -possibly "gmake". To install services after compiled, type "make install". -Then you will need to enter the directory that you specified for the location -for the data of the services. You will most likely see a example.conf file in -the folder. You will need to rename this file to services.conf by typing "mv -example.conf services.conf" and then you will need to edit the services.conf -file in your favourite text editor. We recommend new users use pico, to edit -the file using pico type "pico services.conf". Edit the file to your liking, -make sure you follow their recommendations in settings, and make sure you edit -the root services passwords, server to link to, password and port. - -After you have configured your services you will then be required to edit your -unrealircd.conf. You will require to add server connection lines to your server -in order for services to work. All services on your network will need to have -the same U line as the server that services are linking to. A sample of the -configuration for services for unrealircd.conf is listed below: - -link services.yournetwork.net { - username *; - hostname 0.0.0.0; /*Server Ip Address Or Hostmask */ - bind-ip *; /* IP To Bind To When Connecting */ - port 6667; /* Port Number */ - password-connect "passwordsend"; /*Password To Send On Connection*/ - password-receive "passwordreceive"; /* Password To Receive From - Server Connecting */ - class servers; - options { autoconnect; }; -}; - -Make sure you then add a u:line entry for services. All the servers on your -network will be required to have a U:line. For UnrealIRCD 3.2 the U:lines -should look something like this: - -ulines { - services.yournetwork.net; -}; - -Servers Running UnrealIRCD 3.1.1 Darkshades or below the U:Line for the servers -should look something like this: - - U:services.yournetwork.net:*:* - -You will then be required to edit your unrealircd.conf's network configuration -services name line, which has to be the same name as chosen on the connection -line for your services. ie. in this case your network configuration line would -look something like: - - services-name "services.yournetwork.net"; - -Then you will require to /rehash your ircd and then go back to your services -directory and type ./services to run services. + Services Install Guide For Unreal 3.2 by zyrorl (zyrorl@unrealircd.org) + ======================================================================= + + last updated: 4/5/2001 (4th May 2001) + + +First of all you will be required to download a services package for your +network. + +A few of the most popular services are: + + IRCServices - http://www.ircservices.za.net/ + Epona - http://www.pegsoft.net/epona/ + Wrecked - http://www.wrecked.net/services/index.html + Magick - http://www.magick.tm/ + Sirius - http://ircsystems.net/sirius + +After you have downloaded the appropriate services package, you will have to +upload it to your shell, and untar and un-gzip the file by typing: tar -zxvf +services.x.x.tar.gz + +Then you will need to enter the directory created by your services package (for +a listing type ls -a) and type ./configure . This will run the configure script +to setup your services. The script will ask you questions regarding the path +want to install your services to, where you want the services data files to be +installed to, encryption options, and the type of ircd that you are using (Most +probably Unreal). If you have previously used any other services package, it +may also ask you if you would like to convert their databases. It may also ask +you if you would like the services to dump a core file when a segmentation fault +occurs so that you can find out the cause of the problem and bug report to the +developers of the ircd services. + +Then you will be required to compile your services package by typing "make" or +possibly "gmake". To install services after compiled, type "make install". +Then you will need to enter the directory that you specified for the location +for the data of the services. You will most likely see a example.conf file in +the folder. You will need to rename this file to services.conf by typing "mv +example.conf services.conf" and then you will need to edit the services.conf +file in your favourite text editor. We recommend new users use pico, to edit +the file using pico type "pico services.conf". Edit the file to your liking, +make sure you follow their recommendations in settings, and make sure you edit +the root services passwords, server to link to, password and port. + +After you have configured your services you will then be required to edit your +unrealircd.conf. You will require to add server connection lines to your server +in order for services to work. All services on your network will need to have +the same U line as the server that services are linking to. A sample of the +configuration for services for unrealircd.conf is listed below: + +link services.yournetwork.net { + username *; + hostname 0.0.0.0; /*Server Ip Address Or Hostmask */ + bind-ip *; /* IP To Bind To When Connecting */ + port 6667; /* Port Number */ + password-connect "passwordsend"; /*Password To Send On Connection*/ + password-receive "passwordreceive"; /* Password To Receive From + Server Connecting */ + class servers; + options { autoconnect; }; +}; + +Make sure you then add a u:line entry for services. All the servers on your +network will be required to have a U:line. For UnrealIRCD 3.2 the U:lines +should look something like this: + +ulines { + services.yournetwork.net; +}; + +Servers Running UnrealIRCD 3.1.1 Darkshades or below the U:Line for the servers +should look something like this: + + U:services.yournetwork.net:*:* + +You will then be required to edit your unrealircd.conf's network configuration +services name line, which has to be the same name as chosen on the connection +line for your services. ie. in this case your network configuration line would +look something like: + + services-name "services.yournetwork.net"; + +Then you will require to /rehash your ircd and then go back to your services +directory and type ./services to run services.