1 /* mod-helpserv.c - Support Helper assistant service
2 * Copyright 2002-2003 srvx Development Team
4 * This file is part of x3.
6 * srvx is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License as published by
8 * the Free Software Foundation; either version 2 of the License, or
9 * (at your option) any later version.
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
16 * You should have received a copy of the GNU General Public License
17 * along with srvx; if not, write to the Free Software Foundation,
18 * Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
21 /* Wishlist for helpserv.c
22 * - Make HelpServ send unassigned request count to helpers as they join the
25 * - Get cmd_statsreport to sort by time and show requests closed
26 * - .. then make statsreport show weighted combination of time and requests closed :)
27 * - Something for users to use a subset of commands... like closing their
28 * own request(s), viewing what they've sent so far, and finding their
30 * - It would be nice to have some variable expansions for the custom
31 * request open/close/etc messages. ${request/id}, etc
32 * - Allow manipulation of the persist types on a per-request basis... so
33 * if it's normally set to close requests after a user quits, but there
34 * is a long-term issue, then that single request can remain
46 #define HELPSERV_CONF_NAME "modules/helpserv"
47 #define HELPSERV_HELPFILE_NAME "mod-helpserv.help"
48 const char *helpserv_module_deps
[] = { NULL
};
51 #define KEY_BOTS "bots"
52 #define KEY_LAST_STATS_UPDATE "last_stats_update"
53 #define KEY_NICK "nick"
54 #define KEY_DB_BADCHANS "badchans"
55 #define KEY_HELP_CHANNEL "help_channel"
56 #define KEY_PAGE_DEST "page_dest"
57 #define KEY_CMDWORD "cmdword"
58 #define KEY_PERSIST_LENGTH "persist_length"
59 #define KEY_REGISTERED "registered"
60 #define KEY_REGISTRAR "registrar"
61 #define KEY_IDWRAP "id_wrap"
62 #define KEY_REQ_MAXLEN "req_maxlen"
63 #define KEY_LAST_REQUESTID "last_requestid"
64 #define KEY_HELPERS "users"
65 #define KEY_HELPER_LEVEL "level"
66 #define KEY_HELPER_HELPMODE "helpmode"
67 #define KEY_HELPER_WEEKSTART "weekstart"
68 #define KEY_HELPER_STATS "stats"
69 #define KEY_HELPER_STATS_TIME "time"
70 #define KEY_HELPER_STATS_PICKUP "picked_up"
71 #define KEY_HELPER_STATS_CLOSE "closed"
72 #define KEY_HELPER_STATS_REASSIGNFROM "reassign_from"
73 #define KEY_HELPER_STATS_REASSIGNTO "reassign_to"
74 #define KEY_REQUESTS "requests"
75 #define KEY_REQUEST_HELPER "helper"
76 #define KEY_REQUEST_ASSIGNED "assigned"
77 #define KEY_REQUEST_HANDLE "handle"
78 #define KEY_REQUEST_TEXT "text"
79 #define KEY_REQUEST_OPENED "opened"
80 #define KEY_REQUEST_NICK "nick"
81 #define KEY_REQUEST_USERHOST "userhost"
82 #define KEY_REQUEST_CLOSED "closed"
83 #define KEY_REQUEST_CLOSEREASON "closereason"
84 #define KEY_NOTIFICATION "notification"
85 #define KEY_PRIVMSG_ONLY "privmsg_only"
86 #define KEY_REQ_ON_JOIN "req_on_join"
87 #define KEY_AUTO_VOICE "auto_voice"
88 #define KEY_AUTO_DEVOICE "auto_devoice"
89 #define KEY_LAST_ACTIVE "last_active"
92 #define HSFMT_TIME "%a, %d %b %Y %H:%M:%S %Z"
93 static const struct message_entry msgtab
[] = {
94 { "HSMSG_READHELP_SUCCESS", "Read HelpServ help database in "FMT_TIME_T
".%03ld seconds." },
95 { "HSMSG_INVALID_BOT", "This command requires a valid HelpServ bot name." },
96 { "HSMSG_ILLEGAL_CHANNEL", "$b%s$b is an illegal channel; cannot use it." },
97 { "HSMSG_INTERNAL_COMMAND", "$b%s$b appears to be an internal HelpServ command, sorry." },
98 { "HSMSG_NOT_IN_USERLIST", "%s lacks access to $b%s$b." },
99 { "HSMSG_LEVEL_TOO_LOW", "You lack access to this command." },
100 { "HSMSG_OPER_CMD", "This command can only be executed via $O." },
101 { "HSMSG_WTF_WHO_ARE_YOU", "$bUnable to find you on the %s userlist.$b This is a bug. Please report it." },
102 { "HSMSG_NO_USE_OPSERV", "This command cannot be used via $O. If you really need to use it, add yourself to the userlist." },
103 { "HSMSG_OPSERV_NEED_USER", "To use this command via $O, you must supply a user to target." },
104 { "HSMSG_PAGE_REQUEST", "Page from $b%s$b: $b%s$b" },
105 { "HSMSG_BAD_REQ_TYPE", "I don't know how to list $b%s$b requests." },
108 { "HSMSG_GREET_EXISTING_REQ", "Welcome back to %s. You have already opened request ID#%lu. Any messages you send to $S will be appended to that request." },
109 { "HSMSG_GREET_PRIVMSG_EXISTREQ", "Hello again. Your account has a previously opened request ID#%lu. This message and any further messages you send to $S will be appended to that request." },
111 /* User Management */
112 { "HSMSG_CANNOT_ADD", "You do not have permission to add users." },
113 { "HSMSG_CANNOT_DEL", "You do not have permission to delete users." },
114 { "HSMSG_CANNOT_CLVL", "You do not have permission to modify users' access." },
115 { "HSMSG_NO_SELF_CLVL", "You cannot change your own access." },
116 { "HSMSG_NO_BUMP_ACCESS", "You cannot give users the same or more access than yourself." },
117 { "HSMSG_NO_TRANSFER_SELF", "You cannot give ownership to your own account." },
118 { "HSMSG_ADDED_USER", "Added new $b%s$b %s to the user list." },
119 { "HSMSG_DELETED_USER", "Deleted $b%s$b %s from the user list." },
120 { "HSMSG_USER_EXISTS", "$b%s$b is already on the user list." },
121 { "HSMSG_INVALID_ACCESS", "$b%s$b is an invalid access level." },
122 { "HSMSG_CHANGED_ACCESS", "%s now has $b%s$b access." },
123 { "HSMSG_EXPIRATION_DONE", "%d eligible HelpServ bots have retired." },
124 { "HSMSG_BAD_WEEKDAY", "I do not know which day of the week $b%s$b is." },
125 { "HSMSG_WEEK_STARTS", "$b%s$b's weeks start on $b%s$b." },
128 { "HSMSG_ILLEGAL_NICK", "$b%s$b is an illegal nick; cannot use it." },
129 { "HSMSG_NICK_EXISTS", "The nick %s is in use by someone else." },
130 { "HSMSG_REG_SUCCESS", "%s now has ownership of bot %s." },
131 { "HSMSG_NEED_UNREG_CONFIRM", "To unregister this bot, you must /msg $S unregister CONFIRM" },
132 { "HSMSG_ERROR_ADDING_SERVICE", "Error creating new user $b%s$b." },
135 { "HSMSG_RENAMED", "%s has been renamed to $b%s$b." },
136 { "HSMSG_MOVE_SAME_CHANNEL", "You cannot move %s to the same channel it is on." },
137 { "HSMSG_INVALID_MOVE", "$b%s$b is not a valid nick or channel name." },
138 { "HSMSG_NEED_GIVEOWNERSHIP_CONFIRM", "To transfer ownership of this bot, you must /msg $S giveownership newowner CONFIRM" },
139 { "HSMSG_MULTIPLE_OWNERS", "There is more than one owner of %s; please use other commands to change ownership." },
140 { "HSMSG_NO_TRANSFER_SELF", "You cannot give ownership to your own account." },
141 { "HSMSG_OWNERSHIP_GIVEN", "Ownership of $b%s$b has been transferred to account $b%s$b." },
144 { "HSMSG_INVALID_OPTION", "$b%s$b is not a valid option." },
145 { "HSMSG_QUEUE_OPTIONS", "HelpServ Queue Options:" },
146 { "HSMSG_SET_COMMAND_TYPE", "$bPageType $b %s" },
147 { "HSMSG_SET_ALERT_TYPE", "$bAlertPageType $b %s" },
148 { "HSMSG_SET_STATUS_TYPE", "$bStatusPageType $b %s" },
149 { "HSMSG_SET_COMMAND_TARGET", "$bPageTarget $b %s" },
150 { "HSMSG_SET_ALERT_TARGET", "$bAlertPageTarget $b %s" },
151 { "HSMSG_SET_STATUS_TARGET", "$bStatusPageTarget$b %s" },
152 { "HSMSG_SET_GREETING", "$bGreeting $b %s" },
153 { "HSMSG_SET_REQOPENED", "$bReqOpened $b %s" },
154 { "HSMSG_SET_REQASSIGNED", "$bReqAssigned $b %s" },
155 { "HSMSG_SET_REQCLOSED", "$bReqClosed $b %s" },
156 { "HSMSG_SET_IDLEDELAY", "$bIdleDelay $b %s" },
157 { "HSMSG_SET_WHINEDELAY", "$bWhineDelay $b %s" },
158 { "HSMSG_SET_WHINEINTERVAL", "$bWhineInterval $b %s" },
159 { "HSMSG_SET_EMPTYINTERVAL", "$bEmptyInterval $b %s" },
160 { "HSMSG_SET_STALEDELAY", "$bStaleDelay $b %s" },
161 { "HSMSG_SET_REQPERSIST", "$bReqPersist $b %s" },
162 { "HSMSG_SET_HELPERPERSIST", "$bHelperPersist $b %s" },
163 { "HSMSG_SET_NOTIFICATION", "$bNotification $b %s" },
164 { "HSMSG_SET_IDWRAP", "$bIDWrap $b %d" },
165 { "HSMSG_SET_REQMAXLEN", "$bReqMaxLen $b %d" },
166 { "HSMSG_SET_PRIVMSGONLY", "$bPrivmsgOnly $b %s" },
167 { "HSMSG_SET_REQONJOIN", "$bReqOnJoin $b %s" },
168 { "HSMSG_SET_AUTOVOICE", "$bAutoVoice $b %s" },
169 { "HSMSG_SET_AUTODEVOICE", "$bAutoDevoice $b %s" },
170 { "HSMSG_PAGE_NOTICE", "notice" },
171 { "HSMSG_PAGE_PRIVMSG", "privmsg" },
172 { "HSMSG_PAGE_ONOTICE", "onotice" },
173 { "HSMSG_LENGTH_PART", "part" },
174 { "HSMSG_LENGTH_QUIT", "quit" },
175 { "HSMSG_LENGTH_CLOSE", "close" },
176 { "HSMSG_NOTIFY_DROP", "ReqDrop" },
177 { "HSMSG_NOTIFY_USERCHANGES", "UserChanges" },
178 { "HSMSG_NOTIFY_ACCOUNTCHANGES", "AccountChanges" },
179 { "HSMSG_INVALID_INTERVAL", "Sorry, %s must be at least %s." },
180 { "HSMSG_0_DISABLED", "0 (Disabled)" },
181 { "HSMSG_NEED_MANAGER", "Only managers or higher can do this." },
182 { "HSMSG_SET_NEED_OPER", "This option can only be set by an oper." },
185 { "HSMSG_REQ_INVALID", "$b%s$b is not a valid request ID, or there are no requests for that nick or account." },
186 { "HSMSG_REQ_NOT_YOURS_ASSIGNED_TO", "Request $b%lu$b is not assigned to you; it is currently assigned to %s." },
187 { "HSMSG_REQ_NOT_YOURS_UNASSIGNED", "Request $b%lu$b is not assigned to you; it is currently unassigned." },
188 { "HSMSG_REQ_FOUNDMANY", "The user you entered had multiple requests. The oldest one is being used." },
189 { "HSMSG_REQ_CLOSED", "Request $b%lu$b has been closed." },
190 { "HSMSG_REQ_NO_UNASSIGNED", "There are no unassigned requests." },
191 { "HSMSG_USERCMD_NO_REQUEST", "You must have an open request to use a user command." },
192 { "HSMSG_USERCMD_UNKNOWN", "I do not know the user command $b%s$b." },
193 { "HSMSG_REQ_YOU_NOT_IN_HELPCHAN_OPEN", "You cannot open this request as you are not in %s." },
194 { "HSMSG_REQ_YOU_NOT_IN_HELPCHAN", "You cannot be assigned this request as you are not in %s." },
195 { "HSMSG_REQ_HIM_NOT_IN_HELPCHAN", "%s cannot be assigned this request as they are not in %s." },
196 { "HSMSG_REQ_SELF_NOT_IN_OVERRIDE", "You are being assigned this request even though you are not in %s, because the restriction was overridden (you are a manager or owner). If you join and then part, this request will be marked unassigned." },
197 { "HSMSG_REQ_YOU_NOT_IN_OVERRIDE", "Note: You are being assigned this request even though you are not in %s, because the restriction was overridden by a manager or owner. If you join and then part, this request will be marked unassigned." },
198 { "HSMSG_REQ_HIM_NOT_IN_OVERRIDE", "Note: %s is being assigned this request even though they are not in %s, because the restriction was overridden (you are a manager or owner). If they join and then part, this request will be marked unassigned." },
199 { "HSMSG_REQ_ASSIGNED_YOU", "You have been assigned request ID#%lu:" },
200 { "HSMSG_REQ_REASSIGNED", "You have been assigned request ID#%lu (reassigned from %s):" },
201 { "HSMSG_REQ_INFO_1", "Request ID#%lu:" },
202 { "HSMSG_REQ_INFO_2a", " - Nick %s / Account %s" },
203 { "HSMSG_REQ_INFO_2b", " - Nick %s / Not authed" },
204 { "HSMSG_REQ_INFO_2c", " - Online somewhere / Account %s" },
205 { "HSMSG_REQ_INFO_2d", " - Not online / Account %s" },
206 { "HSMSG_REQ_INFO_2e", " - Not online / No account" },
207 { "HSMSG_REQ_INFO_3", " - Opened at %s (%s ago)" },
208 { "HSMSG_REQ_INFO_4", " - Message:" },
209 { "HSMSG_REQ_INFO_MESSAGE", " %s" },
210 { "HSMSG_REQ_ASSIGNED", "Your helper for request ID#%lu is %s (Current nick: %s)" },
211 { "HSMSG_REQ_ASSIGNED_AGAIN", "Your helper for request ID#%lu has been changed to %s (Current nick: %s)" },
212 { "HSMSG_REQ_UNASSIGNED", "Your helper for request ID#%lu has %s, so your request is no longer being handled by them. It has been placed near the front of the unhandled request queue, based on how long ago your request was opened." },
213 { "HSMSG_REQ_NEW", "Your message has been recorded and assigned request ID#%lu. A helper should contact you shortly." },
214 { "HSMSG_REQ_NEWONJOIN", "Welcome to %s. You have been assigned request ID#%lu. A helper should contact you shortly." },
215 { "HSMSG_REQ_UNHANDLED_TIME", "The oldest unhandled request has been waiting for %s." },
216 { "HSMSG_REQ_NO_UNHANDLED", "There are no other unhandled requests." },
217 { "HSMSG_REQ_PERSIST_QUIT", "Everything you tell me until you are helped (or you quit) will be recorded. If you disconnect, your request will be lost." },
218 { "HSMSG_REQ_PERSIST_PART", "Everything you tell me until you are helped (or you leave %s) will be recorded. If you part %s, your request will be lost." },
219 { "HSMSG_REQ_PERSIST_HANDLE", "Everything you tell me until you are helped will be recorded." },
220 { "HSMSG_REQ_MAXLEN", "Sorry, but your request has reached the maximum number of lines. Please wait to be assigned to a helper and continue explaining your request to them." },
221 { "HSMSQ_REQ_TEXT_ADDED", "Message from $b%s:$b %s" },
222 { "HSMSG_REQ_FOUND_ANOTHER", "Request ID#%lu has been closed. $S detected that you also have request ID#%lu open. If you send $S a message, it will be associated with that request." },
224 /* Messages that are inserted into request text */
225 { "HSMSG_REQMSG_NOTE_ADDED", "Your note for request ID#%lu has been recorded." },
227 /* Automatically generated page messages */
228 { "HSMSG_PAGE_NEW_REQUEST_AUTHED", "New request (ID#%lu) from $b%s$b (Account %s)" },
229 { "HSMSG_PAGE_NEW_REQUEST_UNAUTHED", "New request (ID#%lu) from $b%s$b (Not logged in)" },
230 { "HSMSG_PAGE_UPD_REQUEST_AUTHED", "Request ID#%lu has been updated by $b%s$b (Account %s). Request was initially opened at %s, and was last updated %s ago." },
231 { "HSMSG_PAGE_UPD_REQUEST_NOT_AUTHED", "Request ID#%lu has been updated by $b%s$b (not authed). Request was initially opened at %s, and was last updated %s ago." },
232 { "HSMSG_PAGE_CLOSE_REQUEST_1", "Request ID#%lu from $b%s$b (Account %s) has been closed by %s." },
233 { "HSMSG_PAGE_CLOSE_REQUEST_2", "Request ID#%lu from $b%s$b (Not authed) has been closed by %s." },
234 { "HSMSG_PAGE_CLOSE_REQUEST_3", "Request ID#%lu from an offline user (Account %s) has been closed by %s." },
235 { "HSMSG_PAGE_CLOSE_REQUEST_4", "Request ID#%lu from an offline user (no account) has been closed by %s." },
236 { "HSMSG_PAGE_ASSIGN_REQUEST_1", "Request ID#%lu from $b%s$b (Account %s) has been assigned to %s." },
237 { "HSMSG_PAGE_ASSIGN_REQUEST_2", "Request ID#%lu from $b%s$b (Not authed) has been assigned to %s." },
238 { "HSMSG_PAGE_ASSIGN_REQUEST_3", "Request ID#%lu from an offline user (Account %s) has been assigned to %s." },
239 { "HSMSG_PAGE_ASSIGN_REQUEST_4", "Request ID#%lu from an offline user (no account) has been assigned to %s." },
240 /* The last %s is still an I18N lose. Blame whoever decided to overload it so much. */
241 { "HSMSG_PAGE_HELPER_GONE_1", "Request ID#%lu from $b%s$b (Account %s) $bhas been unassigned$b, as its helper, %s has %s." },
242 { "HSMSG_PAGE_HELPER_GONE_2", "Request ID#%lu from $b%s$b (Not authed) $bhas been unassigned$b, as its helper, %s has %s." },
243 { "HSMSG_PAGE_HELPER_GONE_3", "Request ID#%lu from an offline user (Account %s) $bhas been unassigned$b, as its helper, %s has %s." },
244 { "HSMSG_PAGE_HELPER_GONE_4", "Request ID#%lu from an offline user (No account) $bhas been unassigned$b, as its helper, %s has %s." },
245 { "HSMSG_PAGE_WHINE_HEADER", "$b%u unhandled request(s)$b waiting at least $b%s$b (%u total)" },
246 { "HSMSG_PAGE_IDLE_HEADER", "$b%u users$b in %s $bidle at least %s$b:" },
247 { "HSMSG_PAGE_EMPTYALERT", "$b%s has no helpers present (%u unhandled request(s))$b" },
248 { "HSMSG_PAGE_ONLYTRIALALERT", "$b%s has no full helpers present (%d trial(s) present; %u unhandled request(s))$b" },
249 { "HSMSG_PAGE_FIRSTEMPTYALERT", "$b%s has no helpers present because %s has left (%u unhandled request(s))$b" },
250 { "HSMSG_PAGE_FIRSTONLYTRIALALERT", "$b%s has no full helpers present because %s has left (%d trial(s) present; %u unhandled request(s))$b" },
251 { "HSMSG_PAGE_EMPTYNOMORE", "%s has joined %s; cancelling the \"no helpers present\" alert" },
253 /* Notification messages */
254 { "HSMSG_NOTIFY_USER_QUIT", "The user for request ID#%lu, $b%s$b, has disconnected." },
255 { "HSMSG_NOTIFY_USER_MOVE", "The account for request ID#%lu, $b%s$b has been unregistered. It has been associated with user $b%s$b." },
256 { "HSMSG_NOTIFY_USER_NICK", "The user for request ID#%lu has changed their nick from $b%s$b to $b%s$b." },
257 { "HSMSG_NOTIFY_USER_FOUND", "The user for request ID#%lu is now online using nick $b%s$b." },
258 { "HSMSG_NOTIFY_HAND_RENAME", "The account for request ID#%lu has been renamed from $b%s$b to $b%s$b." },
259 { "HSMSG_NOTIFY_HAND_MOVE", "The account for request ID#%lu has been changed to $b%s$b from $b%s$b." },
260 { "HSMSG_NOTIFY_HAND_STUCK", "The user for request ID#%lu, $b%s$b, has re-authenticated to account $b%s$b from $b%s$b, and the request remained associated with the old handle." },
261 { "HSMSG_NOTIFY_HAND_AUTH", "The user for request ID#%lu, $b%s$b, has authenticated to account $b%s$b." },
262 { "HSMSG_NOTIFY_HAND_UNREG", "The account for request ID#%lu, $b%s$b, has been unregistered by $b%s$b." },
263 { "HSMSG_NOTIFY_HAND_MERGE", "The account for request ID#%lu, $b%s$b, has been merged with $b%s$b by %s." },
264 { "HSMSG_NOTIFY_ALLOWAUTH", "The user for request ID#%lu, $b%s$b, has been permitted by %s to authenticate to account $b%s$b without hostmask checking." },
265 { "HSMSG_NOTIFY_UNALLOWAUTH", "The user for request ID#%lu, $b%s$b, has had their ability to authenticate without hostmask checking revoked by %s." },
266 { "HSMSG_NOTIFY_FAILPW", "The user for request ID#%lu, $b%s$b, has attempted to authenticate to account $b%s$b, but used an incorrect password." },
267 { "HSMSG_NOTIFY_REQ_DROP_PART", "Request ID#%lu has been $bdropped$b because %s left the help channel." },
268 { "HSMSG_NOTIFY_REQ_DROP_QUIT", "Request ID#%lu has been $bdropped$b because %s quit IRC." },
269 { "HSMSG_NOTIFY_REQ_DROP_UNREGGED", "Request ID#%lu (account %s) has been $bdropped$b because the account was unregistered." },
271 /* Presence and request-related messages */
272 { "HSMSG_REQ_DROPPED_PART", "You have left $b%s$b. Your help request (ID#%lu) has been deleted." },
273 { "HSMSG_REQ_WARN_UNREG", "The account you were authenticated to ($b%s$b) has been unregistered. Therefore unless you register a new handle, or authenticate to another one, if you disconnect, your HelpServ $S (%s) request ID#%lu will be lost." },
274 { "HSMSG_REQ_DROPPED_UNREG", "By unregistering the account $b%s$b, HelpServ $S (%s) request ID#%lu was dropped, as there was nobody online to associate the request with." },
275 { "HSMSG_REQ_ASSIGNED_UNREG", "As the account $b%s$b was unregistered, HelpServ $S (%s) request ID#%lu was associated with you, as you were authenticated to that account. If you disconnect, then this request will be lost forever." },
276 { "HSMSG_REQ_AUTH_STUCK", "By authenticating to account $b%s$b, HelpServ $S (%s) request ID#%lu remained with the previous account $b%s$b (because the request will remain until closed). This means that if you send $S a message, it $uwill not$u be associated with this request." },
277 { "HSMSG_REQ_AUTH_MOVED", "By authenticating to account $b%s$b, HelpServ $S (%s) request ID#%lu ceased to be associated with your previously authenticated account ($b%s$b), and was transferred to your new account (because the request will only remain until you %s). This means that if you send $S a message, it $uwill$u be associated with this request." },
280 { "HSMSG_BOTLIST_HEADER", "$bCurrent HelpServ bots:$b" },
281 { "HSMSG_USERLIST_HEADER", "$b%s users:$b" },
282 { "HSMSG_USERLIST_ZOOT_LVL", "%s $b%ss$b:" },
283 { "HSMSG_REQLIST_AUTH", "You are currently assigned these requests:" },
284 { "HSMSG_REQ_LIST_TOP_UNASSIGNED", "Listing $ball unassigned$b requests (%d in list)." },
285 { "HSMSG_REQ_LIST_TOP_ASSIGNED", "Listing $ball assigned$b requests (%d in list)." },
286 { "HSMSG_REQ_LIST_TOP_YOUR", "Listing $byour$b requests (%d in list)." },
287 { "HSMSG_REQ_LIST_TOP_ALL", "Listing $ball$b requests (%d in list)." },
288 { "HSMSG_REQ_LIST_NONE", "There are no matching requests." },
289 { "HSMSG_STATS_TOP", "Stats for %s user $b%s$b (week starts %s):" },
290 { "HSMSG_STATS_TIME", "$uTime spent helping in %s:$u" },
291 { "HSMSG_STATS_REQS", "$uRequest activity statistics:$u" },
293 /* Status report headers */
294 { "HSMSG_STATS_REPORT_0", "Stats report for current week" },
295 { "HSMSG_STATS_REPORT_1", "Stats report for one week ago" },
296 { "HSMSG_STATS_REPORT_2", "Stats report for two weeks ago" },
297 { "HSMSG_STATS_REPORT_3", "Stats report for three weeks ago" },
299 /* Responses to user commands */
300 { "HSMSG_YOU_BEING_HELPED", "You are already being helped." },
301 { "HSMSG_YOU_BEING_HELPED_BY", "You are already being helped by $b%s$b." },
302 { "HSMSG_WAIT_STATUS", "You are %d of %d in line; the first person has waited %s." },
306 enum helpserv_level
{
316 static const char *helpserv_level_names
[] = {
334 static const struct {
339 { "none", "MSG_NONE", NULL
},
340 { "notice", "HSMSG_PAGE_NOTICE", irc_notice
},
341 { "privmsg", "HSMSG_PAGE_PRIVMSG", irc_privmsg
},
342 { "onotice", "HSMSG_PAGE_ONOTICE", irc_wallchops
},
353 static const struct {
358 { "command", "HSMSG_SET_COMMAND_TARGET", "HSMSG_SET_COMMAND_TYPE" },
359 { "alert", "HSMSG_SET_ALERT_TARGET", "HSMSG_SET_ALERT_TYPE" },
360 { "status", "HSMSG_SET_STATUS_TARGET", "HSMSG_SET_STATUS_TYPE" },
367 MSGTYPE_REQ_ASSIGNED
,
373 static const struct {
376 } message_types
[] = {
377 { "greeting", "HSMSG_SET_GREETING" },
378 { "reqopened", "HSMSG_SET_REQOPENED" },
379 { "reqassigned", "HSMSG_SET_REQASSIGNED" },
380 { "reqclosed", "HSMSG_SET_REQCLOSED" },
381 { "reqdropped", "HSMSG_SET_REQDROPPED" },
387 INTERVAL_WHINE_DELAY
,
388 INTERVAL_WHINE_INTERVAL
,
389 INTERVAL_EMPTY_INTERVAL
,
390 INTERVAL_STALE_DELAY
,
394 static const struct {
397 } interval_types
[] = {
398 { "idledelay", "HSMSG_SET_IDLEDELAY" },
399 { "whinedelay", "HSMSG_SET_WHINEDELAY" },
400 { "whineinterval", "HSMSG_SET_WHINEINTERVAL" },
401 { "emptyinterval", "HSMSG_SET_EMPTYINTERVAL" },
402 { "staledelay", "HSMSG_SET_STALEDELAY" },
406 enum persistence_type
{
412 static const struct {
415 } persistence_types
[] = {
416 { "reqpersist", "HSMSG_SET_REQPERSIST" },
417 { "helperpersist", "HSMSG_SET_HELPERPERSIST" },
421 enum persistence_length
{
428 static const struct {
431 } persistence_lengths
[] = {
432 { "part", "HSMSG_LENGTH_PART" },
433 { "quit", "HSMSG_LENGTH_QUIT" },
434 { "close", "HSMSG_LENGTH_CLOSE" },
438 enum notification_type
{
446 static const struct {
449 } notification_types
[] = {
450 { "none", "MSG_NONE" },
451 { "reqdrop", "HSMSG_NOTIFY_DROP" },
452 { "userchanges", "HSMSG_NOTIFY_USERCHANGES" },
453 { "accountchanges", "HSMSG_NOTIFY_ACCOUNTCHANGES" },
457 static const char *weekday_names
[] = {
468 static const char *statsreport_week
[] = {
469 "HSMSG_STATS_REPORT_0",
470 "HSMSG_STATS_REPORT_1",
471 "HSMSG_STATS_REPORT_2",
472 "HSMSG_STATS_REPORT_3"
476 const char *description
;
477 const char *reqlogfile
;
478 unsigned long db_backup_frequency
;
479 unsigned int expire_age
;
483 static time_t last_stats_update
;
484 static int shutting_down
;
485 static FILE *reqlog_f
;
486 static struct log_type
*HS_LOG
;
488 #define CMD_NEED_BOT 0x001
489 #define CMD_NOT_OVERRIDE 0x002
490 #define CMD_FROM_OPSERV_ONLY 0x004
491 #define CMD_IGNORE_EVENT 0x008
492 #define CMD_NEVER_FROM_OPSERV 0x010
494 struct helpserv_bot
{
495 struct userNode
*helpserv
;
497 struct chanNode
*helpchan
;
499 struct chanNode
*page_targets
[PGSRC_COUNT
];
500 enum page_type page_types
[PGSRC_COUNT
];
501 char *messages
[MSGTYPE_COUNT
];
502 unsigned long intervals
[INTERVAL_COUNT
];
503 enum notification_type notify
;
505 /* This is a default; it can be changed on a per-request basis */
506 enum persistence_type persist_types
[PERSIST_T_COUNT
];
508 dict_t users
; /* indexed by handle */
510 struct helpserv_request
*unhandled
; /* linked list of unhandled requests */
511 dict_t requests
; /* indexed by request id */
512 unsigned long last_requestid
;
513 unsigned long id_wrap
;
514 unsigned long req_maxlen
; /* Maxmimum request length in lines */
516 unsigned int privmsg_only
: 1;
517 unsigned int req_on_join
: 1;
518 unsigned int auto_voice
: 1;
519 unsigned int auto_devoice
: 1;
521 unsigned int helpchan_empty
: 1;
528 struct helpserv_user
{
529 struct handle_info
*handle
;
530 struct helpserv_bot
*hs
;
531 unsigned int help_mode
: 1;
532 unsigned int week_start
: 3;
533 enum helpserv_level level
;
535 time_t join_time
; /* when they joined, or 0 if not in channel */
536 /* [0] through [3] are n weeks ago, [4] is the total of everything before that */
537 unsigned int time_per_week
[5]; /* how long they've were in the channel the past 4 weeks */
538 unsigned int picked_up
[5]; /* how many requests they have picked up */
539 unsigned int closed
[5]; /* how many requests they have closed */
540 unsigned int reassigned_from
[5]; /* how many requests reassigned from them to others */
541 unsigned int reassigned_to
[5]; /* how many requests reassigned from others to them */
544 struct helpserv_request
{
545 struct helpserv_user
*helper
;
546 struct helpserv_bot
*hs
;
547 struct string_list
*text
;
548 struct helpserv_request
*next_unhandled
;
550 struct helpserv_reqlist
*parent_nick_list
;
551 struct helpserv_reqlist
*parent_hand_list
;
553 /* One, but not both, of "user" and "handle" may be NULL,
554 * depending on what we know about the user.
556 * If persist == PERSIST_CLOSE when the user quits, then it
557 * switches to handle instead of user... and stays that way (it's
558 * possible to have >1 nick per handle, so you can't really decide
559 * to reassign a userNode to it unless they send another message
562 struct userNode
*user
;
563 struct handle_info
*handle
;
571 #define DEFINE_LIST_ALLOC(STRUCTNAME) \
572 struct STRUCTNAME * STRUCTNAME##_alloc() {\
573 struct STRUCTNAME *newlist; \
574 newlist = malloc(sizeof(struct STRUCTNAME)); \
575 STRUCTNAME##_init(newlist); \
578 void STRUCTNAME##_free(void *data) {\
579 struct STRUCTNAME *list = data; /* void * to let dict_set_free_data use it */ \
580 STRUCTNAME##_clean(list); \
584 DECLARE_LIST(helpserv_botlist
, struct helpserv_bot
*);
585 DEFINE_LIST(helpserv_botlist
, struct helpserv_bot
*);
586 DEFINE_LIST_ALLOC(helpserv_botlist
);
588 DECLARE_LIST(helpserv_reqlist
, struct helpserv_request
*);
589 DEFINE_LIST(helpserv_reqlist
, struct helpserv_request
*);
590 DEFINE_LIST_ALLOC(helpserv_reqlist
);
592 DECLARE_LIST(helpserv_userlist
, struct helpserv_user
*);
593 DEFINE_LIST(helpserv_userlist
, struct helpserv_user
*);
594 DEFINE_LIST_ALLOC(helpserv_userlist
);
596 struct helpfile
*helpserv_helpfile
;
597 static struct module *helpserv_module
;
598 static dict_t helpserv_func_dict
;
599 static dict_t helpserv_usercmd_dict
; /* contains helpserv_usercmd_t */
600 static dict_t helpserv_option_dict
;
601 static dict_t helpserv_bots_dict
; /* indexed by nick */
602 static dict_t helpserv_bots_bychan_dict
; /* indexed by chan, holds a struct helpserv_botlist */
603 /* QUESTION: why are these outside of any helpserv_bot struct? */
604 static dict_t helpserv_reqs_bynick_dict
; /* indexed by nick, holds a struct helpserv_reqlist */
605 static dict_t helpserv_reqs_byhand_dict
; /* indexed by handle, holds a struct helpserv_reqlist */
606 static dict_t helpserv_users_byhand_dict
; /* indexed by handle, holds a struct helpserv_userlist */
608 /* This is so that overrides can "speak" from opserv */
609 extern struct userNode
*opserv
;
611 #define HELPSERV_SYNTAX() helpserv_help(hs, from_opserv, user, argv[0])
612 #define HELPSERV_FUNC(NAME) int NAME(struct userNode *user, UNUSED_ARG(struct helpserv_bot *hs), int from_opserv, UNUSED_ARG(unsigned int argc), UNUSED_ARG(char *argv[]))
613 typedef HELPSERV_FUNC(helpserv_func_t
);
614 #define HELPSERV_USERCMD(NAME) void NAME(struct helpserv_request *req, UNUSED_ARG(struct userNode *likely_helper), UNUSED_ARG(char *args))
615 typedef HELPSERV_USERCMD(helpserv_usercmd_t
);
616 #define HELPSERV_OPTION(NAME) HELPSERV_FUNC(NAME)
617 typedef HELPSERV_OPTION(helpserv_option_func_t
);
619 static HELPSERV_FUNC(cmd_help
);
621 #define REQUIRE_PARMS(N) if (argc < N) { \
622 helpserv_notice(user, "MSG_MISSING_PARAMS", argv[0]); \
626 /* For messages going to users being helped */
627 #define helpserv_msguser(target, format...) send_message_type((from_opserv ? 0 : hs->privmsg_only), (target), (from_opserv ? opserv : hs->helpserv) , ## format)
628 #define helpserv_user_reply(format...) send_message_type(req->hs->privmsg_only, req->user, req->hs->helpserv , ## format)
629 /* For messages going to helpers */
630 #define helpserv_notice(target, format...) send_message((target), (from_opserv ? opserv : hs->helpserv) , ## format)
631 #define helpserv_notify(helper, format...) do { struct userNode *_target; for (_target = (helper)->handle->users; _target; _target = _target->next_authed) { \
632 send_message(_target, (helper)->hs->helpserv, ## format); \
634 #define helpserv_message(hs, target, id) do { if ((hs)->messages[id]) { \
636 send_message_type(4, (target), opserv, "%s", (hs)->messages[id]); \
638 send_message_type(4 | hs->privmsg_only, (target), hs->helpserv, "%s", (hs)->messages[id]); \
640 #define helpserv_page(TYPE, FORMAT...) do { \
641 struct chanNode *target=NULL; int msg_type=0; \
642 target = hs->page_targets[TYPE]; \
643 switch (hs->page_types[TYPE]) { \
644 case PAGE_NOTICE: msg_type = 0; break; \
645 case PAGE_PRIVMSG: msg_type = 1; break; \
646 case PAGE_ONOTICE: msg_type = 2; break; \
647 default: log_module(HS_LOG, LOG_ERROR, "helpserv_page() called but %s has an invalid page type %d.", hs->helpserv->nick, TYPE); \
648 case PAGE_NONE: target = NULL; break; \
650 if (target) send_target_message(msg_type, target->name, hs->helpserv, ## FORMAT); \
652 #define helpserv_get_handle_info(user, text) smart_get_handle_info((from_opserv ? opserv : hs->helpserv) , (user), (text))
654 struct helpserv_cmd
{
655 enum helpserv_level access
;
656 helpserv_func_t
*func
;
661 static void run_empty_interval(void *data
);
663 static void helpserv_interval(char *output
, time_t interval
) {
664 int num_hours
= interval
/ 3600;
665 int num_minutes
= (interval
% 3600) / 60;
666 sprintf(output
, "%u hour%s, %u minute%s", num_hours
, num_hours
== 1 ? "" : "s", num_minutes
, num_minutes
== 1 ? "" : "s");
669 static const char * helpserv_level2str(enum helpserv_level level
) {
670 if (level
<= HlOper
) {
671 return helpserv_level_names
[level
];
673 log_module(HS_LOG
, LOG_ERROR
, "helpserv_level2str receieved invalid level %d.", level
);
678 static enum helpserv_level
helpserv_str2level(const char *msg
) {
679 enum helpserv_level nn
;
680 for (nn
=HlNone
; nn
<=HlOper
; nn
++) {
681 if (!irccasecmp(msg
, helpserv_level_names
[nn
]))
684 log_module(HS_LOG
, LOG_ERROR
, "helpserv_str2level received invalid level %s.", msg
);
685 return HlNone
; /* Error */
688 static struct helpserv_user
*GetHSUser(struct helpserv_bot
*hs
, struct handle_info
*hi
) {
689 return dict_find(hs
->users
, hi
->handle
, NULL
);
692 static void helpserv_log_request(struct helpserv_request
*req
, const char *reason
) {
693 char key
[27+NICKLEN
];
694 char userhost
[USERLEN
+HOSTLEN
+2];
695 struct saxdb_context
*ctx
;
699 assert(reason
!= NULL
);
700 if (!(ctx
= saxdb_open_context(reqlog_f
)))
702 sprintf(key
, "%s-" FMT_TIME_T
"-%lu", req
->hs
->helpserv
->nick
, req
->opened
, req
->id
);
703 if ((res
= setjmp(ctx
->jbuf
)) != 0) {
704 log_module(HS_LOG
, LOG_ERROR
, "Unable to log helpserv request: %s.", strerror(res
));
706 saxdb_start_record(ctx
, key
, 1);
708 saxdb_write_string(ctx
, KEY_REQUEST_HELPER
, req
->helper
->handle
->handle
);
709 saxdb_write_int(ctx
, KEY_REQUEST_ASSIGNED
, req
->assigned
);
712 saxdb_write_string(ctx
, KEY_REQUEST_HANDLE
, req
->handle
->handle
);
715 saxdb_write_string(ctx
, KEY_REQUEST_NICK
, req
->user
->nick
);
716 sprintf(userhost
, "%s@%s", req
->user
->ident
, req
->user
->hostname
);
717 saxdb_write_string(ctx
, KEY_REQUEST_USERHOST
, userhost
);
719 saxdb_write_int(ctx
, KEY_REQUEST_OPENED
, req
->opened
);
720 saxdb_write_int(ctx
, KEY_REQUEST_CLOSED
, now
);
721 saxdb_write_string(ctx
, KEY_REQUEST_CLOSEREASON
, reason
);
722 saxdb_write_string_list(ctx
, KEY_REQUEST_TEXT
, req
->text
);
723 saxdb_end_record(ctx
);
724 saxdb_close_context(ctx
);
729 /* Searches for a request by number, nick, or account (num|nick|*account).
730 * As there can potentially be >1 match, it takes a reqlist. The return
731 * value is the "best" request found (explained in the comment block below).
733 * If num_results is not NULL, it is set to the number of potentially matching
735 * If hs_user is not NULL, requests assigned to this helper will be given
736 * preference (oldest assigned, falling back to oldest if there are none).
738 static struct helpserv_request
* smart_get_request(struct helpserv_bot
*hs
, struct helpserv_user
*hs_user
, const char *needle
, int *num_results
) {
739 struct helpserv_reqlist
*reqlist
, resultlist
;
740 struct helpserv_request
*req
, *oldest
=NULL
, *oldest_assigned
=NULL
;
741 struct userNode
*user
;
747 if (*needle
== '*') {
748 /* This test (handle) requires the least processing, so it's first */
749 if (!(reqlist
= dict_find(helpserv_reqs_byhand_dict
, needle
+1, NULL
)))
751 helpserv_reqlist_init(&resultlist
);
752 for (i
=0; i
< reqlist
->used
; i
++) {
753 req
= reqlist
->list
[i
];
755 helpserv_reqlist_append(&resultlist
, req
);
760 } else if (!needle
[strspn(needle
, "0123456789")]) {
761 /* The string is 100% numeric - a request id */
762 if (!(req
= dict_find(hs
->requests
, needle
, NULL
)))
767 } else if ((user
= GetUserH(needle
))) {
768 /* And finally, search by nick */
769 if (!(reqlist
= dict_find(helpserv_reqs_bynick_dict
, needle
, NULL
)))
771 helpserv_reqlist_init(&resultlist
);
773 for (i
=0; i
< reqlist
->used
; i
++) {
774 req
= reqlist
->list
[i
];
776 helpserv_reqlist_append(&resultlist
, req
);
781 /* If the nick didn't have anything, try their handle */
782 if (!resultlist
.used
&& user
->handle_info
) {
783 char star_handle
[NICKSERV_HANDLE_LEN
+2];
785 helpserv_reqlist_clean(&resultlist
);
786 sprintf(star_handle
, "*%s", user
->handle_info
->handle
);
788 return smart_get_request(hs
, hs_user
, star_handle
, num_results
);
794 if (resultlist
.used
== 0) {
795 helpserv_reqlist_clean(&resultlist
);
797 } else if (resultlist
.used
== 1) {
798 req
= resultlist
.list
[0];
799 helpserv_reqlist_clean(&resultlist
);
803 /* In case there is >1 request returned, use the oldest one assigned to
804 * the helper executing the command. Otherwise, use the oldest request.
805 * This may not be the intended result for cmd_pickup (first unhandled
806 * request may be better), or cmd_reassign (first handled request), but
807 * it's close enough, and there really aren't supposed to be multiple
808 * requests per person anyway; they're just side effects of authing. */
810 for (i
=0; i
< resultlist
.used
; i
++) {
811 req
= resultlist
.list
[i
];
812 if (!oldest
|| req
->opened
< oldest
->opened
)
814 if (hs_user
&& (!oldest_assigned
|| (req
->helper
== hs_user
&& req
->opened
< oldest_assigned
->opened
)))
815 oldest_assigned
= req
;
818 helpserv_reqlist_clean(&resultlist
);
820 return oldest_assigned
? oldest_assigned
: oldest
;
823 static struct helpserv_request
* create_request(struct userNode
*user
, struct helpserv_bot
*hs
, int from_join
) {
824 struct helpserv_request
*req
= calloc(1, sizeof(struct helpserv_request
));
825 char lbuf
[3][MAX_LINE_SIZE
], unh
[INTERVALLEN
];
826 struct helpserv_reqlist
*reqlist
, *hand_reqlist
;
827 const unsigned int from_opserv
= 0;
832 req
->id
= ++hs
->last_requestid
;
833 sprintf(unh
, "%lu", req
->id
);
834 dict_insert(hs
->requests
, strdup(unh
), req
);
839 if (hs
->last_requestid
< hs
->id_wrap
) {
840 for (i
=hs
->last_requestid
; i
< hs
->id_wrap
; i
++) {
841 sprintf(buf
, "%lu", i
);
842 if (!dict_find(hs
->requests
, buf
, NULL
)) {
843 hs
->last_requestid
= i
-1;
848 if (hs
->last_requestid
>= hs
->id_wrap
) {
849 for (i
=1; i
< hs
->id_wrap
; i
++) {
850 sprintf(buf
, "%lu", i
);
851 if (!dict_find(hs
->requests
, buf
, NULL
)) {
852 hs
->last_requestid
= i
-1;
856 if (i
>= hs
->id_wrap
) {
857 log_module(HS_LOG
, LOG_INFO
, "%s has more requests than its id_wrap.", hs
->helpserv
->nick
);
864 req
->text
= alloc_string_list(4);
866 req
->handle
= user
->handle_info
;
867 if (from_join
&& self
->burst
) {
868 extern time_t burst_begin
;
869 /* We need to keep all the requests during a burst join together,
870 * even if the burst takes more than 1 second. ircu seems to burst
871 * in reverse-join order. */
872 req
->opened
= burst_begin
;
878 if (!hs
->unhandled
) {
880 req
->next_unhandled
= NULL
;
881 } else if (self
->burst
&& hs
->unhandled
->opened
>= req
->opened
) {
882 req
->next_unhandled
= hs
->unhandled
;
884 } else if (self
->burst
) {
885 struct helpserv_request
*unh
;
886 /* Add the request to the beginning of the set of requests with
887 * req->opened having the same value. This makes reqonjoin create
888 * requests in the correct order while bursting. Note that this
889 * does not correct request ids, so they will be in reverse order
890 * though "/msg botname next" will work properly. */
891 for (unh
= hs
->unhandled
; unh
->next_unhandled
&& unh
->next_unhandled
->opened
< req
->opened
; unh
= unh
->next_unhandled
) ;
892 req
->next_unhandled
= unh
->next_unhandled
;
893 unh
->next_unhandled
= req
;
895 struct helpserv_request
*unh
;
897 for (unh
= hs
->unhandled
; unh
->next_unhandled
; unh
= unh
->next_unhandled
) ;
898 req
->next_unhandled
= NULL
;
899 unh
->next_unhandled
= req
;
902 if (!(reqlist
= dict_find(helpserv_reqs_bynick_dict
, user
->nick
, NULL
))) {
903 reqlist
= helpserv_reqlist_alloc();
904 dict_insert(helpserv_reqs_bynick_dict
, user
->nick
, reqlist
);
906 req
->parent_nick_list
= reqlist
;
907 helpserv_reqlist_append(reqlist
, req
);
909 if (user
->handle_info
) {
910 if (!(hand_reqlist
= dict_find(helpserv_reqs_byhand_dict
, user
->handle_info
->handle
, NULL
))) {
911 hand_reqlist
= helpserv_reqlist_alloc();
912 dict_insert(helpserv_reqs_byhand_dict
, user
->handle_info
->handle
, hand_reqlist
);
914 req
->parent_hand_list
= hand_reqlist
;
915 helpserv_reqlist_append(hand_reqlist
, req
);
917 req
->parent_hand_list
= NULL
;
921 fmt
= user_find_message(user
, "HSMSG_REQ_NEWONJOIN");
922 sprintf(lbuf
[0], fmt
, hs
->helpchan
->name
, req
->id
);
924 fmt
= user_find_message(user
, "HSMSG_REQ_NEW");
925 sprintf(lbuf
[0], fmt
, req
->id
);
927 if (req
!= hs
->unhandled
) {
928 intervalString(unh
, now
- hs
->unhandled
->opened
, user
->handle_info
);
929 fmt
= user_find_message(user
, "HSMSG_REQ_UNHANDLED_TIME");
930 sprintf(lbuf
[1], fmt
, unh
);
932 fmt
= user_find_message(user
, "HSMSG_REQ_NO_UNHANDLED");
933 sprintf(lbuf
[1], fmt
);
935 switch (hs
->persist_types
[PERSIST_T_REQUEST
]) {
937 fmt
= user_find_message(user
, "HSMSG_REQ_PERSIST_PART");
938 sprintf(lbuf
[2], fmt
, hs
->helpchan
->name
, hs
->helpchan
->name
);
941 fmt
= user_find_message(user
, "HSMSG_REQ_PERSIST_QUIT");
942 sprintf(lbuf
[2], fmt
);
945 log_module(HS_LOG
, LOG_ERROR
, "%s has an invalid req_persist.", hs
->helpserv
->nick
);
947 if (user
->handle_info
) {
948 fmt
= user_find_message(user
, "HSMSG_REQ_PERSIST_HANDLE");
949 sprintf(lbuf
[2], fmt
);
951 fmt
= user_find_message(user
, "HSMSG_REQ_PERSIST_QUIT");
952 sprintf(lbuf
[2], fmt
);
956 helpserv_message(hs
, user
, MSGTYPE_REQ_OPENED
);
958 send_message_type(4, user
, opserv
, "%s %s %s", lbuf
[0], lbuf
[1], lbuf
[2]);
960 send_message_type(4, user
, hs
->helpserv
, "%s %s %s", lbuf
[0], lbuf
[1], lbuf
[2]);
962 if (hs
->req_on_join
&& req
== hs
->unhandled
&& hs
->helpchan_empty
&& !user
->uplink
->burst
) {
963 timeq_del(0, run_empty_interval
, hs
, TIMEQ_IGNORE_WHEN
);
964 run_empty_interval(hs
);
970 /* Handle a message from a user to a HelpServ bot. */
971 static void helpserv_usermsg(struct userNode
*user
, struct helpserv_bot
*hs
, char *text
) {
972 const int from_opserv
= 0; /* for helpserv_notice */
973 struct helpserv_request
*req
=NULL
, *newest
=NULL
;
974 struct helpserv_reqlist
*reqlist
, *hand_reqlist
;
977 if ((reqlist
= dict_find(helpserv_reqs_bynick_dict
, user
->nick
, NULL
))) {
978 for (i
=0; i
< reqlist
->used
; i
++) {
979 req
= reqlist
->list
[i
];
982 if (!newest
|| (newest
->opened
< req
->opened
))
986 /* If nothing was found, this will set req to NULL */
990 if (user
->handle_info
) {
991 hand_reqlist
= dict_find(helpserv_reqs_byhand_dict
, user
->handle_info
->handle
, NULL
);
992 if (!req
&& hand_reqlist
) {
993 /* Most recent first again */
994 for (i
=0; i
< hand_reqlist
->used
; i
++) {
995 req
= hand_reqlist
->list
[i
];
996 if ((req
->hs
!= hs
) || req
->user
)
998 if (!newest
|| (newest
->opened
< req
->opened
))
1006 reqlist
= helpserv_reqlist_alloc();
1007 dict_insert(helpserv_reqs_bynick_dict
, user
->nick
, reqlist
);
1009 req
->parent_nick_list
= reqlist
;
1010 helpserv_reqlist_append(reqlist
, req
);
1012 if (req
->helper
&& (hs
->notify
>= NOTIFY_USER
))
1013 helpserv_notify(req
->helper
, "HSMSG_NOTIFY_USER_FOUND", req
->id
, user
->nick
);
1015 helpserv_msguser(user
, "HSMSG_GREET_PRIVMSG_EXISTREQ", req
->id
);
1019 hand_reqlist
= NULL
;
1023 if (text
[0] == helpserv_conf
.user_escape
) {
1024 helpserv_msguser(user
, "HSMSG_USERCMD_NO_REQUEST");
1027 if ((hs
->persist_types
[PERSIST_T_REQUEST
] == PERSIST_PART
) && !GetUserMode(hs
->helpchan
, user
)) {
1028 helpserv_msguser(user
, "HSMSG_REQ_YOU_NOT_IN_HELPCHAN_OPEN", hs
->helpchan
->name
);
1032 req
= create_request(user
, hs
, 0);
1033 if (user
->handle_info
)
1034 helpserv_page(PGSRC_STATUS
, "HSMSG_PAGE_NEW_REQUEST_AUTHED", req
->id
, user
->nick
, user
->handle_info
->handle
);
1036 helpserv_page(PGSRC_STATUS
, "HSMSG_PAGE_NEW_REQUEST_UNAUTHED", req
->id
, user
->nick
);
1037 } else if (text
[0] == helpserv_conf
.user_escape
) {
1038 char cmdname
[MAXLEN
], *space
;
1039 helpserv_usercmd_t
*usercmd
;
1040 struct userNode
*likely_helper
;
1042 /* Find somebody likely to be the helper */
1044 likely_helper
= NULL
;
1045 else if ((likely_helper
= req
->helper
->handle
->users
) && !likely_helper
->next_authed
) {
1046 /* only one user it could be :> */
1047 } else for (likely_helper
= req
->helper
->handle
->users
; likely_helper
; likely_helper
= likely_helper
->next_authed
)
1048 if (GetUserMode(hs
->helpchan
, likely_helper
))
1051 /* Parse out command name */
1052 space
= strchr(text
+1, ' ');
1054 strncpy(cmdname
, text
+1, space
-text
-1);
1056 strcpy(cmdname
, text
+1);
1058 /* Call the user command function */
1059 usercmd
= dict_find(helpserv_usercmd_dict
, cmdname
, NULL
);
1061 usercmd(req
, likely_helper
, space
+1);
1063 helpserv_msguser(user
, "HSMSG_USERCMD_UNKNOWN", cmdname
);
1065 } else if (hs
->intervals
[INTERVAL_STALE_DELAY
]
1066 && (req
->updated
< (time_t)(now
- hs
->intervals
[INTERVAL_STALE_DELAY
]))
1067 && (!hs
->req_maxlen
|| req
->text
->used
< hs
->req_maxlen
)) {
1068 char buf
[MAX_LINE_SIZE
], updatestr
[INTERVALLEN
], timestr
[MAX_LINE_SIZE
];
1070 strftime(timestr
, MAX_LINE_SIZE
, HSFMT_TIME
, localtime(&req
->opened
));
1071 intervalString(updatestr
, now
- req
->updated
, user
->handle_info
);
1072 if (req
->helper
&& (hs
->notify
>= NOTIFY_USER
))
1073 if (user
->handle_info
)
1074 helpserv_notify(req
->helper
, "HSMSG_PAGE_UPD_REQUEST_AUTHED", req
->id
, user
->nick
, user
->handle_info
->handle
, timestr
, updatestr
);
1076 helpserv_notify(req
->helper
, "HSMSG_PAGE_UPD_REQUESTNOT_AUTHED", req
->id
, user
->nick
, timestr
, updatestr
);
1078 if (user
->handle_info
)
1079 helpserv_page(PGSRC_STATUS
, "HSMSG_PAGE_UPD_REQUEST_AUTHED", req
->id
, user
->nick
, user
->handle_info
->handle
, timestr
, updatestr
);
1081 helpserv_page(PGSRC_STATUS
, "HSMSG_PAGE_UPD_REQUEST_NOT_AUTHED", req
->id
, user
->nick
, timestr
, updatestr
);
1082 strftime(timestr
, MAX_LINE_SIZE
, HSFMT_TIME
, localtime(&now
));
1083 snprintf(buf
, MAX_LINE_SIZE
, "[Stale request updated at %s]", timestr
);
1084 string_list_append(req
->text
, strdup(buf
));
1088 if (!hs
->req_maxlen
|| req
->text
->used
< hs
->req_maxlen
)
1090 string_list_append(req
->text
, strdup(text
));
1092 struct userNode
*likely_helper
;
1093 /* Find somebody likely to be the helper */
1095 likely_helper
= NULL
;
1096 else if ((likely_helper
= req
->helper
->handle
->users
) && !likely_helper
->next_authed
) {
1097 /* only one user it could be :> */
1098 } else for (likely_helper
= req
->helper
->handle
->users
; likely_helper
; likely_helper
= likely_helper
->next_authed
)
1099 if (GetUserMode(hs
->helpchan
, likely_helper
))
1103 send_target_message(1, likely_helper
->nick
, hs
->helpserv
, "HSMSQ_REQ_TEXT_ADDED", user
->nick
, text
);
1106 helpserv_msguser(user
, "HSMSG_REQ_MAXLEN");
1109 /* Handle messages direct to a HelpServ bot. */
1110 static void helpserv_botmsg(struct userNode
*user
, struct userNode
*target
, char *text
, UNUSED_ARG(int server_qualified
)) {
1111 struct helpserv_bot
*hs
;
1112 struct helpserv_cmd
*cmd
;
1113 struct helpserv_user
*hs_user
;
1114 char *argv
[MAXNUMPARAMS
];
1115 int argc
, argv_shift
;
1116 const int from_opserv
= 0; /* for helpserv_notice */
1118 /* Ignore things consisting of empty lines or from ourselves */
1119 if (!*text
|| IsLocal(user
))
1122 hs
= dict_find(helpserv_bots_dict
, target
->nick
, NULL
);
1124 /* See if we should listen to their message as a command (helper)
1125 * or a help request (user) */
1126 if (!user
->handle_info
|| !(hs_user
= dict_find(hs
->users
, user
->handle_info
->handle
, NULL
))) {
1127 helpserv_usermsg(user
, hs
, text
);
1132 argc
= split_line(text
, false, ArrayLength(argv
)-argv_shift
, argv
+argv_shift
);
1136 cmd
= dict_find(helpserv_func_dict
, argv
[argv_shift
], NULL
);
1138 helpserv_notice(user
, "MSG_COMMAND_UNKNOWN", argv
[argv_shift
]);
1141 if (cmd
->flags
& CMD_FROM_OPSERV_ONLY
) {
1142 helpserv_notice(user
, "HSMSG_OPER_CMD");
1145 if (cmd
->access
> hs_user
->level
) {
1146 helpserv_notice(user
, "HSMSG_LEVEL_TOO_LOW");
1150 helpserv_notice(user
, "HSMSG_INTERNAL_COMMAND", argv
[argv_shift
]);
1151 } else if (cmd
->func(user
, hs
, 0, argc
, argv
+argv_shift
)) {
1152 unsplit_string(argv
+argv_shift
, argc
, text
);
1153 log_audit(HS_LOG
, LOG_COMMAND
, user
, hs
->helpserv
, hs
->helpchan
->name
, 0, text
);
1157 /* Handle a control command from an IRC operator */
1158 static MODCMD_FUNC(cmd_helpserv
) {
1159 struct helpserv_bot
*hs
= NULL
;
1160 struct helpserv_cmd
*subcmd
;
1161 const int from_opserv
= 1; /* for helpserv_notice */
1162 char botnick
[NICKLEN
+1]; /* in case command is unregister */
1166 send_help(user
, opserv
, helpserv_helpfile
, NULL
);
1170 if (!(subcmd
= dict_find(helpserv_func_dict
, argv
[1], NULL
))) {
1171 helpserv_notice(user
, "MSG_COMMAND_UNKNOWN", argv
[1]);
1175 if (!subcmd
->func
) {
1176 helpserv_notice(user
, "HSMSG_INTERNAL_COMMAND", argv
[1]);
1180 if ((subcmd
->flags
& CMD_NEED_BOT
) && ((argc
< 3) || !(hs
= dict_find(helpserv_bots_dict
, argv
[2], NULL
)))) {
1181 helpserv_notice(user
, "HSMSG_INVALID_BOT");
1185 if (subcmd
->flags
& CMD_NEVER_FROM_OPSERV
) {
1186 helpserv_notice(user
, "HSMSG_NO_USE_OPSERV");
1192 strcpy(botnick
, hs
->helpserv
->nick
);
1193 retval
= subcmd
->func(user
, hs
, 1, argc
-2, argv
+2);
1195 strcpy(botnick
, "No bot");
1196 retval
= subcmd
->func(user
, hs
, 1, argc
-1, argv
+1);
1202 static void helpserv_help(struct helpserv_bot
*hs
, int from_opserv
, struct userNode
*user
, const char *topic
) {
1203 send_help(user
, (from_opserv
? opserv
: hs
->helpserv
), helpserv_helpfile
, topic
);
1206 static int append_entry(const char *key
, UNUSED_ARG(void *data
), void *extra
) {
1207 struct helpfile_expansion
*exp
= extra
;
1210 row
= exp
->value
.table
.length
++;
1211 exp
->value
.table
.contents
[row
] = calloc(1, sizeof(char*));
1212 exp
->value
.table
.contents
[row
][0] = key
;
1216 static struct helpfile_expansion
helpserv_expand_variable(const char *variable
) {
1217 struct helpfile_expansion exp
;
1219 if (!irccasecmp(variable
, "index")) {
1220 exp
.type
= HF_TABLE
;
1221 exp
.value
.table
.length
= 1;
1222 exp
.value
.table
.width
= 1;
1223 exp
.value
.table
.flags
= TABLE_REPEAT_ROWS
;
1224 exp
.value
.table
.contents
= calloc(dict_size(helpserv_func_dict
)+1, sizeof(char**));
1225 exp
.value
.table
.contents
[0] = calloc(1, sizeof(char*));
1226 exp
.value
.table
.contents
[0][0] = "Commands:";
1227 dict_foreach(helpserv_func_dict
, append_entry
, &exp
);
1231 exp
.type
= HF_STRING
;
1232 exp
.value
.str
= NULL
;
1236 static void helpserv_helpfile_read(void) {
1237 helpserv_helpfile
= open_helpfile(HELPSERV_HELPFILE_NAME
, helpserv_expand_variable
);
1240 static HELPSERV_USERCMD(usercmd_wait
) {
1241 struct helpserv_request
*other
;
1243 char buf
[INTERVALLEN
];
1247 helpserv_user_reply("HSMSG_YOU_BEING_HELPED_BY", likely_helper
->nick
);
1249 helpserv_user_reply("HSMSG_YOU_BEING_HELPED");
1253 for (other
= req
->hs
->unhandled
, pos
= -1, count
= 0;
1255 other
= other
->next_unhandled
, ++count
) {
1260 intervalString(buf
, now
- req
->hs
->unhandled
->opened
, req
->user
->handle_info
);
1261 helpserv_user_reply("HSMSG_WAIT_STATUS", pos
+1, count
, buf
);
1264 static HELPSERV_FUNC(cmd_help
) {
1270 topic
= unsplit_string(argv
+1, argc
-1, NULL
);
1271 helpserv_help(hs
, from_opserv
, user
, topic
);
1276 static HELPSERV_FUNC(cmd_readhelp
) {
1277 struct timeval start
, stop
;
1278 struct helpfile
*old_helpfile
= helpserv_helpfile
;
1280 gettimeofday(&start
, NULL
);
1281 helpserv_helpfile_read();
1282 if (helpserv_helpfile
) {
1283 close_helpfile(old_helpfile
);
1285 helpserv_helpfile
= old_helpfile
;
1287 gettimeofday(&stop
, NULL
);
1288 stop
.tv_sec
-= start
.tv_sec
;
1289 stop
.tv_usec
-= start
.tv_usec
;
1290 if (stop
.tv_usec
< 0) {
1292 stop
.tv_usec
+= 1000000;
1294 helpserv_notice(user
, "HSMSG_READHELP_SUCCESS", stop
.tv_sec
, stop
.tv_usec
/1000);
1299 static struct helpserv_user
* helpserv_add_user(struct helpserv_bot
*hs
, struct handle_info
*handle
, enum helpserv_level level
) {
1300 struct helpserv_user
*hs_user
;
1301 struct helpserv_userlist
*userlist
;
1303 hs_user
= calloc(1, sizeof(struct helpserv_user
));
1304 hs_user
->handle
= handle
;
1306 hs_user
->help_mode
= 0;
1307 hs_user
->level
= level
;
1308 hs_user
->join_time
= find_handle_in_channel(hs
->helpchan
, handle
, NULL
) ? now
: 0;
1309 dict_insert(hs
->users
, handle
->handle
, hs_user
);
1311 if (!(userlist
= dict_find(helpserv_users_byhand_dict
, handle
->handle
, NULL
))) {
1312 userlist
= helpserv_userlist_alloc();
1313 dict_insert(helpserv_users_byhand_dict
, handle
->handle
, userlist
);
1315 helpserv_userlist_append(userlist
, hs_user
);
1320 static void helpserv_del_user(struct helpserv_bot
*hs
, struct helpserv_user
*hs_user
) {
1321 dict_remove(hs
->users
, hs_user
->handle
->handle
);
1324 static int cmd_add_user(struct helpserv_bot
*hs
, int from_opserv
, struct userNode
*user
, enum helpserv_level level
, int argc
, char *argv
[]) {
1325 struct helpserv_user
*actor
, *new_user
;
1326 struct handle_info
*handle
;
1331 actor
= GetHSUser(hs
, user
->handle_info
);
1332 if (actor
->level
< HlManager
) {
1333 helpserv_notice(user
, "HSMSG_CANNOT_ADD");
1340 if (!(handle
= helpserv_get_handle_info(user
, argv
[1])))
1343 if (GetHSUser(hs
, handle
)) {
1344 helpserv_notice(user
, "HSMSG_USER_EXISTS", handle
->handle
);
1348 if (!(from_opserv
) && actor
&& (actor
->level
<= level
)) {
1349 helpserv_notice(user
, "HSMSG_NO_BUMP_ACCESS");
1353 new_user
= helpserv_add_user(hs
, handle
, level
);
1355 helpserv_notice(user
, "HSMSG_ADDED_USER", helpserv_level2str(level
), handle
->handle
);
1359 static HELPSERV_FUNC(cmd_deluser
) {
1360 struct helpserv_user
*actor
=NULL
, *victim
;
1361 struct handle_info
*handle
;
1362 enum helpserv_level level
;
1367 actor
= GetHSUser(hs
, user
->handle_info
);
1368 if (actor
->level
< HlManager
) {
1369 helpserv_notice(user
, "HSMSG_CANNOT_DEL");
1374 if (!(handle
= helpserv_get_handle_info(user
, argv
[1])))
1377 if (!(victim
= GetHSUser(hs
, handle
))) {
1378 helpserv_notice(user
, "HSMSG_NOT_IN_USERLIST", handle
->handle
, hs
->helpserv
->nick
);
1382 if (!from_opserv
&& actor
&& (actor
->level
<= victim
->level
)) {
1383 helpserv_notice(user
, "MSG_USER_OUTRANKED", victim
->handle
->handle
);
1387 level
= victim
->level
;
1388 helpserv_del_user(hs
, victim
);
1389 helpserv_notice(user
, "HSMSG_DELETED_USER", helpserv_level2str(level
), handle
->handle
);
1394 helpserv_user_comp(const void *arg_a
, const void *arg_b
)
1396 const struct helpserv_user
*a
= *(struct helpserv_user
**)arg_a
;
1397 const struct helpserv_user
*b
= *(struct helpserv_user
**)arg_b
;
1399 if (a
->level
!= b
->level
)
1400 res
= b
->level
- a
->level
;
1402 res
= irccasecmp(a
->handle
->handle
, b
->handle
->handle
);
1406 static int show_helper_range(struct userNode
*user
, struct helpserv_bot
*hs
, int from_opserv
, enum helpserv_level min_lvl
, enum helpserv_level max_lvl
) {
1407 struct helpserv_userlist users
;
1408 struct helpfile_table tbl
;
1409 struct helpserv_user
*hs_user
;
1411 enum helpserv_level last_level
;
1415 users
.size
= dict_size(hs
->users
);
1416 users
.list
= alloca(users
.size
*sizeof(hs
->users
[0]));
1417 helpserv_notice(user
, "HSMSG_USERLIST_HEADER", hs
->helpserv
->nick
);
1418 for (it
= dict_first(hs
->users
); it
; it
= iter_next(it
)) {
1419 hs_user
= iter_data(it
);
1420 if (hs_user
->level
< min_lvl
)
1422 if (hs_user
->level
> max_lvl
)
1424 users
.list
[users
.used
++] = hs_user
;
1427 helpserv_notice(user
, "MSG_NONE");
1430 qsort(users
.list
, users
.used
, sizeof(users
.list
[0]), helpserv_user_comp
);
1431 switch (user
->handle_info
->userlist_style
) {
1433 tbl
.length
= users
.used
+ 1;
1435 tbl
.flags
= TABLE_NO_FREE
;
1436 tbl
.contents
= alloca(tbl
.length
* sizeof(tbl
.contents
[0]));
1437 tbl
.contents
[0] = alloca(tbl
.width
* sizeof(tbl
.contents
[0][0]));
1438 tbl
.contents
[0][0] = "Level";
1439 tbl
.contents
[0][1] = "Handle";
1440 tbl
.contents
[0][2] = "WeekStart";
1441 for (ii
= 0; ii
< users
.used
; ) {
1442 hs_user
= users
.list
[ii
++];
1443 tbl
.contents
[ii
] = alloca(tbl
.width
* sizeof(tbl
.contents
[0][0]));
1444 tbl
.contents
[ii
][0] = helpserv_level_names
[hs_user
->level
];
1445 tbl
.contents
[ii
][1] = hs_user
->handle
->handle
;
1446 tbl
.contents
[ii
][2] = weekday_names
[hs_user
->week_start
];
1448 table_send((from_opserv
? opserv
: hs
->helpserv
), user
->nick
, 0, NULL
, tbl
);
1450 case HI_STYLE_ZOOT
: default:
1451 last_level
= HlNone
;
1454 tbl
.flags
= TABLE_NO_FREE
| TABLE_REPEAT_ROWS
| TABLE_NO_HEADERS
;
1455 tbl
.contents
= alloca(users
.used
* sizeof(tbl
.contents
[0]));
1456 for (ii
= 0; ii
< users
.used
; ) {
1457 hs_user
= users
.list
[ii
++];
1458 if (hs_user
->level
!= last_level
) {
1460 helpserv_notice(user
, "HSMSG_USERLIST_ZOOT_LVL", hs
->helpserv
->nick
, helpserv_level_names
[last_level
]);
1461 table_send((from_opserv
? opserv
: hs
->helpserv
), user
->nick
, 0, NULL
, tbl
);
1464 last_level
= hs_user
->level
;
1466 tbl
.contents
[tbl
.length
] = alloca(tbl
.width
* sizeof(tbl
.contents
[0][0]));
1467 tbl
.contents
[tbl
.length
++][0] = hs_user
->handle
->handle
;
1470 helpserv_notice(user
, "HSMSG_USERLIST_ZOOT_LVL", hs
->helpserv
->nick
, helpserv_level_names
[last_level
]);
1471 table_send((from_opserv
? opserv
: hs
->helpserv
), user
->nick
, 0, NULL
, tbl
);
1477 static HELPSERV_FUNC(cmd_helpers
) {
1478 return show_helper_range(user
, hs
, from_opserv
, HlTrial
, HlOwner
);
1481 static HELPSERV_FUNC(cmd_wlist
) {
1482 return show_helper_range(user
, hs
, from_opserv
, HlOwner
, HlOwner
);
1485 static HELPSERV_FUNC(cmd_mlist
) {
1486 return show_helper_range(user
, hs
, from_opserv
, HlManager
, HlManager
);
1489 static HELPSERV_FUNC(cmd_hlist
) {
1490 return show_helper_range(user
, hs
, from_opserv
, HlHelper
, HlHelper
);
1493 static HELPSERV_FUNC(cmd_tlist
) {
1494 return show_helper_range(user
, hs
, from_opserv
, HlTrial
, HlTrial
);
1497 static HELPSERV_FUNC(cmd_addowner
) {
1498 return cmd_add_user(hs
, from_opserv
, user
, HlOwner
, argc
, argv
);
1501 static HELPSERV_FUNC(cmd_addmanager
) {
1502 return cmd_add_user(hs
, from_opserv
, user
, HlManager
, argc
, argv
);
1505 static HELPSERV_FUNC(cmd_addhelper
) {
1506 return cmd_add_user(hs
, from_opserv
, user
, HlHelper
, argc
, argv
);
1509 static HELPSERV_FUNC(cmd_addtrial
) {
1510 return cmd_add_user(hs
, from_opserv
, user
, HlTrial
, argc
, argv
);
1513 static HELPSERV_FUNC(cmd_clvl
) {
1514 struct helpserv_user
*actor
=NULL
, *victim
;
1515 struct handle_info
*handle
;
1516 enum helpserv_level level
;
1521 actor
= GetHSUser(hs
, user
->handle_info
);
1522 if (actor
->level
< HlManager
) {
1523 helpserv_notice(user
, "HSMSG_CANNOT_CLVL");
1528 if (!(handle
= helpserv_get_handle_info(user
, argv
[1])))
1531 if (!(victim
= GetHSUser(hs
, handle
))) {
1532 helpserv_notice(user
, "HSMSG_NOT_IN_USERLIST", handle
->handle
, hs
->helpserv
->nick
);
1536 if (((level
= helpserv_str2level(argv
[2])) == HlNone
) || level
== HlOper
) {
1537 helpserv_notice(user
, "HSMSG_INVALID_ACCESS", argv
[2]);
1541 if (!(from_opserv
) && actor
) {
1542 if (actor
== victim
) {
1543 helpserv_notice(user
, "HSMSG_NO_SELF_CLVL");
1547 if (actor
->level
<= victim
->level
) {
1548 helpserv_notice(user
, "MSG_USER_OUTRANKED", victim
->handle
->handle
);
1552 if (level
>= actor
->level
) {
1553 helpserv_notice(user
, "HSMSG_NO_BUMP_ACCESS");
1558 victim
->level
= level
;
1559 helpserv_notice(user
, "HSMSG_CHANGED_ACCESS", handle
->handle
, helpserv_level2str(level
));
1564 static void free_request(void *data
) {
1565 struct helpserv_request
*req
= data
;
1568 if (shutting_down
&& (req
->hs
->persist_types
[PERSIST_T_REQUEST
] != PERSIST_CLOSE
|| !req
->handle
)) {
1569 helpserv_log_request(req
, "X3 shutdown");
1572 /* Clean up from the unhandled queue */
1573 if (req
->hs
->unhandled
) {
1574 if (req
->hs
->unhandled
== req
) {
1575 req
->hs
->unhandled
= req
->next_unhandled
;
1577 struct helpserv_request
*uh
;
1578 for (uh
=req
->hs
->unhandled
; uh
->next_unhandled
&& (uh
->next_unhandled
!= req
); uh
= uh
->next_unhandled
);
1579 if (uh
->next_unhandled
) {
1580 uh
->next_unhandled
= req
->next_unhandled
;
1585 /* Clean up the lists */
1586 if (req
->parent_nick_list
) {
1587 if (req
->parent_nick_list
->used
== 1) {
1588 dict_remove(helpserv_reqs_bynick_dict
, req
->user
->nick
);
1590 helpserv_reqlist_remove(req
->parent_nick_list
, req
);
1593 if (req
->parent_hand_list
) {
1594 if (req
->parent_hand_list
->used
== 1) {
1595 dict_remove(helpserv_reqs_byhand_dict
, req
->handle
->handle
);
1597 helpserv_reqlist_remove(req
->parent_hand_list
, req
);
1601 free_string_list(req
->text
);
1605 static HELPSERV_FUNC(cmd_close
) {
1606 struct helpserv_request
*req
, *newest
=NULL
;
1607 struct helpserv_reqlist
*nick_list
, *hand_list
;
1608 struct helpserv_user
*hs_user
=GetHSUser(hs
, user
->handle_info
);
1609 struct userNode
*req_user
=NULL
;
1610 char close_reason
[MAXLEN
], reqnum
[12];
1611 unsigned long old_req
;
1619 if (!(req
= smart_get_request(hs
, hs_user
, argv
[1], &num_requests
))) {
1620 helpserv_notice(user
, "HSMSG_REQ_INVALID", argv
[1]);
1624 sprintf(reqnum
, "%lu", req
->id
);
1626 if (num_requests
> 1)
1627 helpserv_notice(user
, "HSMSG_REQ_FOUNDMANY");
1629 if (hs_user
->level
< HlManager
&& req
->helper
!= hs_user
) {
1631 helpserv_notice(user
, "HSMSG_REQ_NOT_YOURS_ASSIGNED_TO", req
->id
, req
->helper
->handle
->handle
);
1633 helpserv_notice(user
, "HSMSG_REQ_NOT_YOURS_UNASSIGNED", req
->id
);
1637 helpserv_notice(user
, "HSMSG_REQ_CLOSED", req
->id
);
1639 req_user
= req
->user
;
1640 helpserv_message(hs
, req
->user
, MSGTYPE_REQ_CLOSED
);
1642 helpserv_page(PGSRC_STATUS
, "HSMSG_PAGE_CLOSE_REQUEST_1", req
->id
, req
->user
->nick
, req
->handle
->handle
, user
->nick
);
1644 helpserv_page(PGSRC_STATUS
, "HSMSG_PAGE_CLOSE_REQUEST_2", req
->id
, req
->user
->nick
, user
->nick
);
1647 helpserv_page(PGSRC_STATUS
, "HSMSG_PAGE_CLOSE_REQUEST_3", req
->id
, req
->handle
->handle
, user
->nick
);
1649 helpserv_page(PGSRC_STATUS
, "HSMSG_PAGE_CLOSE_REQUEST_4", req
->id
, user
->nick
);
1652 hs_user
->closed
[0]++;
1653 hs_user
->closed
[4]++;
1655 /* Set these to keep track of the lists after the request is gone, but
1656 * not if free_request() will helpserv_reqlist_free() them. */
1657 nick_list
= req
->parent_nick_list
;
1658 if (nick_list
&& (nick_list
->used
== 1))
1660 hand_list
= req
->parent_hand_list
;
1661 if (hand_list
&& (hand_list
->used
== 1))
1666 snprintf(close_reason
, MAXLEN
, "Closed by %s: %s", user
->handle_info
->handle
, unsplit_string(argv
+2, argc
-2, NULL
));
1668 sprintf(close_reason
, "Closed by %s", user
->handle_info
->handle
);
1670 helpserv_log_request(req
, close_reason
);
1671 dict_remove(hs
->requests
, reqnum
);
1673 /* Look for other requests associated with them */
1675 for (i
=0; i
< nick_list
->used
; i
++) {
1676 req
= nick_list
->list
[i
];
1680 if (!newest
|| (newest
->opened
< req
->opened
))
1685 helpserv_msguser(newest
->user
, "HSMSG_REQ_FOUND_ANOTHER", old_req
, newest
->id
);
1688 if (req_user
&& hs
->auto_devoice
) {
1689 struct modeNode
*mn
= GetUserMode(hs
->helpchan
, req_user
);
1690 if ((!newest
|| !newest
->helper
) && mn
&& (mn
->modes
& MODE_VOICE
)) {
1691 struct mod_chanmode change
;
1692 mod_chanmode_init(&change
);
1694 change
.args
[0].mode
= MODE_REMOVE
| MODE_VOICE
;
1695 change
.args
[0].u
.member
= mn
;
1696 mod_chanmode_announce(hs
->helpserv
, hs
->helpchan
, &change
);
1703 static HELPSERV_FUNC(cmd_list
) {
1706 struct helpfile_table tbl
;
1707 unsigned int line
, total
;
1708 struct helpserv_request
*req
;
1710 if ((argc
< 2) || !irccasecmp(argv
[1], "unassigned")) {
1711 for (req
= hs
->unhandled
, total
=0; req
; req
= req
->next_unhandled
, total
++) ;
1712 helpserv_notice(user
, "HSMSG_REQ_LIST_TOP_UNASSIGNED", total
);
1713 searchtype
= 1; /* Unassigned */
1714 } else if (!irccasecmp(argv
[1], "assigned")) {
1715 for (req
= hs
->unhandled
, total
=dict_size(hs
->requests
); req
; req
= req
->next_unhandled
, total
--) ;
1716 helpserv_notice(user
, "HSMSG_REQ_LIST_TOP_ASSIGNED", total
);
1717 searchtype
= 2; /* Assigned */
1718 } else if (!irccasecmp(argv
[1], "me")) {
1719 for (total
= 0, it
= dict_first(hs
->requests
); it
; it
= iter_next(it
)) {
1720 req
= iter_data(it
);
1721 if (req
->helper
&& (req
->helper
->handle
== user
->handle_info
))
1724 helpserv_notice(user
, "HSMSG_REQ_LIST_TOP_YOUR", total
);
1726 } else if (!irccasecmp(argv
[1], "all")) {
1727 total
= dict_size(hs
->requests
);
1728 helpserv_notice(user
, "HSMSG_REQ_LIST_TOP_ALL", total
);
1729 searchtype
= 3; /* All */
1731 helpserv_notice(user
, "HSMSG_BAD_REQ_TYPE", argv
[1]);
1736 helpserv_notice(user
, "HSMSG_REQ_LIST_NONE");
1740 tbl
.length
= total
+1;
1742 tbl
.flags
= TABLE_NO_FREE
;
1743 tbl
.contents
= alloca(tbl
.length
* sizeof(*tbl
.contents
));
1744 tbl
.contents
[0] = alloca(tbl
.width
* sizeof(**tbl
.contents
));
1745 tbl
.contents
[0][0] = "ID#";
1746 tbl
.contents
[0][1] = "User";
1747 tbl
.contents
[0][2] = "Helper";
1748 tbl
.contents
[0][3] = "Time open";
1749 tbl
.contents
[0][4] = "User status";
1751 for (it
=dict_first(hs
->requests
), line
=0; it
; it
=iter_next(it
)) {
1752 char opentime
[INTERVALLEN
], reqid
[12], username
[NICKLEN
+2];
1754 req
= iter_data(it
);
1756 switch (searchtype
) {
1769 if (!req
->helper
|| (req
->helper
->handle
!= user
->handle_info
))
1776 tbl
.contents
[line
] = alloca(tbl
.width
* sizeof(**tbl
.contents
));
1777 sprintf(reqid
, "%lu", req
->id
);
1778 tbl
.contents
[line
][0] = strdup(reqid
);
1780 strcpy(username
, req
->user
->nick
);
1783 strcpy(username
+1, req
->handle
->handle
);
1785 tbl
.contents
[line
][1] = strdup(username
);
1786 tbl
.contents
[line
][2] = req
->helper
? req
->helper
->handle
->handle
: "(Unassigned)";
1787 intervalString(opentime
, now
- req
->opened
, user
->handle_info
);
1788 tbl
.contents
[line
][3] = strdup(opentime
);
1789 tbl
.contents
[line
][4] = ((req
->user
|| req
->handle
->users
) ? "Online" : "Offline");
1792 table_send((from_opserv
? opserv
: hs
->helpserv
), user
->nick
, 0, NULL
, tbl
);
1794 for (; line
> 0; line
--) {
1795 free((char *)tbl
.contents
[line
][0]);
1796 free((char *)tbl
.contents
[line
][1]);
1797 free((char *)tbl
.contents
[line
][3]);
1803 static void helpserv_show(int from_opserv
, struct helpserv_bot
*hs
, struct userNode
*user
, struct helpserv_request
*req
) {
1805 char buf
[MAX_LINE_SIZE
];
1806 char buf2
[INTERVALLEN
];
1810 helpserv_notice(user
, "HSMSG_REQ_INFO_2a", req
->user
->nick
, req
->handle
->handle
);
1812 helpserv_notice(user
, "HSMSG_REQ_INFO_2b", req
->user
->nick
);
1813 else if (req
->handle
)
1814 if (req
->handle
->users
)
1815 helpserv_notice(user
, "HSMSG_REQ_INFO_2c", req
->handle
->handle
);
1817 helpserv_notice(user
, "HSMSG_REQ_INFO_2d", req
->handle
->handle
);
1819 helpserv_notice(user
, "HSMSG_REQ_INFO_2e");
1820 strftime(buf
, MAX_LINE_SIZE
, HSFMT_TIME
, localtime(&req
->opened
));
1821 intervalString(buf2
, now
- req
->opened
, user
->handle_info
);
1822 helpserv_notice(user
, "HSMSG_REQ_INFO_3", buf
, buf2
);
1823 helpserv_notice(user
, "HSMSG_REQ_INFO_4");
1824 for (nn
=0; nn
< req
->text
->used
; nn
++)
1825 helpserv_notice(user
, "HSMSG_REQ_INFO_MESSAGE", req
->text
->list
[nn
]);
1828 /* actor is the one who executed the command... it should == user except from
1830 static int helpserv_assign(int from_opserv
, struct helpserv_bot
*hs
, struct userNode
*user
, struct userNode
*actor
, struct helpserv_request
*req
) {
1831 struct helpserv_request
*req2
;
1832 struct helpserv_user
*old_helper
;
1834 if (!user
->handle_info
)
1836 if ((hs
->persist_types
[PERSIST_T_HELPER
] == PERSIST_PART
) && !GetUserMode(hs
->helpchan
, user
)) {
1837 struct helpserv_user
*hsuser_actor
= GetHSUser(hs
, actor
->handle_info
);
1838 if (hsuser_actor
->level
< HlManager
) {
1839 helpserv_notice(user
, "HSMSG_REQ_YOU_NOT_IN_HELPCHAN", hs
->helpchan
->name
);
1841 } else if (user
!= actor
) {
1842 helpserv_notice(user
, "HSMSG_REQ_YOU_NOT_IN_OVERRIDE", hs
->helpchan
->name
);
1843 helpserv_notice(actor
, "HSMSG_REQ_HIM_NOT_IN_OVERRIDE", user
->nick
, hs
->helpchan
->name
);
1845 helpserv_notice(user
, "HSMSG_REQ_SELF_NOT_IN_OVERRIDE", hs
->helpchan
->name
);
1848 hs
->last_active
= now
;
1849 if ((old_helper
= req
->helper
)) {
1850 /* don't need to remove from the unhandled queue */
1851 } else if (hs
->unhandled
== req
) {
1852 hs
->unhandled
= req
->next_unhandled
;
1853 } else for (req2
= hs
->unhandled
; req2
; req2
= req2
->next_unhandled
) {
1854 if (req2
->next_unhandled
== req
) {
1855 req2
->next_unhandled
= req
->next_unhandled
;
1859 req
->next_unhandled
= NULL
;
1860 req
->helper
= GetHSUser(hs
, user
->handle_info
);
1861 assert(req
->helper
);
1862 req
->assigned
= now
;
1865 helpserv_notice(user
, "HSMSG_REQ_REASSIGNED", req
->id
, old_helper
->handle
->handle
);
1866 req
->helper
->reassigned_to
[0]++;
1867 req
->helper
->reassigned_to
[4]++;
1868 old_helper
->reassigned_from
[0]++;
1869 old_helper
->reassigned_from
[4]++;
1871 helpserv_notice(user
, "HSMSG_REQ_ASSIGNED_YOU", req
->id
);
1872 req
->helper
->picked_up
[0]++;
1873 req
->helper
->picked_up
[4]++;
1875 helpserv_show(from_opserv
, hs
, user
, req
);
1877 helpserv_message(hs
, req
->user
, MSGTYPE_REQ_ASSIGNED
);
1879 helpserv_msguser(req
->user
, "HSMSG_REQ_ASSIGNED_AGAIN", req
->id
, user
->handle_info
->handle
, user
->nick
);
1881 helpserv_msguser(req
->user
, "HSMSG_REQ_ASSIGNED", req
->id
, user
->handle_info
->handle
, user
->nick
);
1884 helpserv_page(PGSRC_STATUS
, "HSMSG_PAGE_ASSIGN_REQUEST_1", req
->id
, req
->user
->nick
, req
->handle
->handle
, user
->nick
);
1886 helpserv_page(PGSRC_STATUS
, "HSMSG_PAGE_ASSIGN_REQUEST_2", req
->id
, req
->user
->nick
, user
->nick
);
1889 helpserv_page(PGSRC_STATUS
, "HSMSG_PAGE_ASSIGN_REQUEST_3", req
->id
, req
->handle
->handle
, user
->nick
);
1891 helpserv_page(PGSRC_STATUS
, "HSMSG_PAGE_ASSIGN_REQUEST_4", req
->id
, user
->nick
);
1894 if (req
->user
&& hs
->auto_voice
) {
1895 struct mod_chanmode change
;
1896 mod_chanmode_init(&change
);
1898 change
.args
[0].mode
= MODE_VOICE
;
1899 if ((change
.args
[0].u
.member
= GetUserMode(hs
->helpchan
, req
->user
)))
1900 mod_chanmode_announce(hs
->helpserv
, hs
->helpchan
, &change
);
1906 static HELPSERV_FUNC(cmd_next
) {
1907 struct helpserv_request
*req
;
1909 if (!(req
= hs
->unhandled
)) {
1910 helpserv_notice(user
, "HSMSG_REQ_NO_UNASSIGNED");
1913 return helpserv_assign(from_opserv
, hs
, user
, user
, req
);
1916 static HELPSERV_FUNC(cmd_show
) {
1917 struct helpserv_request
*req
;
1918 struct helpserv_user
*hs_user
=GetHSUser(hs
, user
->handle_info
);
1923 if (!(req
= smart_get_request(hs
, hs_user
, argv
[1], &num_requests
))) {
1924 helpserv_notice(user
, "HSMSG_REQ_INVALID", argv
[1]);
1928 if (num_requests
> 1)
1929 helpserv_notice(user
, "HSMSG_REQ_FOUNDMANY");
1931 helpserv_notice(user
, "HSMSG_REQ_INFO_1", req
->id
);
1932 helpserv_show(from_opserv
, hs
, user
, req
);
1936 static HELPSERV_FUNC(cmd_pickup
) {
1937 struct helpserv_request
*req
;
1938 struct helpserv_user
*hs_user
=GetHSUser(hs
, user
->handle_info
);
1945 if (!(req
= smart_get_request(hs
, hs_user
, argv
[1], &num_requests
))) {
1946 helpserv_notice(user
, "HSMSG_REQ_INVALID", argv
[1]);
1950 if (num_requests
> 1)
1951 helpserv_notice(user
, "HSMSG_REQ_FOUNDMANY");
1953 return helpserv_assign(from_opserv
, hs
, user
, user
, req
);
1956 static HELPSERV_FUNC(cmd_reassign
) {
1957 struct helpserv_request
*req
;
1958 struct userNode
*targetuser
;
1959 struct helpserv_user
*target
;
1960 struct helpserv_user
*hs_user
=GetHSUser(hs
, user
->handle_info
);
1967 if (!(req
= smart_get_request(hs
, hs_user
, argv
[1], &num_requests
))) {
1968 helpserv_notice(user
, "HSMSG_REQ_INVALID", argv
[1]);
1972 if (num_requests
> 1)
1973 helpserv_notice(user
, "HSMSG_REQ_FOUNDMANY");
1975 if (!(targetuser
= GetUserH(argv
[2]))) {
1976 helpserv_notice(user
, "MSG_NICK_UNKNOWN", argv
[2]);
1980 if (!targetuser
->handle_info
) {
1981 helpserv_notice(user
, "MSG_USER_AUTHENTICATE", targetuser
->nick
);
1985 if (!(target
= GetHSUser(hs
, targetuser
->handle_info
))) {
1986 helpserv_notice(user
, "HSMSG_NOT_IN_USERLIST", targetuser
->nick
, hs
->helpserv
->nick
);
1990 if ((hs
->persist_types
[PERSIST_T_HELPER
] == PERSIST_PART
) && !GetUserMode(hs
->helpchan
, user
) && (hs_user
->level
< HlManager
)) {
1991 helpserv_notice(user
, "HSMSG_REQ_HIM_NOT_IN_HELPCHAN", targetuser
->nick
, hs
->helpchan
->name
);
1995 helpserv_assign(from_opserv
, hs
, targetuser
, user
, req
);
1999 static HELPSERV_FUNC(cmd_addnote
) {
2000 char text
[MAX_LINE_SIZE
], timestr
[MAX_LINE_SIZE
], *note
;
2001 struct helpserv_request
*req
;
2002 struct helpserv_user
*hs_user
=GetHSUser(hs
, user
->handle_info
);
2007 if (!(req
= smart_get_request(hs
, hs_user
, argv
[1], &num_requests
))) {
2008 helpserv_notice(user
, "HSMSG_REQ_INVALID", argv
[1]);
2012 if (num_requests
> 1)
2013 helpserv_notice(user
, "HSMSG_REQ_FOUNDMANY");
2015 note
= unsplit_string(argv
+2, argc
-2, NULL
);
2017 strftime(timestr
, MAX_LINE_SIZE
, HSFMT_TIME
, localtime(&now
));
2018 snprintf(text
, MAX_LINE_SIZE
, "[Helper note at %s]:", timestr
);
2019 string_list_append(req
->text
, strdup(text
));
2020 snprintf(text
, MAX_LINE_SIZE
, " <%s> %s", user
->handle_info
->handle
, note
);
2021 string_list_append(req
->text
, strdup(text
));
2023 helpserv_notice(user
, "HSMSG_REQMSG_NOTE_ADDED", req
->id
);
2028 static HELPSERV_FUNC(cmd_page
) {
2031 helpserv_page(PGSRC_COMMAND
, "HSMSG_PAGE_REQUEST", user
->nick
, unsplit_string(argv
+1, argc
-1, NULL
));
2036 static HELPSERV_FUNC(cmd_stats
) {
2037 struct helpserv_user
*target
, *hs_user
;
2038 struct handle_info
*target_handle
;
2039 struct helpfile_table tbl
;
2041 char intervalstr
[INTERVALLEN
], buf
[16];
2043 hs_user
= from_opserv
? NULL
: GetHSUser(hs
, user
->handle_info
);
2046 if (!from_opserv
&& (hs_user
->level
< HlManager
)) {
2047 helpserv_notice(user
, "HSMSG_NEED_MANAGER");
2051 if (!(target_handle
= helpserv_get_handle_info(user
, argv
[1]))) {
2055 if (!(target
= GetHSUser(hs
, target_handle
))) {
2056 helpserv_notice(user
, "HSMSG_NOT_IN_USERLIST", target_handle
->handle
, hs
->helpserv
->nick
);
2061 helpserv_notice(user
, "HSMSG_OPSERV_NEED_USER");
2067 helpserv_notice(user
, "HSMSG_STATS_TOP", hs
->helpserv
->nick
, target
->handle
->handle
, weekday_names
[target
->week_start
]);
2071 tbl
.flags
= TABLE_NO_FREE
;
2072 tbl
.contents
= alloca(tbl
.length
* sizeof(*tbl
.contents
));
2073 tbl
.contents
[0] = alloca(tbl
.width
* sizeof(**tbl
.contents
));
2074 tbl
.contents
[0][0] = "";
2075 tbl
.contents
[0][1] = "Recorded time";
2076 for (i
=0; i
< 5; i
++) {
2077 unsigned int week_time
= target
->time_per_week
[i
];
2078 tbl
.contents
[i
+1] = alloca(tbl
.width
* sizeof(**tbl
.contents
));
2079 if ((i
== 0 || i
== 4) && target
->join_time
)
2080 week_time
+= now
- target
->join_time
;
2081 helpserv_interval(intervalstr
, week_time
);
2082 tbl
.contents
[i
+1][1] = strdup(intervalstr
);
2084 tbl
.contents
[1][0] = "This week";
2085 tbl
.contents
[2][0] = "Last week";
2086 tbl
.contents
[3][0] = "2 weeks ago";
2087 tbl
.contents
[4][0] = "3 weeks ago";
2088 tbl
.contents
[5][0] = "Total";
2090 helpserv_notice(user
, "HSMSG_STATS_TIME", hs
->helpchan
->name
);
2091 table_send((from_opserv
? opserv
: hs
->helpserv
), user
->nick
, 0, NULL
, tbl
);
2093 for (i
=1; i
<= 5; i
++)
2094 free((char *)tbl
.contents
[i
][1]);
2098 tbl
.flags
= TABLE_NO_FREE
;
2099 tbl
.contents
= alloca(tbl
.length
* sizeof(*tbl
.contents
));
2100 tbl
.contents
[0] = alloca(tbl
.width
* sizeof(**tbl
.contents
));
2101 tbl
.contents
[1] = alloca(tbl
.width
* sizeof(**tbl
.contents
));
2102 tbl
.contents
[2] = alloca(tbl
.width
* sizeof(**tbl
.contents
));
2103 tbl
.contents
[3] = alloca(tbl
.width
* sizeof(**tbl
.contents
));
2104 tbl
.contents
[4] = alloca(tbl
.width
* sizeof(**tbl
.contents
));
2105 tbl
.contents
[0][0] = "Category";
2106 tbl
.contents
[0][1] = "This week";
2107 tbl
.contents
[0][2] = "Last week";
2108 tbl
.contents
[0][3] = "Total";
2110 tbl
.contents
[1][0] = "Requests picked up";
2111 for (i
=0; i
< 3; i
++) {
2112 sprintf(buf
, "%u", target
->picked_up
[(i
== 2 ? 4 : i
)]);
2113 tbl
.contents
[1][i
+1] = strdup(buf
);
2115 tbl
.contents
[2][0] = "Requests closed";
2116 for (i
=0; i
< 3; i
++) {
2117 sprintf(buf
, "%u", target
->closed
[(i
== 2 ? 4 : i
)]);
2118 tbl
.contents
[2][i
+1] = strdup(buf
);
2120 tbl
.contents
[3][0] = "Reassigned from";
2121 for (i
=0; i
< 3; i
++) {
2122 sprintf(buf
, "%u", target
->reassigned_from
[(i
== 2 ? 4 : i
)]);
2123 tbl
.contents
[3][i
+1] = strdup(buf
);
2125 tbl
.contents
[4][0] = "Reassigned to";
2126 for (i
=0; i
< 3; i
++) {
2127 sprintf(buf
, "%u", target
->reassigned_to
[(i
== 2 ? 4 : i
)]);
2128 tbl
.contents
[4][i
+1] = strdup(buf
);
2131 helpserv_notice(user
, "HSMSG_STATS_REQS");
2132 table_send((from_opserv
? opserv
: hs
->helpserv
), user
->nick
, 0, NULL
, tbl
);
2134 for (i
=1; i
< 5; i
++) {
2135 free((char *)tbl
.contents
[i
][1]);
2136 free((char *)tbl
.contents
[i
][2]);
2137 free((char *)tbl
.contents
[i
][3]);
2143 static HELPSERV_FUNC(cmd_statsreport
) {
2145 struct helpfile_table tbl
;
2147 unsigned int line
, i
;
2148 struct userNode
*srcbot
= from_opserv
? opserv
: hs
->helpserv
;
2150 if ((argc
> 1) && !irccasecmp(argv
[1], "NOTICE"))
2153 tbl
.length
= dict_size(hs
->users
)+1;
2155 tbl
.flags
= TABLE_NO_FREE
;
2156 tbl
.contents
= alloca(tbl
.length
* sizeof(*tbl
.contents
));
2157 tbl
.contents
[0] = alloca(tbl
.width
* sizeof(**tbl
.contents
));
2158 tbl
.contents
[0][0] = "Account";
2159 tbl
.contents
[0][1] = "Requests";
2160 tbl
.contents
[0][2] = "Time helping";
2162 for (it
=dict_first(hs
->users
), line
=0; it
; it
=iter_next(it
)) {
2163 struct helpserv_user
*hs_user
=iter_data(it
);
2165 tbl
.contents
[++line
] = alloca(tbl
.width
* sizeof(**tbl
.contents
));
2166 tbl
.contents
[line
][0] = hs_user
->handle
->handle
;
2167 tbl
.contents
[line
][1] = malloc(12);
2168 tbl
.contents
[line
][2] = malloc(32); /* A bit more than needed */
2171 /* 4 to 1 instead of 3 to 0 because it's unsigned */
2172 for (i
=4; i
> 0; i
--) {
2173 for (it
=dict_first(hs
->users
), line
=0; it
; it
=iter_next(it
)) {
2174 struct helpserv_user
*hs_user
= iter_data(it
);
2176 unsigned int week_time
= hs_user
->time_per_week
[i
-1];
2177 if ((i
==1) && hs_user
->join_time
)
2178 week_time
+= now
- hs_user
->join_time
;
2179 helpserv_interval((char *)tbl
.contents
[++line
][2], week_time
);
2182 sprintf((char *)tbl
.contents
[line
][1], "%u", hs_user
->picked_up
[i
-1]+hs_user
->reassigned_to
[i
-1]);
2184 send_target_message(use_privmsg
, user
->nick
, srcbot
, statsreport_week
[i
-1]);
2185 table_send(srcbot
, user
->nick
, 0, (use_privmsg
? irc_privmsg
: irc_notice
), tbl
);
2188 for (line
=1; line
<= dict_size(hs
->users
); line
++) {
2189 free((char *)tbl
.contents
[line
][1]);
2190 free((char *)tbl
.contents
[line
][2]);
2197 helpserv_in_channel(struct helpserv_bot
*hs
, struct chanNode
*channel
) {
2198 enum page_source pgsrc
;
2199 if (channel
== hs
->helpchan
)
2201 for (pgsrc
=0; pgsrc
<PGSRC_COUNT
; pgsrc
++)
2202 if (channel
== hs
->page_targets
[pgsrc
])
2207 static HELPSERV_FUNC(cmd_move
) {
2209 helpserv_notice(user
, "HSMSG_INVALID_BOT");
2215 if (is_valid_nick(argv
[1])) {
2216 char *newnick
= argv
[1], oldnick
[NICKLEN
], reason
[MAXLEN
];
2218 strcpy(oldnick
, hs
->helpserv
->nick
);
2220 if (GetUserH(newnick
)) {
2221 helpserv_notice(user
, "HSMSG_NICK_EXISTS", newnick
);
2225 dict_remove2(helpserv_bots_dict
, hs
->helpserv
->nick
, 1);
2226 NickChange(hs
->helpserv
, newnick
, 0);
2227 dict_insert(helpserv_bots_dict
, hs
->helpserv
->nick
, hs
);
2229 helpserv_notice(user
, "HSMSG_RENAMED", oldnick
, newnick
);
2231 snprintf(reason
, MAXLEN
, "HelpServ bot %s (in %s) renamed to %s by %s.", oldnick
, hs
->helpchan
->name
, newnick
, user
->nick
);
2232 global_message(MESSAGE_RECIPIENT_OPERS
, reason
);
2235 } else if (IsChannelName(argv
[1])) {
2236 struct chanNode
*old_helpchan
= hs
->helpchan
;
2237 char *newchan
= argv
[1], oldchan
[CHANNELLEN
], reason
[MAXLEN
];
2238 struct helpserv_botlist
*botlist
;
2240 strcpy(oldchan
, hs
->helpchan
->name
);
2242 if (!irccasecmp(oldchan
, newchan
)) {
2243 helpserv_notice(user
, "HSMSG_MOVE_SAME_CHANNEL", hs
->helpserv
->nick
);
2247 if (opserv_bad_channel(newchan
)) {
2248 helpserv_notice(user
, "HSMSG_ILLEGAL_CHANNEL", newchan
);
2252 botlist
= dict_find(helpserv_bots_bychan_dict
, hs
->helpchan
->name
, NULL
);
2253 helpserv_botlist_remove(botlist
, hs
);
2254 if (botlist
->used
== 0) {
2255 dict_remove(helpserv_bots_bychan_dict
, hs
->helpchan
->name
);
2258 hs
->helpchan
= NULL
;
2259 if (!helpserv_in_channel(hs
, old_helpchan
)) {
2260 snprintf(reason
, MAXLEN
, "Moved to %s by %s.", newchan
, user
->nick
);
2261 DelChannelUser(hs
->helpserv
, old_helpchan
, reason
, 0);
2264 if (!(hs
->helpchan
= GetChannel(newchan
))) {
2265 hs
->helpchan
= AddChannel(newchan
, now
, NULL
, NULL
, NULL
);
2266 AddChannelUser(hs
->helpserv
, hs
->helpchan
)->modes
|= MODE_CHANOP
;
2267 } else if (!helpserv_in_channel(hs
, old_helpchan
)) {
2268 struct mod_chanmode change
;
2269 mod_chanmode_init(&change
);
2271 change
.args
[0].mode
= MODE_CHANOP
;
2272 change
.args
[0].u
.member
= AddChannelUser(hs
->helpserv
, hs
->helpchan
);
2273 mod_chanmode_announce(hs
->helpserv
, hs
->helpchan
, &change
);
2276 if (!(botlist
= dict_find(helpserv_bots_bychan_dict
, hs
->helpchan
->name
, NULL
))) {
2277 botlist
= helpserv_botlist_alloc();
2278 dict_insert(helpserv_bots_bychan_dict
, hs
->helpchan
->name
, botlist
);
2280 helpserv_botlist_append(botlist
, hs
);
2282 snprintf(reason
, MAXLEN
, "HelpServ %s (%s) moved to %s by %s.", hs
->helpserv
->nick
, oldchan
, newchan
, user
->nick
);
2283 global_message(MESSAGE_RECIPIENT_OPERS
, reason
);
2287 helpserv_notice(user
, "HSMSG_INVALID_MOVE", argv
[1]);
2292 static HELPSERV_FUNC(cmd_bots
) {
2294 struct helpfile_table tbl
;
2297 helpserv_notice(user
, "HSMSG_BOTLIST_HEADER");
2299 tbl
.length
= dict_size(helpserv_bots_dict
)+1;
2301 tbl
.flags
= TABLE_NO_FREE
;
2302 tbl
.contents
= alloca(tbl
.length
* sizeof(*tbl
.contents
));
2303 tbl
.contents
[0] = alloca(tbl
.width
* sizeof(**tbl
.contents
));
2304 tbl
.contents
[0][0] = "Bot";
2305 tbl
.contents
[0][1] = "Channel";
2306 tbl
.contents
[0][2] = "Owner";
2307 tbl
.contents
[0][3] = "Inactivity";
2309 for (it
=dict_first(helpserv_bots_dict
), i
=1; it
; it
=iter_next(it
), i
++) {
2310 dict_iterator_t it2
;
2311 struct helpserv_bot
*bot
;
2312 struct helpserv_user
*owner
=NULL
;
2314 bot
= iter_data(it
);
2316 for (it2
=dict_first(bot
->users
); it2
; it2
=iter_next(it2
)) {
2317 if (((struct helpserv_user
*)iter_data(it2
))->level
== HlOwner
) {
2318 owner
= iter_data(it2
);
2323 tbl
.contents
[i
] = alloca(tbl
.width
* sizeof(**tbl
.contents
));
2324 tbl
.contents
[i
][0] = iter_key(it
);
2325 tbl
.contents
[i
][1] = bot
->helpchan
->name
;
2326 tbl
.contents
[i
][2] = owner
? owner
->handle
->handle
: "None";
2327 tbl
.contents
[i
][3] = alloca(INTERVALLEN
);
2328 intervalString((char*)tbl
.contents
[i
][3], now
- bot
->last_active
, user
->handle_info
);
2331 table_send((from_opserv
? opserv
: hs
->helpserv
), user
->nick
, 0, NULL
, tbl
);
2336 static void helpserv_page_helper_gone(struct helpserv_bot
*hs
, struct helpserv_request
*req
, const char *reason
) {
2337 const int from_opserv
= 0;
2342 /* Let the user know that their request is now unhandled */
2344 struct modeNode
*mn
= GetUserMode(hs
->helpchan
, req
->user
);
2345 helpserv_msguser(req
->user
, "HSMSG_REQ_UNASSIGNED", req
->id
, reason
);
2346 if (hs
->auto_devoice
&& mn
&& (mn
->modes
& MODE_VOICE
)) {
2347 struct mod_chanmode change
;
2348 mod_chanmode_init(&change
);
2350 change
.args
[0].mode
= MODE_REMOVE
| MODE_VOICE
;
2351 change
.args
[0].u
.member
= mn
;
2352 mod_chanmode_announce(hs
->helpserv
, hs
->helpchan
, &change
);
2355 helpserv_page(PGSRC_STATUS
, "HSMSG_PAGE_HELPER_GONE_1", req
->id
, req
->user
->nick
, req
->handle
->handle
, req
->helper
->handle
->handle
, reason
);
2357 helpserv_page(PGSRC_STATUS
, "HSMSG_PAGE_HELPER_GONE_2", req
->id
, req
->user
->nick
, req
->helper
->handle
->handle
, reason
);
2360 helpserv_page(PGSRC_STATUS
, "HSMSG_PAGE_HELPER_GONE_3", req
->id
, req
->handle
->handle
, req
->helper
->handle
->handle
, reason
);
2362 helpserv_page(PGSRC_STATUS
, "HSMSG_PAGE_HELPER_GONE_2", req
->id
, req
->helper
->handle
->handle
, reason
);
2365 /* Now put it back in the queue */
2366 if (hs
->unhandled
== NULL
) {
2367 /* Nothing there, put it at the front */
2368 hs
->unhandled
= req
;
2369 req
->next_unhandled
= NULL
;
2371 /* Should it be at the front? */
2372 if (hs
->unhandled
->opened
>= req
->opened
) {
2373 req
->next_unhandled
= hs
->unhandled
;
2374 hs
->unhandled
= req
;
2376 struct helpserv_request
*unhandled
;
2377 /* Find the request that this should be inserted AFTER */
2378 for (unhandled
=hs
->unhandled
; unhandled
->next_unhandled
&& (unhandled
->next_unhandled
->opened
< req
->opened
); unhandled
= unhandled
->next_unhandled
);
2379 req
->next_unhandled
= unhandled
->next_unhandled
;
2380 unhandled
->next_unhandled
= req
;
2387 /* This takes care of WHINE_DELAY and IDLE_DELAY */
2388 static void run_whine_interval(void *data
) {
2389 struct helpserv_bot
*hs
=data
;
2390 struct helpfile_table tbl
;
2393 /* First, run the WHINE_DELAY */
2394 if (hs
->intervals
[INTERVAL_WHINE_DELAY
]
2395 && (hs
->page_types
[PGSRC_ALERT
] != PAGE_NONE
)
2396 && (hs
->page_targets
[PGSRC_ALERT
] != NULL
)
2397 && (!hs
->intervals
[INTERVAL_EMPTY_INTERVAL
] || !hs
->helpchan_empty
)) {
2398 struct helpserv_request
*unh
;
2399 struct helpserv_reqlist reqlist
;
2400 unsigned int queuesize
=0;
2402 helpserv_reqlist_init(&reqlist
);
2404 for (unh
= hs
->unhandled
; unh
; unh
= unh
->next_unhandled
) {
2406 if ((now
- unh
->opened
) >= (time_t)hs
->intervals
[INTERVAL_WHINE_DELAY
]) {
2407 helpserv_reqlist_append(&reqlist
, unh
);
2412 char strwhinedelay
[INTERVALLEN
];
2414 intervalString(strwhinedelay
, (time_t)hs
->intervals
[INTERVAL_WHINE_DELAY
], NULL
);
2415 #if ANNOYING_ALERT_PAGES
2416 tbl
.length
= reqlist
.used
+ 1;
2418 tbl
.flags
= TABLE_NO_FREE
;
2419 tbl
.contents
= alloca(tbl
.length
* sizeof(*tbl
.contents
));
2420 tbl
.contents
[0] = alloca(tbl
.width
* sizeof(**tbl
.contents
));
2421 tbl
.contents
[0][0] = "ID#";
2422 tbl
.contents
[0][1] = "Nick";
2423 tbl
.contents
[0][2] = "Account";
2424 tbl
.contents
[0][3] = "Waiting time";
2426 for (i
=1; i
<= reqlist
.used
; i
++) {
2427 char reqid
[12], unh_time
[INTERVALLEN
];
2428 unh
= reqlist
.list
[i
-1];
2430 tbl
.contents
[i
] = alloca(tbl
.width
* sizeof(**tbl
.contents
));
2431 sprintf(reqid
, "%lu", unh
->id
);
2432 tbl
.contents
[i
][0] = strdup(reqid
);
2433 tbl
.contents
[i
][1] = unh
->user
? unh
->user
->nick
: "Not online";
2434 tbl
.contents
[i
][2] = unh
->handle
? unh
->handle
->handle
: "Not authed";
2435 intervalString(unh_time
, now
- unh
->opened
, NULL
);
2436 tbl
.contents
[i
][3] = strdup(unh_time
);
2439 helpserv_page(PGSRC_ALERT
, "HSMSG_PAGE_WHINE_HEADER", reqlist
.used
, strwhinedelay
, queuesize
);
2440 table_send(hs
->helpserv
, hs
->page_targets
[PGSRC_ALERT
]->name
, 0, page_type_funcs
[hs
->page_types
[PGSRC_ALERT
]], tbl
);
2442 for (i
=1; i
<= reqlist
.used
; i
++) {
2443 free((char *)tbl
.contents
[i
][0]);
2444 free((char *)tbl
.contents
[i
][3]);
2447 helpserv_page(PGSRC_ALERT
, "HSMSG_PAGE_WHINE_HEADER", reqlist
.used
, strwhinedelay
, queuesize
);
2451 helpserv_reqlist_clean(&reqlist
);
2454 /* Next run IDLE_DELAY */
2455 if (hs
->intervals
[INTERVAL_IDLE_DELAY
]
2456 && (hs
->page_types
[PGSRC_STATUS
] != PAGE_NONE
)
2457 && (hs
->page_targets
[PGSRC_STATUS
] != NULL
)) {
2458 struct modeList mode_list
;
2460 modeList_init(&mode_list
);
2462 for (i
=0; i
< hs
->helpchan
->members
.used
; i
++) {
2463 struct modeNode
*mn
= hs
->helpchan
->members
.list
[i
];
2464 /* Ignore ops. Perhaps this should be a set option? */
2465 if (mn
->modes
& MODE_CHANOP
)
2467 /* Check if they've been idle long enough */
2468 if ((unsigned)(now
- mn
->idle_since
) < hs
->intervals
[INTERVAL_IDLE_DELAY
])
2470 /* Add them to the list of idle people.. */
2471 modeList_append(&mode_list
, mn
);
2474 if (mode_list
.used
) {
2475 char stridledelay
[INTERVALLEN
];
2477 tbl
.length
= mode_list
.used
+ 1;
2479 tbl
.flags
= TABLE_NO_FREE
;
2480 tbl
.contents
= alloca(tbl
.length
* sizeof(*tbl
.contents
));
2481 tbl
.contents
[0] = alloca(tbl
.width
* sizeof(**tbl
.contents
));
2482 tbl
.contents
[0][0] = "Nick";
2483 tbl
.contents
[0][1] = "Account";
2484 tbl
.contents
[0][2] = "ID#";
2485 tbl
.contents
[0][3] = "Idle time";
2487 for (i
=1; i
<= mode_list
.used
; i
++) {
2488 char reqid
[12], idle_time
[INTERVALLEN
];
2489 struct helpserv_reqlist
*reqlist
;
2490 struct modeNode
*mn
= mode_list
.list
[i
-1];
2492 tbl
.contents
[i
] = alloca(tbl
.width
* sizeof(**tbl
.contents
));
2493 tbl
.contents
[i
][0] = mn
->user
->nick
;
2494 tbl
.contents
[i
][1] = mn
->user
->handle_info
? mn
->user
->handle_info
->handle
: "Not authed";
2496 if ((reqlist
= dict_find(helpserv_reqs_bynick_dict
, mn
->user
->nick
, NULL
))) {
2499 for (j
= reqlist
->used
-1; j
>= 0; j
--) {
2500 struct helpserv_request
*req
= reqlist
->list
[j
];
2502 if (req
->hs
== hs
) {
2503 sprintf(reqid
, "%lu", req
->id
);
2509 strcpy(reqid
, "None");
2511 strcpy(reqid
, "None");
2513 tbl
.contents
[i
][2] = strdup(reqid
);
2515 intervalString(idle_time
, now
- mn
->idle_since
, NULL
);
2516 tbl
.contents
[i
][3] = strdup(idle_time
);
2519 intervalString(stridledelay
, (time_t)hs
->intervals
[INTERVAL_IDLE_DELAY
], NULL
);
2520 helpserv_page(PGSRC_STATUS
, "HSMSG_PAGE_IDLE_HEADER", mode_list
.used
, hs
->helpchan
->name
, stridledelay
);
2521 table_send(hs
->helpserv
, hs
->page_targets
[PGSRC_STATUS
]->name
, 0, page_types
[hs
->page_types
[PGSRC_STATUS
]].func
, tbl
);
2523 for (i
=1; i
<= mode_list
.used
; i
++) {
2524 free((char *)tbl
.contents
[i
][2]);
2525 free((char *)tbl
.contents
[i
][3]);
2529 modeList_clean(&mode_list
);
2532 if (hs
->intervals
[INTERVAL_WHINE_INTERVAL
]) {
2533 timeq_add(now
+ hs
->intervals
[INTERVAL_WHINE_INTERVAL
], run_whine_interval
, hs
);
2537 /* Returns -1 if there's any helpers,
2538 * 0 if there are no helpers
2539 * >1 if there are trials (number of trials)
2541 static int find_helpchan_helpers(struct helpserv_bot
*hs
) {
2545 for (it
=dict_first(hs
->users
); it
; it
=iter_next(it
)) {
2546 struct helpserv_user
*hs_user
=iter_data(it
);
2548 if (find_handle_in_channel(hs
->helpchan
, hs_user
->handle
, NULL
)) {
2549 if (hs_user
->level
>= HlHelper
) {
2550 hs
->helpchan_empty
= 0;
2557 hs
->helpchan_empty
= 1;
2562 static void run_empty_interval(void *data
) {
2563 struct helpserv_bot
*hs
=data
;
2564 int num_trials
=find_helpchan_helpers(hs
);
2565 unsigned int num_unh
;
2566 struct helpserv_request
*unh
;
2568 if (num_trials
== -1)
2570 if (hs
->req_on_join
&& !hs
->unhandled
)
2573 for (num_unh
=0, unh
=hs
->unhandled
; unh
; num_unh
++)
2574 unh
= unh
->next_unhandled
;
2577 helpserv_page(PGSRC_ALERT
, "HSMSG_PAGE_ONLYTRIALALERT", hs
->helpchan
->name
, num_trials
, num_unh
);
2579 helpserv_page(PGSRC_ALERT
, "HSMSG_PAGE_EMPTYALERT", hs
->helpchan
->name
, num_unh
);
2581 if (hs
->intervals
[INTERVAL_EMPTY_INTERVAL
])
2582 timeq_add(now
+ hs
->intervals
[INTERVAL_EMPTY_INTERVAL
], run_empty_interval
, hs
);
2585 static void free_user(void *data
) {
2586 struct helpserv_user
*hs_user
= data
;
2587 struct helpserv_bot
*hs
= hs_user
->hs
;
2588 struct helpserv_userlist
*userlist
;
2592 for (it
=dict_first(hs
->requests
); it
; it
=iter_next(it
)) {
2593 struct helpserv_request
*req
= iter_data(it
);
2595 if (req
->helper
== hs_user
)
2596 helpserv_page_helper_gone(hs
, req
, "been deleted");
2600 userlist
= dict_find(helpserv_users_byhand_dict
, hs_user
->handle
->handle
, NULL
);
2601 if (userlist
->used
== 1) {
2602 dict_remove(helpserv_users_byhand_dict
, hs_user
->handle
->handle
);
2604 helpserv_userlist_remove(userlist
, hs_user
);
2610 static struct helpserv_bot
*register_helpserv(const char *nick
, const char *help_channel
, const char *registrar
) {
2611 struct helpserv_bot
*hs
;
2612 struct helpserv_botlist
*botlist
;
2614 /* Laziness dictates calloc, since there's a lot to set to NULL or 0, and
2615 * it's a harmless default */
2616 hs
= calloc(1, sizeof(struct helpserv_bot
));
2618 if (!(hs
->helpserv
= AddService(nick
, "+iok", helpserv_conf
.description
, NULL
))) {
2623 reg_privmsg_func(hs
->helpserv
, helpserv_botmsg
);
2625 if (!(hs
->helpchan
= GetChannel(help_channel
))) {
2626 hs
->helpchan
= AddChannel(help_channel
, now
, NULL
, NULL
, NULL
);
2627 AddChannelUser(hs
->helpserv
, hs
->helpchan
)->modes
|= MODE_CHANOP
;
2629 struct mod_chanmode change
;
2630 mod_chanmode_init(&change
);
2632 change
.args
[0].mode
= MODE_CHANOP
;
2633 change
.args
[0].u
.member
= AddChannelUser(hs
->helpserv
, hs
->helpchan
);
2634 mod_chanmode_announce(hs
->helpserv
, hs
->helpchan
, &change
);
2638 hs
->registrar
= strdup(registrar
);
2640 hs
->users
= dict_new();
2641 /* Don't free keys - they use the handle_info's handle field */
2642 dict_set_free_data(hs
->users
, free_user
);
2643 hs
->requests
= dict_new();
2644 dict_set_free_keys(hs
->requests
, free
);
2645 dict_set_free_data(hs
->requests
, free_request
);
2647 dict_insert(helpserv_bots_dict
, hs
->helpserv
->nick
, hs
);
2649 if (!(botlist
= dict_find(helpserv_bots_bychan_dict
, hs
->helpchan
->name
, NULL
))) {
2650 botlist
= helpserv_botlist_alloc();
2651 dict_insert(helpserv_bots_bychan_dict
, hs
->helpchan
->name
, botlist
);
2653 helpserv_botlist_append(botlist
, hs
);
2658 static HELPSERV_FUNC(cmd_register
) {
2659 char *nick
, *helpchan
, reason
[MAXLEN
];
2660 struct handle_info
*handle
;
2664 if (!is_valid_nick(nick
)) {
2665 helpserv_notice(user
, "HSMSG_ILLEGAL_NICK", nick
);
2668 if (GetUserH(nick
)) {
2669 helpserv_notice(user
, "HSMSG_NICK_EXISTS", nick
);
2673 if (!IsChannelName(helpchan
)) {
2674 helpserv_notice(user
, "HSMSG_ILLEGAL_CHANNEL", helpchan
);
2678 if (opserv_bad_channel(helpchan
)) {
2679 helpserv_notice(user
, "HSMSG_ILLEGAL_CHANNEL", helpchan
);
2682 if (!(handle
= helpserv_get_handle_info(user
, argv
[3])))
2685 if (!(hs
= register_helpserv(nick
, helpchan
, user
->handle_info
->handle
))) {
2686 helpserv_notice(user
, "HSMSG_ERROR_ADDING_SERVICE", nick
);
2690 hs
->registered
= now
;
2691 helpserv_add_user(hs
, handle
, HlOwner
);
2693 helpserv_notice(user
, "HSMSG_REG_SUCCESS", handle
->handle
, nick
);
2695 snprintf(reason
, MAXLEN
, "HelpServ %s (%s) registered to %s by %s.", nick
, hs
->helpchan
->name
, handle
->handle
, user
->nick
);
2696 /* Not sent to helpers, since they can't register HelpServ */
2697 global_message(MESSAGE_RECIPIENT_OPERS
, reason
);
2701 static void unregister_helpserv(struct helpserv_bot
*hs
) {
2702 enum message_type msgtype
;
2704 timeq_del(0, NULL
, hs
, TIMEQ_IGNORE_WHEN
|TIMEQ_IGNORE_FUNC
);
2706 /* Requests before users so that it doesn't spam mentioning now-unhandled
2707 * requests because the users were deleted */
2708 dict_delete(hs
->requests
);
2709 hs
->requests
= NULL
; /* so we don't try to look up requests in free_user() */
2710 dict_delete(hs
->users
);
2711 free(hs
->registrar
);
2713 for (msgtype
=0; msgtype
<MSGTYPE_COUNT
; msgtype
++)
2714 free(hs
->messages
[msgtype
]);
2717 static void helpserv_free_bot(void *data
) {
2718 unregister_helpserv(data
);
2722 static void helpserv_unregister(struct helpserv_bot
*bot
, const char *quit_fmt
, const char *global_fmt
, const char *actor
) {
2723 char reason
[MAXLEN
], channame
[CHANNELLEN
], botname
[NICKLEN
];
2724 struct helpserv_botlist
*botlist
;
2727 botlist
= dict_find(helpserv_bots_bychan_dict
, bot
->helpchan
->name
, NULL
);
2728 helpserv_botlist_remove(botlist
, bot
);
2730 dict_remove(helpserv_bots_bychan_dict
, bot
->helpchan
->name
);
2731 len
= strlen(bot
->helpserv
->nick
) + 1;
2732 safestrncpy(botname
, bot
->helpserv
->nick
, len
);
2733 len
= strlen(bot
->helpchan
->name
) + 1;
2734 safestrncpy(channame
, bot
->helpchan
->name
, len
);
2735 snprintf(reason
, sizeof(reason
), quit_fmt
, actor
);
2736 DelUser(bot
->helpserv
, NULL
, 1, reason
);
2737 dict_remove(helpserv_bots_dict
, botname
);
2738 snprintf(reason
, sizeof(reason
), global_fmt
, botname
, channame
, actor
);
2739 global_message(MESSAGE_RECIPIENT_OPERS
, reason
);
2742 static HELPSERV_FUNC(cmd_unregister
) {
2744 if (argc
< 2 || strcmp(argv
[1], "CONFIRM")) {
2745 helpserv_notice(user
, "HSMSG_NEED_UNREG_CONFIRM");
2748 log_audit(HS_LOG
, LOG_COMMAND
, user
, hs
->helpserv
, hs
->helpchan
->name
, 0, "unregister CONFIRM");
2751 helpserv_unregister(hs
, "Unregistered by %s", "HelpServ %s (%s) unregistered by %s.", user
->nick
);
2755 static HELPSERV_FUNC(cmd_expire
) {
2756 struct helpserv_botlist victims
;
2757 struct helpserv_bot
*bot
;
2758 dict_iterator_t it
, next
;
2759 unsigned int count
= 0;
2761 memset(&victims
, 0, sizeof(victims
));
2762 for (it
= dict_first(helpserv_bots_dict
); it
; it
= next
) {
2763 bot
= iter_data(it
);
2764 next
= iter_next(it
);
2765 if ((unsigned int)(now
- bot
->last_active
) < helpserv_conf
.expire_age
)
2767 helpserv_unregister(bot
, "Registration expired due to inactivity", "HelpServ %s (%s) expired at request of %s.", user
->nick
);
2770 helpserv_notice(user
, "HSMSG_EXPIRATION_DONE", count
);
2774 static HELPSERV_FUNC(cmd_giveownership
) {
2775 struct handle_info
*hi
;
2776 struct helpserv_user
*new_owner
, *old_owner
, *hs_user
;
2778 char reason
[MAXLEN
];
2780 if (!from_opserv
&& ((argc
< 3) || strcmp(argv
[2], "CONFIRM"))) {
2781 helpserv_notice(user
, "HSMSG_NEED_GIVEOWNERSHIP_CONFIRM");
2784 hi
= helpserv_get_handle_info(user
, argv
[1]);
2787 new_owner
= GetHSUser(hs
, hi
);
2789 helpserv_notice(user
, "HSMSG_NOT_IN_USERLIST", hi
->handle
, hs
->helpserv
->nick
);
2793 old_owner
= GetHSUser(hs
, user
->handle_info
);
2794 else for (it
= dict_first(hs
->users
), old_owner
= NULL
; it
; it
= iter_next(it
)) {
2795 hs_user
= iter_data(it
);
2796 if (hs_user
->level
!= HlOwner
)
2799 helpserv_notice(user
, "HSMSG_MULTIPLE_OWNERS", hs
->helpserv
->nick
);
2802 old_owner
= hs_user
;
2804 if (!from_opserv
&& (new_owner
->handle
== user
->handle_info
)) {
2805 helpserv_notice(user
, "HSMSG_NO_TRANSFER_SELF");
2809 old_owner
->level
= HlManager
;
2810 new_owner
->level
= HlOwner
;
2811 helpserv_notice(user
, "HSMSG_OWNERSHIP_GIVEN", hs
->helpserv
->nick
, new_owner
->handle
->handle
);
2812 sprintf(reason
, "%s (%s) ownership transferred to %s by %s.", hs
->helpserv
->nick
, hs
->helpchan
->name
, new_owner
->handle
->handle
, user
->handle_info
->handle
);
2816 static HELPSERV_FUNC(cmd_weekstart
) {
2817 struct handle_info
*hi
;
2818 struct helpserv_user
*actor
, *victim
;
2822 actor
= from_opserv
? NULL
: GetHSUser(hs
, user
->handle_info
);
2823 if (!(hi
= helpserv_get_handle_info(user
, argv
[1])))
2825 if (!(victim
= GetHSUser(hs
, hi
))) {
2826 helpserv_notice(user
, "HSMSG_NOT_IN_USERLIST", hi
->handle
, hs
->helpserv
->nick
);
2829 if (actor
&& (actor
->level
<= victim
->level
) && (actor
!= victim
)) {
2830 helpserv_notice(user
, "MSG_USER_OUTRANKED", victim
->handle
->handle
);
2833 if (argc
> 2 && (!actor
|| actor
->level
>= HlManager
)) {
2835 switch (argv
[2][0]) {
2837 if ((argv
[2][1] == 'u') || (argv
[2][1] == 'U'))
2839 else if ((argv
[2][1] == 'a') || (argv
[2][1] == 'A'))
2842 case 'm': case 'M': new_day
= 1; break;
2844 if ((argv
[2][1] == 'u') || (argv
[2][1] == 'U'))
2846 else if ((argv
[2][1] == 'h') || (argv
[2][1] == 'H'))
2849 case 'w': case 'W': new_day
= 3; break;
2850 case 'f': case 'F': new_day
= 5; break;
2853 helpserv_notice(user
, "HSMSG_BAD_WEEKDAY", argv
[2]);
2856 victim
->week_start
= new_day
;
2859 helpserv_notice(user
, "HSMSG_WEEK_STARTS", victim
->handle
->handle
, weekday_names
[victim
->week_start
]);
2863 static void set_page_target(struct helpserv_bot
*hs
, enum page_source idx
, const char *target
) {
2864 struct chanNode
*new_target
, *old_target
;
2867 if (!IsChannelName(target
)) {
2868 log_module(HS_LOG
, LOG_ERROR
, "%s has an invalid page target.", hs
->helpserv
->nick
);
2871 new_target
= GetChannel(target
);
2873 new_target
= AddChannel(target
, now
, NULL
, NULL
, NULL
);
2874 AddChannelUser(hs
->helpserv
, new_target
);
2879 if (new_target
== hs
->page_targets
[idx
])
2881 old_target
= hs
->page_targets
[idx
];
2882 hs
->page_targets
[idx
] = NULL
;
2883 if (old_target
&& !helpserv_in_channel(hs
, old_target
))
2884 DelChannelUser(hs
->helpserv
, old_target
, "Changing page target.", 0);
2885 if (new_target
&& !helpserv_in_channel(hs
, new_target
)) {
2886 struct mod_chanmode change
;
2887 mod_chanmode_init(&change
);
2889 change
.args
[0].mode
= MODE_CHANOP
;
2890 change
.args
[0].u
.member
= AddChannelUser(hs
->helpserv
, new_target
);
2891 mod_chanmode_announce(hs
->helpserv
, new_target
, &change
);
2893 hs
->page_targets
[idx
] = new_target
;
2896 static int opt_page_target(struct userNode
*user
, struct helpserv_bot
*hs
, int from_opserv
, int argc
, char *argv
[], enum page_source idx
) {
2900 if (!IsOper(user
)) {
2901 helpserv_notice(user
, "HSMSG_SET_NEED_OPER");
2904 if (!strcmp(argv
[0], "*")) {
2905 set_page_target(hs
, idx
, NULL
);
2907 } else if (!IsChannelName(argv
[0])) {
2908 helpserv_notice(user
, "MSG_NOT_CHANNEL_NAME");
2911 set_page_target(hs
, idx
, argv
[0]);
2915 if (hs
->page_targets
[idx
])
2916 helpserv_notice(user
, page_sources
[idx
].print_target
, hs
->page_targets
[idx
]->name
);
2918 helpserv_notice(user
, page_sources
[idx
].print_target
, user_find_message(user
, "MSG_NONE"));
2922 static HELPSERV_OPTION(opt_pagetarget_command
) {
2923 return opt_page_target(user
, hs
, from_opserv
, argc
, argv
, PGSRC_COMMAND
);
2926 static HELPSERV_OPTION(opt_pagetarget_alert
) {
2927 return opt_page_target(user
, hs
, from_opserv
, argc
, argv
, PGSRC_ALERT
);
2930 static HELPSERV_OPTION(opt_pagetarget_status
) {
2931 return opt_page_target(user
, hs
, from_opserv
, argc
, argv
, PGSRC_STATUS
);
2934 static enum page_type
page_type_from_name(const char *name
) {
2935 enum page_type type
;
2936 for (type
=0; type
<PAGE_COUNT
; type
++)
2937 if (!irccasecmp(page_types
[type
].db_name
, name
))
2942 static int opt_page_type(struct userNode
*user
, struct helpserv_bot
*hs
, int from_opserv
, int argc
, char *argv
[], enum page_source idx
) {
2943 enum page_type new_type
;
2947 new_type
= page_type_from_name(argv
[0]);
2948 if (new_type
== PAGE_COUNT
) {
2949 helpserv_notice(user
, "HSMSG_INVALID_OPTION", argv
[0]);
2952 hs
->page_types
[idx
] = new_type
;
2955 helpserv_notice(user
, page_sources
[idx
].print_type
,
2956 user_find_message(user
, page_types
[hs
->page_types
[idx
]].print_name
));
2960 static HELPSERV_OPTION(opt_pagetype
) {
2961 return opt_page_type(user
, hs
, from_opserv
, argc
, argv
, PGSRC_COMMAND
);
2964 static HELPSERV_OPTION(opt_alert_page_type
) {
2965 return opt_page_type(user
, hs
, from_opserv
, argc
, argv
, PGSRC_ALERT
);
2968 static HELPSERV_OPTION(opt_status_page_type
) {
2969 return opt_page_type(user
, hs
, from_opserv
, argc
, argv
, PGSRC_STATUS
);
2972 static int opt_message(struct userNode
*user
, struct helpserv_bot
*hs
, int from_opserv
, int argc
, char *argv
[], enum message_type idx
) {
2976 char *msg
= unsplit_string(argv
, argc
, NULL
);
2977 free(hs
->messages
[idx
]);
2978 hs
->messages
[idx
] = strcmp(msg
, "*") ? strdup(msg
) : NULL
;
2981 if (hs
->messages
[idx
])
2982 helpserv_notice(user
, message_types
[idx
].print_name
, hs
->messages
[idx
]);
2984 helpserv_notice(user
, message_types
[idx
].print_name
, user_find_message(user
, "MSG_NONE"));
2988 static HELPSERV_OPTION(opt_greeting
) {
2989 return opt_message(user
, hs
, from_opserv
, argc
, argv
, MSGTYPE_GREETING
);
2992 static HELPSERV_OPTION(opt_req_opened
) {
2993 return opt_message(user
, hs
, from_opserv
, argc
, argv
, MSGTYPE_REQ_OPENED
);
2996 static HELPSERV_OPTION(opt_req_assigned
) {
2997 return opt_message(user
, hs
, from_opserv
, argc
, argv
, MSGTYPE_REQ_ASSIGNED
);
3000 static HELPSERV_OPTION(opt_req_closed
) {
3001 return opt_message(user
, hs
, from_opserv
, argc
, argv
, MSGTYPE_REQ_CLOSED
);
3004 static int opt_interval(struct userNode
*user
, struct helpserv_bot
*hs
, int from_opserv
, int argc
, char *argv
[], enum interval_type idx
, unsigned int min
) {
3005 char buf
[INTERVALLEN
];
3009 unsigned long new_int
= ParseInterval(argv
[0]);
3010 if (!new_int
&& strcmp(argv
[0], "0")) {
3011 helpserv_notice(user
, "MSG_INVALID_DURATION", argv
[0]);
3014 if (new_int
&& new_int
< min
) {
3015 intervalString(buf
, min
, user
->handle_info
);
3016 helpserv_notice(user
, "HSMSG_INVALID_INTERVAL", user_find_message(user
, interval_types
[idx
].print_name
), buf
);
3019 hs
->intervals
[idx
] = new_int
;
3022 if (hs
->intervals
[idx
]) {
3023 intervalString(buf
, hs
->intervals
[idx
], user
->handle_info
);
3024 helpserv_notice(user
, interval_types
[idx
].print_name
, buf
);
3026 helpserv_notice(user
, interval_types
[idx
].print_name
, user_find_message(user
, "HSMSG_0_DISABLED"));
3030 static HELPSERV_OPTION(opt_idle_delay
) {
3031 return opt_interval(user
, hs
, from_opserv
, argc
, argv
, INTERVAL_IDLE_DELAY
, 60);
3034 static HELPSERV_OPTION(opt_whine_delay
) {
3035 return opt_interval(user
, hs
, from_opserv
, argc
, argv
, INTERVAL_WHINE_DELAY
, 60);
3038 static HELPSERV_OPTION(opt_whine_interval
) {
3039 unsigned int old_val
= hs
->intervals
[INTERVAL_WHINE_INTERVAL
];
3042 retval
= opt_interval(user
, hs
, from_opserv
, argc
, argv
, INTERVAL_WHINE_INTERVAL
, 60);
3044 if (!old_val
&& hs
->intervals
[INTERVAL_WHINE_INTERVAL
]) {
3045 timeq_add(now
+ hs
->intervals
[INTERVAL_WHINE_INTERVAL
], run_whine_interval
, hs
);
3046 } else if (old_val
&& !hs
->intervals
[INTERVAL_WHINE_INTERVAL
]) {
3047 timeq_del(0, run_whine_interval
, hs
, TIMEQ_IGNORE_WHEN
);
3053 static HELPSERV_OPTION(opt_empty_interval
) {
3054 unsigned int old_val
= hs
->intervals
[INTERVAL_EMPTY_INTERVAL
];
3057 retval
= opt_interval(user
, hs
, from_opserv
, argc
, argv
, INTERVAL_EMPTY_INTERVAL
, 60);
3059 if (!old_val
&& hs
->intervals
[INTERVAL_EMPTY_INTERVAL
]) {
3060 timeq_add(now
+ hs
->intervals
[INTERVAL_EMPTY_INTERVAL
], run_empty_interval
, hs
);
3061 } else if (old_val
&& !hs
->intervals
[INTERVAL_EMPTY_INTERVAL
]) {
3062 timeq_del(0, run_empty_interval
, hs
, TIMEQ_IGNORE_WHEN
);
3068 static HELPSERV_OPTION(opt_stale_delay
) {
3069 return opt_interval(user
, hs
, from_opserv
, argc
, argv
, INTERVAL_STALE_DELAY
, 60);
3072 static enum persistence_length
persistence_from_name(const char *name
) {
3073 enum persistence_length pers
;
3074 for (pers
=0; pers
<PERSIST_COUNT
; pers
++)
3075 if (!irccasecmp(name
, persistence_lengths
[pers
].db_name
))
3077 return PERSIST_COUNT
;
3080 static int opt_persist(struct userNode
*user
, struct helpserv_bot
*hs
, int from_opserv
, int argc
, char *argv
[], enum persistence_type idx
) {
3084 enum persistence_length new_pers
= persistence_from_name(argv
[0]);
3085 if (new_pers
== PERSIST_COUNT
) {
3086 helpserv_notice(user
, "HSMSG_INVALID_OPTION", argv
[0]);
3089 hs
->persist_types
[idx
] = new_pers
;
3092 helpserv_notice(user
, persistence_types
[idx
].print_name
,
3093 user_find_message(user
, persistence_lengths
[hs
->persist_types
[idx
]].print_name
));
3097 static HELPSERV_OPTION(opt_request_persistence
) {
3098 return opt_persist(user
, hs
, from_opserv
, argc
, argv
, PERSIST_T_REQUEST
);
3101 static HELPSERV_OPTION(opt_helper_persistence
) {
3102 return opt_persist(user
, hs
, from_opserv
, argc
, argv
, PERSIST_T_HELPER
);
3105 static enum notification_type
notification_from_name(const char *name
) {
3106 enum notification_type notify
;
3107 for (notify
=0; notify
<NOTIFY_COUNT
; notify
++)
3108 if (!irccasecmp(name
, notification_types
[notify
].db_name
))
3110 return NOTIFY_COUNT
;
3113 static HELPSERV_OPTION(opt_notification
) {
3117 enum notification_type new_notify
= notification_from_name(argv
[0]);
3118 if (new_notify
== NOTIFY_COUNT
) {
3119 helpserv_notice(user
, "HSMSG_INVALID_OPTION", argv
[0]);
3122 if (!from_opserv
&& (new_notify
== NOTIFY_HANDLE
)) {
3123 helpserv_notice(user
, "HSMSG_SET_NEED_OPER");
3126 hs
->notify
= new_notify
;
3129 helpserv_notice(user
, "HSMSG_SET_NOTIFICATION", user_find_message(user
, notification_types
[hs
->notify
].print_name
));
3133 #define OPTION_UINT(var, name) do { \
3136 (var) = strtoul(argv[0], NULL, 0); \
3139 helpserv_notice(user, name, (var)); \
3143 static HELPSERV_OPTION(opt_id_wrap
) {
3144 OPTION_UINT(hs
->id_wrap
, "HSMSG_SET_IDWRAP");
3147 static HELPSERV_OPTION(opt_req_maxlen
) {
3148 OPTION_UINT(hs
->req_maxlen
, "HSMSG_SET_REQMAXLEN");
3151 #define OPTION_BINARY(var, name) do { \
3154 if (enabled_string(argv[0])) { \
3157 } else if (disabled_string(argv[0])) { \
3161 helpserv_notice(user, "MSG_INVALID_BINARY", argv[0]); \
3165 helpserv_notice(user, name, user_find_message(user, (var) ? "MSG_ON" : "MSG_OFF")); \
3169 static HELPSERV_OPTION(opt_privmsg_only
) {
3170 OPTION_BINARY(hs
->privmsg_only
, "HSMSG_SET_PRIVMSGONLY");
3173 static HELPSERV_OPTION(opt_req_on_join
) {
3174 OPTION_BINARY(hs
->req_on_join
, "HSMSG_SET_REQONJOIN");
3177 static HELPSERV_OPTION(opt_auto_voice
) {
3178 OPTION_BINARY(hs
->auto_voice
, "HSMSG_SET_AUTOVOICE");
3181 static HELPSERV_OPTION(opt_auto_devoice
) {
3182 OPTION_BINARY(hs
->auto_devoice
, "HSMSG_SET_AUTODEVOICE");
3185 static HELPSERV_FUNC(cmd_set
) {
3186 helpserv_option_func_t
*opt
;
3190 helpserv_option_func_t
*display
[] = {
3191 opt_pagetarget_command
, opt_pagetarget_alert
, opt_pagetarget_status
,
3192 opt_pagetype
, opt_alert_page_type
, opt_status_page_type
,
3193 opt_greeting
, opt_req_opened
, opt_req_assigned
, opt_req_closed
,
3194 opt_idle_delay
, opt_whine_delay
, opt_whine_interval
,
3195 opt_empty_interval
, opt_stale_delay
, opt_request_persistence
,
3196 opt_helper_persistence
, opt_notification
, opt_id_wrap
,
3197 opt_req_maxlen
, opt_privmsg_only
, opt_req_on_join
, opt_auto_voice
,
3201 helpserv_notice(user
, "HSMSG_QUEUE_OPTIONS");
3202 for (i
=0; i
<ArrayLength(display
); i
++)
3203 display
[i
](user
, hs
, from_opserv
, 0, argv
);
3207 if (!(opt
= dict_find(helpserv_option_dict
, argv
[1], NULL
))) {
3208 helpserv_notice(user
, "HSMSG_INVALID_OPTION", argv
[1]);
3212 if ((argc
> 2) && !from_opserv
) {
3213 struct helpserv_user
*hs_user
;
3215 if (!(hs_user
= dict_find(hs
->users
, user
->handle_info
->handle
, NULL
))) {
3216 helpserv_notice(user
, "HSMSG_WTF_WHO_ARE_YOU", hs
->helpserv
->nick
);
3220 if (hs_user
->level
< HlManager
) {
3221 helpserv_notice(user
, "HSMSG_NEED_MANAGER");
3225 return opt(user
, hs
, from_opserv
, argc
-2, argv
+2);
3228 static int user_write_helper(const char *key
, void *data
, void *extra
) {
3229 struct helpserv_user
*hs_user
= data
;
3230 struct saxdb_context
*ctx
= extra
;
3231 struct string_list strlist
;
3232 char str
[5][16], *strs
[5];
3235 saxdb_start_record(ctx
, key
, 0);
3236 /* Helper identification. */
3237 saxdb_write_string(ctx
, KEY_HELPER_LEVEL
, helpserv_level2str(hs_user
->level
));
3238 saxdb_write_string(ctx
, KEY_HELPER_HELPMODE
, (hs_user
->help_mode
? "1" : "0"));
3239 saxdb_write_int(ctx
, KEY_HELPER_WEEKSTART
, hs_user
->week_start
);
3241 saxdb_start_record(ctx
, KEY_HELPER_STATS
, 0);
3242 for (i
=0; i
< ArrayLength(strs
); ++i
)
3244 strlist
.list
= strs
;
3246 /* Time in help channel */
3247 for (i
=0; i
< strlist
.used
; i
++) {
3248 unsigned int week_time
= hs_user
->time_per_week
[i
];
3249 if ((i
==0 || i
==4) && hs_user
->join_time
)
3250 week_time
+= now
- hs_user
->join_time
;
3251 sprintf(str
[i
], "%u", week_time
);
3253 saxdb_write_string_list(ctx
, KEY_HELPER_STATS_TIME
, &strlist
);
3254 /* Requests picked up */
3255 for (i
=0; i
< strlist
.used
; i
++)
3256 sprintf(str
[i
], "%u", hs_user
->picked_up
[i
]);
3257 saxdb_write_string_list(ctx
, KEY_HELPER_STATS_PICKUP
, &strlist
);
3258 /* Requests closed */
3259 for (i
=0; i
< strlist
.used
; i
++)
3260 sprintf(str
[i
], "%u", hs_user
->closed
[i
]);
3261 saxdb_write_string_list(ctx
, KEY_HELPER_STATS_CLOSE
, &strlist
);
3262 /* Requests reassigned from user */
3263 for (i
=0; i
< strlist
.used
; i
++)
3264 sprintf(str
[i
], "%u", hs_user
->reassigned_from
[i
]);
3265 saxdb_write_string_list(ctx
, KEY_HELPER_STATS_REASSIGNFROM
, &strlist
);
3266 /* Requests reassigned to user */
3267 for (i
=0; i
< strlist
.used
; i
++)
3268 sprintf(str
[i
], "%u", hs_user
->reassigned_to
[i
]);
3269 saxdb_write_string_list(ctx
, KEY_HELPER_STATS_REASSIGNTO
, &strlist
);
3270 /* End of stats and whole record. */
3271 saxdb_end_record(ctx
);
3272 saxdb_end_record(ctx
);
3276 static int user_read_helper(const char *key
, void *data
, void *extra
) {
3277 struct record_data
*rd
= data
;
3278 struct helpserv_bot
*hs
= extra
;
3279 struct helpserv_user
*hs_user
;
3280 struct handle_info
*handle
;
3282 enum helpserv_level level
;
3284 struct string_list
*strlist
;
3287 if (rd
->type
!= RECDB_OBJECT
|| !dict_size(rd
->d
.object
)) {
3288 log_module(HS_LOG
, LOG_ERROR
, "Invalid user %s for %s.", key
, hs
->helpserv
->nick
);
3292 if (!(handle
= get_handle_info(key
))) {
3293 log_module(HS_LOG
, LOG_ERROR
, "Nonexistant account %s for %s.", key
, hs
->helpserv
->nick
);
3296 str
= database_get_data(rd
->d
.object
, KEY_HELPER_LEVEL
, RECDB_QSTRING
);
3298 level
= helpserv_str2level(str
);
3299 if (level
== HlNone
) {
3300 log_module(HS_LOG
, LOG_ERROR
, "Account %s has invalid level %s.", key
, str
);
3304 log_module(HS_LOG
, LOG_ERROR
, "Account %s has no level field for %s.", key
, hs
->helpserv
->nick
);
3308 hs_user
= helpserv_add_user(hs
, handle
, level
);
3310 str
= database_get_data(rd
->d
.object
, KEY_HELPER_HELPMODE
, RECDB_QSTRING
);
3311 hs_user
->help_mode
= (str
&& strtol(str
, NULL
, 0)) ? 1 : 0;
3312 str
= database_get_data(rd
->d
.object
, KEY_HELPER_WEEKSTART
, RECDB_QSTRING
);
3313 hs_user
->week_start
= str
? strtol(str
, NULL
, 0) : 0;
3316 stats
= database_get_data(GET_RECORD_OBJECT(rd
), KEY_HELPER_STATS
, RECDB_OBJECT
);
3319 /* The tests for strlist->used are for converting the old format to the new one */
3320 strlist
= database_get_data(stats
, KEY_HELPER_STATS_TIME
, RECDB_STRING_LIST
);
3322 for (i
=0; i
< 5 && i
< strlist
->used
; i
++)
3323 hs_user
->time_per_week
[i
] = strtoul(strlist
->list
[i
], NULL
, 0);
3324 if (strlist
->used
== 4)
3325 hs_user
->time_per_week
[4] = hs_user
->time_per_week
[0]+hs_user
->time_per_week
[1]+hs_user
->time_per_week
[2]+hs_user
->time_per_week
[3];
3327 strlist
= database_get_data(stats
, KEY_HELPER_STATS_PICKUP
, RECDB_STRING_LIST
);
3329 for (i
=0; i
< 5 && i
< strlist
->used
; i
++)
3330 hs_user
->picked_up
[i
] = strtoul(strlist
->list
[i
], NULL
, 0);
3331 if (strlist
->used
== 2)
3332 hs_user
->picked_up
[4] = hs_user
->picked_up
[0]+hs_user
->picked_up
[1];
3334 strlist
= database_get_data(stats
, KEY_HELPER_STATS_CLOSE
, RECDB_STRING_LIST
);
3336 for (i
=0; i
< 5 && i
< strlist
->used
; i
++)
3337 hs_user
->closed
[i
] = strtoul(strlist
->list
[i
], NULL
, 0);
3338 if (strlist
->used
== 2)
3339 hs_user
->closed
[4] = hs_user
->closed
[0]+hs_user
->closed
[1];
3341 strlist
= database_get_data(stats
, KEY_HELPER_STATS_REASSIGNFROM
, RECDB_STRING_LIST
);
3343 for (i
=0; i
< 5 && i
< strlist
->used
; i
++)
3344 hs_user
->reassigned_from
[i
] = strtoul(strlist
->list
[i
], NULL
, 0);
3345 if (strlist
->used
== 2)
3346 hs_user
->reassigned_from
[4] = hs_user
->reassigned_from
[0]+hs_user
->reassigned_from
[1];
3348 strlist
= database_get_data(stats
, KEY_HELPER_STATS_REASSIGNTO
, RECDB_STRING_LIST
);
3350 for (i
=0; i
< 5 && i
< strlist
->used
; i
++)
3351 hs_user
->reassigned_to
[i
] = strtoul(strlist
->list
[i
], NULL
, 0);
3352 if (strlist
->used
== 2)
3353 hs_user
->reassigned_to
[4] = hs_user
->reassigned_to
[0]+hs_user
->reassigned_to
[1];
3360 static int request_write_helper(const char *key
, void *data
, void *extra
) {
3361 struct helpserv_request
*request
= data
;
3362 struct saxdb_context
*ctx
= extra
;
3364 if (!request
->handle
)
3367 saxdb_start_record(ctx
, key
, 0);
3368 if (request
->helper
) {
3369 saxdb_write_string(ctx
, KEY_REQUEST_HELPER
, request
->helper
->handle
->handle
);
3370 saxdb_write_int(ctx
, KEY_REQUEST_ASSIGNED
, request
->assigned
);
3372 saxdb_write_string(ctx
, KEY_REQUEST_HANDLE
, request
->handle
->handle
);
3373 saxdb_write_int(ctx
, KEY_REQUEST_OPENED
, request
->opened
);
3374 saxdb_write_string_list(ctx
, KEY_REQUEST_TEXT
, request
->text
);
3375 saxdb_end_record(ctx
);
3379 static int request_read_helper(const char *key
, void *data
, void *extra
) {
3380 struct record_data
*rd
= data
;
3381 struct helpserv_bot
*hs
= extra
;
3382 struct helpserv_request
*request
;
3383 struct string_list
*strlist
;
3386 if (rd
->type
!= RECDB_OBJECT
|| !dict_size(rd
->d
.object
)) {
3387 log_module(HS_LOG
, LOG_ERROR
, "Invalid request %s:%s.", hs
->helpserv
->nick
, key
);
3391 request
= calloc(1, sizeof(struct helpserv_request
));
3393 request
->id
= strtoul(key
, NULL
, 0);
3395 request
->user
= NULL
;
3396 request
->parent_nick_list
= request
->parent_hand_list
= NULL
;
3398 str
= database_get_data(rd
->d
.object
, KEY_REQUEST_HANDLE
, RECDB_QSTRING
);
3399 if (!str
|| !(request
->handle
= get_handle_info(str
))) {
3400 log_module(HS_LOG
, LOG_ERROR
, "Request %s:%s has an invalid or nonexistant account.", hs
->helpserv
->nick
, key
);
3404 if (!(request
->parent_hand_list
= dict_find(helpserv_reqs_byhand_dict
, request
->handle
->handle
, NULL
))) {
3405 request
->parent_hand_list
= helpserv_reqlist_alloc();
3406 dict_insert(helpserv_reqs_byhand_dict
, request
->handle
->handle
, request
->parent_hand_list
);
3408 helpserv_reqlist_append(request
->parent_hand_list
, request
);
3410 str
= database_get_data(rd
->d
.object
, KEY_REQUEST_OPENED
, RECDB_QSTRING
);
3412 log_module(HS_LOG
, LOG_ERROR
, "Request %s:%s has a nonexistant opening time. Using time(NULL).", hs
->helpserv
->nick
, key
);
3413 request
->opened
= time(NULL
);
3415 request
->opened
= (time_t)strtoul(str
, NULL
, 0);
3418 str
= database_get_data(rd
->d
.object
, KEY_REQUEST_ASSIGNED
, RECDB_QSTRING
);
3420 request
->assigned
= (time_t)strtoul(str
, NULL
, 0);
3422 str
= database_get_data(rd
->d
.object
, KEY_REQUEST_HELPER
, RECDB_QSTRING
);
3424 if (!(request
->helper
= dict_find(hs
->users
, str
, NULL
))) {
3425 log_module(HS_LOG
, LOG_ERROR
, "Request %s:%s has an invalid or nonexistant helper.", hs
->helpserv
->nick
, key
);
3430 if (!hs
->unhandled
) {
3431 request
->next_unhandled
= NULL
;
3432 hs
->unhandled
= request
;
3433 } else if (hs
->unhandled
->opened
> request
->opened
) {
3434 request
->next_unhandled
= hs
->unhandled
;
3435 hs
->unhandled
= request
;
3437 struct helpserv_request
*unh
;
3438 for (unh
= hs
->unhandled
; unh
->next_unhandled
&& (unh
->next_unhandled
->opened
< request
->opened
); unh
= unh
->next_unhandled
);
3439 request
->next_unhandled
= unh
->next_unhandled
;
3440 unh
->next_unhandled
= request
;
3444 strlist
= database_get_data(rd
->d
.object
, KEY_REQUEST_TEXT
, RECDB_STRING_LIST
);
3446 log_module(HS_LOG
, LOG_ERROR
, "Request %s:%s has no text.", hs
->helpserv
->nick
, key
);
3450 request
->text
= string_list_copy(strlist
);
3452 dict_insert(hs
->requests
, strdup(key
), request
);
3458 helpserv_bot_write(const char *key
, void *data
, void *extra
) {
3459 const struct helpserv_bot
*hs
= data
;
3460 struct saxdb_context
*ctx
= extra
;
3461 enum page_source pagesrc
;
3462 enum message_type msgtype
;
3463 enum interval_type inttype
;
3464 enum persistence_type persisttype
;
3465 struct string_list
*slist
;
3468 saxdb_start_record(ctx
, key
, 1);
3471 saxdb_start_record(ctx
, KEY_HELPERS
, 1);
3472 dict_foreach(hs
->users
, user_write_helper
, ctx
);
3473 saxdb_end_record(ctx
);
3476 if (hs
->persist_types
[PERSIST_T_REQUEST
] == PERSIST_CLOSE
) {
3477 saxdb_start_record(ctx
, KEY_REQUESTS
, 0);
3478 dict_foreach(hs
->requests
, request_write_helper
, ctx
);
3479 saxdb_end_record(ctx
);
3482 /* Other settings and state */
3483 saxdb_write_string(ctx
, KEY_HELP_CHANNEL
, hs
->helpchan
->name
);
3484 slist
= alloc_string_list(PGSRC_COUNT
);
3485 for (pagesrc
=0; pagesrc
<PGSRC_COUNT
; pagesrc
++) {
3486 struct chanNode
*target
= hs
->page_targets
[pagesrc
];
3487 string_list_append(slist
, strdup(target
? target
->name
: "*"));
3489 saxdb_write_string_list(ctx
, KEY_PAGE_DEST
, slist
);
3490 free_string_list(slist
);
3491 for (pagesrc
=0; pagesrc
<PGSRC_COUNT
; pagesrc
++) {
3492 const char *src
= page_types
[hs
->page_types
[pagesrc
]].db_name
;
3493 saxdb_write_string(ctx
, page_sources
[pagesrc
].db_name
, src
);
3495 for (msgtype
=0; msgtype
<MSGTYPE_COUNT
; msgtype
++) {
3496 const char *msg
= hs
->messages
[msgtype
];
3498 saxdb_write_string(ctx
, message_types
[msgtype
].db_name
, msg
);
3500 for (inttype
=0; inttype
<INTERVAL_COUNT
; inttype
++) {
3501 if (!hs
->intervals
[inttype
])
3503 saxdb_write_int(ctx
, interval_types
[inttype
].db_name
, hs
->intervals
[inttype
]);
3505 for (persisttype
=0; persisttype
<PERSIST_T_COUNT
; persisttype
++) {
3506 const char *persist
= persistence_lengths
[hs
->persist_types
[persisttype
]].db_name
;
3507 saxdb_write_string(ctx
, persistence_types
[persisttype
].db_name
, persist
);
3509 saxdb_write_string(ctx
, KEY_NOTIFICATION
, notification_types
[hs
->notify
].db_name
);
3510 saxdb_write_int(ctx
, KEY_REGISTERED
, hs
->registered
);
3511 saxdb_write_int(ctx
, KEY_IDWRAP
, hs
->id_wrap
);
3512 saxdb_write_int(ctx
, KEY_REQ_MAXLEN
, hs
->req_maxlen
);
3513 saxdb_write_int(ctx
, KEY_LAST_REQUESTID
, hs
->last_requestid
);
3515 saxdb_write_string(ctx
, KEY_REGISTRAR
, hs
->registrar
);
3516 saxdb_write_int(ctx
, KEY_PRIVMSG_ONLY
, hs
->privmsg_only
);
3517 saxdb_write_int(ctx
, KEY_REQ_ON_JOIN
, hs
->req_on_join
);
3518 saxdb_write_int(ctx
, KEY_AUTO_VOICE
, hs
->auto_voice
);
3519 saxdb_write_int(ctx
, KEY_AUTO_DEVOICE
, hs
->auto_devoice
);
3520 saxdb_write_int(ctx
, KEY_LAST_ACTIVE
, hs
->last_active
);
3522 /* End bot record */
3523 saxdb_end_record(ctx
);
3528 helpserv_saxdb_write(struct saxdb_context
*ctx
) {
3529 saxdb_start_record(ctx
, KEY_BOTS
, 1);
3530 dict_foreach(helpserv_bots_dict
, helpserv_bot_write
, ctx
);
3531 saxdb_end_record(ctx
);
3532 saxdb_write_int(ctx
, KEY_LAST_STATS_UPDATE
, last_stats_update
);
3536 static int helpserv_bot_read(const char *key
, void *data
, UNUSED_ARG(void *extra
)) {
3537 struct record_data
*br
= data
, *raw_record
;
3538 struct helpserv_bot
*hs
;
3539 char *registrar
, *helpchannel_name
, *str
;
3540 dict_t users
, requests
;
3541 enum page_source pagesrc
;
3542 enum message_type msgtype
;
3543 enum interval_type inttype
;
3544 enum persistence_type persisttype
;
3546 users
= database_get_data(GET_RECORD_OBJECT(br
), KEY_HELPERS
, RECDB_OBJECT
);
3548 log_module(HS_LOG
, LOG_ERROR
, "%s has no users.", key
);
3551 helpchannel_name
= database_get_data(GET_RECORD_OBJECT(br
), KEY_HELP_CHANNEL
, RECDB_QSTRING
);
3552 if (!helpchannel_name
|| !IsChannelName(helpchannel_name
)) {
3553 log_module(HS_LOG
, LOG_ERROR
, "%s has an invalid channel name.", key
);
3556 registrar
= database_get_data(GET_RECORD_OBJECT(br
), KEY_REGISTRAR
, RECDB_QSTRING
);
3558 hs
= register_helpserv(key
, helpchannel_name
, registrar
);
3560 raw_record
= dict_find(GET_RECORD_OBJECT(br
), KEY_PAGE_DEST
, NULL
);
3561 switch (raw_record
? raw_record
->type
: RECDB_INVALID
) {
3563 set_page_target(hs
, PGSRC_COMMAND
, GET_RECORD_QSTRING(raw_record
));
3564 pagesrc
= PGSRC_COMMAND
+ 1;
3566 case RECDB_STRING_LIST
: {
3567 struct string_list
*slist
= GET_RECORD_STRING_LIST(raw_record
);
3568 for (pagesrc
=0; (pagesrc
<slist
->used
) && (pagesrc
<PGSRC_COUNT
); pagesrc
++) {
3569 const char *dest
= slist
->list
[pagesrc
];
3570 set_page_target(hs
, pagesrc
, strcmp(dest
, "*") ? dest
: NULL
);
3575 set_page_target(hs
, PGSRC_COMMAND
, NULL
);
3576 pagesrc
= PGSRC_COMMAND
+ 1;
3579 while (pagesrc
< PGSRC_COUNT
) {
3580 set_page_target(hs
, pagesrc
++, hs
->page_targets
[PGSRC_COMMAND
] ? hs
->page_targets
[PGSRC_COMMAND
]->name
: NULL
);
3583 for (pagesrc
=0; pagesrc
<PGSRC_COUNT
; pagesrc
++) {
3584 str
= database_get_data(GET_RECORD_OBJECT(br
), page_sources
[pagesrc
].db_name
, RECDB_QSTRING
);
3585 hs
->page_types
[pagesrc
] = str
? page_type_from_name(str
) : PAGE_NONE
;
3588 for (msgtype
=0; msgtype
<MSGTYPE_COUNT
; msgtype
++) {
3589 str
= database_get_data(GET_RECORD_OBJECT(br
), message_types
[msgtype
].db_name
, RECDB_QSTRING
);
3590 hs
->messages
[msgtype
] = str
? strdup(str
) : NULL
;
3593 for (inttype
=0; inttype
<INTERVAL_COUNT
; inttype
++) {
3594 str
= database_get_data(GET_RECORD_OBJECT(br
), interval_types
[inttype
].db_name
, RECDB_QSTRING
);
3595 hs
->intervals
[inttype
] = str
? ParseInterval(str
) : 0;
3597 if (hs
->intervals
[INTERVAL_WHINE_INTERVAL
])
3598 timeq_add(now
+ hs
->intervals
[INTERVAL_WHINE_INTERVAL
], run_whine_interval
, hs
);
3599 if (hs
->intervals
[INTERVAL_EMPTY_INTERVAL
])
3600 timeq_add(now
+ hs
->intervals
[INTERVAL_EMPTY_INTERVAL
], run_empty_interval
, hs
);
3602 for (persisttype
=0; persisttype
<PERSIST_T_COUNT
; persisttype
++) {
3603 str
= database_get_data(GET_RECORD_OBJECT(br
), persistence_types
[persisttype
].db_name
, RECDB_QSTRING
);
3604 hs
->persist_types
[persisttype
] = str
? persistence_from_name(str
) : PERSIST_QUIT
;
3606 str
= database_get_data(GET_RECORD_OBJECT(br
), KEY_NOTIFICATION
, RECDB_QSTRING
);
3607 hs
->notify
= str
? notification_from_name(str
) : NOTIFY_NONE
;
3608 str
= database_get_data(GET_RECORD_OBJECT(br
), KEY_REGISTERED
, RECDB_QSTRING
);
3610 hs
->registered
= (time_t)strtol(str
, NULL
, 0);
3611 str
= database_get_data(GET_RECORD_OBJECT(br
), KEY_IDWRAP
, RECDB_QSTRING
);
3613 hs
->id_wrap
= strtoul(str
, NULL
, 0);
3614 str
= database_get_data(GET_RECORD_OBJECT(br
), KEY_REQ_MAXLEN
, RECDB_QSTRING
);
3616 hs
->req_maxlen
= strtoul(str
, NULL
, 0);
3617 str
= database_get_data(GET_RECORD_OBJECT(br
), KEY_LAST_REQUESTID
, RECDB_QSTRING
);
3619 hs
->last_requestid
= strtoul(str
, NULL
, 0);
3620 str
= database_get_data(GET_RECORD_OBJECT(br
), KEY_PRIVMSG_ONLY
, RECDB_QSTRING
);
3621 hs
->privmsg_only
= str
? enabled_string(str
) : 0;
3622 str
= database_get_data(GET_RECORD_OBJECT(br
), KEY_REQ_ON_JOIN
, RECDB_QSTRING
);
3623 hs
->req_on_join
= str
? enabled_string(str
) : 0;
3624 str
= database_get_data(GET_RECORD_OBJECT(br
), KEY_AUTO_VOICE
, RECDB_QSTRING
);
3625 hs
->auto_voice
= str
? enabled_string(str
) : 0;
3626 str
= database_get_data(GET_RECORD_OBJECT(br
), KEY_AUTO_DEVOICE
, RECDB_QSTRING
);
3627 hs
->auto_devoice
= str
? enabled_string(str
) : 0;
3628 str
= database_get_data(GET_RECORD_OBJECT(br
), KEY_LAST_ACTIVE
, RECDB_QSTRING
);
3629 hs
->last_active
= str
? atoi(str
) : now
;
3631 dict_foreach(users
, user_read_helper
, hs
);
3633 requests
= database_get_data(GET_RECORD_OBJECT(br
), KEY_REQUESTS
, RECDB_OBJECT
);
3635 dict_foreach(requests
, request_read_helper
, hs
);
3641 helpserv_saxdb_read(struct dict
*conf_db
) {
3645 if ((object
= database_get_data(conf_db
, KEY_BOTS
, RECDB_OBJECT
))) {
3646 dict_foreach(object
, helpserv_bot_read
, NULL
);
3649 str
= database_get_data(conf_db
, KEY_LAST_STATS_UPDATE
, RECDB_QSTRING
);
3650 last_stats_update
= str
? (time_t)strtol(str
, NULL
, 0) : now
;
3654 static void helpserv_conf_read(void) {
3658 if (!(conf_node
= conf_get_data(HELPSERV_CONF_NAME
, RECDB_OBJECT
))) {
3659 log_module(HS_LOG
, LOG_ERROR
, "config node `%s' is missing or has wrong type", HELPSERV_CONF_NAME
);
3663 str
= database_get_data(conf_node
, "db_backup_freq", RECDB_QSTRING
);
3664 helpserv_conf
.db_backup_frequency
= str
? ParseInterval(str
) : 7200;
3666 str
= database_get_data(conf_node
, "description", RECDB_QSTRING
);
3667 helpserv_conf
.description
= str
? str
: "Help Queue Manager";
3669 str
= database_get_data(conf_node
, "reqlogfile", RECDB_QSTRING
);
3670 if (str
&& strlen(str
))
3671 helpserv_conf
.reqlogfile
= str
;
3673 helpserv_conf
.reqlogfile
= NULL
;
3675 str
= database_get_data(conf_node
, "expiration", RECDB_QSTRING
);
3676 helpserv_conf
.expire_age
= ParseInterval(str
? str
: "60d");
3677 str
= database_get_data(conf_node
, "user_escape", RECDB_QSTRING
);
3678 helpserv_conf
.user_escape
= str
? str
[0] : '@';
3684 if (helpserv_conf
.reqlogfile
3685 && !(reqlog_f
= fopen(helpserv_conf
.reqlogfile
, "a"))) {
3686 log_module(HS_LOG
, LOG_ERROR
, "Unable to open request logfile (%s): %s", helpserv_conf
.reqlogfile
, strerror(errno
));
3690 static struct helpserv_cmd
*
3691 helpserv_define_func(const char *name
, helpserv_func_t
*func
, enum helpserv_level access
, long flags
) {
3692 struct helpserv_cmd
*cmd
= calloc(1, sizeof(struct helpserv_cmd
));
3694 cmd
->access
= access
;
3698 dict_insert(helpserv_func_dict
, name
, cmd
);
3703 /* Drop requests that persist until part when a user leaves the chan */
3704 static void handle_part(struct modeNode
*mn
, UNUSED_ARG(const char *reason
)) {
3705 struct helpserv_botlist
*botlist
;
3706 struct helpserv_userlist
*userlist
;
3707 const int from_opserv
= 0; /* for helpserv_notice */
3710 if ((botlist
= dict_find(helpserv_bots_bychan_dict
, mn
->channel
->name
, NULL
))) {
3711 for (i
=0; i
< botlist
->used
; i
++) {
3712 struct helpserv_bot
*hs
;
3715 hs
= botlist
->list
[i
];
3718 if (hs
->persist_types
[PERSIST_T_REQUEST
] != PERSIST_PART
)
3721 for (it
=dict_first(hs
->requests
); it
; it
=iter_next(it
)) {
3722 struct helpserv_request
*req
= iter_data(it
);
3724 if (mn
->user
!= req
->user
)
3726 if (req
->text
->used
) {
3727 helpserv_message(hs
, mn
->user
, MSGTYPE_REQ_DROPPED
);
3728 helpserv_msguser(mn
->user
, "HSMSG_REQ_DROPPED_PART", mn
->channel
->name
, req
->id
);
3729 if (req
->helper
&& (hs
->notify
>= NOTIFY_DROP
))
3730 helpserv_notify(req
->helper
, "HSMSG_NOTIFY_REQ_DROP_PART", req
->id
, mn
->user
->nick
);
3732 helpserv_log_request(req
, "Dropped");
3733 dict_remove(hs
->requests
, iter_key(it
));
3739 if (mn
->user
->handle_info
&& (userlist
= dict_find(helpserv_users_byhand_dict
, mn
->user
->handle_info
->handle
, NULL
))) {
3740 for (i
=0; i
< userlist
->used
; i
++) {
3741 struct helpserv_user
*hs_user
= userlist
->list
[i
];
3742 struct helpserv_bot
*hs
= hs_user
->hs
;
3745 if ((hs
->helpserv
== NULL
) || (hs
->helpchan
!= mn
->channel
) || find_handle_in_channel(hs
->helpchan
, mn
->user
->handle_info
, mn
->user
))
3748 /* In case of the clock being set back for whatever reason,
3749 * minimize penalty. Don't duplicate this in handle_quit because
3750 * when users quit, handle_part is called for every channel first.
3752 if (hs_user
->join_time
&& (hs_user
->join_time
< now
)) {
3753 hs_user
->time_per_week
[0] += (unsigned int)(now
- hs_user
->join_time
);
3754 hs_user
->time_per_week
[4] += (unsigned int)(now
- hs_user
->join_time
);
3756 hs_user
->join_time
= 0;
3758 for (it
=dict_first(hs
->requests
); it
; it
=iter_next(it
)) {
3759 struct helpserv_request
*req
=iter_data(it
);
3761 if ((hs
->persist_types
[PERSIST_T_HELPER
] == PERSIST_PART
)
3762 && (req
->helper
== hs_user
)) {
3763 char reason
[CHANNELLEN
+ 8];
3764 sprintf(reason
, "parted %s", mn
->channel
->name
);
3765 helpserv_page_helper_gone(hs
, req
, reason
);
3769 if (hs
->intervals
[INTERVAL_EMPTY_INTERVAL
] && hs_user
->level
>= HlHelper
) {
3772 if ((num_trials
= find_helpchan_helpers(hs
)) >= 0) {
3773 unsigned int num_unh
;
3774 struct helpserv_request
*unh
;
3776 for (num_unh
=0, unh
=hs
->unhandled
; unh
; num_unh
++)
3777 unh
= unh
->next_unhandled
;
3780 helpserv_page(PGSRC_ALERT
, "HSMSG_PAGE_FIRSTONLYTRIALALERT", hs
->helpchan
->name
, mn
->user
->nick
, num_trials
, num_unh
);
3782 helpserv_page(PGSRC_ALERT
, "HSMSG_PAGE_FIRSTEMPTYALERT", hs
->helpchan
->name
, mn
->user
->nick
, num_unh
);
3784 if (num_unh
|| !hs
->req_on_join
) {
3785 timeq_del(0, run_empty_interval
, hs
, TIMEQ_IGNORE_WHEN
);
3786 timeq_add(now
+ hs
->intervals
[INTERVAL_EMPTY_INTERVAL
], run_empty_interval
, hs
);
3794 /* Drop requests that persist until part or quit when a user quits. Otherwise
3795 * set req->user to null (it's no longer valid) if they have a handle,
3796 * and drop it if they don't (nowhere to store the request).
3798 * Unassign requests where req->helper persists until the helper parts or
3800 static void handle_quit(struct userNode
*user
, UNUSED_ARG(struct userNode
*killer
), UNUSED_ARG(const char *why
)) {
3801 struct helpserv_reqlist
*reqlist
;
3802 struct helpserv_userlist
*userlist
;
3805 if (IsLocal(user
)) {
3806 struct helpserv_bot
*hs
;
3807 if ((hs
= dict_find(helpserv_bots_dict
, user
->nick
, NULL
))) {
3808 hs
->helpserv
= NULL
;
3813 if ((reqlist
= dict_find(helpserv_reqs_bynick_dict
, user
->nick
, NULL
))) {
3815 for (i
=0; i
< n
; i
++) {
3816 struct helpserv_request
*req
= reqlist
->list
[0];
3818 if ((req
->hs
->persist_types
[PERSIST_T_REQUEST
] == PERSIST_QUIT
) || !req
->handle
) {
3820 sprintf(buf
, "%lu", req
->id
);
3822 if (req
->helper
&& (req
->hs
->notify
>= NOTIFY_DROP
))
3823 helpserv_notify(req
->helper
, "HSMSG_NOTIFY_REQ_DROP_QUIT", req
->id
, req
->user
->nick
);
3825 helpserv_log_request(req
, "Dropped");
3826 dict_remove(req
->hs
->requests
, buf
);
3829 req
->parent_nick_list
= NULL
;
3830 helpserv_reqlist_remove(reqlist
, req
);
3832 if (req
->helper
&& (req
->hs
->notify
>= NOTIFY_USER
))
3833 helpserv_notify(req
->helper
, "HSMSG_NOTIFY_USER_QUIT", req
->id
, user
->nick
);
3837 dict_remove(helpserv_reqs_bynick_dict
, user
->nick
);
3840 if (user
->handle_info
&& (userlist
= dict_find(helpserv_users_byhand_dict
, user
->handle_info
->handle
, NULL
))) {
3841 for (i
=0; i
< userlist
->used
; i
++) {
3842 struct helpserv_user
*hs_user
= userlist
->list
[i
];
3843 struct helpserv_bot
*hs
= hs_user
->hs
;
3846 if ((hs
->helpserv
== NULL
) || user
->next_authed
|| (user
->handle_info
->users
!= user
))
3849 for (it
=dict_first(hs
->requests
); it
; it
=iter_next(it
)) {
3850 struct helpserv_request
*req
=iter_data(it
);
3852 if ((hs
->persist_types
[PERSIST_T_HELPER
] == PERSIST_QUIT
) && (req
->helper
== hs_user
)) {
3853 helpserv_page_helper_gone(hs
, req
, "disconnected");
3860 static void associate_requests_bybot(struct helpserv_bot
*hs
, struct userNode
*user
, int force_greet
) {
3861 struct helpserv_reqlist
*reqlist
, *hand_reqlist
=NULL
;
3862 struct helpserv_request
*newest
=NULL
, *nicknewest
=NULL
;
3864 const int from_opserv
= 0; /* For helpserv_notice */
3866 if (!(user
->handle_info
&& (hand_reqlist
= dict_find(helpserv_reqs_byhand_dict
, user
->handle_info
->handle
, NULL
))) && !force_greet
) {
3870 reqlist
= dict_find(helpserv_reqs_bynick_dict
, user
->nick
, NULL
);
3873 for (i
=0; i
< hand_reqlist
->used
; i
++) {
3874 struct helpserv_request
*req
=hand_reqlist
->list
[i
];
3876 if (req
->user
|| (req
->hs
!= hs
))
3881 reqlist
= helpserv_reqlist_alloc();
3882 dict_insert(helpserv_reqs_bynick_dict
, user
->nick
, reqlist
);
3884 req
->parent_nick_list
= reqlist
;
3885 helpserv_reqlist_append(reqlist
, req
);
3887 if (req
->helper
&& (hs
->notify
>= NOTIFY_USER
))
3888 helpserv_notify(req
->helper
, "HSMSG_NOTIFY_USER_FOUND", req
->id
, user
->nick
);
3890 if (!newest
|| (newest
->opened
< req
->opened
))
3895 /* If it's supposed to force a greeting, only bail out if there are no
3896 * requests at all. If it's not supposed to force a greeting, bail out if
3897 * nothing was changed. */
3898 if (!(newest
|| (force_greet
&& reqlist
)))
3901 /* Possible conditions here:
3902 * 1. newest == NULL, force_greeting == 1, reqlist != NULL
3903 * 2. newest != NULL, force_greeting doesn't matter, reqlist != NULL */
3905 /* Figure out which request will get their next message */
3906 for (i
=0; i
< reqlist
->used
; i
++) {
3907 struct helpserv_request
*req
=reqlist
->list
[i
];
3912 if (!nicknewest
|| (nicknewest
->opened
< req
->opened
))
3915 if (hs
->auto_voice
&& req
->helper
)
3917 struct mod_chanmode change
;
3918 mod_chanmode_init(&change
);
3920 change
.args
[0].mode
= MODE_VOICE
;
3921 if ((change
.args
[0].u
.member
= GetUserMode(hs
->helpchan
, user
)))
3922 mod_chanmode_announce(hs
->helpserv
, hs
->helpchan
, &change
);
3926 if ((force_greet
&& nicknewest
) || (newest
&& (nicknewest
== newest
))) {
3927 /* Let the user know. Either the user is forced to be greeted, or the
3928 * above has changed which request will get their next message. */
3929 helpserv_msguser(user
, "HSMSG_GREET_EXISTING_REQ", hs
->helpchan
->name
, nicknewest
->id
);
3933 static void associate_requests_bychan(struct chanNode
*chan
, struct userNode
*user
, int force_greet
) {
3934 struct helpserv_botlist
*botlist
;
3937 if (!(botlist
= dict_find(helpserv_bots_bychan_dict
, chan
->name
, NULL
)))
3940 for (i
=0; i
< botlist
->used
; i
++)
3941 associate_requests_bybot(botlist
->list
[i
], user
, force_greet
);
3945 /* Greet users upon joining a helpserv channel (if greeting is set) and set
3946 * req->user to the user joining for all requests owned by the user's handle
3947 * (if any) with a req->user == NULL */
3948 static int handle_join(struct modeNode
*mNode
) {
3949 struct userNode
*user
= mNode
->user
;
3950 struct chanNode
*chan
= mNode
->channel
;
3951 struct helpserv_botlist
*botlist
;
3953 const int from_opserv
= 0; /* for helpserv_notice */
3958 if (!(botlist
= dict_find(helpserv_bots_bychan_dict
, chan
->name
, NULL
)))
3961 for (i
=0; i
< botlist
->used
; i
++) {
3962 struct helpserv_bot
*hs
=botlist
->list
[i
];
3964 if (user
->handle_info
) {
3965 struct helpserv_user
*hs_user
;
3967 if ((hs_user
= dict_find(hs
->users
, user
->handle_info
->handle
, NULL
))) {
3968 if (!hs_user
->join_time
)
3969 hs_user
->join_time
= now
;
3971 if (hs_user
->level
>= HlHelper
&& hs
->intervals
[INTERVAL_EMPTY_INTERVAL
] && hs
->helpchan_empty
) {
3972 hs
->helpchan_empty
= 0;
3973 timeq_del(0, run_empty_interval
, hs
, TIMEQ_IGNORE_WHEN
);
3974 helpserv_page(PGSRC_ALERT
, "HSMSG_PAGE_EMPTYNOMORE", user
->nick
, hs
->helpchan
->name
);
3976 continue; /* Don't want helpers to have request-on-join */
3980 if (self
->burst
&& !hs
->req_on_join
)
3983 associate_requests_bybot(hs
, user
, 1);
3985 helpserv_message(hs
, user
, MSGTYPE_GREETING
);
3987 /* Make sure this is at the end (because of the continues) */
3988 if (hs
->req_on_join
) {
3989 struct helpserv_reqlist
*reqlist
;
3992 if ((reqlist
= dict_find(helpserv_reqs_bynick_dict
, user
->nick
, NULL
))) {
3993 for (j
=0; j
< reqlist
->used
; j
++)
3994 if (reqlist
->list
[i
]->hs
== hs
)
3996 if (j
< reqlist
->used
)
4000 create_request(user
, hs
, 1);
4006 /* Update helpserv_reqs_bynick_dict upon nick change */
4007 static void handle_nickchange(struct userNode
*user
, const char *old_nick
) {
4008 struct helpserv_reqlist
*reqlist
;
4011 if (!(reqlist
= dict_find(helpserv_reqs_bynick_dict
, old_nick
, NULL
)))
4014 /* Don't free the list when we switch it over to the new nick. */
4015 dict_remove2(helpserv_reqs_bynick_dict
, old_nick
, 1);
4016 dict_insert(helpserv_reqs_bynick_dict
, user
->nick
, reqlist
);
4018 for (i
=0; i
< reqlist
->used
; i
++) {
4019 struct helpserv_request
*req
=reqlist
->list
[i
];
4021 if (req
->helper
&& (req
->hs
->notify
>= NOTIFY_USER
))
4022 helpserv_notify(req
->helper
, "HSMSG_NOTIFY_USER_NICK", req
->id
, old_nick
, user
->nick
);
4026 /* Also update helpserv_reqs_byhand_dict upon handle rename */
4027 static void handle_nickserv_rename(struct handle_info
*handle
, const char *old_handle
) {
4028 struct helpserv_reqlist
*reqlist
;
4029 struct helpserv_userlist
*userlist
;
4032 /* First, rename the handle in the requests dict */
4033 if ((reqlist
= dict_find(helpserv_reqs_byhand_dict
, old_handle
, NULL
))) {
4034 /* Don't free the list */
4035 dict_remove2(helpserv_reqs_byhand_dict
, old_handle
, 1);
4036 dict_insert(helpserv_reqs_byhand_dict
, handle
->handle
, reqlist
);
4039 /* Second, rename the handle in the users dict */
4040 if ((userlist
= dict_find(helpserv_users_byhand_dict
, old_handle
, NULL
))) {
4041 dict_remove2(helpserv_users_byhand_dict
, old_handle
, 1);
4043 for (i
=0; i
< userlist
->used
; i
++)
4044 dict_remove2(userlist
->list
[i
]->hs
->users
, old_handle
, 1);
4046 dict_insert(helpserv_users_byhand_dict
, handle
->handle
, userlist
);
4047 for (i
=0; i
< userlist
->used
; i
++)
4048 dict_insert(userlist
->list
[i
]->hs
->users
, handle
->handle
, userlist
->list
[i
]);
4052 for (i
=0; i
< reqlist
->used
; i
++) {
4053 struct helpserv_request
*req
=reqlist
->list
[i
];
4055 if (req
->helper
&& (req
->hs
->notify
>= NOTIFY_HANDLE
))
4056 helpserv_notify(req
->helper
, "HSMSG_NOTIFY_HAND_RENAME", req
->id
, old_handle
, handle
->handle
);
4061 /* Deals with two cases:
4062 * 1. No handle -> handle
4063 * - Bots with a request assigned to both the user (w/o handle) and the
4064 * handle can exist in this case. When a message is sent,
4065 * helpserv_usermsg will append it to the most recently opened request.
4066 * - Requests assigned to the handle are NOT assigned to the user, since
4067 * multiple people can auth to the same handle at once. Wait for them to
4068 * join / privmsg before setting req->user.
4069 * 2. Handle -> handle
4070 * - Generally avoided, but sometimes the code may allow this.
4071 * - Requests that persist only until part/quit are brought along to the
4073 * - Requests that persist until closed (stay saved with the handle) are
4074 * left with the old handle. This is to prevent the confusing situation
4075 * where some requests are carried over to the new handle, and some are
4076 * left (because req->handle is the same for all of them, but only some
4077 * have req->user set).
4078 * - In either of the above cases, if a user is on a bot's userlist and has
4079 * requests assigned to them, it will give them a list. */
4080 static void handle_nickserv_auth(struct userNode
*user
, struct handle_info
*old_handle
) {
4081 struct helpserv_reqlist
*reqlist
, *dellist
=NULL
, *hand_reqlist
, *oldhand_reqlist
;
4082 struct helpserv_userlist
*userlist
;
4085 const int from_opserv
= 0; /* for helpserv_notice */
4087 if (!user
->handle_info
)
4088 return; /* Authed user is quitting */
4090 if ((userlist
= dict_find(helpserv_users_byhand_dict
, user
->handle_info
->handle
, NULL
))) {
4091 for (i
=0; i
< userlist
->used
; i
++) {
4092 struct helpserv_user
*hs_user
= userlist
->list
[i
];
4093 struct helpserv_bot
*hs
= hs_user
->hs
;
4094 struct helpserv_reqlist helper_reqs
;
4095 struct helpfile_table tbl
;
4097 if (!hs_user
->join_time
&& find_handle_in_channel(hs
->helpchan
, hs_user
->handle
, NULL
))
4098 hs_user
->join_time
= now
;
4100 helpserv_reqlist_init(&helper_reqs
);
4102 for (it
=dict_first(hs
->requests
); it
; it
=iter_next(it
)) {
4103 struct helpserv_request
*req
=iter_data(it
);
4105 if (req
->helper
== hs_user
)
4106 helpserv_reqlist_append(&helper_reqs
, req
);
4109 if (helper_reqs
.used
) {
4110 tbl
.length
= helper_reqs
.used
+1;
4112 tbl
.flags
= TABLE_NO_FREE
;
4113 tbl
.contents
= alloca(tbl
.length
* sizeof(*tbl
.contents
));
4114 tbl
.contents
[0] = alloca(tbl
.width
* sizeof(**tbl
.contents
));
4115 tbl
.contents
[0][0] = "Bot";
4116 tbl
.contents
[0][1] = "ID#";
4117 tbl
.contents
[0][2] = "Nick";
4118 tbl
.contents
[0][3] = "Account";
4119 tbl
.contents
[0][4] = "Opened";
4121 for (j
=1; j
<= helper_reqs
.used
; j
++) {
4122 struct helpserv_request
*req
=helper_reqs
.list
[j
-1];
4123 char reqid
[12], timestr
[MAX_LINE_SIZE
];
4125 tbl
.contents
[j
] = alloca(tbl
.width
* sizeof(**tbl
.contents
));
4126 tbl
.contents
[j
][0] = req
->hs
->helpserv
->nick
;
4127 sprintf(reqid
, "%lu", req
->id
);
4128 tbl
.contents
[j
][1] = strdup(reqid
);
4129 tbl
.contents
[j
][2] = req
->user
? req
->user
->nick
: "Not online";
4130 tbl
.contents
[j
][3] = req
->handle
? req
->handle
->handle
: "Not authed";
4131 strftime(timestr
, MAX_LINE_SIZE
, HSFMT_TIME
, localtime(&req
->opened
));
4132 tbl
.contents
[j
][4] = strdup(timestr
);
4135 helpserv_notice(user
, "HSMSG_REQLIST_AUTH");
4136 table_send(hs
->helpserv
, user
->nick
, 0, NULL
, tbl
);
4138 for (j
=1; j
<= helper_reqs
.used
; j
++) {
4139 free((char *)tbl
.contents
[j
][1]);
4140 free((char *)tbl
.contents
[j
][4]);
4144 helpserv_reqlist_clean(&helper_reqs
);
4149 if (!(reqlist
= dict_find(helpserv_reqs_bynick_dict
, user
->nick
, NULL
))) {
4150 for (i
=0; i
< user
->channels
.used
; i
++)
4151 associate_requests_bychan(user
->channels
.list
[i
]->channel
, user
, 0);
4155 if (!(hand_reqlist
= dict_find(helpserv_reqs_byhand_dict
, user
->handle_info
->handle
, NULL
))) {
4156 hand_reqlist
= helpserv_reqlist_alloc();
4157 dict_insert(helpserv_reqs_byhand_dict
, user
->handle_info
->handle
, hand_reqlist
);
4161 dellist
= helpserv_reqlist_alloc();
4162 oldhand_reqlist
= dict_find(helpserv_reqs_byhand_dict
, old_handle
->handle
, NULL
);
4164 oldhand_reqlist
= NULL
;
4167 for (i
=0; i
< reqlist
->used
; i
++) {
4168 struct helpserv_request
*req
= reqlist
->list
[i
];
4169 struct helpserv_bot
*hs
=req
->hs
;
4171 if (!old_handle
|| hs
->persist_types
[PERSIST_T_REQUEST
] == PERSIST_PART
|| hs
->persist_types
[PERSIST_T_REQUEST
] == PERSIST_QUIT
) {
4172 /* The request needs to be assigned to the new handle; either it
4173 * only persists until part/quit (so it makes sense to keep it as
4174 * close to the user as possible, and if it's made persistent later
4175 * then it's attached to the new handle) or there is no old handle.
4178 req
->handle
= user
->handle_info
;
4180 req
->parent_hand_list
= hand_reqlist
;
4181 helpserv_reqlist_append(hand_reqlist
, req
);
4183 if (oldhand_reqlist
) {
4184 if (oldhand_reqlist
->used
== 1) {
4185 dict_remove(helpserv_reqs_byhand_dict
, old_handle
->handle
);
4186 oldhand_reqlist
= NULL
;
4188 helpserv_reqlist_remove(oldhand_reqlist
, req
);
4193 char buf
[CHANNELLEN
+ 14];
4195 if (hs
->persist_types
[PERSIST_T_REQUEST
] == PERSIST_PART
) {
4196 sprintf(buf
, "part channel %s", hs
->helpchan
->name
);
4198 strcpy(buf
, "quit irc");
4201 helpserv_msguser(user
, "HSMSG_REQ_AUTH_MOVED", user
->handle_info
->handle
, hs
->helpchan
->name
, req
->id
, old_handle
->handle
, buf
);
4202 if (req
->helper
&& (hs
->notify
>= NOTIFY_HANDLE
))
4203 helpserv_notify(req
->helper
, "HSMSG_NOTIFY_HAND_MOVE", req
->id
, user
->handle_info
->handle
, old_handle
->handle
);
4205 if (req
->helper
&& (hs
->notify
>= NOTIFY_HANDLE
))
4206 helpserv_notify(req
->helper
, "HSMSG_NOTIFY_HAND_AUTH", req
->id
, user
->nick
, user
->handle_info
->handle
);
4210 req
->parent_nick_list
= NULL
;
4211 /* Would rather not mess with the list while iterating through
4213 helpserv_reqlist_append(dellist
, req
);
4215 helpserv_msguser(user
, "HSMSG_REQ_AUTH_STUCK", user
->handle_info
->handle
, hs
->helpchan
->name
, req
->id
, old_handle
->handle
);
4216 if (req
->helper
&& (hs
->notify
>= NOTIFY_HANDLE
))
4217 helpserv_notify(req
->helper
, "HSMSG_NOTIFY_HAND_STUCK", req
->id
, user
->nick
, user
->handle_info
->handle
, old_handle
->handle
);
4222 if (dellist
->used
) {
4223 if (dellist
->used
== reqlist
->used
) {
4224 dict_remove(helpserv_reqs_bynick_dict
, user
->nick
);
4226 for (i
=0; i
< dellist
->used
; i
++)
4227 helpserv_reqlist_remove(reqlist
, dellist
->list
[i
]);
4230 helpserv_reqlist_free(dellist
);
4233 for (i
=0; i
< user
->channels
.used
; i
++)
4234 associate_requests_bychan(user
->channels
.list
[i
]->channel
, user
, 0);
4238 /* Disassociate all requests from the handle. If any have req->user == NULL
4239 * then give them to the user doing the unregistration (if not an oper/helper)
4240 * otherwise the first nick it finds authed (it lets them know about this). If
4241 * there are no users authed to the handle online, the requests are lost. This
4242 * may result in the user having >1 request/bot, and messages go to the most
4243 * recently opened request.
4245 * Also, remove the user from all bots that it has access in.
4246 * helpserv_del_user() will take care of unassigning the requests. */
4247 static void handle_nickserv_unreg(struct userNode
*user
, struct handle_info
*handle
) {
4248 struct helpserv_reqlist
*hand_reqlist
;
4249 struct helpserv_userlist
*userlist
;
4251 const int from_opserv
= 0; /* for helpserv_notice */
4252 struct helpserv_bot
*hs
; /* for helpserv_notice */
4254 if ((userlist
= dict_find(helpserv_users_byhand_dict
, handle
->handle
, NULL
))) {
4257 /* Each time helpserv_del_user is called, that entry is going to be
4258 * taken out of userlist... so this should cope with that */
4259 for (i
=0; i
< n
; i
++) {
4260 struct helpserv_user
*hs_user
=userlist
->list
[0];
4261 helpserv_del_user(hs_user
->hs
, hs_user
);
4265 if (!(hand_reqlist
= dict_find(helpserv_reqs_byhand_dict
, handle
->handle
, NULL
))) {
4269 n
= hand_reqlist
->used
;
4270 for (i
=0; i
< n
; i
++) {
4271 struct helpserv_request
*req
=hand_reqlist
->list
[0];
4275 req
->parent_hand_list
= NULL
;
4276 helpserv_reqlist_remove(hand_reqlist
, req
);
4277 if (user
&& req
->helper
&& (hs
->notify
>= NOTIFY_HANDLE
))
4278 helpserv_notify(req
->helper
, "HSMSG_NOTIFY_HAND_UNREG", req
->id
, handle
->handle
, user
->nick
);
4282 /* This is probably an expire. Silently remove everything. */
4285 if (req
->helper
&& (hs
->notify
>= NOTIFY_DROP
))
4286 helpserv_notify(req
->helper
, "HSMSG_NOTIFY_REQ_DROP_UNREGGED", req
->id
, req
->handle
->handle
);
4287 sprintf(buf
, "%lu", req
->id
);
4288 helpserv_log_request(req
, "Account unregistered");
4289 dict_remove(req
->hs
->requests
, buf
);
4290 } else if (user
->handle_info
== handle
) {
4292 if (!(req
->parent_nick_list
= dict_find(helpserv_reqs_bynick_dict
, user
->nick
, NULL
))) {
4293 req
->parent_nick_list
= helpserv_reqlist_alloc();
4294 dict_insert(helpserv_reqs_bynick_dict
, user
->nick
, req
->parent_nick_list
);
4296 helpserv_reqlist_append(req
->parent_nick_list
, req
);
4298 if (hs
->persist_types
[PERSIST_T_REQUEST
] == PERSIST_CLOSE
)
4299 helpserv_msguser(req
->user
, "HSMSG_REQ_WARN_UNREG", handle
->handle
, hs
->helpchan
->name
, req
->id
);
4301 if (handle
->users
) {
4302 req
->user
= handle
->users
;
4304 if (!(req
->parent_nick_list
= dict_find(helpserv_reqs_bynick_dict
, req
->user
->nick
, NULL
))) {
4305 req
->parent_nick_list
= helpserv_reqlist_alloc();
4306 dict_insert(helpserv_reqs_bynick_dict
, req
->user
->nick
, req
->parent_nick_list
);
4308 helpserv_reqlist_append(req
->parent_nick_list
, req
);
4310 helpserv_msguser(req
->user
, "HSMSG_REQ_ASSIGNED_UNREG", handle
->handle
, hs
->helpchan
->name
, req
->id
);
4311 if (req
->helper
&& (hs
->notify
>= NOTIFY_USER
))
4312 helpserv_notify(req
->helper
, "HSMSG_NOTIFY_USER_MOVE", req
->id
, handle
->handle
, req
->user
->nick
);
4316 helpserv_notice(user
, "HSMSG_REQ_DROPPED_UNREG", handle
->handle
, hs
->helpchan
->name
, req
->id
);
4317 if (req
->helper
&& (hs
->notify
>= NOTIFY_DROP
))
4318 helpserv_notify(req
->helper
, "HSMSG_NOTIFY_REQ_DROP_UNREGGED", req
->id
, req
->handle
->handle
);
4319 sprintf(buf
, "%lu", req
->id
);
4320 helpserv_log_request(req
, "Account unregistered");
4321 dict_remove(req
->hs
->requests
, buf
);
4327 dict_remove(helpserv_reqs_byhand_dict
, handle
->handle
);
4330 static void handle_nickserv_merge(struct userNode
*user
, struct handle_info
*handle_to
, struct handle_info
*handle_from
) {
4331 struct helpserv_reqlist
*reqlist_from
, *reqlist_to
;
4334 reqlist_to
= dict_find(helpserv_reqs_byhand_dict
, handle_to
->handle
, NULL
);
4336 if ((reqlist_from
= dict_find(helpserv_reqs_byhand_dict
, handle_from
->handle
, NULL
))) {
4337 for (i
=0; i
< reqlist_from
->used
; i
++) {
4338 struct helpserv_request
*req
=reqlist_from
->list
[i
];
4341 reqlist_to
= helpserv_reqlist_alloc();
4342 dict_insert(helpserv_reqs_byhand_dict
, handle_to
->handle
, reqlist_to
);
4344 req
->parent_hand_list
= reqlist_to
;
4345 req
->handle
= handle_to
;
4346 helpserv_reqlist_append(reqlist_to
, req
);
4348 dict_remove(helpserv_reqs_byhand_dict
, handle_from
->handle
);
4352 for (i
=0; i
< reqlist_to
->used
; i
++) {
4353 struct helpserv_request
*req
=reqlist_to
->list
[i
];
4355 if (req
->helper
&& (req
->hs
->notify
>= NOTIFY_HANDLE
)) {
4356 helpserv_notify(req
->helper
, "HSMSG_NOTIFY_HAND_MERGE", req
->id
, handle_to
->handle
, handle_from
->handle
, user
->nick
);
4362 static void handle_nickserv_allowauth(struct userNode
*user
, struct userNode
*target
, struct handle_info
*handle
) {
4363 struct helpserv_reqlist
*reqlist
;
4366 if ((reqlist
= dict_find(helpserv_reqs_bynick_dict
, target
->nick
, NULL
))) {
4367 for (i
=0; i
< reqlist
->used
; i
++) {
4368 struct helpserv_request
*req
=reqlist
->list
[i
];
4370 if (req
->helper
&& (req
->hs
->notify
>= NOTIFY_HANDLE
)) {
4372 helpserv_notify(req
->helper
, "HSMSG_NOTIFY_ALLOWAUTH", req
->id
, target
->nick
, user
->nick
, handle
->handle
);
4374 helpserv_notify(req
->helper
, "HSMSG_NOTIFY_UNALLOWAUTH", req
->id
, target
->nick
, user
->nick
);
4381 static void handle_nickserv_failpw(struct userNode
*user
, struct handle_info
*handle
) {
4382 struct helpserv_reqlist
*reqlist
;
4385 if ((reqlist
= dict_find(helpserv_reqs_bynick_dict
, user
->nick
, NULL
))) {
4386 for (i
=0; i
< reqlist
->used
; i
++) {
4387 struct helpserv_request
*req
=reqlist
->list
[i
];
4388 if (req
->helper
&& (req
->hs
->notify
>= NOTIFY_HANDLE
))
4389 helpserv_notify(req
->helper
, "HSMSG_NOTIFY_FAILPW", req
->id
, user
->nick
, handle
->handle
);
4394 static time_t helpserv_next_stats(time_t after_when
) {
4395 struct tm
*timeinfo
= localtime(&after_when
);
4397 /* This works because mktime(3) says it will accept out-of-range values
4398 * and fix them for us. tm_wday and tm_yday are ignored. */
4399 timeinfo
->tm_mday
++;
4401 /* We want to run stats at midnight (local time). */
4402 timeinfo
->tm_sec
= timeinfo
->tm_min
= timeinfo
->tm_hour
= 0;
4404 return mktime(timeinfo
);
4407 /* If data != NULL, then don't add to the timeq */
4408 static void helpserv_run_stats(time_t when
) {
4410 struct helpserv_bot
*hs
;
4411 struct helpserv_user
*hs_user
;
4413 dict_iterator_t it
, it2
;
4415 last_stats_update
= when
;
4416 localtime_r(&when
, &when_s
);
4417 for (it
=dict_first(helpserv_bots_dict
); it
; it
=iter_next(it
)) {
4420 for (it2
=dict_first(hs
->users
); it2
; it2
=iter_next(it2
)) {
4421 hs_user
= iter_data(it2
);
4423 /* Skip the helper if it's not their week-start day. */
4424 if (hs_user
->week_start
!= when_s
.tm_wday
)
4427 /* Adjust their credit if they are in-channel at rollover. */
4428 if (hs_user
->join_time
) {
4429 hs_user
->time_per_week
[0] += when
- hs_user
->join_time
;
4430 hs_user
->time_per_week
[4] += when
- hs_user
->join_time
;
4431 hs_user
->join_time
= when
;
4434 /* Shift everything */
4435 for (i
=3; i
> 0; i
--) {
4436 hs_user
->time_per_week
[i
] = hs_user
->time_per_week
[i
-1];
4437 hs_user
->picked_up
[i
] = hs_user
->picked_up
[i
-1];
4438 hs_user
->closed
[i
] = hs_user
->closed
[i
-1];
4439 hs_user
->reassigned_from
[i
] = hs_user
->reassigned_from
[i
-1];
4440 hs_user
->reassigned_to
[i
] = hs_user
->reassigned_to
[i
-1];
4443 /* Reset it for this week */
4444 hs_user
->time_per_week
[0] = hs_user
->picked_up
[0] = hs_user
->closed
[0] = hs_user
->reassigned_from
[0] = hs_user
->reassigned_to
[0] = 0;
4449 static void helpserv_timed_run_stats(UNUSED_ARG(void *data
)) {
4450 helpserv_run_stats(now
);
4451 timeq_add(helpserv_next_stats(now
), helpserv_timed_run_stats
, data
);
4455 helpserv_define_option(const char *name
, helpserv_option_func_t
*func
) {
4456 dict_insert(helpserv_option_dict
, name
, func
);
4459 static void helpserv_db_cleanup(void) {
4461 unreg_part_func(handle_part
);
4462 unreg_del_user_func(handle_quit
);
4463 close_helpfile(helpserv_helpfile
);
4464 dict_delete(helpserv_func_dict
);
4465 dict_delete(helpserv_option_dict
);
4466 dict_delete(helpserv_usercmd_dict
);
4467 dict_delete(helpserv_bots_dict
);
4468 dict_delete(helpserv_bots_bychan_dict
);
4469 dict_delete(helpserv_reqs_bynick_dict
);
4470 dict_delete(helpserv_reqs_byhand_dict
);
4471 dict_delete(helpserv_users_byhand_dict
);
4477 int helpserv_init() {
4478 HS_LOG
= log_register_type("HelpServ", "file:helpserv.log");
4479 conf_register_reload(helpserv_conf_read
);
4481 helpserv_func_dict
= dict_new();
4482 dict_set_free_data(helpserv_func_dict
, free
);
4483 helpserv_define_func("HELP", cmd_help
, HlNone
, CMD_NOT_OVERRIDE
|CMD_IGNORE_EVENT
);
4484 helpserv_define_func("LIST", cmd_list
, HlTrial
, CMD_NEED_BOT
|CMD_IGNORE_EVENT
);
4485 helpserv_define_func("NEXT", cmd_next
, HlTrial
, CMD_NEED_BOT
|CMD_NEVER_FROM_OPSERV
);
4486 helpserv_define_func("PICKUP", cmd_pickup
, HlTrial
, CMD_NEED_BOT
|CMD_NEVER_FROM_OPSERV
);
4487 helpserv_define_func("REASSIGN", cmd_reassign
, HlManager
, CMD_NEED_BOT
|CMD_NEVER_FROM_OPSERV
);
4488 helpserv_define_func("CLOSE", cmd_close
, HlTrial
, CMD_NEED_BOT
|CMD_NEVER_FROM_OPSERV
);
4489 helpserv_define_func("SHOW", cmd_show
, HlTrial
, CMD_NEED_BOT
|CMD_IGNORE_EVENT
);
4490 helpserv_define_func("ADDNOTE", cmd_addnote
, HlTrial
, CMD_NEED_BOT
);
4491 helpserv_define_func("ADDOWNER", cmd_addowner
, HlOper
, CMD_NEED_BOT
|CMD_FROM_OPSERV_ONLY
);
4492 helpserv_define_func("DELOWNER", cmd_deluser
, HlOper
, CMD_NEED_BOT
|CMD_FROM_OPSERV_ONLY
);
4493 helpserv_define_func("ADDTRIAL", cmd_addtrial
, HlManager
, CMD_NEED_BOT
);
4494 helpserv_define_func("ADDHELPER", cmd_addhelper
, HlManager
, CMD_NEED_BOT
);
4495 helpserv_define_func("ADDMANAGER", cmd_addmanager
, HlOwner
, CMD_NEED_BOT
);
4496 helpserv_define_func("GIVEOWNERSHIP", cmd_giveownership
, HlOwner
, CMD_NEED_BOT
);
4497 helpserv_define_func("DELUSER", cmd_deluser
, HlManager
, CMD_NEED_BOT
);
4498 helpserv_define_func("HELPERS", cmd_helpers
, HlNone
, CMD_NEED_BOT
);
4499 helpserv_define_func("WLIST", cmd_wlist
, HlNone
, CMD_NEED_BOT
);
4500 helpserv_define_func("MLIST", cmd_mlist
, HlNone
, CMD_NEED_BOT
);
4501 helpserv_define_func("HLIST", cmd_hlist
, HlNone
, CMD_NEED_BOT
);
4502 helpserv_define_func("TLIST", cmd_tlist
, HlNone
, CMD_NEED_BOT
);
4503 helpserv_define_func("CLVL", cmd_clvl
, HlManager
, CMD_NEED_BOT
);
4504 helpserv_define_func("PAGE", cmd_page
, HlTrial
, CMD_NEED_BOT
);
4505 helpserv_define_func("SET", cmd_set
, HlHelper
, CMD_NEED_BOT
);
4506 helpserv_define_func("STATS", cmd_stats
, HlTrial
, CMD_NEED_BOT
);
4507 helpserv_define_func("STATSREPORT", cmd_statsreport
, HlManager
, CMD_NEED_BOT
);
4508 helpserv_define_func("UNREGISTER", cmd_unregister
, HlOwner
, CMD_NEED_BOT
);
4509 helpserv_define_func("READHELP", cmd_readhelp
, HlOper
, CMD_FROM_OPSERV_ONLY
);
4510 helpserv_define_func("REGISTER", cmd_register
, HlOper
, CMD_FROM_OPSERV_ONLY
);
4511 helpserv_define_func("MOVE", cmd_move
, HlOper
, CMD_FROM_OPSERV_ONLY
|CMD_NEED_BOT
);
4512 helpserv_define_func("BOTS", cmd_bots
, HlOper
, CMD_FROM_OPSERV_ONLY
|CMD_IGNORE_EVENT
);
4513 helpserv_define_func("EXPIRE", cmd_expire
, HlOper
, CMD_FROM_OPSERV_ONLY
);
4514 helpserv_define_func("WEEKSTART", cmd_weekstart
, HlTrial
, CMD_NEED_BOT
);
4516 helpserv_option_dict
= dict_new();
4517 helpserv_define_option("PAGETARGET", opt_pagetarget_command
);
4518 helpserv_define_option("ALERTPAGETARGET", opt_pagetarget_alert
);
4519 helpserv_define_option("STATUSPAGETARGET", opt_pagetarget_status
);
4520 helpserv_define_option("PAGE", opt_pagetype
);
4521 helpserv_define_option("PAGETYPE", opt_pagetype
);
4522 helpserv_define_option("ALERTPAGETYPE", opt_alert_page_type
);
4523 helpserv_define_option("STATUSPAGETYPE", opt_status_page_type
);
4524 helpserv_define_option("GREETING", opt_greeting
);
4525 helpserv_define_option("REQOPENED", opt_req_opened
);
4526 helpserv_define_option("REQASSIGNED", opt_req_assigned
);
4527 helpserv_define_option("REQCLOSED", opt_req_closed
);
4528 helpserv_define_option("IDLEDELAY", opt_idle_delay
);
4529 helpserv_define_option("WHINEDELAY", opt_whine_delay
);
4530 helpserv_define_option("WHINEINTERVAL", opt_whine_interval
);
4531 helpserv_define_option("EMPTYINTERVAL", opt_empty_interval
);
4532 helpserv_define_option("STALEDELAY", opt_stale_delay
);
4533 helpserv_define_option("REQPERSIST", opt_request_persistence
);
4534 helpserv_define_option("HELPERPERSIST", opt_helper_persistence
);
4535 helpserv_define_option("NOTIFICATION", opt_notification
);
4536 helpserv_define_option("REQMAXLEN", opt_req_maxlen
);
4537 helpserv_define_option("IDWRAP", opt_id_wrap
);
4538 helpserv_define_option("PRIVMSGONLY", opt_privmsg_only
);
4539 helpserv_define_option("REQONJOIN", opt_req_on_join
);
4540 helpserv_define_option("AUTOVOICE", opt_auto_voice
);
4541 helpserv_define_option("AUTODEVOICE", opt_auto_devoice
);
4543 helpserv_usercmd_dict
= dict_new();
4544 dict_insert(helpserv_usercmd_dict
, "WAIT", usercmd_wait
);
4546 helpserv_bots_dict
= dict_new();
4547 dict_set_free_data(helpserv_bots_dict
, helpserv_free_bot
);
4549 helpserv_bots_bychan_dict
= dict_new();
4550 dict_set_free_data(helpserv_bots_bychan_dict
, helpserv_botlist_free
);
4552 helpserv_reqs_bynick_dict
= dict_new();
4553 dict_set_free_data(helpserv_reqs_bynick_dict
, helpserv_reqlist_free
);
4554 helpserv_reqs_byhand_dict
= dict_new();
4555 dict_set_free_data(helpserv_reqs_byhand_dict
, helpserv_reqlist_free
);
4557 helpserv_users_byhand_dict
= dict_new();
4558 dict_set_free_data(helpserv_users_byhand_dict
, helpserv_userlist_free
);
4560 saxdb_register("HelpServ", helpserv_saxdb_read
, helpserv_saxdb_write
);
4561 helpserv_helpfile_read();
4563 /* Make up for downtime... though this will only really affect the
4565 if (last_stats_update
&& (helpserv_next_stats(last_stats_update
) < now
)) {
4566 time_t statsrun
= last_stats_update
;
4567 while ((statsrun
= helpserv_next_stats(statsrun
)) < now
)
4568 helpserv_run_stats(statsrun
);
4570 timeq_add(helpserv_next_stats(now
), helpserv_timed_run_stats
, NULL
);
4572 reg_join_func(handle_join
);
4573 reg_part_func(handle_part
); /* also deals with kick */
4574 reg_nick_change_func(handle_nickchange
);
4575 reg_del_user_func(handle_quit
);
4577 reg_auth_func(handle_nickserv_auth
);
4578 reg_handle_rename_func(handle_nickserv_rename
);
4579 reg_unreg_func(handle_nickserv_unreg
);
4580 reg_allowauth_func(handle_nickserv_allowauth
);
4581 reg_failpw_func(handle_nickserv_failpw
);
4582 reg_handle_merge_func(handle_nickserv_merge
);
4584 reg_exit_func(helpserv_db_cleanup
);
4586 helpserv_module
= module_register("helpserv", HS_LOG
, HELPSERV_HELPFILE_NAME
, helpserv_expand_variable
);
4587 modcmd_register(helpserv_module
, "helpserv", cmd_helpserv
, 1, MODCMD_REQUIRE_AUTHED
|MODCMD_NO_LOG
|MODCMD_NO_DEFAULT_BIND
, "level", "800", NULL
);
4588 message_register_table(msgtab
);
4593 helpserv_finalize(void) {