[irc/rqf/shadowircd.git] / doc / tgchange.txt

Target Change for Messages
Lee H <lee -at- leeh.co.uk>
---------------------------

Reworked by Jilles Tjoelker, February 2010.
Channel target change added by Jilles Tjoelker, August 2010.

If the server you are using uses the target change mechanism, then
restrictions are placed on how many different users and/or channels you can
message in a set timeframe.  This also applies to invites (for the target
user) and topic changes.

Target change does not apply to ctcp replies, messages to yourself, messages
to services and joins.

You will have a set number of 'slots', each different target you message
will take up one slot.  A client doing a nick change will not use a new slot,
however a client disconnecting from the server it is on and reconnecting
will.  You will receive 1 new slot roughly every minute.

Additionally, clients that message or invite you are placed in one of a
small number of special slots, in many cases allowing replies without using
a slot.

When all slots are filled, messages to new targets will not be accepted.
Messages to targets already filling a slot will be accepted.  If all slots
are full, you will receive the ERR_TARGCHANGE numeric, number 707 in the
form:
:<server> 707 <yournick> <target> :Targets changing too fast, message dropped

The slots are operated in an LRU (least recently used), so the person or
channel you have talked to least recently will be replaced.

The number of slots in use will be kept through a reconnection, though the
information in those slots will be dropped.  However, you will always
receive one free slot on a reconnection.  Other servers using this mechanism
will also be made aware of details about slots.

Target change does not apply if you are opped or voiced in a channel, and
you are messaging that channel or a client within that channel.  The latter
can be done explicitly using the CNOTICE and CPRIVMSG commands, see
/quote help cnotice and /quote help cprivmsg, but is also implicit in a
normal /msg, /notice or /invite.

--
Commit	Line	Data
212380e3	1	Target Change for Messages
	2	Lee H <lee -at- leeh.co.uk>
	3	---------------------------
	4
04a611e2	5	Reworked by Jilles Tjoelker, February 2010.
9e94d9ea	6	Channel target change added by Jilles Tjoelker, August 2010.
04a611e2	7
212380e3	8	If the server you are using uses the target change mechanism, then
9e94d9ea JT	9	restrictions are placed on how many different users and/or channels you can
	10	message in a set timeframe. This also applies to invites (for the target
	11	user) and topic changes.
212380e3	12
9e94d9ea JT	13	Target change does not apply to ctcp replies, messages to yourself, messages
9e94d9ea JT	14	to services and joins.
212380e3	15
9e94d9ea	16	You will have a set number of 'slots', each different target you message
212380e3	17	will take up one slot. A client doing a nick change will not use a new slot,
4d17e288 JT	18	however a client disconnecting from the server it is on and reconnecting
4d17e288 JT	19	will. You will receive 1 new slot roughly every minute.
212380e3	20
04a611e2 JT	21	Additionally, clients that message or invite you are placed in one of a
	22	small number of special slots, in many cases allowing replies without using
	23	a slot.
	24
9e94d9ea JT	25	When all slots are filled, messages to new targets will not be accepted.
9e94d9ea JT	26	Messages to targets already filling a slot will be accepted. If all slots
212380e3	27	are full, you will receive the ERR_TARGCHANGE numeric, number 707 in the
212380e3	28	form:
9e94d9ea	29	:<server> 707 <yournick> <target> :Targets changing too fast, message dropped
212380e3	30
9e94d9ea JT	31	The slots are operated in an LRU (least recently used), so the person or
9e94d9ea JT	32	channel you have talked to least recently will be replaced.
212380e3	33
	34	The number of slots in use will be kept through a reconnection, though the
	35	information in those slots will be dropped. However, you will always
	36	receive one free slot on a reconnection. Other servers using this mechanism
	37	will also be made aware of details about slots.
	38
04a611e2	39	Target change does not apply if you are opped or voiced in a channel, and
9e94d9ea JT	40	you are messaging that channel or a client within that channel. The latter
	41	can be done explicitly using the CNOTICE and CPRIVMSG commands, see
	42	/quote help cnotice and /quote help cprivmsg, but is also implicit in a
	43	normal /msg, /notice or /invite.
212380e3	44
212380e3	45	--