2 * IRC - Internet Relay Chat, ircd/features.c
3 * Copyright (C) 2000 Kevin L. Mitchell <klmitch@mit.edu>
5 * This program is free software; you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License as published by
7 * the Free Software Foundation; either version 1, or (at your option)
10 * This program is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 * GNU General Public License for more details.
15 * You should have received a copy of the GNU General Public License
16 * along with this program; if not, write to the Free Software
17 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
20 * @brief Implementation of configurable feature support.
21 * @version $Id: ircd_features.c 1907 2009-02-09 04:11:04Z entrope $
25 #include "ircd_features.h"
26 #include "channel.h" /* list_set_default */
31 #include "ircd_alloc.h"
33 #include "ircd_reply.h"
34 #include "ircd_string.h"
40 #include "random.h" /* random_seed_set */
46 #include "sys.h" /* FALSE bleah */
47 #include "whowas.h" /* whowas_realloc */
49 /* #include <assert.h> -- Now using assert in ircd_log.h */
55 /** List of log output types that can be set */
56 static struct LogTypes {
57 char *type; /**< Settable name. */
58 int (*set)(const char *, const char *); /**< Function to set the value. */
59 char *(*get)(const char *); /**< Function to get the value. */
61 { "FILE", log_set_file, log_get_file },
62 { "FACILITY", log_set_facility, log_get_facility },
63 { "SNOMASK", log_set_snomask, log_get_snomask },
64 { "LEVEL", log_set_level, log_get_level },
68 /** Look up a struct LogType given the type string.
69 * @param[in] from &Client requesting type, or NULL.
70 * @param[in] type Name of log type to find.
71 * @return Pointer to the found LogType, or NULL if none was found.
73 static struct LogTypes *
74 feature_log_desc(struct Client* from, const char *type)
80 for (i = 0; logTypes[i].type; i++) /* find appropriate descriptor */
81 if (!ircd_strcmp(type, logTypes[i].type))
84 Debug((DEBUG_ERROR, "Unknown log feature type \"%s\"", type));
85 if (from) /* send an error; if from is NULL, called from conf parser */
86 send_reply(from, ERR_BADLOGTYPE, type);
88 log_write(LS_CONFIG, L_ERROR, 0, "Unknown log feature type \"%s\"", type);
90 return 0; /* not found */
93 /** Set the value of a log output type for a log subsystem.
94 * @param[in] from &Client trying to set the log type, or NULL.
95 * @param[in] fields Array of parameters to set.
96 * @param[in] count Number of parameters in \a fields.
97 * @return -1 to clear the mark, 0 to leave the mask alone, 1 to set the mask.
100 feature_log_set(struct Client* from, const char* const* fields, int count)
102 struct LogTypes *desc;
105 if (count < 2) { /* set default facility */
106 if (log_set_default(count < 1 ? 0 : fields[0])) {
107 assert(count >= 1); /* should always accept default */
109 if (from) /* send an error */
110 send_reply(from, ERR_BADLOGVALUE, fields[0]);
112 log_write(LS_CONFIG, L_ERROR, 0,
113 "Bad value \"%s\" for default facility", fields[0]);
115 return count < 1 ? -1 : 1; /* tell feature to set or clear mark */
116 } else if (!(subsys = log_canon(fields[0]))) { /* no such subsystem */
117 if (from) /* send an error */
118 send_reply(from, ERR_BADLOGSYS, fields[0]);
120 log_write(LS_CONFIG, L_ERROR, 0,
121 "No such logging subsystem \"%s\"", fields[0]);
122 } else if ((desc = feature_log_desc(from, fields[1]))) { /* set value */
123 if ((*desc->set)(fields[0], count < 3 ? 0 : fields[2])) {
124 assert(count >= 3); /* should always accept default */
126 if (from) /* send an error */
127 send_reply(from, ERR_BADLOGVALUE, fields[2]);
129 log_write(LS_CONFIG, L_ERROR, 0,
130 "Bad value \"%s\" for log type %s (subsystem %s)",
131 fields[2], desc->type, subsys);
138 /** Reset a log type for a subsystem to its default value.
139 * @param[in] from &Client trying to reset the subsystem.
140 * @param[in] fields Array of parameters to reset.
141 * @param[in] count Number of fields in \a fields.
142 * @return -1 to unmark the entry, or zero to leave it alone.
145 feature_log_reset(struct Client* from, const char* const* fields, int count)
147 struct LogTypes *desc;
150 assert(0 != from); /* Never called by the .conf parser */
152 if (count < 1) { /* reset default facility */
154 return -1; /* unmark this entry */
155 } else if (count < 2)
156 need_more_params(from, "RESET");
157 else if (!(subsys = log_canon(fields[0]))) /* no such subsystem */
158 send_reply(from, ERR_BADLOGSYS, fields[0]);
159 else if ((desc = feature_log_desc(from, fields[1]))) /* reset value */
160 (*desc->set)(fields[0], 0); /* default should always be accepted */
165 /** Handle an update to FEAT_HIS_SERVERNAME. */
167 feature_notify_servername(void)
169 ircd_strncpy(cli_name(&his), feature_str(FEAT_HIS_SERVERNAME), HOSTLEN);
172 /** Handle an update to FEAT_HIS_SERVERINFO. */
174 feature_notify_serverinfo(void)
176 ircd_strncpy(cli_info(&his), feature_str(FEAT_HIS_SERVERINFO), REALLEN);
179 /** Report the value of a log setting.
180 * @param[in] from &Client asking for details.
181 * @param[in] fields Array of parameters to get.
182 * @param[in] count Number of fields in \a fields.
185 feature_log_get(struct Client* from, const char* const* fields, int count)
187 struct LogTypes *desc;
188 char *value, *subsys;
190 assert(0 != from); /* never called by .conf parser */
192 if (count < 1) /* return default facility */
193 send_reply(from, SND_EXPLICIT | RPL_FEATURE, ":Log facility: %s",
196 need_more_params(from, "GET");
197 else if (!(subsys = log_canon(fields[0]))) { /* no such subsystem */
198 send_reply(from, ERR_BADLOGSYS, fields[0]);
199 } else if ((desc = feature_log_desc(from, fields[1]))) {
200 if ((value = (*desc->get)(fields[0]))) /* send along value */
201 send_reply(from, SND_EXPLICIT | RPL_FEATURE,
202 ":Log %s for subsystem %s: %s", desc->type, subsys,
203 (*desc->get)(subsys));
205 send_reply(from, SND_EXPLICIT | RPL_FEATURE,
206 ":No log %s is set for subsystem %s", desc->type, subsys);
210 /** Update whether #me is a hub or not.
213 feature_notify_hub(void)
215 if (feature_bool(FEAT_HUB))
221 /** Sets a feature to the given value.
222 * @param[in] from Client trying to set parameters.
223 * @param[in] fields Array of parameters to set.
224 * @param[in] count Number of fields in \a count.
225 * @return <0 to clear the feature mark, 0 to leave it, >0 to set the feature mark.
227 typedef int (*feat_set_call)(struct Client* from, const char* const* fields, int count);
228 /** Gets the value of a feature.
229 * @param[in] from Client trying to get parameters.
230 * @param[in] fields Array of parameters to set.
231 * @param[in] count Number of fields in \a count.
233 typedef void (*feat_get_call)(struct Client* from, const char* const* fields, int count);
234 /** Callback to notify of a feature's change. */
235 typedef void (*feat_notify_call)(void);
236 /** Unmarks all sub-feature values prior to reading .conf. */
237 typedef void (*feat_unmark_call)(void);
238 /** Resets to defaults all currently unmarked values.
239 * @param[in] marked Non-zero if the feature is marked.
241 typedef int (*feat_mark_call)(int marked);
242 /* Reports features as a /stats f list.
243 * @param[in] sptr Client asking for feature list.
244 * @param[in] marked Non-zero if the feature is marked.
246 typedef void (*feat_report_call)(struct Client* sptr, int marked);
248 #define FEAT_NONE 0x0000 /**< no value */
249 #define FEAT_INT 0x0001 /**< set if entry contains an integer value */
250 #define FEAT_BOOL 0x0002 /**< set if entry contains a boolean value */
251 #define FEAT_STR 0x0003 /**< set if entry contains a string value */
252 #define FEAT_MASK 0x000f /**< possible value types */
254 #define FEAT_MARK 0x0010 /**< set if entry has been changed */
255 #define FEAT_NULL 0x0020 /**< NULL string is permitted */
256 #define FEAT_CASE 0x0040 /**< string is case-sensitive */
258 #define FEAT_OPER 0x0100 /**< set to display only to opers */
259 #define FEAT_MYOPER 0x0200 /**< set to display only to local opers */
260 #define FEAT_NODISP 0x0400 /**< feature must never be displayed */
262 #define FEAT_READ 0x1000 /**< feature is read-only (for now, perhaps?) */
264 /** Declare a feature with custom behavior. */
265 #define F_N(type, flags, set, reset, get, notify, unmark, mark, report) \
266 { FEAT_ ## type, #type, FEAT_NONE | (flags), 0, 0, 0, 0, \
267 (set), (reset), (get), (notify), (unmark), (mark), (report) }
268 /** Declare a feature that takes integer values. */
269 #define F_I(type, flags, v_int, notify) \
270 { FEAT_ ## type, #type, FEAT_INT | (flags), 0, (v_int), 0, 0, \
271 0, 0, 0, (notify), 0, 0, 0 }
272 /** Declare a feature that takes boolean values. */
273 #define F_B(type, flags, v_int, notify) \
274 { FEAT_ ## type, #type, FEAT_BOOL | (flags), 0, (v_int), 0, 0, \
275 0, 0, 0, (notify), 0, 0, 0 }
276 /** Declare a feature that takes string values. */
277 #define F_S(type, flags, v_str, notify) \
278 { FEAT_ ## type, #type, FEAT_STR | (flags), 0, 0, 0, (v_str), \
279 0, 0, 0, (notify), 0, 0, 0 }
281 /** Table of feature descriptions. */
282 static struct FeatureDesc {
283 enum Feature feat; /**< feature identifier */
284 char* type; /**< string describing type */
285 unsigned int flags; /**< flags for feature */
286 int v_int; /**< integer value */
287 int def_int; /**< default value */
288 char* v_str; /**< string value */
289 char* def_str; /**< default value */
290 feat_set_call set; /**< set feature values */
291 feat_set_call reset; /**< reset feature values to defaults */
292 feat_get_call get; /**< get feature values */
293 feat_notify_call notify; /**< notify of value change */
294 feat_unmark_call unmark; /**< unmark all feature change values */
295 feat_mark_call mark; /**< reset to defaults all unchanged features */
296 feat_report_call report; /**< report feature values */
299 F_N(LOG, FEAT_MYOPER, feature_log_set, feature_log_reset, feature_log_get,
300 0, log_feature_unmark, log_feature_mark, log_feature_report),
301 F_S(DOMAINNAME, 0, DOMAINNAME, 0),
302 F_B(RELIABLE_CLOCK, 0, 0, 0),
303 F_I(BUFFERPOOL, 0, 27000000, 0),
304 F_B(HAS_FERGUSON_FLUSHER, 0, 0, 0),
305 F_I(CLIENT_FLOOD, 0, 1024, 0),
306 F_I(SERVER_PORT, FEAT_OPER, 4400, 0),
307 F_B(NODEFAULTMOTD, 0, 1, 0),
308 F_S(MOTD_BANNER, FEAT_NULL, 0, 0),
309 F_S(PROVIDER, FEAT_NULL, 0, 0),
310 F_B(KILL_IPMISMATCH, FEAT_OPER, 0, 0),
311 F_B(IDLE_FROM_MSG, 0, 1, 0),
312 F_B(HUB, 0, 0, feature_notify_hub),
313 F_B(WALLOPS_OPER_ONLY, 0, 0, 0),
315 F_N(RANDOM_SEED, FEAT_NODISP, random_seed_set, 0, 0, 0, 0, 0, 0),
316 F_S(DEFAULT_LIST_PARAM, FEAT_NULL, 0, list_set_default),
317 F_I(NICKNAMEHISTORYLENGTH, 0, 800, whowas_realloc),
318 F_B(HOST_HIDING, 0, 1, 0),
319 F_S(HIDDEN_HOST, FEAT_CASE, "users.undernet.org", 0),
320 F_S(HIDDEN_IP, 0, "127.0.0.1", 0),
321 F_B(CONNEXIT_NOTICES, 0, 0, 0),
322 F_B(OPLEVELS, 0, 1, 0),
323 F_B(ZANNELS, 0, 1, 0),
324 F_B(LOCAL_CHANNELS, 0, 1, 0),
325 F_B(TOPIC_BURST, 0, 0, 0),
326 F_B(AWAY_BURST, 0, 0, 0),
327 F_B(DISABLE_GLINES, 0, 0, 0),
328 F_B(FAKE_WEBIRC, 0, 1, 0),
329 F_B(WEBIRC_UMODE, 0, 1, 0),
330 F_B(WEBIRC_REJECT, 0, 1, 0),
331 F_B(LOC_ENABLE, 0, 0, 0),
332 F_S(LOC_TARGET, FEAT_NULL, 0, 0),
333 F_I(NOAMSG_TIME, 0, 0, 0),
334 F_I(NOAMSG_NUM, 0, 1, 0),
336 /* friendly error messages
337 * The errors below are the default */
338 F_S(ERR_CHANNELISFULL, FEAT_CASE, "Cannot join channel (+l)", 0),
339 F_S(ERR_INVITEONLYCHAN, FEAT_CASE, "Cannot join channel (+i)", 0),
340 F_S(ERR_BANNEDFROMCHAN, FEAT_CASE, "Cannot join channel (+b)", 0),
341 F_S(ERR_BADCHANNELKEY, FEAT_CASE, "Cannot join channel (+k)", 0),
342 F_S(ERR_NEEDREGGEDNICK, FEAT_CASE, "Cannot join channel (+r)", 0),
343 F_S(ERR_SSLCHANNEL, FEAT_CASE, "Cannot join channel (+S)", 0),
344 F_S(ERR_JOINACCESS, FEAT_CASE, "Cannot join channel (+a)", 0),
346 /* features that probably should not be touched */
347 F_I(KILLCHASETIMELIMIT, 0, 30, 0),
348 F_I(MAXCHANNELSPERUSER, 0, 10, 0),
349 F_I(NICKLEN, 0, 12, 0),
350 F_I(AVBANLEN, 0, 40, 0),
351 F_I(MAXBANS, 0, 45, 0),
352 F_I(MAXSILES, 0, 15, 0),
353 F_I(HANGONGOODLINK, 0, 300, 0),
354 F_I(HANGONRETRYDELAY, 0, 10, 0),
355 F_I(CONNECTTIMEOUT, 0, 90, 0),
356 F_I(MAXIMUM_LINKS, 0, 1, init_class), /* reinit class 0 as needed */
357 F_I(PINGFREQUENCY, 0, 120, init_class),
358 F_I(CONNECTFREQUENCY, 0, 600, init_class),
359 F_I(DEFAULTMAXSENDQLENGTH, 0, 40000, init_class),
360 F_I(GLINEMAXUSERCOUNT, 0, 20, 0),
361 F_I(SOCKSENDBUF, 0, SERVER_TCP_WINDOW, 0),
362 F_I(SOCKRECVBUF, 0, SERVER_TCP_WINDOW, 0),
363 F_I(IPCHECK_CLONE_LIMIT, 0, 4, 0),
364 F_I(IPCHECK_CLONE_PERIOD, 0, 40, 0),
365 F_I(IPCHECK_CLONE_DELAY, 0, 600, 0),
366 F_I(CHANNELLEN, 0, 200, 0),
368 /* Some misc. default paths */
369 F_S(MPATH, FEAT_CASE | FEAT_MYOPER, "ircd.motd", motd_init),
370 F_S(RPATH, FEAT_CASE | FEAT_MYOPER, "remote.motd", motd_init),
371 F_S(PPATH, FEAT_CASE | FEAT_MYOPER | FEAT_READ, "ircd.pid", 0),
373 /* Networking features */
374 F_I(TOS_SERVER, 0, 0x08, 0),
375 F_I(TOS_CLIENT, 0, 0x08, 0),
376 F_I(POLLS_PER_LOOP, 0, 200, 0),
377 F_I(IRCD_RES_RETRIES, 0, 2, 0),
378 F_I(IRCD_RES_TIMEOUT, 0, 4, 0),
379 F_I(AUTH_TIMEOUT, 0, 9, 0),
380 F_B(ANNOUNCE_INVITES, 0, 0, 0),
382 /* features that affect all operators */
383 F_B(CONFIG_OPERCMDS, 0, 0, 0),
385 /* HEAD_IN_SAND Features */
386 F_B(HIS_SNOTICES, 0, 1, 0),
387 F_B(HIS_SNOTICES_OPER_ONLY, 0, 1, 0),
388 F_B(HIS_DEBUG_OPER_ONLY, 0, 1, 0),
389 F_B(HIS_WALLOPS, 0, 1, 0),
390 F_B(HIS_MAP, 0, 1, 0),
391 F_B(HIS_LINKS, 0, 1, 0),
392 F_B(HIS_TRACE, 0, 1, 0),
393 F_B(HIS_STATS_a, 0, 1, 0),
394 F_B(HIS_STATS_c, 0, 1, 0),
395 F_B(HIS_STATS_d, 0, 1, 0),
396 F_B(HIS_STATS_e, 0, 1, 0),
397 F_B(HIS_STATS_f, 0, 1, 0),
398 F_B(HIS_STATS_g, 0, 1, 0),
399 F_B(HIS_STATS_i, 0, 1, 0),
400 F_B(HIS_STATS_j, 0, 1, 0),
401 F_B(HIS_STATS_J, 0, 1, 0),
402 F_B(HIS_STATS_k, 0, 1, 0),
403 F_B(HIS_STATS_l, 0, 1, 0),
404 F_B(HIS_STATS_L, 0, 1, 0),
405 F_B(HIS_STATS_M, 0, 1, 0),
406 F_B(HIS_STATS_m, 0, 1, 0),
407 F_B(HIS_STATS_o, 0, 1, 0),
408 F_B(HIS_STATS_p, 0, 1, 0),
409 F_B(HIS_STATS_q, 0, 1, 0),
410 F_B(HIS_STATS_R, 0, 1, 0),
411 F_B(HIS_STATS_r, 0, 1, 0),
412 F_B(HIS_STATS_t, 0, 1, 0),
413 F_B(HIS_STATS_T, 0, 1, 0),
414 F_B(HIS_STATS_u, 0, 0, 0),
415 F_B(HIS_STATS_U, 0, 1, 0),
416 F_B(HIS_STATS_v, 0, 1, 0),
417 F_B(HIS_STATS_w, 0, 0, 0),
418 F_B(HIS_STATS_x, 0, 1, 0),
419 F_B(HIS_STATS_y, 0, 1, 0),
420 F_B(HIS_STATS_z, 0, 1, 0),
421 F_B(HIS_STATS_IAUTH, 0, 1, 0),
422 F_B(HIS_WHOIS_SERVERNAME, 0, 1, 0),
423 F_B(HIS_WHOIS_IDLETIME, 0, 1, 0),
424 F_B(HIS_WHOIS_LOCALCHAN, 0, 1, 0),
425 F_B(HIS_WHO_SERVERNAME, 0, 1, 0),
426 F_B(HIS_WHO_HOPCOUNT, 0, 1, 0),
427 F_B(HIS_MODEWHO, 0, 1, 0),
428 F_B(HIS_BANWHO, 0, 1, 0),
429 F_B(HIS_KILLWHO, 0, 1, 0),
430 F_B(HIS_REWRITE, 0, 1, 0),
431 F_I(HIS_REMOTE, 0, 1, 0),
432 F_B(HIS_NETSPLIT, 0, 1, 0),
433 F_S(HIS_SERVERNAME, 0, "*.undernet.org", feature_notify_servername),
434 F_S(HIS_SERVERINFO, 0, "The Undernet Underworld", feature_notify_serverinfo),
435 F_S(HIS_URLSERVERS, 0, "http://www.undernet.org/servers.php", 0),
437 /* Misc. random stuff */
438 F_S(NETWORK, 0, "UnderNet", 0),
439 F_S(URL_CLIENTS, 0, "ftp://ftp.undernet.org/pub/irc/clients", 0),
441 F_B(UNKNOWN_CMD_ENABLE, 0, 0, 0),
442 F_S(UNKNOWN_CMD_TARGET, FEAT_NULL, 0, 0),
443 F_B(CHMODE_A_ENABLE, 0, 0, 0),
444 F_S(CHMODE_A_TARGET, FEAT_NULL, 0, 0),
445 F_B(CHMODE_A_NOSET, 0, 0, 0),
446 F_B(CHMODE_F_ENABLE, 0, 0, 0),
447 F_B(HALFOP, 0, 0, 0),
453 { FEAT_LAST_F, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 }
456 /** Given a feature's identifier, look up the feature descriptor.
457 * @param[in] from Client looking up feature, or NULL.
458 * @param[in] feature Feature name to find.
459 * @return Pointer to a FeatureDesc, or NULL if none was found.
461 static struct FeatureDesc *
462 feature_desc(struct Client* from, const char *feature)
466 assert(0 != feature);
468 for (i = 0; features[i].type; i++) /* find appropriate descriptor */
469 if (!strcmp(feature, features[i].type))
472 Debug((DEBUG_ERROR, "Unknown feature \"%s\"", feature));
473 if (from) /* report an error */
474 send_reply(from, ERR_NOFEATURE, feature);
476 log_write(LS_CONFIG, L_ERROR, 0, "Unknown feature \"%s\"", feature);
478 return 0; /* not found */
481 /** Given a feature vector string, set the value of a feature.
482 * @param[in] from Client trying to set the feature, or NULL.
483 * @param[in] fields Parameters to set, starting with feature name.
484 * @param[in] count Number of fields in \a fields.
485 * @return Zero (or, theoretically, CPTR_KILLED).
488 feature_set(struct Client* from, const char* const* fields, int count)
490 int i, change = 0, tmp;
492 struct FeatureDesc *feat;
494 if (from && !HasPriv(from, PRIV_SET))
495 return send_reply(from, ERR_NOPRIVILEGES);
498 if (from) /* report an error in the number of arguments */
499 need_more_params(from, "SET");
501 log_write(LS_CONFIG, L_ERROR, 0, "Not enough fields in F line");
502 } else if ((feat = feature_desc(from, fields[0]))) { /* find feature */
503 if (from && feat->flags & FEAT_READ)
504 return send_reply(from, ERR_NOFEATURE, fields[0]);
506 switch (feat->flags & FEAT_MASK) {
508 if (feat->set && (i = (*feat->set)(from, fields + 1, count - 1))) {
509 change++; /* feature handler wants a change recorded */
511 if (i > 0) /* call the set callback and do marking */
512 feat->flags |= FEAT_MARK;
514 feat->flags &= ~FEAT_MARK;
518 case FEAT_INT: /* an integer value */
519 tmp = feat->v_int; /* detect changes... */
521 if (count < 2) { /* reset value */
522 feat->v_int = feat->def_int;
523 feat->flags &= ~FEAT_MARK;
524 } else { /* ok, figure out the value and whether to mark it */
525 feat->v_int = strtoul(fields[1], 0, 0);
526 if (feat->v_int == feat->def_int)
527 feat->flags &= ~FEAT_MARK;
529 feat->flags |= FEAT_MARK;
532 if (feat->v_int != tmp) /* check for change */
536 case FEAT_BOOL: /* it's a boolean value--true or false */
537 tmp = feat->v_int; /* detect changes... */
539 if (count < 2) { /* reset value */
540 feat->v_int = feat->def_int;
541 feat->flags &= ~FEAT_MARK;
542 } else { /* figure out the value and whether to mark it */
543 if (!ircd_strncmp(fields[1], "TRUE", strlen(fields[1])) ||
544 !ircd_strncmp(fields[1], "YES", strlen(fields[1])) ||
545 (strlen(fields[1]) >= 2 &&
546 !ircd_strncmp(fields[1], "ON", strlen(fields[1]))))
548 else if (!ircd_strncmp(fields[1], "FALSE", strlen(fields[1])) ||
549 !ircd_strncmp(fields[1], "NO", strlen(fields[1])) ||
550 (strlen(fields[1]) >= 2 &&
551 !ircd_strncmp(fields[1], "OFF", strlen(fields[1]))))
553 else if (from) /* report an error... */
554 return send_reply(from, ERR_BADFEATVALUE, fields[1], feat->type);
556 log_write(LS_CONFIG, L_ERROR, 0, "Bad value \"%s\" for feature %s",
557 fields[1], feat->type);
561 if (feat->v_int == feat->def_int) /* figure out whether to mark it */
562 feat->flags &= ~FEAT_MARK;
564 feat->flags |= FEAT_MARK;
567 if (feat->v_int != tmp) /* check for change */
571 case FEAT_STR: /* it's a string value */
573 t_str = feat->def_str; /* changing to default */
575 t_str = *fields[1] ? fields[1] : 0;
577 if (!t_str && !(feat->flags & FEAT_NULL)) { /* NULL value permitted? */
579 return send_reply(from, ERR_BADFEATVALUE, "NULL", feat->type);
581 log_write(LS_CONFIG, L_ERROR, 0, "Bad value \"NULL\" for feature %s",
587 if (t_str == feat->def_str ||
588 (t_str && feat->def_str &&
589 !(feat->flags & FEAT_CASE ? strcmp(t_str, feat->def_str) :
590 ircd_strcmp(t_str, feat->def_str)))) { /* resetting to default */
591 if (feat->v_str != feat->def_str) {
592 change++; /* change from previous value */
595 MyFree(feat->v_str); /* free old value */
598 feat->v_str = feat->def_str; /* very special... */
600 feat->flags &= ~FEAT_MARK;
603 change++; /* change from previous value */
605 if (feat->v_str != feat->def_str)
606 MyFree(feat->v_str); /* free old value */
609 feat->v_str = 0; /* set it to NULL */
611 feat->flags |= FEAT_MARK;
612 } else if (!feat->v_str ||
613 (feat->flags & FEAT_CASE ? strcmp(t_str, feat->v_str) :
614 ircd_strcmp(t_str, feat->v_str))) { /* new value */
615 change++; /* change from previous value */
617 if (feat->v_str && feat->v_str != feat->def_str)
618 MyFree(feat->v_str); /* free old value */
619 DupString(feat->v_str, t_str); /* store new value */
621 feat->flags |= FEAT_MARK;
622 } else /* they match, but don't match the default */
623 feat->flags |= FEAT_MARK;
627 if (change && feat->notify) /* call change notify function */
631 return feature_get(from, fields, count);
637 /** Reset a feature to its default values.
638 * @param[in] from Client trying to reset the feature, or NULL.
639 * @param[in] fields Parameters to set, starting with feature name.
640 * @param[in] count Number of fields in \a fields.
641 * @return Zero (or, theoretically, CPTR_KILLED).
644 feature_reset(struct Client* from, const char* const* fields, int count)
647 struct FeatureDesc *feat;
651 if (!HasPriv(from, PRIV_SET))
652 return send_reply(from, ERR_NOPRIVILEGES);
654 if (count < 1) /* check arguments */
655 need_more_params(from, "RESET");
656 else if ((feat = feature_desc(from, fields[0]))) { /* get descriptor */
657 if (from && feat->flags & FEAT_READ)
658 return send_reply(from, ERR_NOFEATURE, fields[0]);
660 switch (feat->flags & FEAT_MASK) {
661 case FEAT_NONE: /* None... */
662 if (feat->reset && (i = (*feat->reset)(from, fields + 1, count - 1))) {
663 change++; /* feature handler wants a change recorded */
665 if (i > 0) /* call reset callback and parse mark return */
666 feat->flags |= FEAT_MARK;
668 feat->flags &= ~FEAT_MARK;
672 case FEAT_INT: /* Integer... */
673 case FEAT_BOOL: /* Boolean... */
674 if (feat->v_int != feat->def_int)
675 change++; /* change will be made */
677 feat->v_int = feat->def_int; /* set the default */
678 feat->flags &= ~FEAT_MARK; /* unmark it */
681 case FEAT_STR: /* string! */
682 if (feat->v_str != feat->def_str) {
683 change++; /* change has been made */
685 MyFree(feat->v_str); /* free old value */
688 feat->v_str = feat->def_str; /* set it to default */
689 feat->flags &= ~FEAT_MARK; /* unmark it */
693 if (change && feat->notify) /* call change notify function */
697 return feature_get(from, fields, count);
703 /** Gets the value of a specific feature and reports it to the user.
704 * @param[in] from Client trying to get the feature.
705 * @param[in] fields Parameters to set, starting with feature name.
706 * @param[in] count Number of fields in \a fields.
707 * @return Zero (or, theoretically, CPTR_KILLED).
710 feature_get(struct Client* from, const char* const* fields, int count)
712 struct FeatureDesc *feat;
716 if (count < 1) /* check parameters */
717 need_more_params(from, "GET");
718 else if ((feat = feature_desc(from, fields[0]))) {
719 if ((feat->flags & FEAT_NODISP) ||
720 (feat->flags & FEAT_MYOPER && !MyOper(from)) ||
721 (feat->flags & FEAT_OPER && !IsAnOper(from))) /* check privs */
722 return send_reply(from, ERR_NOPRIVILEGES);
724 switch (feat->flags & FEAT_MASK) {
725 case FEAT_NONE: /* none, call the callback... */
726 if (feat->get) /* if there's a callback, use it */
727 (*feat->get)(from, fields + 1, count - 1);
730 case FEAT_INT: /* integer, report integer value */
731 send_reply(from, SND_EXPLICIT | RPL_FEATURE,
732 ":Integer value of %s: %d", feat->type, feat->v_int);
735 case FEAT_BOOL: /* boolean, report boolean value */
736 send_reply(from, SND_EXPLICIT | RPL_FEATURE,
737 ":Boolean value of %s: %s", feat->type,
738 feat->v_int ? "TRUE" : "FALSE");
741 case FEAT_STR: /* string, report string value */
742 if (feat->v_str) /* deal with null case */
743 send_reply(from, SND_EXPLICIT | RPL_FEATURE,
744 ":String value of %s: %s", feat->type, feat->v_str);
746 send_reply(from, SND_EXPLICIT | RPL_FEATURE,
747 ":String value for %s not set", feat->type);
755 /** Called before reading the .conf to clear all dirty marks. */
761 for (i = 0; features[i].type; i++) {
762 features[i].flags &= ~FEAT_MARK; /* clear the marks... */
763 if (features[i].unmark) /* call the unmark callback if necessary */
764 (*features[i].unmark)();
768 /** Called after reading the .conf to reset unmodified values to defaults. */
774 for (i = 0; features[i].type; i++) {
777 switch (features[i].flags & FEAT_MASK) {
779 if (features[i].mark &&
780 (*features[i].mark)(features[i].flags & FEAT_MARK ? 1 : 0))
781 change++; /* feature handler wants a change recorded */
784 case FEAT_INT: /* Integers or Booleans... */
786 if (!(features[i].flags & FEAT_MARK)) { /* not changed? */
787 if (features[i].v_int != features[i].def_int)
788 change++; /* we're making a change */
789 features[i].v_int = features[i].def_int;
793 case FEAT_STR: /* strings... */
794 if (!(features[i].flags & FEAT_MARK)) { /* not changed? */
795 if (features[i].v_str != features[i].def_str) {
796 change++; /* we're making a change */
797 if (features[i].v_str)
798 MyFree(features[i].v_str); /* free old value */
800 features[i].v_str = features[i].def_str;
805 if (change && features[i].notify)
806 (*features[i].notify)(); /* call change notify function */
810 /** Initialize the features subsystem. */
816 for (i = 0; features[i].type; i++) {
817 switch (features[i].flags & FEAT_MASK) {
818 case FEAT_NONE: /* you're on your own */
821 case FEAT_INT: /* Integers or Booleans... */
823 features[i].v_int = features[i].def_int;
826 case FEAT_STR: /* Strings */
827 features[i].v_str = features[i].def_str;
828 assert(features[i].def_str || (features[i].flags & FEAT_NULL));
833 cli_magic(&his) = CLIENT_MAGIC;
834 cli_status(&his) = STAT_SERVER;
835 feature_notify_servername();
836 feature_notify_serverinfo();
839 /** Report all F-lines to a user.
840 * @param[in] to Client requesting statistics.
841 * @param[in] sd Stats descriptor for request (ignored).
842 * @param[in] param Extra parameter from user (ignored).
845 feature_report(struct Client* to, const struct StatDesc* sd, char* param)
849 for (i = 0; features[i].type; i++) {
850 if ((features[i].flags & FEAT_NODISP) ||
851 (features[i].flags & FEAT_MYOPER && !MyOper(to)) ||
852 (features[i].flags & FEAT_OPER && !IsAnOper(to)))
853 continue; /* skip this one */
855 switch (features[i].flags & FEAT_MASK) {
857 if (features[i].report) /* let the callback handle this */
858 (*features[i].report)(to, features[i].flags & FEAT_MARK ? 1 : 0);
862 case FEAT_INT: /* Report an F-line with integer values */
863 if (features[i].flags & FEAT_MARK) /* it's been changed */
864 send_reply(to, SND_EXPLICIT | RPL_STATSFLINE, "F %s %d",
865 features[i].type, features[i].v_int);
868 case FEAT_BOOL: /* Report an F-line with boolean values */
869 if (features[i].flags & FEAT_MARK) /* it's been changed */
870 send_reply(to, SND_EXPLICIT | RPL_STATSFLINE, "F %s %s",
871 features[i].type, features[i].v_int ? "TRUE" : "FALSE");
874 case FEAT_STR: /* Report an F-line with string values */
875 if (features[i].flags & FEAT_MARK) { /* it's been changed */
876 if (features[i].v_str)
877 send_reply(to, SND_EXPLICIT | RPL_STATSFLINE, "F %s %s",
878 features[i].type, features[i].v_str);
879 else /* Actually, F:<type> would reset it; you want F:<type>: */
880 send_reply(to, SND_EXPLICIT | RPL_STATSFLINE, "F %s",
888 /** Return a feature's integer value.
889 * @param[in] feat &Feature identifier.
890 * @return Integer value of feature.
893 feature_int(enum Feature feat)
895 assert(features[feat].feat == feat);
896 assert((features[feat].flags & FEAT_MASK) == FEAT_INT);
898 return features[feat].v_int;
901 /** Return a feature's boolean value.
902 * @param[in] feat &Feature identifier.
903 * @return Boolean value of feature.
906 feature_bool(enum Feature feat)
908 assert(feat <= FEAT_LAST_F);
909 if (FEAT_LAST_F < feat)
911 assert(features[feat].feat == feat);
912 assert((features[feat].flags & FEAT_MASK) == FEAT_BOOL);
914 return features[feat].v_int;
917 /** Return a feature's string value.
918 * @param[in] feat &Feature identifier.
919 * @return String value of feature.
922 feature_str(enum Feature feat)
924 assert(features[feat].feat == feat);
925 assert((features[feat].flags & FEAT_MASK) == FEAT_STR);
927 return features[feat].v_str;