]>
Commit | Line | Data |
---|---|---|
c8ca69a0 | 1 | ************************************** |
ca3486a2 | 2 | *** X3 IRC Services *** |
c8ca69a0 | 3 | ************************************** |
4 | *** IMPORTANT UPGRADE INSTRUCTIONS *** | |
5 | ************************************** | |
1136f709 | 6 | Upgrading from X3 1.6 |
7 | ------------------------------------------------------------------------------- | |
8 | ||
9 | Core changes: | |
10 | ||
11 | * There is a new mod-qserver module that allows direct connections to | |
12 | X3. There is no documentation on the protocol, but the file is | |
13 | under 250 lines long, so it shouldn't be hard to figure out. | |
14 | ||
15 | * There is a new mod-blacklist module that allows a blacklist based | |
16 | on DNSBLs and IP- and host-based text files. See x3.conf.example | |
17 | for details on how to configure this module. | |
18 | ||
19 | * Commands that use security overrides can be logged more easily. | |
20 | This includes, among many other things, adding or removing users in | |
21 | channels where the staff user would not normally have the necessary | |
22 | access. These can be selected with the "staff" and "override" log | |
23 | levels. | |
24 | ||
25 | * The database writing code has been rewritten because the previous | |
26 | code performed much worse (for an unknown reason) on 64-bit | |
27 | machines than on 32-bit machines. Now it is faster than ever on | |
28 | both types. | |
29 | ||
30 | * The logger now avoids recursive logging to the same destination. | |
31 | ||
32 | * G-lines support the last-modification syntax introduced in | |
33 | ircu2.10.12.11. | |
34 | ||
35 | * X3 now re-reads translations from its "languages" directory on a | |
36 | ?rehash. | |
37 | ||
38 | * X3 now re-reads its own server name and description on a ?rehash. | |
39 | ||
40 | * X3 has several implementations of the ioset event loop | |
41 | (ioset-epoll.c, ioset-kevent.c, ioset-select.c, ioset-win32.c). | |
42 | The most efficient one supported by the OS should be selected | |
43 | automatically. | |
44 | ||
45 | * X3 has several implementations of its mail sending utility | |
46 | (mail-sendmail.c, mail-smtp.c). The sendmail implementation is | |
47 | used on configure-based builds, and the SMTP implementation is used | |
48 | on mingw/Win32 native builds. | |
49 | ||
50 | ChanServ changes: | |
51 | ||
52 | * Do-not-register (DNR) entries now have an expiration time. The | |
53 | duration can be set to 0 to create a permanent entry; this is the | |
54 | default for pre-1.4 DNRs. There is also a DNR search command that | |
55 | should be bound to ChanServ (/msg OpServ bind ChanServ dnrsearch | |
56 | *ChanServ.dnrsearch; likewise for its actions: dnrsearch\ print, | |
57 | dnrsearch\ remove and dnrsearch\ count). | |
58 | ||
59 | * Kick, ban and unban commands will now accept arguments of the form | |
60 | *ACCOUNT, affecting users with that account name. | |
61 | ||
62 | * The default titles "IRCOp", "network helper" and "support helper" | |
63 | can be localized using "CSMSG_OPERATOR_TITLE", "CSMSG_UC_H_TITLE" | |
64 | and "CSMSG_LC_H_TITLE" respectively. | |
65 | ||
66 | * The BANS command can search for users affected by a ban in addition | |
67 | to searching for matching ban patterns. | |
68 | ||
69 | * The SAY and EMOTE commands will now accept arguments of the form | |
70 | *ACCOUNT. | |
71 | ||
72 | * There is a new channel flag, Unreviewed, that can distinguish | |
73 | between automatically registered channels that have been reviewed | |
74 | against network policies by staff and those that have not. The | |
75 | "unreviewed" search criteria can select channels without this flag. | |
76 | (/msg OpServ bind ChanServ set\ unreviewed *ChanServ.set\ | |
77 | unreviewed; likewise for its values: set\ unreviewed\ on and set\ | |
78 | unreviewed\ off.) | |
79 | ||
80 | * Changing the AutoInvite user option will warn if the user does not | |
81 | have enough access in the channel to be automatically invited. | |
82 | ||
83 | * The GIVEOWNERSHIP command requires a confirmation code. | |
84 | ||
85 | * ChanServ's event handling functions are only registered if it has a | |
86 | nickname set. This makes it easier to disable ChanServ in one | |
87 | instance of X3. There are a few related changes in modcmd.c's | |
88 | permission and flag checks. | |
89 | ||
90 | NickServ changes: | |
91 | ||
92 | * Notes on an account are now supported. (/msg OpServ bind NickServ | |
93 | notes *NickServ.notes; likewise for the related addnote and delnote | |
94 | commands.) | |
95 | ||
96 | * The new command CHECKEMAIL has been added to allow helpers to check | |
97 | whether an account's email address matches one known to the helper. | |
98 | This allows email visibility to remain limited. | |
99 | ||
100 | * The OUNREGISTER command now has two configuration options that may | |
101 | require a "force" parameter to be used: "ounregister_inactive" and | |
102 | "ounregister_flags". See X3.conf.example for details. | |
103 | ||
104 | OpServ changes: | |
105 | ||
106 | * IPs with trusts or with active opers are protected from being | |
107 | accidentally affected by G-lines, TRACE KILL and TRACE GAG. The | |
108 | "abuse" pseudo-criterion for TRACE now has a "trusted" option to | |
109 | override trusted IP protection (in addition to the previous, and | |
110 | independent, "opers" option). | |
111 | ||
112 | * The BLOCK command takes an optional duration after the target. | |
113 | Using this requires the same access level as the GLINE command. | |
114 | ||
115 | * There is a new FORCEKICK command that will allow opers to kick | |
116 | anyone (including remote +k users) from a channel. | |
117 | ||
118 | * The STATS GLINE command now accepts an optional target, to have it | |
119 | show the first known G-line matching that target. | |
120 | ||
121 | * X3 will no longer crash in OpServ's join checks if no OpServ bot | |
122 | is instantiated. | |
123 | ||
124 | * The TRACE command will now allow more than one "channel" criterion | |
125 | to be specified. It also accepts a "target" pseudo-criterion that | |
126 | contains the name of a channel to receive the output. | |
127 | ||
128 | -------------------------------------------------------------------------------------------- | |
c8ca69a0 | 129 | From srvx 1.4: |
130 | Rename srvx.conf to x3.conf | |
131 | Review .conf file settings. | |
132 | * remove giveops, givevoice from set_shows and add "Voice" above "Protect". | |
133 | * you can change from srvx.db to x3.db here also (dont forget to rename the file) | |
134 | Run all of the steps below | |
135 | ||
c8ca69a0 | 136 | |
c8273589 | 137 | ***************************** |
c8ca69a0 | 138 | NOTE about command bindings: |
c8273589 | 139 | ***************************** |
140 | From srvx to x3, and within versions of x3, some commands have changed. When you upgrade | |
141 | your .db file may not have command bindings for new command names. I have added a command | |
142 | to help make solving this easy. | |
143 | If you don't have the 'rebindall' command bound, first bind it: | |
144 | /msg O3 bind o3 * *modcmd.* | |
145 | Then, after any upgrade, or after adding modules, or changing command effecting settings | |
146 | such as 'email', you can simply run: | |
147 | /msg O3 rebindall | |
148 | to ensure you have all the latest commands bound on all services. | |
149 | ||
150 | You may do: 'bind nick * *module.*' to re-bind ALL builtin commands on a givin module, | |
151 | (chanserv, opserv, nickserv, modcmd, etc) if you prefer to update them individually | |
152 | (if you unbind some default commands, and want them to stay unbound). | |
c8ca69a0 | 153 | Alternatively you can edit the .db by hand or using the 'bind' command on irc. |
c8273589 | 154 | NOTE: You will need to shut down x3 gracefully (using the die or restart commands) |
c8ca69a0 | 155 | after binding in order for 'set' and 'uset' subcommand changes to function properly since |
c8273589 | 156 | the listings are cached. |
157 | ||
158 | ********************************************* | |
159 | *** Steps needed, by version: | |
160 | *** note, binding can be taken care of | |
161 | *** according to the note above. | |
162 | ********************************************* | |
163 | As of CVS version 1.24: | |
164 | bind chanserv commands: uset autoop, and set voice | |
165 | ||
166 | As of CVS version 1.29: | |
167 | bind chanserv commands: addlamer, dellamer, addtimedlamer, lamers, and llist | |
168 | bind opserv commands: rebindall | |
169 | ||
170 |