remove upstream readme
--HG-- branch : nmdc-ircfrontend
This commit is contained in:
parent
562e8a178a
commit
588795a3be
128
README.md
128
README.md
@ -1,128 +0,0 @@
|
|||||||
Rosella
|
|
||||||
=======
|
|
||||||
[![Build Status](https://drone.io/github.com/eXeC64/Rosella/status.png)](https://drone.io/github.com/eXeC64/Rosella/latest)
|
|
||||||
About
|
|
||||||
-----
|
|
||||||
Rosella is a small ircd (Internet Relay Chat Daemon).
|
|
||||||
It partially implements RFC1459, but will never be fully compliant.
|
|
||||||
|
|
||||||
Rosella is intended to provide a portable, light-weight, near-zero-conf
|
|
||||||
ircd capable of handling many simultaneous connections, whilst providing
|
|
||||||
as much privacy for its users as possible.
|
|
||||||
|
|
||||||
Rosella *only* communicates with clients over SSL/TLS connections, therefore an
|
|
||||||
x.509 certificate and private key are required for operation. Proper key
|
|
||||||
handling and certificate checking is the responsibility of the users. Rosella
|
|
||||||
cannot protect you from stupidity or untrustworthy CA's.
|
|
||||||
|
|
||||||
Features
|
|
||||||
--------
|
|
||||||
|
|
||||||
Rosella is a stand-alone server, and does not support server→server
|
|
||||||
communication or services→server communication. Basic services are expected to
|
|
||||||
be provided by IRC bots.
|
|
||||||
|
|
||||||
The following channel modes are supported:
|
|
||||||
|
|
||||||
* s - Secret. The channel is hidden from /LIST unless you are already in it.
|
|
||||||
* n - No external. Only users in the channel may send messages to it.
|
|
||||||
* t - Topic Locked. Only operators may set the topic.
|
|
||||||
* m - Moderated. Only users with voice or operators may talk.
|
|
||||||
|
|
||||||
The following irc commands are supported:
|
|
||||||
|
|
||||||
* INFO
|
|
||||||
* JOIN
|
|
||||||
* KICK
|
|
||||||
* KILL
|
|
||||||
* LIST
|
|
||||||
* MODE
|
|
||||||
* NICK
|
|
||||||
* OPER
|
|
||||||
* PART
|
|
||||||
* PRIVMSG
|
|
||||||
* QUIT
|
|
||||||
* TOPIC
|
|
||||||
* USER
|
|
||||||
* VERSION
|
|
||||||
|
|
||||||
Download
|
|
||||||
--------
|
|
||||||
The latest x86-64 build of Rosella is available from Drone.io's continuous
|
|
||||||
integration service.
|
|
||||||
|
|
||||||
[Download Latest Build](https://drone.io/github.com/eXeC64/Rosella/files/Rosella)
|
|
||||||
|
|
||||||
If you would rather review the code and then compile it yourself then run this
|
|
||||||
on a system with Go 1.1.2 or later installed.
|
|
||||||
|
|
||||||
~~~
|
|
||||||
go get github.com/eXeC64/Rosella
|
|
||||||
cd $GOPATH/src/github.com/eXeC64/Rosella
|
|
||||||
~~~
|
|
||||||
|
|
||||||
You can then browse and review the source code at your leisure before compiling
|
|
||||||
it by running `go build`.
|
|
||||||
|
|
||||||
Usage
|
|
||||||
-----
|
|
||||||
Command line options can be found by running `Rosella -h`.
|
|
||||||
|
|
||||||
###x.509 Certificate###
|
|
||||||
Rosella expects you to provide a valid x.509 certificate and private key.
|
|
||||||
You can generate these yourself with openssl, or obtain one from a certificate
|
|
||||||
authority you trust.
|
|
||||||
|
|
||||||
###Auth File###
|
|
||||||
The auth file provides a list of usernames and hashed passwords that the /OPER
|
|
||||||
command will accept. The format is one username and password pair per line.
|
|
||||||
Lines starting with a `#` are ignored as comments, as are blank lines. The
|
|
||||||
password is hashed with bcrypt. Username and password are placed on the same
|
|
||||||
line and separated by a single space, as such:
|
|
||||||
|
|
||||||
#This line is a comment
|
|
||||||
username1 bcrypt_hashed_password
|
|
||||||
|
|
||||||
#Another comment, blank lines are ignored
|
|
||||||
username2 bcrypt_hashed_password
|
|
||||||
username3 bcrypt_hashed_password
|
|
||||||
|
|
||||||
**Treat this file as you would treat a private key file.**
|
|
||||||
|
|
||||||
Design Principles
|
|
||||||
-----------------
|
|
||||||
|
|
||||||
* Rosella will not spy upon its users, or log them in any way.
|
|
||||||
|
|
||||||
* Rosella will not communicate with any users in plaintext.
|
|
||||||
|
|
||||||
* Rosella will not provide any mechanism for identifying other users beyond
|
|
||||||
their nicknames.
|
|
||||||
|
|
||||||
* Rosella will not allow any user to spy upon any other user.
|
|
||||||
|
|
||||||
* Rosella's source code will be kept as easy to review as possible.
|
|
||||||
|
|
||||||
Contributing
|
|
||||||
------------
|
|
||||||
|
|
||||||
Patches and pull requests for new features and code clean ups are welcome as
|
|
||||||
long as they follow the design principles.
|
|
||||||
|
|
||||||
License
|
|
||||||
-------
|
|
||||||
|
|
||||||
Copyright (C) 2013 Harry Jeffery
|
|
||||||
|
|
||||||
This program is free software: you can redistribute it and/or modify
|
|
||||||
it under the terms of the GNU Affero General Public License as
|
|
||||||
published by the Free Software Foundation, either version 3 of the
|
|
||||||
License, or (at your option) 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 Affero General Public License for more details.
|
|
||||||
|
|
||||||
You should have received a copy of the GNU Affero General Public License
|
|
||||||
along with this program. If not, see <http://www.gnu.org/licenses/>.
|
|
Loading…
Reference in New Issue
Block a user