You are about to install Sux Services, the new-generation IRC services: they aim to be robust, flexible and scalable.
Remember that the code is nor complete neither heavily tested: random crashes can occur, and they could even put your machine on fire.
Read the license (the COPYING file) for informations about warranty.
Component | Notes |
A supported Operating System |
Currently supported systems are:
Porting efforts are really wanted. mailto: vjt@openssl.it.
Linux notes:
Not tested with older 2.4 kernels, tested a little with 2.2
kernels. But they should work. |
GCC 2.95 or later | Tested also with gcc 3.{0,2} |
LinuxThreads |
Make sure you have |
GLib >= 2.2.0 with gthreads |
You can get source tarballs of GLib from The GTK Site or you can install it with your favourite package manager. |
mySQL server and threaded mySQL client library. |
You can download source tarballs from http://www.mysql.com. |
Bahamut 1.4.34 or later |
You can download bahamut from http://bahamut.dal.net.
!!!! NOT TESTED WITH ANY OTHER IRC DAEMON !!!! |
First of all you need to build the core services:
./configure
script.
make
After that, sux services should have been succesfully compiled. If the ./configure script or the build fails, please drop me a note: vjt@openssl.it. Thanks :).
If you are looking for a graphical client for mysql, I suggest
mysqlcc.
If you are looking for a web-based client for mysql, I suggest
phpMyAdmin.
If you are an SQL expert, you can use the command line mysql client :).
suxserv
'
with the 'sUx4L07
' password and a database called 'suxdb
'.
-rw-r----- 1 vjt vjt 5943 Mar 1 02:10 sux-db.sql
-rw-r----- 1 vjt vjt 14143 Feb 28 18:19 sux-help.sql
The first file contains the database schema, the second one contains the help
files. You must import the schema first, and then the help files.
You can do this by issuing these commands:
$ mysql -h host.where.the.mysql.server.is -u suxserv -p suxdb < sux-db.sql
$ mysql -h host.where.the.mysql.server.is -u suxserv -p suxdb < sux-help.sql
suxserv
' user when asked ('sUx4L07
' in
this example).
You are almost done !
Now you need to edit the sux.conf
file to reflect your
installation-specific parameters.
sux.conf
is located into the src/
subdirectory. For correct operation,
you must keep the 'sux
' binary and the 'sux.conf
' file into the same
subdirectory. Keeping both files into the src/
subdirectory is also
a good idea.
Editing sux.conf
is really straigthforward.
The file is broken in three main parts:
The file is also heavily commented, so open it now and insert your parameters :).
Congratulations ! You have just installed Sux Services. Start your ircd, and then
go into the src/
subdirectory of sux services and type ./sux
They should link to your server and start to process data.
If something goes wrong, and you want to help me finding bugs, you can compile
a debug version of Sux Services:
$ make clean
$ ./configure --enable-debug-build
$ make
After that, you can run the binary into gdb:
And then you could try to repeat the commands that made services crash.
At this point, the gdb will catch the SIGSEGV and give you his prompt. Now,
type 'bt full'
$ gdb ./sux
GNU gdb 5.3-debian
Copyright 2002 Free Software Foundation, Inc.
GDB is free software, covered by the GNU General Public License, and you are
welcome to change it and/or distribute copies of it under certain conditions.
Type "show copying" to see the conditions.
There is absolutely no warranty for GDB. Type "show warranty" for details.
This GDB was configured as "i386-linux"...
(gdb) run -d
and email me those strange lines. Core dumps ( they can be also quite large ) and binaries
are also welcome. Thanks :)
(gdb) bt full
#0 0x46d85ae2 in sigsuspend () from /lib/libc.so.6
.... etc ...
Enjoy !
EOF