RageIRCd v2.0 (bluemoon): Privacy Mode
--------------------------------------

$Id: privacy-mode.txt,v 1.4.2.1 2005/02/21 02:32:45 amcwilliam Exp $
(C) 2000-2005 the RageIRCd Development Team, all rights reserved.

NB: Some references from hybrid-7/doc/modeg.txt.

RageIRCd v2.0 includes a new "privacy mode", inspired by ircd-hybrid-7s 
"Caller ID" mode. This allows all users to control who can and cannot 
send them private messages, therefore protecting themselves against any 
message flooders or unwanted messages.

Clients can take advantage of this new feature by setting usermode +p. 
This will then block any messages to the target user from all 
non-operators and non-ulines. The server will then send the target client 
a message saying the source client attempted to message them. The 
frequency of this message is set by flood::accept_notice_time, to protect 
against flooding. However, the source client will receive a notice saying 
their message was blocked each time they attempt to message the target.

This is all very well, but, what if there is somone you want to talk to, 
whilst still being able to block everyone else out? Well, this is where 
the power of RageIRCd v2's privacy mode kicks in. Instead of being forced 
to unset +p, and open yourself to flooding, you can use the ACCEPT command 
to 'accept' messages from users you select. The ACCEPT syntax is as 
follows.

   * /quote accept +user1,user2,user3...
     - adds specified users to accept list (hense the '+' prefix)
   * /quote accept -user1,user2,user3...
     - removes specified users from accept list (hense the '-' prefix)
   * /quote accept list
     - lists clients currently on the accept list
   * /quote accept help
     - displays accept help

You can also add and remove users at the same time within one call to 
ACCEPT. Simply prefix nicknames with either '+' or '-' depending on 
whether you want to add or remove them. For example:

   * /quote accpet +user1,-user2,+user3,-user4

Once a client is added, they are free to message the target client freely, 
until such time as the accept list references are removed. Accept list 
references are removed if either of the following situations become true:

   * either source or target client QUIT (or if either are lost in a 
     network split).
   * source client changes their nickname (to prevent user tracking).

Privacy mode is similar to DALnet and Undernet's SILENCE system in the 
sence that it will only work whilst you are connected to IRC. Once you 
disconnect, all references will be removed. If you want your accept list 
to be restored each time you are on IRC, you will have to either issue the 
commands manually, or add them to your chat client's auto-perform. 
However, privacy mode is also the complete reverse of SILENCE. Where as 
SILENCE would ignore specific clients, and allow messages from everyone 
else, ACCEPT will only allow messages from specific clients, and will 
ignore messages from everyone else.

End of document.
