User documentation User documentation
<< back


GNUWorld is remarkably easy to use. Simply download, configure, compile, change to gnuworld/bin directory, and execute the GNUWorld executable.

If you have any configuration, compilation, or runtime programs, please let us know.


Getting GNUWorld
The most efficient method for obtaining GNUWorld is by using CVS. This will also yield the most up to date version of GNUWorld. For information on using CVS from your shell account, see Using CVS to Obtain GNUWorld.

Currently, there is no official release of GNUWorld to download from the web pages. However, you examine the source repository online at the GNUWorld CVS Repository.


Configuring and Building GNUWorld
If you plan on installing the whole system with X, Uworld and website, you should visit :
      GNUworld setup guide

Once you've obtained GNUWorld, cd into the gnuworld directory:

      cd gnuworld

Next you need to run the configure script:

      ./configure

This script will determine your system settings, and build the Makefiles for GNUWorld. Once this has completed, you might want to have a look over the include/config.h file. This file contains the general programmer level compile time definitions for GNUWorld. You shouldn't need to modify this file, the default should work on most networks, large and small.

Next you need to compile GNUWorld. This is done with the make command (note that GNUmake is preferred):

      make

If you have any configuration, compilation, or runtime programs, please let us know.


Starting GNUWorld
The GNUWorld executable accepts several options:

  • -f <config file>: This option should always be specified for the server configuration (described below). This file contains the basic server information (numeric, name, uplink, etc). By default, this value is set to CONFFILE (from config.h).
  • -c: This is the verbose option. Specify this flag on the command line to copy all data sent to the network to the standard output stream.
  • -h: Output a help menu. This describes the available command line argument in brief, and terminates the program.
    The server conf(ig) file protocol is currently being altered. It would be unwise to give a (possibly outdated) description of this file here until the protocol has been decided. See the config files located in bin/ for more current examples.