]> jfr.im git - irc/quakenet/snircd.git/blame - doc/snomask.html
import of 2.10.12.05
[irc/quakenet/snircd.git] / doc / snomask.html
CommitLineData
189935b1 1<html>\r
2<head>\r
3<title>SNOMASK - Server Notice Masks</title>\r
4</head>\r
5<body bgcolor=#FFFFFF text=#000000 link=#700000 vlink=#404040>\r
6<center>\r
7<font face="arial">\r
8<h2>SNOMASK - Server Notice Masks</h2></font>\r
9<font face="arial" size="2">\r
10Written by <a href="mailto:foxxe@trms.com">Ghostwolf</a> 18th June 1997<br>\r
11Modified with permission by <a href="mailto:loki@undernet.org">loki</a> 12th November 1997\r
12</center>\r
13<p><hr width="80%" noshade>\r
14\r
15<blockquote>\r
16This document (hopefully) gives a brief explanation of the use of server\r
17notice masks new to ircu2.10.00. This mask allows clients to specify which\r
18types of server notices they will receive when usermode +s. The mask may\r
19optionally be omitted, and reasonable defaults will be used by the server.\r
20<p>\r
21Note: the descriptions here will be best understood by those with knowledge\r
22of C syntax. We do not attempt to explain either this or hexadecimal values\r
23in this document, and familiarity with these is assumed of the reader.\r
24<p>\r
25Usage:\r
26</font><kbd><strong>\r
27/mode &lt;nick&gt; +s [+/-][mask]</kbd></strong>\r
28<font face="arial" size="2">\r
29<p>\r
30<center>\r
31<table border=0 cellspacing=5 cellpadding=0 width=85%>\r
32<tr align=center valign=middle>\r
33<th align=left><font face="arial" size="2">Mask</th>\r
34<th align=left>&nbsp;</th>\r
35<th align=left><font face="arial" size="2">Hex value</th>\r
36<th align=left><font face="arial" size="2">Description</th>\r
37</tr>\r
38<tr>\r
39<td><font face="arial" size="2">1</td>\r
40<td><font face="arial" size="2">SNO_OLDSNO</td>\r
41<td><font face="arial" size="2">0x1</td>\r
42<td><font face="arial" size="2">/* unsorted old messages */</td>\r
43</tr>\r
44<tr>\r
45<td><font face="arial" size="2">2</td>\r
46<td><font face="arial" size="2">SNO_SERVKILL</td>\r
47<td><font face="arial" size="2">0x2</td>\r
48<td><font face="arial" size="2">/* server kills (nick collisions) */</td>\r
49</tr>\r
50<tr>\r
51<td><font face="arial" size="2">4</td>\r
52<td><font face="arial" size="2">SNO_OPERKILL</td>\r
53<td><font face="arial" size="2">0x4</td>\r
54<td><font face="arial" size="2">/* oper kills */</td>\r
55</tr>\r
56<tr>\r
57<td><font face="arial" size="2">8</td>\r
58<td><font face="arial" size="2">SNO_HACK2</td>\r
59<td><font face="arial" size="2">0x8</td>\r
60<td><font face="arial" size="2">/* desyncs */</td>\r
61</tr>\r
62<tr>\r
63<td><font face="arial" size="2">16</td>\r
64<td><font face="arial" size="2">SNO_HACK3\r
65<td><font face="arial" size="2">0x10</td>\r
66<td><font face="arial" size="2">/* temporary desyncs */</td>\r
67</tr>\r
68<tr>\r
69<td><font face="arial" size="2">32</td>\r
70<td><font face="arial" size="2">SNO_UNAUTH</td>\r
71<td><font face="arial" size="2">0x20</td>\r
72<td><font face="arial" size="2">/* unauthorized connections */</td>\r
73</tr>\r
74<tr>\r
75<td><font face="arial" size="2">64</td>\r
76<td><font face="arial" size="2">SNO_TCPCOMMON</td>\r
77<td><font face="arial" size="2">0x40</td>\r
78<td><font face="arial" size="2">/* common TCP or socket errors */</td>\r
79</tr>\r
80<tr>\r
81<td><font face="arial" size="2">128</td>\r
82<td><font face="arial" size="2">SNO_TOOMANY</td>\r
83<td><font face="arial" size="2">0x80</td>\r
84<td><font face="arial" size="2">/* too many connections */</td>\r
85</tr>\r
86<tr>\r
87<td><font face="arial" size="2">256</td>\r
88<td><font face="arial" size="2">SNO_HACK4</td>\r
89<td><font face="arial" size="2">0x100</td>\r
90<td><font face="arial" size="2">/* Uworld actions on channels */</td>\r
91</tr>\r
92<tr>\r
93<td><font face="arial" size="2">512</td>\r
94<td><font face="arial" size="2">SNO_GLINE</td>\r
95<td><font face="arial" size="2">0x200</td>\r
96<td><font face="arial" size="2">/* glines */</td>\r
97</tr>\r
98<tr>\r
99<td><font face="arial" size="2">1024</td>\r
100<td><font face="arial" size="2">SNO_NETWORK</td>\r
101<td><font face="arial" size="2">0x400</td>\r
102<td><font face="arial" size="2">/* net join/break, etc */</td>\r
103</tr>\r
104<tr>\r
105<td><font face="arial" size="2">2048</td>\r
106<td><font face="arial" size="2">SNO_IPMISMATCH</td>\r
107<td><font face="arial" size="2">0x800</td>\r
108<td><font face="arial" size="2">/* IP mismatches */</td>\r
109</tr>\r
110<tr>\r
111<td><font face="arial" size="2">4096</td>\r
112<td><font face="arial" size="2">SNO_THROTTLE</td>\r
113<td><font face="arial" size="2">0x1000</td>\r
114<td><font face="arial" size="2">/* host throttle add/remove notices */</td>\r
115</tr>\r
116<tr>\r
117<td><font face="arial" size="2">8192</td>\r
118<td><font face="arial" size="2">SNO_OLDREALOP</td>\r
119<td><font face="arial" size="2">0x2000</td>\r
120<td><font face="arial" size="2">/* old oper-only messages */</td>\r
121</tr>\r
122<tr>\r
123<td><font face="arial" size="2">16384</td>\r
124<td><font face="arial" size="2">SNO_CONNEXIT</td>\r
125<td><font face="arial" size="2">0x4000</td>\r
126<td><font face="arial" size="2">/* client connect/exit (ugh) */</td>\r
127</tr>\r
128<tr>\r
129<td><font face="arial" size="2">32768</td>\r
130<td><font face="arial" size="2">SNO_AUTO</td>\r
131<td><font face="arial" size="2">0x8000</td>\r
132<td><font face="arial" size="2">/* AUTO G-Lines */</td>\r
133</tr>\r
134<tr>\r
135<td><font face="arial" size="2">65536</td>\r
136<td><font face="arial" size="2">SNO_DEBUG</td>\r
137<td><font face="arial" size="2">0x10000</td>\r
138<td><font face="arial" size="2">/* debugging messages (DEBUGMODE only) */</td>\r
139</tr>\r
140</table>\r
141</center>\r
142\r
143<p>\r
144\r
145<table border=0 cellpadding=0 cellspacing=5 width=90%>\r
146<tr>\r
147<td><font face="arial" size="2">standard +s</td>\r
148<td><font face="arial" size="2">SNO_DEFAULT (SNO_NETWORK | SNO_OPERKILL | SNO_GLINE)</td>\r
149</tr>\r
150<tr>\r
151<td><font face="arial" size="2">standard +s when +o/O</td>\r
152<td><font face="arial" size="2">SNO_DEFAULT | SNO_HACK2 | SNO_HACK4 | SNO_THROTTLE | SNO_OLDSNO)</td>\r
153</tr>\r
154<tr>\r
155<td><font face="arial" size="2">only opers may set</td>\r
156<td><font face="arial" size="2">SNO_OPER (SNO_CONNEXIT | SNO_OLDREALOP)</td>\r
157</tr>\r
158</table>\r
159\r
160<p><hr width="80%" noshade>\r
161<h3 align=center>Examples of Usage</h3>\r
162To receive only operkills, use /mode <nick> +s 4<br>\r
163To receive operkills and glines, add the values:\r
164</font>\r
165<blockquote><kbd><strong>\r
166/mode &lt;nick&gt; +s 516</kbd></strong><p>\r
167<font face="arial" size="2">\r
168(512+4=516)\r
169</blockquote>\r
170<p>\r
171If you are already receiving some notices and you wish to add notices of\r
172netjoins/breaks use:\r
173</font>\r
174<blockquote><kbd><strong>\r
175/mode Ghostwolf +s +1024</kbd></strong><p>\r
176</blockquote>\r
177<font face="arial" size="2">\r
178<p>\r
179If you wish to stop receiving netjoin/break notices, but continue to receive\r
180other notices, use:\r
181</font>\r
182<blockquote><kbd><strong>\r
183/mode Ghostwolf +s -1024<br>\r
184 OR<br>\r
185/mode Ghostwolf -s +1024</kbd></strong>\r
186</blockquote>\r
187<font face="arial" size="2">\r
188<p>\r
189A user typing <strong>/mode Ghostwolf +s </strong>will receive netsplits/joins, operkills, and g-lines.<p>\r
190\r
191Opers who are +s will additionally receive HACK notices and anything that\r
192was originally in sendto_ops() and wasn't changed. Only opers can choose to\r
193receive connect/exit notices and anything that originally was in\r
194sendtoreal_ops() and hasn't been changed (connect/exit notices also require\r
195a #define in config.h).\r
196<p>\r
197</font><center>\r
198<hr width=80% noshade><font size=-1><strong>\r
199If you have further questions about server notices (implementation, etc.),<br>\r
200please consult the ircu source code and/or e-mail <a\r
201href="mailto:coder-com@undernet.org">coder-com@undernet.org</a>.\r
202</strong></font></center>\r
203<hr width="80%" noshade><p>\r
204\r
205<p align="right">\r
206<em>\r
207<font face="times new roman" font size="-1">\r
208Return to <a href="http://www.user-com.undernet.org/documents/" target="nfo">main Documents Project page</a><br>\r
209</em>\r
210</font>\r
211\r
212</body>\r
213</html>\r
214\r
215\r