X-Git-Url: http://www.git.cypherpunks.ru/?a=blobdiff_plain;f=README;h=87824263e449cc109f01eb4058f9839437942d8d;hb=ad68cf29f652c5bfa7822a10000e9da658fbf1d5;hp=03f31d88485e3ad1b1af0c04d05951c3c0731459;hpb=afbf2b40d4f5accd041a3052ab58718958c8da1c;p=goircd.git diff --git a/README b/README index 03f31d8..8782426 100644 --- a/README +++ b/README @@ -1,10 +1,6 @@ goircd -- minimalistic simple Internet Relay Chat (IRC) server ============================================================== -SYNOPSIS - -goircd is very simple IRC server, written on Go. - DESCRIPTION goircd is very simple IRC server, written on Go. @@ -14,7 +10,6 @@ It does not aim to replace full featured mass scalable IRC networks: * It can not connect to other servers. Just standalone installation * It has few basic IRC commands * There is no support for channel operators, modes, votes, invites - and so on * No ident lookups, reverse DNS queries But it has some convincing features: @@ -28,6 +23,7 @@ But it has some convincing features: * Optional permanent channel's state saving in plain text files (so you can reload daemon and all channels topics and keys won't disappear) +* Optional ability to authenticate users by nickname and password Some remarks and recommendations related to it's simplicity: @@ -36,10 +32,10 @@ Some remarks and recommendations related to it's simplicity: SUPPORTED IRC COMMANDS -* NICK/USER during registration workflow +* PASS/NICK/USER during registration workflow * PING/PONGs * NOTICE/PRIVMSG -* MOTD, LUSERS, WHO, WHOIS, QUIT +* AWAY, MOTD, LUSERS, WHO, WHOIS, VERSION, QUIT * LIST, JOIN, TOPIC, +k/-k channel MODE USAGE @@ -55,9 +51,30 @@ Just execute goircd daemon. It has following optional arguments: * -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 +* -tlsbind/-pem: enable TLS, specify address to listen on and path + to PEM file with certificate and private key +* -passwords: enable client authentication and specify path to + passwords file * -verbose: increase log messages verbosity +TLS + +If you specify -bind and -tlsbind simultaneously, then you will have +both raw and encrypted listening sockets. You can use -bind "" to +disable raw socket. + +AUTHENTICATION + +You can turn on optional client authentication by preparing passwords +file and using the -passwords argument. Format of passwords file is: + + login1:password1\n + login2:password2\n + … + +You can force rereading of passwords file without server interruption by +sending HUP signal to him. + LICENCE This program is free software: you can redistribute it and/or modify