From 29fa7549197034a16ead099f06f95c7b5e47fe01 Mon Sep 17 00:00:00 2001 From: jilles Date: Sat, 18 Aug 2007 07:45:10 -0700 Subject: [PATCH] [svn] callerid (+g) documentation: - Mention 005 (isupport) token with possibility of different mode letter. - Explicitly clarify that /accept can be used while -g, and setting -g does not clear the accept list. - Mention that some users may be able to bypass +g. - Mention that /accept may allow more than just going through +g. - Update to 716/717/718 numerics instead of notices. - Clarify that the one-minute period applies to messages from all users, not just one user. - Add a numerics section with more exact syntax. --- ChangeLog | 12 ++++++ doc/modeg.txt | 100 ++++++++++++++++++++++++++++++++++++++++++------ include/serno.h | 2 +- 3 files changed, 102 insertions(+), 12 deletions(-) diff --git a/ChangeLog b/ChangeLog index 7537166..4167a58 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,15 @@ +jilles 2007/08/10 22:31:14 UTC (20070810-3554) + Log: + Send TS6 protocol for the actual work of override modules. + Wallops remain TS5-style for now. + + + Changes: Modified: + +12 -3 trunk/extensions/m_ojoin.c (File Modified) + +3 -1 trunk/extensions/m_okick.c (File Modified) + +6 -2 trunk/extensions/m_opme.c (File Modified) + + nenolod 2007/08/09 06:50:13 UTC (20070809-3552) Log: - update IDEAS as TS6 only is partially done diff --git a/doc/modeg.txt b/doc/modeg.txt index 5680f7e..1e05ed4 100644 --- a/doc/modeg.txt +++ b/doc/modeg.txt @@ -1,5 +1,12 @@ User Mode +g Documentation +Support of this specification is indicated by the CALLERID token in +RPL_ISUPPORT (005). This token takes an optional parameter, of the letter +of the user mode. If no parameter is specified, the user mode is g. A +typical token would be: CALLERID=g +The rest of this specification will assume the user mode is g, as +implemented in hybrid, ratbox and charybdis. + Hybrid 7 includes a new and power feature that all users can take advantage of to help prevent flooding and unwanted messages. This new feature is invoked by setting user mode +g. When a client is set +g, that user will @@ -10,7 +17,7 @@ messaged them, and that they are in +g mode. The target of the message will only receive one notification per minute, from any client, in order to help prevent flooding. The sender will NOT have the -rate limit, and will receive a notice saying the target is in +g mode every +rate limit, and will receive a numeric saying the target is in +g mode every time they send a message. Note that this behavior is similar to the way AWAY messages are done. @@ -48,6 +55,16 @@ Viewing the accept list is also very easy. Issue the raw command ACCEPT *. Removing a user from your accept list is also simple. Issue the command ACCEPT -. +The ACCEPT command can be used whether or not +g is enabled at the time. +Setting -g does not clear the accept list. + +Some users (in particular IRC operators and services) may be exempt from +CallerID, and able to message a +g user without being on their accept list. + +Being on the accept list may allow a user to bypass more than +g (for example, +a +R user can use the ACCEPT command to receive messages from unidentified +users in charybdis). + Sample Session The easiest way to see how this works is by experiencing it. Seeing a sample @@ -61,22 +78,19 @@ Note that some clients may have to use /quote ACCEPT instead of /accept. -- Client Hwy101: /msg Hwy-LL hi -Hwy101 will see: -Hwy-LL- *** I'm in +g mode (server side ignore). - -Hwy-LL- *** I've been informed you messaged me. +Hwy101 will see: -!- Hwy-LL is in +g mode (server-side ignore.) + -!- Hwy-LL has been informed that you messaged them. -Hwy-LL will see: Client Hwy101 [wcampbel@admin.irc.monkie.org] is messaging - you and you are +g - -The sender will receive the NOTICE from the target of the message, while -the recipient will receive the NOTICE from the server. +Hwy-LL will see: -!- Hwy101 wcampbel@admin.irc.monkie.org is messaging you, and you have umode +g. -- If Hwy101 sends another message to Hwy-LL (before the minute expires), he will -see: -Hwy-LL- *** I'm in +g mode (server side ignore). +see: -!- Hwy-LL is in +g mode (server-side ignore.) and will not receive the second notice -Hwy-LL will NOT see any notice. +Hwy-LL will NOT see any notice. This also applies if the second message comes +from a different user. -- @@ -135,6 +149,70 @@ spamming, and to provide users with a means to keep their privacy. We hope that these goals are obtained. +Numeric replies +--------------- + +280 - RPL_ACCEPTLIST +-------------------- +: 280 ... + +This numeric is used to indicate to a client the list of nicknames they are +accepting. At most 15 accepted nicknames may be included; if this is exceeded +multiple RPL_ACCEPTLIST must be sent. + +281 - RPL_ENDOFACCEPT +--------------------- +: 281 :End of /ACCEPT list. + +This numeric is used to indicate to a client the end of an accept list. + +456 - ERR_ACCEPTFULL +-------------------- +: 456 :Accept list is full + +This numeric is used to indicate to a client that their accept list is full +and one or more nicks could not be added. + +457 - ERR_ACCEPTEXIST +--------------------- +: 457 :is already on your accept list + +This numeric is used to indicate to a client that the given nick was already +on their accept list. + +458 - ERR_ACCEPTNOT +------------------- +: 458 :is not on your accept list + +This numeric is used to indicate to a client that the given nick was not on +their accept list. + +716 - ERR_TARGUMODEG +-------------------- +: 716 :is in +g mode (server-side ignore.) + +This numeric is used to indicate that a message (PRIVMSG) the client sent +could not be delivered because of CallerID restrictions. The +parameter is the target user's nick. + +717 - RPL_TARGNOTIFY +-------------------- +: 717 :has been informed that you messaged them. + +This numeric is sent after 716 if the target user was notified of the message. + +718 - RPL_UMODEGMSG +------------------- +: 718 @ :is messaging you, and you have umode +g. + +This numeric is sent when a message (PRIVMSG or NOTICE) sent to the user is +blocked by CallerID, at most once per minute. + +Problem: hybrid uses the following form instead +: 718 [@] :is messaging you, and you have umode +g. +which is ambiguous if the user may contain a [ and in the author's opinion ugly. + -- W. Campbell -$Id: modeg.txt 6 2005-09-10 01:02:21Z nenolod $ +updated by J. Tjoelker +$Id: modeg.txt 3556 2007-08-18 14:45:10Z jilles $ diff --git a/include/serno.h b/include/serno.h index 57831e2..4585acb 100644 --- a/include/serno.h +++ b/include/serno.h @@ -1 +1 @@ -#define SERNO "20070809-3552" +#define SERNO "20070810-3554"