/* * InspIRCd -- Internet Relay Chat Daemon * * Copyright (C) 2018 linuxdaemon * Copyright (C) 2013-2014, 2016-2021 Sadie Powell * Copyright (C) 2013 ChrisTX * Copyright (C) 2012-2014 Attila Molnar * Copyright (C) 2012 Robby * Copyright (C) 2010 Craig Edwards * Copyright (C) 2009-2010 Daniel De Graaf * * This file is part of InspIRCd. InspIRCd is free software: you can * redistribute it and/or modify it under the terms of the GNU General Public * License as published by the Free Software Foundation, version 2. * * This program is distributed in the hope that it will be useful, but WITHOUT * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS * FOR A PARTICULAR PURPOSE. See the GNU General Public License for more * details. * * You should have received a copy of the GNU General Public License * along with this program. If not, see . */ #include "inspircd.h" #include #include "configparser.h" enum ParseFlags { // Legacy config parsing should be used. FLAG_USE_COMPAT = 1, // Executable includes are disabled. FLAG_NO_EXEC = 2, // All includes are disabled. FLAG_NO_INC = 4, // &env.FOO; is disabled. FLAG_NO_ENV = 8, // It's okay if an include doesn't exist. FLAG_MISSING_OKAY = 16 }; // Represents the position within a config file. struct FilePosition { // The name of the file which is being read. std::string name; // The line of the file that this position points to. unsigned int line; // The column of the file that this position points to. unsigned int column; FilePosition(const std::string& Name) : name(Name) , line(1) , column(1) { } /** Returns a string that represents this file position. */ std::string str() { return name + ":" + ConvToStr(line) + ":" + ConvToStr(column); } }; // RAII wrapper for FILE* which closes the file when it goes out of scope. class FileWrapper { private: // Whether this file handle should be closed with pclose. bool close_with_pclose; // The file handle which is being wrapped. FILE* const file; public: FileWrapper(FILE* File, bool CloseWithPClose = false) : close_with_pclose(CloseWithPClose) , file(File) { } // Operator which determines whether the file is open. operator bool() { return (file != NULL); } // Operator which retrieves the underlying FILE pointer. operator FILE*() { return file; } ~FileWrapper() { if (!file) return; if (close_with_pclose) pclose(file); else fclose(file); } }; struct Parser { ParseStack& stack; int flags; FILE* const file; FilePosition current; FilePosition last_tag; reference tag; int ungot; std::string mandatory_tag; Parser(ParseStack& me, int myflags, FILE* conf, const std::string& name, const std::string& mandatorytag) : stack(me), flags(myflags), file(conf), current(name), last_tag(name), ungot(-1), mandatory_tag(mandatorytag) { } int next(bool eof_ok = false) { if (ungot != -1) { int ch = ungot; ungot = -1; return ch; } int ch = fgetc(file); if (ch == EOF && !eof_ok) { throw CoreException("Unexpected end-of-file"); } else if (ch == '\n') { current.line++; current.column = 0; } else { current.column++; } return ch; } void unget(int ch) { if (ungot != -1) throw CoreException("INTERNAL ERROR: cannot unget twice"); ungot = ch; } void comment() { while (1) { int ch = next(); if (ch == '\n') return; } } bool wordchar(char ch) { return isalnum(ch) || ch == '-' || ch == '.' || ch == '_'; } void nextword(std::string& rv) { int ch = next(); while (isspace(ch)) ch = next(); while (wordchar(ch)) { rv.push_back(ch); ch = next(); } unget(ch); } bool kv(ConfigItems* items) { std::string key; nextword(key); int ch = next(); if (ch == '>' && key.empty()) { return false; } else if (ch == '#' && key.empty()) { comment(); return true; } else if (ch != '=') { throw CoreException("Invalid character " + std::string(1, ch) + " in key (" + key + ")"); } std::string value; ch = next(); if (ch != '"') { throw CoreException("Invalid character in value of <" + tag->tag + ":" + key + ">"); } while (1) { ch = next(); if (ch == '&' && !(flags & FLAG_USE_COMPAT)) { std::string varname; while (1) { ch = next(); if (wordchar(ch) || (varname.empty() && ch == '#')) varname.push_back(ch); else if (ch == ';') break; else { stack.errstr << "Invalid XML entity name in value of <" + tag->tag + ":" + key + ">\n" << "To include an ampersand or quote, use & or "\n"; throw CoreException("Parse error"); } } if (varname.empty()) throw CoreException("Empty XML entity reference"); else if (varname[0] == '#' && (varname.size() == 1 || (varname.size() == 2 && varname[1] == 'x'))) throw CoreException("Empty numeric character reference"); else if (varname[0] == '#') { const char* cvarname = varname.c_str(); char* endptr; unsigned long lvalue; if (cvarname[1] == 'x') lvalue = strtoul(cvarname + 2, &endptr, 16); else lvalue = strtoul(cvarname + 1, &endptr, 10); if (*endptr != '\0' || lvalue > 255) throw CoreException("Invalid numeric character reference '&" + varname + ";'"); value.push_back(static_cast(lvalue)); } else if (varname.compare(0, 4, "env.") == 0) { if (flags & FLAG_NO_ENV) throw CoreException("XML environment entity reference in file included with noenv=\"yes\""); const char* envstr = getenv(varname.c_str() + 4); if (!envstr) throw CoreException("Undefined XML environment entity reference '&" + varname + ";'"); value.append(envstr); } else { insp::flat_map::iterator var = stack.vars.find(varname); if (var == stack.vars.end()) throw CoreException("Undefined XML entity reference '&" + varname + ";'"); value.append(var->second); } } else if (ch == '\\' && (flags & FLAG_USE_COMPAT)) { int esc = next(); if (esc == 'n') value.push_back('\n'); else if (isalpha(esc)) throw CoreException("Unknown escape character \\" + std::string(1, esc)); else value.push_back(esc); } else if (ch == '"') break; else if (ch != '\r') value.push_back(ch); } if (items->find(key) != items->end()) throw CoreException("Duplicate key '" + key + "' found"); (*items)[key] = value; return true; } void dotag() { last_tag = current; std::string name; nextword(name); int spc = next(); if (spc == '>') unget(spc); else if (!isspace(spc)) throw CoreException("Invalid character in tag name"); if (name.empty()) throw CoreException("Empty tag name"); ConfigItems* items; tag = ConfigTag::create(name, current.name, current.line, items); while (kv(items)) { // Do nothing here (silences a GCC warning). } if (name == mandatory_tag) { // Found the mandatory tag mandatory_tag.clear(); } if (stdalgo::string::equalsci(name, "include")) { stack.DoInclude(tag, flags); } else if (stdalgo::string::equalsci(name, "files")) { for(ConfigItems::iterator i = items->begin(); i != items->end(); i++) { stack.DoReadFile(i->first, i->second, flags, false); } } else if (stdalgo::string::equalsci(name, "execfiles")) { for(ConfigItems::iterator i = items->begin(); i != items->end(); i++) { stack.DoReadFile(i->first, i->second, flags, true); } } else if (stdalgo::string::equalsci(name, "define")) { if (flags & FLAG_USE_COMPAT) throw CoreException(" tags may only be used in XML-style config (add )"); std::string varname = tag->getString("name"); std::string value = tag->getString("value"); if (varname.empty()) throw CoreException("Variable definition must include variable name"); stack.vars[varname] = value; } else if (stdalgo::string::equalsci(name, "config")) { std::string format = tag->getString("format"); if (stdalgo::string::equalsci(format, "xml")) flags &= ~FLAG_USE_COMPAT; else if (stdalgo::string::equalsci(format, "compat")) flags |= FLAG_USE_COMPAT; else if (!format.empty()) throw CoreException("Unknown configuration format " + format); } else { stack.output.insert(std::make_pair(name, tag)); } // this is not a leak; reference<> takes care of the delete tag = NULL; } bool outer_parse() { try { while (1) { int ch = next(true); switch (ch) { case EOF: // this is the one place where an EOF is not an error if (!mandatory_tag.empty()) throw CoreException("Mandatory tag \"" + mandatory_tag + "\" not found"); return true; case '#': comment(); break; case '<': dotag(); break; case ' ': case '\r': case '\t': case '\n': break; case 0xFE: case 0xFF: stack.errstr << "Do not save your files as UTF-16 or UTF-32, use UTF-8!\n"; /*@fallthrough@*/ default: throw CoreException("Syntax error - start of tag expected"); } } } catch (CoreException& err) { stack.errstr << err.GetReason() << " at " << current.str(); if (tag) stack.errstr << " (inside tag " << tag->tag << " at line " << tag->src_line << ")\n"; else stack.errstr << " (last tag was on line " << last_tag.line << ")\n"; } return false; } }; void ParseStack::DoInclude(ConfigTag* tag, int flags) { if (flags & FLAG_NO_INC) throw CoreException("Invalid tag in file included with noinclude=\"yes\""); std::string mandatorytag; tag->readString("mandatorytag", mandatorytag); std::string name; if (tag->readString("file", name)) { if (tag->getBool("noinclude", false)) flags |= FLAG_NO_INC; if (tag->getBool("noexec", false)) flags |= FLAG_NO_EXEC; if (tag->getBool("noenv", false)) flags |= FLAG_NO_ENV; if (tag->getBool("missingokay", false)) flags |= FLAG_MISSING_OKAY; else flags &= ~FLAG_MISSING_OKAY; if (!ParseFile(ServerInstance->Config->Paths.PrependConfig(name), flags, mandatorytag)) throw CoreException("Included"); } else if (tag->readString("directory", name)) { if (tag->getBool("noinclude", false)) flags |= FLAG_NO_INC; if (tag->getBool("noexec", false)) flags |= FLAG_NO_EXEC; if (tag->getBool("noenv", false)) flags |= FLAG_NO_ENV; const std::string includedir = ServerInstance->Config->Paths.PrependConfig(name); std::vector files; if (!FileSystem::GetFileList(includedir, files, "*.conf")) throw CoreException("Unable to read directory for include: " + includedir); std::sort(files.begin(), files.end()); for (std::vector::const_iterator iter = files.begin(); iter != files.end(); ++iter) { const std::string path = includedir + '/' + *iter; if (!ParseFile(path, flags, mandatorytag)) throw CoreException("Included"); } } else if (tag->readString("executable", name)) { if (flags & FLAG_NO_EXEC) throw CoreException("Invalid tag in file included with noexec=\"yes\""); if (tag->getBool("noinclude", false)) flags |= FLAG_NO_INC; if (tag->getBool("noexec", true)) flags |= FLAG_NO_EXEC; if (tag->getBool("noenv", true)) flags |= FLAG_NO_ENV; if (!ParseFile(name, flags, mandatorytag, true)) throw CoreException("Included"); } } void ParseStack::DoReadFile(const std::string& key, const std::string& name, int flags, bool exec) { if (flags & FLAG_NO_INC) throw CoreException("Invalid tag in file included with noinclude=\"yes\""); if (exec && (flags & FLAG_NO_EXEC)) throw CoreException("Invalid tag in file included with noexec=\"yes\""); std::string path = ServerInstance->Config->Paths.PrependConfig(name); FileWrapper file(exec ? popen(name.c_str(), "r") : fopen(path.c_str(), "r"), exec); if (!file) throw CoreException("Could not read \"" + path + "\" for \"" + key + "\" file"); file_cache& cache = FilesOutput[key]; cache.clear(); char linebuf[5120]; while (fgets(linebuf, sizeof(linebuf), file)) { size_t len = strlen(linebuf); if (len) { if (linebuf[len-1] == '\n') len--; cache.push_back(std::string(linebuf, len)); } } } bool ParseStack::ParseFile(const std::string& path, int flags, const std::string& mandatory_tag, bool isexec) { ServerInstance->Logs->Log("CONFIG", LOG_DEBUG, "Reading (isexec=%d) %s", isexec, path.c_str()); if (stdalgo::isin(reading, path)) throw CoreException((isexec ? "Executable " : "File ") + path + " is included recursively (looped inclusion)"); /* It's not already included, add it to the list of files we've loaded */ FileWrapper file((isexec ? popen(path.c_str(), "r") : fopen(path.c_str(), "r")), isexec); if (!file) { if (flags & FLAG_MISSING_OKAY) return true; throw CoreException("Could not read \"" + path + "\" for include"); } reading.push_back(path); Parser p(*this, flags, file, path, mandatory_tag); bool ok = p.outer_parse(); reading.pop_back(); return ok; } bool ConfigTag::readString(const std::string& key, std::string& value, bool allow_lf) { for(ConfigItems::iterator j = items.begin(); j != items.end(); ++j) { if(j->first != key) continue; value = j->second; if (!allow_lf && (value.find('\n') != std::string::npos)) { ServerInstance->Logs->Log("CONFIG", LOG_DEFAULT, "Value of <" + tag + ":" + key + "> at " + getTagLocation() + " contains a linefeed, and linefeeds in this value are not permitted -- stripped to spaces."); for (std::string::iterator n = value.begin(); n != value.end(); n++) if (*n == '\n') *n = ' '; } return true; } return false; } std::string ConfigTag::getString(const std::string& key, const std::string& def, const TR1NS::function& validator) { std::string res; if (!readString(key, res)) return def; if (!validator(res)) { ServerInstance->Logs->Log("CONFIG", LOG_DEFAULT, "WARNING: The value of <%s:%s> is not valid; value set to %s.", tag.c_str(), key.c_str(), def.c_str()); return def; } return res; } std::string ConfigTag::getString(const std::string& key, const std::string& def, size_t minlen, size_t maxlen) { std::string res; if (!readString(key, res)) return def; if (res.length() < minlen || res.length() > maxlen) { ServerInstance->Logs->Log("CONFIG", LOG_DEFAULT, "WARNING: The length of <%s:%s> is not between %ld and %ld; value set to %s.", tag.c_str(), key.c_str(), minlen, maxlen, def.c_str()); return def; } return res; } namespace { /** Check for an invalid magnitude specifier. If one is found a warning is logged and the * value is corrected (set to \p def). * @param tag The tag name; used in the warning message. * @param key The key name; used in the warning message. * @param val The full value set in the config as a string. * @param num The value to verify and modify if needed. * @param def The default value, \p res will be set to this if \p tail does not contain a. * valid magnitude specifier. * @param tail The location in the config value at which the magnifier is located. */ template void CheckMagnitude(const std::string& tag, const std::string& key, const std::string& val, Numeric& num, Numeric def, const char* tail) { // If this is NULL then no magnitude specifier was given. if (!*tail) return; switch (toupper(*tail)) { case 'K': num *= 1024; return; case 'M': num *= 1024 * 1024; return; case 'G': num *= 1024 * 1024 * 1024; return; } const std::string message = "WARNING: <" + tag + ":" + key + "> value of " + val + " contains an invalid magnitude specifier '" + tail + "'; value set to " + ConvToStr(def) + "."; ServerInstance->Logs->Log("CONFIG", LOG_DEFAULT, message); num = def; } /** Check for an out of range value. If the value falls outside the boundaries a warning is * logged and the value is corrected (set to \p def). * @param tag The tag name; used in the warning message. * @param key The key name; used in the warning message. * @param num The value to verify and modify if needed. * @param def The default value, \p res will be set to this if (min <= res <= max) doesn't hold true. * @param min Minimum accepted value for \p res. * @param max Maximum accepted value for \p res. */ template void CheckRange(const std::string& tag, const std::string& key, Numeric& num, Numeric def, Numeric min, Numeric max) { if (num >= min && num <= max) return; const std::string message = "WARNING: <" + tag + ":" + key + "> value of " + ConvToStr(num) + " is not between " + ConvToStr(min) + " and " + ConvToStr(max) + "; value set to " + ConvToStr(def) + "."; ServerInstance->Logs->Log("CONFIG", LOG_DEFAULT, message); num = def; } } long ConfigTag::getInt(const std::string &key, long def, long min, long max) { std::string result; if(!readString(key, result) || result.empty()) return def; const char* res_cstr = result.c_str(); char* res_tail = NULL; long res = strtol(res_cstr, &res_tail, 0); if (res_tail == res_cstr) return def; CheckMagnitude(tag, key, result, res, def, res_tail); CheckRange(tag, key, res, def, min, max); return res; } unsigned long ConfigTag::getUInt(const std::string& key, unsigned long def, unsigned long min, unsigned long max) { std::string result; if (!readString(key, result) || result.empty()) return def; const char* res_cstr = result.c_str(); char* res_tail = NULL; unsigned long res = strtoul(res_cstr, &res_tail, 0); if (res_tail == res_cstr) return def; CheckMagnitude(tag, key, result, res, def, res_tail); CheckRange(tag, key, res, def, min, max); return res; } unsigned long ConfigTag::getDuration(const std::string& key, unsigned long def, unsigned long min, unsigned long max) { std::string duration; if (!readString(key, duration) || duration.empty()) return def; unsigned long ret; if (!InspIRCd::Duration(duration, ret)) { ServerInstance->Logs->Log("CONFIG", LOG_DEFAULT, "Value of <" + tag + ":" + key + "> at " + getTagLocation() + " is not a duration; value set to " + ConvToStr(def) + "."); return def; } CheckRange(tag, key, ret, def, min, max); return ret; } double ConfigTag::getFloat(const std::string& key, double def, double min, double max) { std::string result; if (!readString(key, result)) return def; double res = strtod(result.c_str(), NULL); CheckRange(tag, key, res, def, min, max); return res; } bool ConfigTag::getBool(const std::string &key, bool def) { std::string result; if(!readString(key, result) || result.empty()) return def; if (stdalgo::string::equalsci(result, "yes") || stdalgo::string::equalsci(result, "true") || stdalgo::string::equalsci(result, "on") || result == "1") return true; if (stdalgo::string::equalsci(result, "no") || stdalgo::string::equalsci(result, "false") || stdalgo::string::equalsci(result, "off") || result == "0") return false; ServerInstance->Logs->Log("CONFIG", LOG_DEFAULT, "Value of <" + tag + ":" + key + "> at " + getTagLocation() + " is not valid, ignoring"); return def; } std::string ConfigTag::getTagLocation() { return src_name + ":" + ConvToStr(src_line); } ConfigTag* ConfigTag::create(const std::string& Tag, const std::string& file, int line, ConfigItems*& Items) { ConfigTag* rv = new ConfigTag(Tag, file, line); Items = &rv->items; return rv; } ConfigTag::ConfigTag(const std::string& Tag, const std::string& file, int line) : tag(Tag), src_name(file), src_line(line) { } OperInfo::OperInfo(const std::string& Name) : name(Name) { } std::string OperInfo::getConfig(const std::string& key) { std::string rv; if (type_block) type_block->readString(key, rv); if (oper_block) oper_block->readString(key, rv); return rv; }