/** @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* 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;
}