goircd/README

72 lines
2.5 KiB
Plaintext
Raw Normal View History

2014-05-11 16:18:55 +00:00
goircd -- minimalistic simple Internet Relay Chat (IRC) server
==============================================================
SYNOPSIS
goircd is very simple IRC server, written on Go.
DESCRIPTION
2014-05-11 16:20:29 +00:00
goircd is very simple IRC server, written on Go.
2014-05-11 16:18:55 +00:00
It is heavily inspired by miniircd daemon written on Python.
2014-05-11 16:20:29 +00:00
It does not aim to replace full featured mass scalable IRC networks:
2014-05-11 16:18:55 +00:00
* It can not connect to other servers. Just standalone installation
* It has few basic IRC commands
2014-05-18 11:34:31 +00:00
* There is no support for channel operators, modes, votes, invites
2014-05-11 16:18:55 +00:00
and so on
* No ident lookups, reverse DNS queries
But it has some convincing features:
* Only standard Go libraries, no external requirements
* Single executable binary
* No configuration file, just few command line arguments
* IPv6 out-of-box support
* Ability to listen on TLS-capable ports
2014-05-11 16:18:55 +00:00
* Optional channel logging to plain text files
* Optional permanent channel's state saving in plain text files
(so you can reload daemon and all channels topics and keys won't
disappear)
Some remarks and recommendations related to it's simplicity:
* Use either nohup or similar tools to daemonize it
* Just plain logging on stderr, without syslog support
SUPPORTED IRC COMMANDS
* NICK/USER during registration workflow
* PING/PONGs
* NOTICE/PRIVMSG
* MOTD, LUSERS, WHO, WHOIS, QUIT
* LIST, JOIN, TOPIC, +k/-k channel MODE
USAGE
Just execute goircd daemon. It has following optional arguments:
* -hostname: hostname to show for client's connections
* -bind: address to bind to (:6667 be default)
* -motd: absolute path to MOTD file. It is reread every time MOTD is
requested
* -logdir: directory where all channels messages will be saved. If
omitted, then no logs will be kept
* -statedir: directory where all channels states will be saved and
loaded during startup. If omitted, then states will be
lost after daemon termination
* -tls_key/-tls_cert: enable TLS and specify key and certificate file
* -verbose: increase log messages verbosity
2014-05-11 16:18:55 +00:00
LICENCE
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.