simple-irc-server 0.1.5

Simple IRC server
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76

# Simple IRC Server

This is a simple IRC server written in the Rust languange. This server supports
basic set of IRC commands and basic user's mode and channel's modes.
This server have following features:

* an asynchronous design in the Tokio framework.
* a simple configuration in TOML format.
* a password hashing thanks Argon2 password hash.
* ability to predefine users, operators and channels.
* a domain name lookup for client hosts.
* TLS connections support thanks RusTLS and OpenSSL.

Because it is simple IRC server, unfortunatelly some commands have not been supported like: 
CONNECT, REHASH, RESTART, AUTHENTICATE. This server should be used to simple
installation only with local IRC environment.

## Build

A server can be easily build with Cargo package system. Following features can be enabled:

* dns_lookup - enable DNS lookup, it is uses Trust DNS resolver package.
* tls-rustls - enable TLS connection support.
* tls-openssl - enable TLS connection support thanks native OpenSSL library.

A tls-openssl should be used in old machines that doesn't support SSE2 instructions.
A rustls uses 'ring' crate that need newer instruction set in X86 processors.

To build server with full support just enter:

```
cargo build --release --features=dns_lookup,tls_rustls
```

or

```
cargo build --release --features=dns_lookup,tls_openssl
```

You can build server without DNS lookup and TLS support by using simple command:

```
cargo build --release
```

To increase security you can specify environment variable PASSWORD_SALT during building
to provide own salt for Argon2 password hashing. It can be just some text.

## Configuration

The sample configuration is in config-example.toml that describes any field configuration.
Passwords should be filled by password hashes generated by using command:

```
simple-irc-server -g
```

or 

```
simple-irc-server -g -P password
```

Text after `Password hash:` should be put into password field.

## Run

You can run server by using command:

```
simple-irc-server -c your-config-file.toml
```

An IRC server can prints some logs to terminal output if no log file specified
in configuration.