X-Git-Url: https://arthur.barton.de/cgi-bin/gitweb.cgi?p=ngircd-alex.git;a=blobdiff_plain;f=README;h=45cabd691017039e49fcc7c21228b49005531a8b;hp=e69de29bb2d1d6434b8b29ae775ad8c2e48c5391;hb=c37d6971d66a2d840a2b20fe2b995443c2bd6c87;hpb=f4ade537d550b872b7e86e6ffce940dfbad4c60c diff --git a/README b/README index e69de29b..45cabd69 100644 --- a/README +++ b/README @@ -0,0 +1,89 @@ + + ngIRCd - Next Generation IRC Server + http://ngircd.barton.de/ + + (c)2001-2017 Alexander Barton and Contributors. + ngIRCd is free software and published under the + terms of the GNU General Public License. + + -- README -- + + +I. Introduction +~~~~~~~~~~~~~~~ + +ngIRCd is a free, portable and lightweight Internet Relay Chat server for +small or private networks, developed under the GNU General Public License +(GPL; please see the file COPYING for details). It is simple to configure, +can cope with dynamic IP addresses, and supports IPv6 as well as SSL. It is +written from scratch and not based on the original IRCd. + +The name ngIRCd means next generation IRC daemon, which is a little bit +exaggerated: lightweight Internet Relay Chat server most probably would be a +better name :-) + +Please see the INSTALL document for installation and upgrade information! + + +II. Status +~~~~~~~~~~~ + +ngIRCd should be quite feature complete and stable to be used as daemon in +real world IRC networks. + +It is not the goal of ngIRCd to implement all the nasty behaviors of the +original ircd, but to implement most of the useful commands and semantics +specified by the RFCs that are used by existing clients. + + +III. Features (or: why use ngIRCd?) +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +- Well arranged (lean) configuration file. +- Simple to build, install, configure, and maintain. +- Supports IPv6 and SSL. +- Can use PAM for user authentication. +- Lots of popular user and channel modes are implemented. +- Supports "cloaking" of users. +- No problems with servers that have dynamic IP addresses. +- Freely available, modern, portable and tidy C source. +- Wide field of supported platforms, including AIX, A/UX, FreeBSD, HP-UX, + IRIX, Linux, Mac OS X, NetBSD, OpenBSD, Solaris, and Windows with Cygwin. +- ngIRCd is being actively developed since 2001. + + +IV. Documentation +~~~~~~~~~~~~~~~~~ + +More documentation can be found in the "doc/" directory and the homepage of +ngIRCd: . + + +V. Download +~~~~~~~~~~~ + +The homepage of the ngIRCd is ; you will find +the newest information about the ngIRCd and the most recent ("stable") +releases there. + +Visit our source code repository at GitHub if you are interested in the +latest development version: . + + +VI. Problems, Bugs, Patches +~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Please don't hesitate to contact us if you encounter problems: + +- On IRC: +- Via the mailing list: + +See for details. + +If you find bugs in ngIRCd (which will be there most probably ...), please +report them to our issue tracker at GitHub: + +- Bug tracker: +- Patches, "pull requests": + +There you can read about known bugs and limitations, too.