-# solanum [![POSIX Build Status](https://travis-ci.org/solanum-ircd/solanum.svg?branch=master)](https://travis-ci.org/solanum-ircd/solanum) [![Windows Build Status](https://ci.appveyor.com/api/projects/status/is0obsml8xyq2qk7/branch/master?svg=true)](https://ci.appveyor.com/project/kaniini/solanum/branch/master)
+# solanum ![Build Status](https://github.com/solanum-ircd/solanum/workflows/CI/badge.svg)
Solanum is an IRCv3 server designed to be highly scalable. It implements IRCv3.1 and some parts of IRCv3.2.
It is meant to be used with an IRCv3-capable services implementation such as [Atheme][atheme] or [Anope][anope].
- [atheme]: http://www.atheme.net/
+ [atheme]: https://atheme.github.io/
[anope]: http://www.anope.org/
# necessary requirements
# platforms
-Solanum is designed with portability in mind, but does not target older systems nor those of solely academic
-interest.
-
-Do note that operating systems are only supported if they are supported by their vendor.
-
-## Tier 1
-
-These platforms are the best supported, and should always work. They are actively tested. If you encounter
-problems, please file a bug.
-
-* FreeBSD 10.x and above (i386 and amd64)
-* Linux 2.6.x and above with glibc or musl (i386, x86_64, and ARM)
-* macOS 10.7 and above
-* Windows Vista/Server 2008 and above (x86 or x64)
-
-## Tier 2
-
-These platforms are supported and occasionally tested, and most features should work, but this is not
-guaranteed. If you find any problems, file a bug, but as these are not regularly tested platforms, a timely
-resolution may not be possible.
-
-* DragonflyBSD 4.4 and above (i386)
-* Linux with uClibc (i386 or x86_64)
-* NetBSD 6.1.x and above (i386, amd64)
-* OpenBSD 5.6 and above (i386, amd64)
-* Solaris 10 and above (i386)
-
-## Tier 3
-
-Anything else that hasn't been tested. Solanum may or may not work on it; patches welcome if they don't.
+Solanum is developed on Linux with glibc, but is currently portable to most POSIX-compatible operating systems.
+However, this portability is likely to be removed unless someone is willing to maintain it. If you'd like to be that
+person, please let us know on IRC.
# platform specific errata
-These are known issues and workarounds for supported platforms.
+These are known issues and workarounds for various platforms.
* **macOS**: you must set the `LIBTOOLIZE` environment variable to point to glibtoolize before running autogen.sh:
* **FreeBSD**: if you are compiling with ipv6 you may experience
problems with ipv4 due to the way the socket code is written. To
- fix this you must: "sysctl net.inet6.ip6.v6only=0"
+ fix this you must: `sysctl net.inet6.ip6.v6only=0`
+
+ * **Solaris**: you may have to set your `PATH` to include `/usr/gnu/bin` and `/usr/gnu/sbin` before `/usr/bin`
+ and `/usr/sbin`. Solaris's default tools don't seem to play nicely with the configure script. When running
+ as a 32-bit binary, it should be started as:
+
+ ```bash
+ ulimit -n 4095 ; LD_PRELOAD_32=/usr/lib/extendedFILE.so.1 ./solanum
+ ```
- * **Solaris**: you may have to set your PATH to include /usr/gnu/bin and /usr/gnu/sbin before /usr/bin
- and /usr/sbin. Solaris's default tools don't seem to play nicely with the configure script.
+# building
-# building from git
+```bash
+./autogen.sh
+./configure --prefix=/path/to/installation
+make
+make check # run tests
+make install
+```
-We no longer supply a prebuilt configure script in git, due to use of automake and libtool causing problems.
-You will need to run `autogen.sh` to build the autotools files prior to building solanum.
+See `./configure --help` for build options.
# feature specific requirements
* For SSL/TLS client and server connections, one of:
- * OpenSSL 1.0.0 or newer (--enable-openssl)
- * LibreSSL (--enable-openssl)
- * mbedTLS (--enable-mbedtls)
- * GnuTLS (--enable-gnutls)
+ * OpenSSL 1.0.0 or newer (`--enable-openssl`)
+ * LibreSSL (`--enable-openssl`)
+ * mbedTLS (`--enable-mbedtls`)
+ * GnuTLS (`--enable-gnutls`)
* For certificate-based oper CHALLENGE, OpenSSL 1.0.0 or newer.
(Using CHALLENGE is not recommended for new deployments, so if you want to use a different TLS library,
feel free.)
- * For ECDHE under OpenSSL, on Solaris and RHEL/Fedora (and its derivatives such as CentOS) you will
- need to compile your own OpenSSL on these systems, as they have removed support for ECC/ECDHE.
- Alternatively, consider using another library (see above).
+ * For ECDHE under OpenSSL, on Solaris you will need to compile your own OpenSSL on these systems, as they
+ have removed support for ECC/ECDHE. Alternatively, consider using another library (see above).
# tips
- * To report bugs in solanum, visit us at chat.freenode.net #solanum
+ * To report bugs in Solanum, visit us at `#solanum` on [Libera Chat](https://libera.chat)
- * Please read doc/index.txt to get an overview of the current documentation.
+ * Please read [doc/index.txt](doc/index.txt) to get an overview of the current documentation.
- * Read the NEWS file for what's new in this release.
+ * Read the [NEWS.md](NEWS.md) file for what's new in this release.
- * The files, /etc/services, /etc/protocols, and /etc/resolv.conf, SHOULD be
+ * The files, `/etc/services`, `/etc/protocols`, and `/etc/resolv.conf`, SHOULD be
readable by the user running the server in order for ircd to start with
- the correct settings. If these files are wrong, solanum will try to use
- 127.0.0.1 for a resolver as a last-ditch effort.
+ the correct settings. If these files are wrong, Solanum will try to use
+ `127.0.0.1` for a resolver as a last-ditch effort.
# git access
- * The Solanum GIT repository can be checked out using the following command:
+ * The Solanum git repository can be checked out using the following command:
`git clone https://github.com/solanum-ircd/solanum`
- * Solanum's GIT repository depot can be browsed over the Internet at the following address:
+ * Solanum's git repository can be browsed over the Internet at the following address:
https://github.com/solanum-ircd/solanum