/** @file dbcommands_generic.cpp commands suited for any mongo server (both mongod, mongos) */ /** * Copyright (C) 2012 10gen Inc. * * This program is free software: you can redistribute it and/or modify * it under the terms of the GNU Affero General Public License, version 3, * as published by the Free Software Foundation. * * 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 Affero General Public License for more details. * * You should have received a copy of the GNU Affero General Public License * along with this program. If not, see . * * As a special exception, the copyright holders give permission to link the * code of portions of this program with the OpenSSL library under certain * conditions as described in each individual source file and distribute * linked combinations including the program with the OpenSSL library. You * must comply with the GNU Affero General Public License in all respects for * all of the code used other than as permitted herein. If you modify file(s) * with this exception, you may extend this exception to your version of the * file(s), but you are not obligated to do so. If you do not wish to do so, * delete this exception statement from your version. If you delete this * exception statement from all source files in the program, then also delete * it in the license file. */ #define MONGO_LOG_DEFAULT_COMPONENT ::mongo::logger::LogComponent::kCommand #include "mongo/platform/basic.h" #include #include "mongo/bson/util/builder.h" #include "mongo/client/dbclient_rs.h" #include "mongo/db/auth/action_set.h" #include "mongo/db/auth/action_type.h" #include "mongo/db/auth/authorization_manager.h" #include "mongo/db/auth/privilege.h" #include "mongo/db/background.h" #include "mongo/db/commands.h" #include "mongo/db/commands/shutdown.h" #include "mongo/db/db.h" #include "mongo/db/instance.h" #include "mongo/db/introspect.h" #include "mongo/db/jsobj.h" #include "mongo/db/json.h" #include "mongo/db/lasterror.h" #include "mongo/db/log_process_details.h" #include "mongo/db/server_options.h" #include "mongo/db/service_context.h" #include "mongo/db/stats/counters.h" #include "mongo/scripting/engine.h" #include "mongo/util/exit.h" #include "mongo/util/fail_point.h" #include "mongo/util/fail_point_service.h" #include "mongo/util/log.h" #include "mongo/util/md5.hpp" #include "mongo/util/ntservice.h" #include "mongo/util/processinfo.h" #include "mongo/util/ramlog.h" #include "mongo/util/version.h" namespace mongo { using std::endl; using std::string; using std::stringstream; using std::vector; class CmdBuildInfo : public Command { public: CmdBuildInfo() : Command("buildInfo", true, "buildinfo") {} virtual bool slaveOk() const { return true; } virtual bool adminOnly() const { return false; } virtual bool isWriteCommandForConfigServer() const { return false; } virtual void addRequiredPrivileges(const std::string& dbname, const BSONObj& cmdObj, std::vector* out) {} // No auth required virtual void help(stringstream& help) const { help << "get version #, etc.\n"; help << "{ buildinfo:1 }"; } bool run(OperationContext* txn, const std::string& dbname, BSONObj& jsobj, int, // options std::string& errmsg, BSONObjBuilder& result) { appendBuildInfo(result); appendStorageEngineList(&result); return true; } } cmdBuildInfo; class PingCommand : public Command { public: PingCommand() : Command("ping") {} virtual bool slaveOk() const { return true; } virtual void help(stringstream& help) const { help << "a way to check that the server is alive. responds immediately even if server is " "in a db lock."; } virtual bool isWriteCommandForConfigServer() const { return false; } virtual void addRequiredPrivileges(const std::string& dbname, const BSONObj& cmdObj, std::vector* out) {} // No auth required virtual bool run(OperationContext* txn, const string& badns, BSONObj& cmdObj, int, string& errmsg, BSONObjBuilder& result) { // IMPORTANT: Don't put anything in here that might lock db - including authentication return true; } } pingCmd; class FeaturesCmd : public Command { public: FeaturesCmd() : Command("features", true) {} void help(stringstream& h) const { h << "return build level feature settings"; } virtual bool slaveOk() const { return true; } virtual bool isWriteCommandForConfigServer() const { return false; } virtual void addRequiredPrivileges(const std::string& dbname, const BSONObj& cmdObj, std::vector* out) {} // No auth required virtual bool run(OperationContext* txn, const string& ns, BSONObj& cmdObj, int, string& errmsg, BSONObjBuilder& result) { if (globalScriptEngine) { BSONObjBuilder bb(result.subobjStart("js")); result.append("utf8", globalScriptEngine->utf8Ok()); bb.done(); } if (cmdObj["oidReset"].trueValue()) { result.append("oidMachineOld", OID::getMachineId()); OID::regenMachineId(); } result.append("oidMachine", OID::getMachineId()); return true; } } featuresCmd; class HostInfoCmd : public Command { public: HostInfoCmd() : Command("hostInfo", true) {} virtual bool slaveOk() const { return true; } virtual bool isWriteCommandForConfigServer() const { return false; } virtual void help(stringstream& help) const { help << "returns information about the daemon's host"; } virtual void addRequiredPrivileges(const std::string& dbname, const BSONObj& cmdObj, std::vector* out) { ActionSet actions; actions.addAction(ActionType::hostInfo); out->push_back(Privilege(ResourcePattern::forClusterResource(), actions)); } bool run(OperationContext* txn, const string& dbname, BSONObj& cmdObj, int, string& errmsg, BSONObjBuilder& result) { ProcessInfo p; BSONObjBuilder bSys, bOs; bSys.appendDate("currentTime", jsTime()); bSys.append("hostname", prettyHostName()); bSys.append("cpuAddrSize", p.getAddrSize()); bSys.append("memSizeMB", static_cast(p.getMemSizeMB())); bSys.append("numCores", p.getNumCores()); bSys.append("cpuArch", p.getArch()); bSys.append("numaEnabled", p.hasNumaEnabled()); bOs.append("type", p.getOsType()); bOs.append("name", p.getOsName()); bOs.append("version", p.getOsVersion()); result.append(StringData("system"), bSys.obj()); result.append(StringData("os"), bOs.obj()); p.appendSystemDetails(result); return true; } } hostInfoCmd; class LogRotateCmd : public Command { public: LogRotateCmd() : Command("logRotate") {} virtual bool isWriteCommandForConfigServer() const { return false; } virtual bool slaveOk() const { return true; } virtual bool adminOnly() const { return true; } virtual void addRequiredPrivileges(const std::string& dbname, const BSONObj& cmdObj, std::vector* out) { ActionSet actions; actions.addAction(ActionType::logRotate); out->push_back(Privilege(ResourcePattern::forClusterResource(), actions)); } virtual bool run(OperationContext* txn, const string& ns, BSONObj& cmdObj, int, string& errmsg, BSONObjBuilder& result) { bool didRotate = rotateLogs(serverGlobalParams.logRenameOnRotate); if (didRotate) logProcessDetailsForLogRotate(); return didRotate; } } logRotateCmd; class ListCommandsCmd : public Command { public: virtual void help(stringstream& help) const { help << "get a list of all db commands"; } ListCommandsCmd() : Command("listCommands", false) {} virtual bool isWriteCommandForConfigServer() const { return false; } virtual bool slaveOk() const { return true; } virtual bool adminOnly() const { return false; } virtual void addRequiredPrivileges(const std::string& dbname, const BSONObj& cmdObj, std::vector* out) {} // No auth required virtual bool run(OperationContext* txn, const string& ns, BSONObj& cmdObj, int, string& errmsg, BSONObjBuilder& result) { BSONObjBuilder b(result.subobjStart("commands")); for (CommandMap::const_iterator i = _commands->begin(); i != _commands->end(); ++i) { Command* c = i->second; // don't show oldnames if (i->first != c->name) continue; BSONObjBuilder temp(b.subobjStart(c->name)); { stringstream help; c->help(help); temp.append("help", help.str()); } temp.append("slaveOk", c->slaveOk()); temp.append("adminOnly", c->adminOnly()); // optionally indicates that the command can be forced to run on a slave/secondary if (c->slaveOverrideOk()) temp.append("slaveOverrideOk", c->slaveOverrideOk()); temp.done(); } b.done(); return 1; } } listCommandsCmd; namespace { MONGO_FP_DECLARE(crashOnShutdown); int* volatile illegalAddress; } // namespace void CmdShutdown::addRequiredPrivileges(const std::string& dbname, const BSONObj& cmdObj, std::vector* out) { ActionSet actions; actions.addAction(ActionType::shutdown); out->push_back(Privilege(ResourcePattern::forClusterResource(), actions)); } void CmdShutdown::shutdownHelper() { MONGO_FAIL_POINT_BLOCK(crashOnShutdown, crashBlock) { const std::string crashHow = crashBlock.getData()["how"].str(); if (crashHow == "fault") { ++*illegalAddress; } ::abort(); } log() << "terminating, shutdown command received"; #if defined(_WIN32) // Signal the ServiceMain thread to shutdown. if (ntservice::shouldStartService()) { signalShutdown(); // Client expects us to abruptly close the socket as part of exiting // so this function is not allowed to return. // The ServiceMain thread will quit for us so just sleep until it does. while (true) sleepsecs(60); // Loop forever } else #endif { exitCleanly(EXIT_CLEAN); // this never returns invariant(false); } } /* for testing purposes only */ class CmdForceError : public Command { public: virtual void help(stringstream& help) const { help << "for testing purposes only. forces a user assertion exception"; } virtual bool slaveOk() const { return true; } virtual bool isWriteCommandForConfigServer() const { return false; } virtual void addRequiredPrivileges(const std::string& dbname, const BSONObj& cmdObj, std::vector* out) {} // No auth required CmdForceError() : Command("forceerror") {} bool run(OperationContext* txn, const string& dbnamne, BSONObj& cmdObj, int, string& errmsg, BSONObjBuilder& result) { LastError::get(cc()).setLastError(10038, "forced error"); return false; } } cmdForceError; class GetLogCmd : public Command { public: GetLogCmd() : Command("getLog") {} virtual bool slaveOk() const { return true; } virtual bool isWriteCommandForConfigServer() const { return false; } virtual bool adminOnly() const { return true; } virtual void addRequiredPrivileges(const std::string& dbname, const BSONObj& cmdObj, std::vector* out) { ActionSet actions; actions.addAction(ActionType::getLog); out->push_back(Privilege(ResourcePattern::forClusterResource(), actions)); } virtual void help(stringstream& help) const { help << "{ getLog : '*' } OR { getLog : 'global' }"; } virtual bool run(OperationContext* txn, const string& dbname, BSONObj& cmdObj, int, string& errmsg, BSONObjBuilder& result) { BSONElement val = cmdObj.firstElement(); if (val.type() != String) { return appendCommandStatus( result, Status(ErrorCodes::TypeMismatch, str::stream() << "Argument to getLog must be of type String; found " << val.toString(false) << " of type " << typeName(val.type()))); } string p = val.String(); if (p == "*") { vector names; RamLog::getNames(names); BSONArrayBuilder arr; for (unsigned i = 0; i < names.size(); i++) { arr.append(names[i]); } result.appendArray("names", arr.arr()); } else { RamLog* ramlog = RamLog::getIfExists(p); if (!ramlog) { errmsg = str::stream() << "no RamLog named: " << p; return false; } RamLog::LineIterator rl(ramlog); result.appendNumber("totalLinesWritten", rl.getTotalLinesWritten()); BSONArrayBuilder arr(result.subarrayStart("log")); while (rl.more()) arr.append(rl.next()); arr.done(); } return true; } } getLogCmd; class CmdGetCmdLineOpts : Command { public: CmdGetCmdLineOpts() : Command("getCmdLineOpts") {} void help(stringstream& h) const { h << "get argv"; } virtual bool isWriteCommandForConfigServer() const { return false; } virtual bool adminOnly() const { return true; } virtual bool slaveOk() const { return true; } virtual void addRequiredPrivileges(const std::string& dbname, const BSONObj& cmdObj, std::vector* out) { ActionSet actions; actions.addAction(ActionType::getCmdLineOpts); out->push_back(Privilege(ResourcePattern::forClusterResource(), actions)); } virtual bool run(OperationContext* txn, const string&, BSONObj& cmdObj, int, string& errmsg, BSONObjBuilder& result) { result.append("argv", serverGlobalParams.argvArray); result.append("parsed", serverGlobalParams.parsedOpts); return true; } } cmdGetCmdLineOpts; }