Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Browse files

Normalize all text to be 100 characters max.

  • Loading branch information...
commit dc39ffe986096822aca5e37f00a706cdb34184de 1 parent 36cbdad
@SaberUK SaberUK authored
View
34 Contributing.md
@@ -1,37 +1,41 @@
Introduction
------------
-The InspIRCd project is quite open to all contributions, large and small.
-Whether you're a coder, documentation writer, tester or ''<insert role here>'', we're
-sure you will help out in a useful way.
+The InspIRCd project is quite open to all contributions, large and small. Whether you're a coder,
+documentation writer, tester or ''<insert role here>'', we're sure you will help out in a useful
+way.
-This page documents a bit of how we work internally as a project, so that you
-can better fit in and help out if you want.
+This page documents a bit of how we work internally as a project, so that you can better fit in and
+help out if you want.
Development
-----------
-The development team is of a loosely connected group of contributors,
-all working and collaborating on things they want to see done. We don't
-really assign work to anyone, they find stuff to work on on their own generally.
+The development team is of a loosely connected group of contributors, all working and collaborating
+on things they want to see done. We don't really assign work to anyone, they find stuff to work on
+on their own generally.
You can find repositories on [GitHub](http://github.org/inspircd/).
-If you wish to contribute to development, feel free. File as many
-pull requests as you want. Pull requests that fix existing issues are especially welcome.
+If you wish to contribute to development, feel free. File as many pull requests as you want. Pull
+requests that fix existing issues are especially welcome.
-If you ever need to make a release, see the [release procedure](https://github.com/inspircd/wiki/blob/master/Release-Procedure.md) page for help.
+If you ever need to make a release, see the [release procedure](https://github.com/inspircd/wiki/blob/master/Release-Procedure.md)
+page for help.
Documentation
-------------
-Not everyone who can code is stellar at writing things up in a clear, easy to use way - this is where people can help out quite often, by making our numerous features easy to understand. Alternatively, perhaps you are interested in helping to translate our documentation into the language of your choice. Most of the action in this department takes
-place here on our wiki.
+Not everyone who can code is stellar at writing things up in a clear, easy to use way - this is
+where people can help out quite often, by making our numerous features easy to understand.
+Alternatively, perhaps you are interested in helping to translate our documentation into the
+language of your choice. Most of the action in this department takes place here on our wiki.
Support
-------
-Support is a largely informal area, provided by other users and team members. To help out, hang around in [#inspircd](irc://irc.inspircd.org/inspircd)
-(we don't mind idlers!) and answer questions if you know what it's about.
+Support is a largely informal area, provided by other users and team members. To help out, hang
+around in [#inspircd](irc://irc.inspircd.org/inspircd) (we don't mind idlers!) and answer questions
+if you know what it's about.
We don't bite. Honest.
View
82 FAQ.md
@@ -6,20 +6,30 @@ Why should I choose InspIRCd over some other IRC server?
There are several reasons to choose InspIRCd over some other IRC server. These are:
-* InspIRCd is totally modular -- add and remove features as YOU please, not as we tell you to. This modular design also allows you to upgrade most parts (including but not limited to core commands, server linking and SSL support) without rebooting the IRC server.
+* InspIRCd is totally modular -- add and remove features as YOU please, not as we tell you to. This
+modular design also allows you to upgrade most parts (including but not limited to core commands,
+server linking and SSL support) without rebooting the IRC server.
-* InspIRCd offers its own free (as in beer *and* freedom) implementation of many features which developers of certain other IRC servers want to charge you for.
+* InspIRCd offers its own free (as in beer *and* freedom) implementation of many features which
+developers of certain other IRC servers want to charge you for.
-* InspIRCd has a highly scalable ''non-blocking'' SQL API, supporting, MySQL, PostgreSQL, SQL Server and SQLite -- unseen in any other IRC server.
+* InspIRCd has a highly scalable ''non-blocking'' SQL API, supporting, MySQL, PostgreSQL, SQL
+Server and SQLite -- unseen in any other IRC server.
-* InspIRCd has high-performance socket engines such as epoll and kqueue, whereas other IRC servers with the same feature set do not. We also have some socket engines that no other IRC server has currently, such as Windows I/O Completion Ports, which increases the performance of our Windows builds beyond most other Windows IRC servers.
+* InspIRCd has high-performance socket engines such as epoll and kqueue, whereas other IRC servers
+with the same feature set do not. We also have some socket engines that no other IRC server has
+currently, such as Windows I/O Completion Ports, which increases the performance of our Windows
+builds beyond most other Windows IRC servers.
-* The InspIRCd development team welcome third party contributions, suggestions and criticism whereas many of the developers of alternative IRC servers do not.
+* The InspIRCd development team welcome third party contributions, suggestions and criticism whereas
+many of the developers of alternative IRC servers do not.
How much memory does InspIRCd use?
----------------------------------
-A network with 3000-4000 locally connected clients and 10000 open channels experiences a constant 1-4% CPU use with 70MB of RAM use. This won't go up drastically, but it will go up. Around 40000 local clients means you'll be expecting some 500MB of RAM.
+A network with 3000-4000 locally connected clients and 10000 open channels experiences a constant
+1-4% CPU use with 70MB of RAM use. This won't go up drastically, but it will go up. Around 40000
+local clients means you'll be expecting some 500MB of RAM.
How do I start InspIRCd?
------------------------
@@ -28,7 +38,8 @@ Navigate to the directory in which you installed InspIRCd and issue the followin
./inspircd start
-Note: these instructions only apply if you installed InspIRCd from source on a UNIX-like operating system. If you installed InspIRCd from a package manager it will probably not use this method.
+Note: these instructions only apply if you installed InspIRCd from source on a UNIX-like operating
+system. If you installed InspIRCd from a package manager it will probably not use this method.
Can my network be the "official" InspIRCd network?
--------------------------------------------------
@@ -38,7 +49,8 @@ Sorry, no. That privilege is reserved for our own network at [irc.chatspike.net]
What services package should I choose?
--------------------------------------
-This is an extremely subjective question. It is advised that you trial multiple different packages and use the one that you feel fits your needs.
+This is an extremely subjective question. It is advised that you trial multiple different packages
+and use the one that you feel fits your needs.
Popular IRC services packages used with InspIRCd include:
@@ -60,13 +72,14 @@ On the appropriate issue tracker:
How can I contribute to InspIRCd?
---------------------------------
-Take a look at our [Contributing](https://github.com/inspircd/wiki/blob/master/Contributing.md) page.
-
+Take a look at our [Contributing](https://github.com/inspircd/wiki/blob/master/Contributing.md)
+page.
Can I use InspIRCd on my large network?
---------------------------------------
-Feel free! We have tested InspIRCd up to 80000 clients on a single server. If you have any statistics on performance you would like to share, then get in touch.
+Feel free! We have tested InspIRCd up to 80000 clients on a single server. If you have any
+statistics on performance you would like to share, then get in touch.
Do any large networks use InspIRCd?
-----------------------------------
@@ -88,36 +101,47 @@ The following high performance socket engines are supported:
* **epoll** on Linux.
* **iocp** on Windows
-Please note that the performance improvements given by use of kqueue, iocp or epoll are very large performance gains over select(), and should be used wherever they are available. If you do not have any of these socket engines, you should seriously consider upgrading your operating system or kernel before running an IRC server.
+Please note that the performance improvements given by use of kqueue, iocp or epoll are very large
+performance gains over select(), and should be used wherever they are available. If you do not have
+any of these socket engines, you should seriously consider upgrading your operating system or kernel
+before running an IRC server.
What IRCd is InspIRCd based on?
-------------------------------
-None. Yes that's right, None. We didn't start from anyone else's code, at all. It is not based on Unreal, it is not based on Bahamut, nor is it based on any other IRCd. This is what makes it unique.
+None. Yes that's right, None. We didn't start from anyone else's code, at all. It is not based on
+Unreal, it is not based on Bahamut, nor is it based on any other IRCd. This is what makes it unique.
Can I run InspIRCd as root?
---------------------------
-You could run the InspIRCd binary with the --runasroot parameter, but we will not provide any support for doing this.If you want to bind InspIRCd to a privileged port, you should instead use a port forwarding rule in your firewall. For example, if you are using Linux with iptables:
+You could run the InspIRCd binary with the --runasroot parameter, but we will not provide any
+support for doing this. If you want to bind InspIRCd to a privileged port, you should instead
+use a port forwarding rule in your firewall. For example, if you are using Linux with iptables:
iptables -t nat -A PREROUTING -p tcp -i eth0 -d 127.0.0.1 --dport 194 -j DNAT --to 127.0.0.1:6667
iptables -A FORWARD -p tcp -i eth0 -d 127.0.0.1 --dport 194 -j ACCEPT
-This will forward all traffic on port 194 to port 6667, on the IP 127.0.0.1. You should change this IP and port numbers as appropriate.
+This will forward all traffic on port 194 to port 6667, on the IP 127.0.0.1. You should change this
+IP and port numbers as appropriate.
-If you are running Linux, another solution is to enable [file system capabilities](http://www.friedhoff.org/fscaps.html) in your kernel, which allows you to grant specific privileges (e.g. the ability to bind to ports under 1024) to any process without having to run it as root.
+If you are running Linux, another solution is to enable [file system capabilities](http://www.friedhoff.org/fscaps.html)
+in your kernel, which allows you to grant specific privileges (e.g. the ability to bind to ports
+under 1024) to any process without having to run it as root.
On FreeBSD and similar systems, there is a sysctl OID for this, which you can set:
net.inet.ip.portrange.reservedlow=1
net.inet.ip.portrange.reservedhigh=1
-This will allow non-root processes to bind any ports which are above port 1, essentially all available port numbers.
+This will allow non-root processes to bind any ports which are above port 1, essentially all
+available port numbers.
How do I run InspIRCd when the system starts?
---------------------------------------------
-To launch InspIRCd when your system starts, you should place the following line into the crontab for your IRCd user (crontab -e):
+To launch InspIRCd when your system starts, you should place the following line into the crontab for
+your IRCd user (crontab -e):
@reboot cd /home/user/inspircd; ./inspircd start
@@ -126,36 +150,44 @@ How do I get prefixes like `@`, `~` and `&`?
If you are using InspIRCd 1.2, load [m_customprefix](https://github.com/inspircd/wiki/blob/master/Modules/customprefix.md).
-If you are using InspIRCd 2.0 or newer, load [m_halfop](https://github.com/inspircd/wiki/blob/master/Modules/halfop.md) and [m_chanprotect](https://github.com/inspircd/wiki/blob/master/Modules/halfop.md).
+If you are using InspIRCd 2.0 or newer, load [m_halfop](https://github.com/inspircd/wiki/blob/master/Modules/halfop.md)
+and [m_chanprotect](https://github.com/inspircd/wiki/blob/master/Modules/halfop.md).
Why does my server have none of the advertised features?
--------------------------------------------------------
-By default, InspIRCd only supports features specified in [RFC 1459](http://tools.ietf.org/html/rfc1459). If you want to add extra features then you must load the correct modules. A list of modules can be found in `docs/inspircd.conf.example`.
+By default, InspIRCd only supports features specified in [RFC 1459](http://tools.ietf.org/html/rfc1459).
+If you want to add extra features then you must load the correct modules. A list of modules can be
+found in `docs/inspircd.conf.example`.
Why do I get a 'Loader/Linker' error when loading a module?
-----------------------------------------------------------
-The version of InspIRCd which the module was compiled for is different to your server. Run `make clean` and then `make install` to rebuild everything on the same version.
+The version of InspIRCd which the module was compiled for is different to your server. Run
+`make clean` and then `make install` to rebuild everything on the same version.
When I run my IRC server it exits saying 'Failed to write PID-file'
-------------------------------------------------------------------
-There is a syntax error in your configuration file. To show the real error, move the \<pid\> tag to the top of your configuration.
+There is a syntax error in your configuration file. To show the real error, move the \<pid\> tag to
+the top of your configuration.
How can I use channel admin commands such as kick/mode without having op?
-------------------------------------------------------------------------
Load [m_override](https://github.com/inspircd/wiki/blob/master/Modules/override.md).
-Please note that this module must be loaded on all servers of your network or your mode changes may be reversed and/or you may cause desyncs.
+Please note that this module must be loaded on all servers of your network or your mode changes may
+be reversed and/or you may cause desyncs.
When users connect, InspIRCd never resolves their ident
-------------------------------------------------------
-Ident lookups on InspIRCd are provided by [m_ident](https://github.com/inspircd/wiki/blob/master/Modules/ident.md). You must load this module for them to be resolved.
+Ident lookups on InspIRCd are provided by [m_ident](https://github.com/inspircd/wiki/blob/master/Modules/ident.md).
+You must load this module for them to be resolved.
Can InspIRCd make cheese sandwiches?
------------------------------------
-Yes, providing that you load the [m_cheesesandwich](https://github.com/inspircd/wiki/blob/master/Modules/m_cheesesandwich.md) module.
+Yes, providing that you load the [m_cheesesandwich](https://github.com/inspircd/wiki/blob/master/Modules/m_cheesesandwich.md)
+module.
View
21 IRC-Channel-Rules.md
@@ -3,19 +3,26 @@
As with most IRC channels, the support channel has rules. These rules are as follows:
-* The main purpose of the channel is for support and discussion of InspIRCd. Other off-topic discussion is allowed, but keep it to a minimum when on-topic discussion is happening.
+* The main purpose of the channel is for support and discussion of InspIRCd. Other off-topic
+discussion is allowed, but keep it to a minimum when on-topic discussion is happening.
-* When asking for support make sure to state your full InspIRCd version as well as your Operating System name/version and compiler name/version.
+* When asking for support make sure to state your full InspIRCd version as well as your Operating
+System name/version and compiler name/version.
-* We are here to contribute to the project in some way. Contribute positively. Avoid flaming and arguments.
+* We are here to contribute to the project in some way. Contribute positively. Avoid flaming and
+arguments.
-* Constructive criticism directly related to InspIRCd or an module of InspIRCd is welcomed. By constructive this means you must give recommendations of how it should be improved.
+* Constructive criticism directly related to InspIRCd or an module of InspIRCd is welcomed. By
+constructive this means you must give recommendations of how it should be improved.
-* Outright bashing of people, programs, and ideas without a reasoned argument (e.g. just "its crap") its frowned upon and makes you look an idiot.
+* Outright bashing of people, programs, and ideas without a reasoned argument (e.g. just "its crap")
+its frowned upon and makes you look an idiot.
-* If you find a bug, PLEASE report it to the [bugtracker](https://github.com/inspircd/inspircd/issues) rather than the channel. This makes processing it much easier to manage.
+* If you find a bug, PLEASE report it to the [bugtracker](https://github.com/inspircd/inspircd/issues)
+rather than the channel. This makes processing it much easier to manage.
-* Please use a [pastebin](http://nopaste.snit.ch) if you wish to contribute config file snippets or code to the channel, rather than pasting, or you will be automatically kicked.
+* Please use a [pastebin](http://nopaste.snit.ch) if you wish to contribute config file snippets or
+code to the channel, rather than pasting, or you will be automatically kicked.
* No stupid scripts please (e.g. l33tsp33k-converters, 'thanks for the op' scripts, etc).
View
20 README.md
@@ -5,14 +5,22 @@ Hello, and welcome to the InspIRCd documentation!
Here are some resources that may (or may not!) be useful:
-* If you're stuck, the [Installation](https://github.com/inspircd/wiki/blob/master/Installation.md) and [Configuration](https://github.com/inspircd/wiki/blob/master/Configuration.md) pages might help get you going again.
+* If you're stuck, the [Installation](https://github.com/inspircd/wiki/blob/master/Installation.md)
+and [Configuration](https://github.com/inspircd/wiki/blob/master/Configuration.md) pages might help
+get you going again.
-* Are you interested in [Contributing](https://github.com/inspircd/wiki/blob/master/Contributing.md)? We'd love to hear from you!
+* Are you interested in [Contributing](https://github.com/inspircd/wiki/blob/master/Contributing.md)?
+We'd love to hear from you!
-* The [FAQ](https://github.com/inspircd/wiki/blob/master/FAQ.md) is a good place to start looking if you're new or curious!
+* The [FAQ](https://github.com/inspircd/wiki/blob/master/FAQ.md) is a good place to start looking if
+you're new or curious!
-* To implement server software that talks to InspIRCd, the [Spanning Tree Protocol](https://github.com/inspircd/wiki/blob/master/Modules/spanningtree/Protocol.md) documentation might be useful.
+* To implement server software that talks to InspIRCd, the [Spanning Tree Protocol](https://github.com/inspircd/wiki/blob/master/Modules/spanningtree/Protocol.md)
+documentation might be useful.
-* If you spot a bug in the documentation then file an [issue](https://github.com/inspircd/wiki/issues) or a [pull request](https://github.com/inspircd/wiki/pulls).
+* If you spot a bug in the documentation then file an [issue](https://github.com/inspircd/wiki/issues)
+or a [pull request](https://github.com/inspircd/wiki/pulls).
-* If you'd like to talk to us, we're on IRC (of course) on [irc.chatspike.net #inspircd](irc://irc.chatspike.net/inspircd), but please make sure you read the [channel rules](https://github.com/inspircd/wiki/blob/master/IRC-Channel-Rules.md) first!
+* If you'd like to talk to us, we're on IRC (of course) on [irc.chatspike.net #inspircd](irc://irc.chatspike.net/inspircd),
+but please make sure you read the [channel rules](https://github.com/inspircd/wiki/blob/master/IRC-Channel-Rules.md)
+first!
View
17 SNOMASK.md
@@ -1,15 +1,18 @@
Configuring SNOMASKs
--------------------
-To set SNOMASKs, set user mode +s with the server notice masks you want as a parameter to the mode. For example, to see local and remote connections and quit notices, execute the following command:
+To set SNOMASKs, set user mode +s with the server notice masks you want as a parameter to the mode.
+For example, to see local and remote connections and quit notices, execute the following command:
/MODE YourNick +s +cCqQ
-To enable automatic setting of SNOMASKs upon opering, load [m_opermodes](https://github.com/inspircd/wiki/blob/master/Modules/opermodes.md) and set the modes in the type block. For example:
+To enable automatic setting of SNOMASKs upon opering, load [m_opermodes](https://github.com/inspircd/wiki/blob/master/Modules/opermodes.md)
+and set the modes in the type block. For example:
<type name="GlobalOp" classes="OperChat BanControl HostCloak Modular" host="globalop.chatspike.net" automodes="+s +cCqQ">
-To remove a SNOMASK, set user mode +s again, but remove masks by sending a 'negative' change. For example, to disable remote connection and quit notices, execute the following command:
+To remove a SNOMASK, set user mode +s again, but remove masks by sending a 'negative' change. For
+example, to disable remote connection and quit notices, execute the following command:
/MODE YourNick +s -CQ
@@ -22,14 +25,18 @@ A list of the valid server notice masks and what they do is listed below.
Channel Logging
---------------
-You can use the [m_chanlog](https://github.com/inspircd/wiki/blob/master/Modules/chanlog.md) module to send messages to a channel of your choice. You can even have multiple channels for different masks. Use local masks on every server to the same channel to receive messages globally in the channel.
+You can use the [m_chanlog](https://github.com/inspircd/wiki/blob/master/Modules/chanlog.md) module
+to send messages to a channel of your choice. You can even have multiple channels for different
+masks. Use local masks on every server to the same channel to receive messages globally in the
+channel.
Valid Server Notice Masks
-------------------------
### Core Server Notice Masks
-These are the server notice masks implemented by the core. Modules (table #2) may implement extra notice masks.
+These are the server notice masks implemented by the core. Modules (table #2) may implement extra
+notice masks.
SNOTICE Mask | Function
Please sign in to comment.
Something went wrong with that request. Please try again.