/gnuworld

IRC(u) services in C++

Primary LanguageC++GNU General Public License v2.0GPL-2.0

Welcome to GNUWorld
------------------

****
The setup procedures listed here are generic, and do not provide any 
information for building databases for these two modules.
****

GNUWorld is an IRC services server.  This server hosts several
virtual client modules that perform IRC network and channel 
functions.

To use GNUWorld, you need a few of the basics:
	- An uplink IRC server.  Make sure the UWorld block is
	  set properly for the bots you wish for GNUWorld to 
	  host.
	- A machine to run GNUWorld.  Keep in mind that
	  GNUWorld uses as much bandwidth as any other IRC 
	  server on your network.
	- GNUWorld will also use quite a bit of RAM time, 
	  though not normally nearly as much as other IRC 
	  servers on your network.

The first step you need to take is to obtain a copy of GNUWorld.
GNUWorld is software distributed under the GPL.  A copy of the 
license is included with this distribution.

You can obtain GNUWorld through the above web site.  The
preferred method of getting a copy of GNUWorld is through git.

git clone https://github.com/UndernetIRC/gnuworld.git


(Execute the above command on a single line in your shell.)
This will create a directory under your current directory named 
"gnuworld" in which all of GNUWorld's files will be placed.

Building GNUWorld
----------------

In order to build GNUWorld, you will need a compiler which
supports the ANSI C++ Standard.  GNUmake is also recommended 
(gmake).

Change into the gnuworld directory, and run the configuration script:

cd gnuworld
./configure

When you run configure, you may specify which clients to build.  Use
the --enable-modules option to specify a comma separated list of
modules to build (each client is now a dynamically loadable module).
Here is an example of how to configure for only the cservice client:

./configure --enable-modules=cservice

This example will build both the cservice and ccontrol (oper services)
modules:

./configure --enable-modules=cservice,ccontrol

Not specifying the --enable-modules option at all will build all
available modules.

If you should choose to build no modules at all (which isn't very
useful), you can give the "no" (without the quotes) argument to the 
--enable-modules option:

./configure --enable-modules=no

Note also that all of the usual configure options are supported, and
may be viewed by:

./configure --help

IMPORTANT: If your OS supports shared libraries, you can reduce
the compile time by half if you give configure these addional
options:

--enable-shared --disable-static

This will build the Makefiles that GNUWorld will use to compile
its source code.  Compile gnuworld with the command:

make

This command will build all of the libraries and binaries.
To install the binaries and library modules into ./bin/, type:

make install

Configuring GNUWorld
--------------------

Change into the bin directory:

cd bin

In here you will find several .conf files.  These are the files that
GNUWorld uses to configure itself and its bots.  The file
"GNUWorld.example.conf" contains sufficient information for 
GNUWorld to connect to an IRC uplink server located on the local
(127.0.0.1) machine.

In order to run any services clients, each of those modules must be
built and installed into the bin/ directory (see above).  To have a
client loaded, add a line like this to the .conf of your choice:

module = libcservice.la cservice.conf

The "module" keyword tells gnuworld to attempt to load the given
module.

NOTE: Individual modules may require additional configuration.
Such is the case with modules libcservice (channel service) and 
ccontrol (oper services).  Please read the README files in each 
of those modules' subdirectories for more information.

All modules will be built with a ".la" extension.  This is a
libtool archive.  LibTool is used to build dynamically
loadable modules on many architectures, including those
which do not support shared objects.  Therefore, your system
may require static archives to be built.  In either case,
libtool will figure out the proper build commands, and create a
".la" archive for each client which isb uilt.

The format of the configuration files should be fairly
straightforward.  GNUWorld also supports several command line 
options obtained by running the command:

gnuworld -h

Running GNUWorld
----------------

In order to run GNUWorld, all you need to pass it is the name of the
configuration file.  To have GNUWorld run and connect to the
IRC server located at localhost:6667, using the configuration 
file GNUWorld.example.conf, issue the following command:

gnuworld -f GNUWorld.example.conf

That's it!  You will now have GNUWorld running!

Should you have any problems, you can visit us on the channel #coder-com
of the Undernet IRC network. https://chat.undernet.org/?channel=#coder-com


You may also submit your bug reports via the github Issues section.
https://github.com/UndernetIRC/gnuworld/issues

Thanks,

The GNUWorld Development Team