// validate.cpp
/**
* Copyright (C) 2013 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 "mongo/db/catalog/collection.h"
#include "mongo/db/client.h"
#include "mongo/db/commands.h"
#include "mongo/db/db_raii.h"
#include "mongo/db/query/internal_plans.h"
#include "mongo/db/storage/record_store.h"
#include "mongo/util/fail_point_service.h"
#include "mongo/util/log.h"
namespace mongo {
using std::endl;
using std::string;
using std::stringstream;
MONGO_FP_DECLARE(validateCmdCollectionNotValid);
class ValidateCmd : public Command {
public:
ValidateCmd() : Command("validate") {}
virtual bool slaveOk() const {
return true;
}
virtual void help(stringstream& h) const {
h << "Validate contents of a namespace by scanning its data structures for correctness. "
"Slow.\n"
"Add full:true option to do a more thorough check";
}
virtual bool supportsWriteConcern(const BSONObj& cmd) const override {
return false;
}
virtual void addRequiredPrivileges(const std::string& dbname,
const BSONObj& cmdObj,
std::vector* out) {
ActionSet actions;
actions.addAction(ActionType::validate);
out->push_back(Privilege(parseResourcePattern(dbname, cmdObj), actions));
}
//{ validate: "collectionnamewithoutthedbpart" [, scandata: ] [, full: } */
bool run(OperationContext* txn,
const string& dbname,
BSONObj& cmdObj,
int,
string& errmsg,
BSONObjBuilder& result) {
if (MONGO_FAIL_POINT(validateCmdCollectionNotValid)) {
errmsg = "validateCmdCollectionNotValid fail point was triggered";
result.appendBool("valid", false);
return true;
}
const NamespaceString nss(parseNsCollectionRequired(dbname, cmdObj));
const bool full = cmdObj["full"].trueValue();
const bool scanData = cmdObj["scandata"].trueValue();
ValidateCmdLevel level = kValidateIndex;
if (full) {
level = kValidateFull;
} else if (scanData) {
level = kValidateRecordStore;
}
if (!nss.isNormal() && full) {
errmsg = "Can only run full validate on a regular collection";
return false;
}
if (!serverGlobalParams.quiet) {
LOG(0) << "CMD: validate " << nss.ns();
}
AutoGetDb ctx(txn, nss.db(), MODE_IX);
Lock::CollectionLock collLk(txn->lockState(), nss.ns(), MODE_X);
Collection* collection = ctx.getDb() ? ctx.getDb()->getCollection(nss) : NULL;
if (!collection) {
if (ctx.getDb() && ctx.getDb()->getViewCatalog()->lookup(txn, nss.ns())) {
errmsg = "Cannot validate a view";
return appendCommandStatus(result, {ErrorCodes::CommandNotSupportedOnView, errmsg});
}
errmsg = "ns not found";
return false;
}
result.append("ns", nss.ns());
ValidateResults results;
Status status = collection->validate(txn, level, &results, &result);
if (!status.isOK())
return appendCommandStatus(result, status);
if (!full) {
results.warnings.push_back(
"Some checks omitted for speed. use {full:true} option to do more thorough scan.");
}
result.appendBool("valid", results.valid);
result.append("warnings", results.warnings);
result.append("errors", results.errors);
if (!results.valid) {
result.append("advice",
"A corrupt namespace has been detected. See "
"http://dochub.mongodb.org/core/data-recovery for recovery steps.");
}
return true;
}
} validateCmd;
}