__quiet = false; __magicNoPrint = { __magicNoPrint : 1111 } __callLastError = false; _verboseShell = false; chatty = function(s){ if ( ! __quiet ) print( s ); } function reconnect(db) { assert.soon(function() { try { db.runCommand({ping:1}); return true; } catch (x) { return false; } }); }; // Please consider using bsonWoCompare instead of this as much as possible. friendlyEqual = function( a , b ){ if ( a == b ) return true; a = tojson(a,false,true); b = tojson(b,false,true); if ( a == b ) return true; var clean = function( s ){ s = s.replace( /NumberInt\((\-?\d+)\)/g , "$1" ); return s; } a = clean(a); b = clean(b); if ( a == b ) return true; return false; } printStackTrace = function(){ try{ throw new Error("Printing Stack Trace"); } catch (e) { print(e.stack); } } /** *

Set the shell verbosity. If verbose the shell will display more information about command results. *

Default is off.

* @param {Bool} verbosity on / off */ setVerboseShell = function( value ) { if( value == undefined ) value = true; _verboseShell = value; } argumentsToArray = function( a ){ var arr = []; for ( var i=0; i 0) { res += data[i][1]; } } } while (remaining-- > 0) { res += " "; } res += "]"; return res; } //these two are helpers for Array.sort(func) compare = function(l, r){ return (l == r ? 0 : (l < r ? -1 : 1)); } // arr.sort(compareOn('name')) compareOn = function(field){ return function(l, r) { return compare(l[field], r[field]); } } shellPrint = function( x ){ it = x; if ( x != undefined ) shellPrintHelper( x ); if ( db ){ var e = db.getPrevError(); if ( e.err ) { if ( e.nPrev <= 1 ) print( "error on last call: " + tojson( e.err ) ); else print( "an error " + tojson( e.err ) + " occurred " + e.nPrev + " operations back in the command invocation" ); } db.resetError(); } } if ( typeof TestData == "undefined" ){ TestData = undefined } jsTestName = function(){ if( TestData ) return TestData.testName return "__unknown_name__" } jsTestFile = function(){ if( TestData ) return TestData.testFile return "__unknown_file__" } jsTestPath = function(){ if( TestData ) return TestData.testPath return "__unknown_path__" } var _jsTestOptions = { enableTestCommands : true }; // Test commands should be enabled by default jsTestOptions = function(){ if( TestData ) { return Object.merge(_jsTestOptions, { setParameters : TestData.setParameters, setParametersMongos : TestData.setParametersMongos, storageEngine: TestData.storageEngine, noJournal : TestData.noJournal, noJournalPrealloc : TestData.noJournalPrealloc, auth : TestData.auth, keyFile : TestData.keyFile, authUser : "__system", authPassword : TestData.keyFileData, authMechanism : TestData.authMechanism, adminUser : TestData.adminUser || "admin", adminPassword : TestData.adminPassword || "password", useSSL : TestData.useSSL, useX509 : TestData.useX509}); } return _jsTestOptions; } setJsTestOption = function(name, value) { _jsTestOptions[name] = value; } jsTestLog = function(msg){ print( "\n\n----\n" + msg + "\n----\n\n" ) } jsTest = {} jsTest.name = jsTestName jsTest.file = jsTestFile jsTest.path = jsTestPath jsTest.options = jsTestOptions jsTest.setOption = setJsTestOption jsTest.log = jsTestLog jsTest.readOnlyUserRoles = ["read"] jsTest.basicUserRoles = ["dbOwner"] jsTest.adminUserRoles = ["root"] jsTest.dir = function(){ return jsTest.path().replace( /\/[^\/]+$/, "/" ) } jsTest.randomize = function( seed ) { if( seed == undefined ) seed = new Date().getTime() Random.srand( seed ) print( "Random seed for test : " + seed ) } jsTest.authenticate = function(conn) { if (!jsTest.options().auth && !jsTest.options().keyFile && !jsTest.options().useX509) { conn.authenticated = true; return true; } try { assert.soon(function() { // Set authenticated to stop an infinite recursion from getDB calling // back into authenticate. conn.authenticated = true; print ("Authenticating as internal " + jsTestOptions().authUser + " user with mechanism " + DB.prototype._defaultAuthenticationMechanism + " on connection: " + conn); conn.authenticated = conn.getDB('admin').auth({ user: jsTestOptions().authUser, pwd: jsTestOptions().authPassword, }); return conn.authenticated; }, "Authenticating connection: " + conn, 5000, 1000); } catch (e) { print("Caught exception while authenticating connection: " + tojson(e)); conn.authenticated = false; } return conn.authenticated; } jsTest.authenticateNodes = function(nodes) { assert.soon(function() { for (var i = 0; i < nodes.length; i++) { // Don't try to authenticate to arbiters res = nodes[i].getDB("admin").runCommand({replSetGetStatus: 1}); if(res.myState == 7) { continue; } if(jsTest.authenticate(nodes[i]) != 1) { return false; } } return true; }, "Authenticate to nodes: " + nodes, 30000); } jsTest.isMongos = function(conn) { return conn.getDB('admin').isMaster().msg=='isdbgrid'; } defaultPrompt = function() { var status = db.getMongo().authStatus; try { // try to use repl set prompt -- no status or auth detected yet if (!status || !status.authRequired) { try { var prompt = replSetMemberStatePrompt(); // set our status that it was good db.getMongo().authStatus = {replSetGetStatus:true, isMaster: true}; return prompt; } catch (e) { // don't have permission to run that, or requires auth //print(e); status = {authRequired: true, replSetGetStatus: false, isMaster: true}; } } // auth detected // try to use replSetGetStatus? if (status.replSetGetStatus) { try { var prompt = replSetMemberStatePrompt(); // set our status that it was good status.replSetGetStatus = true; db.getMongo().authStatus = status; return prompt; } catch (e) { // don't have permission to run that, or requires auth //print(e); status.authRequired = true; status.replSetGetStatus = false; } } // try to use isMaster? if (status.isMaster) { try { var prompt = isMasterStatePrompt(); status.isMaster = true; db.getMongo().authStatus = status; return prompt; } catch (e) { status.authRequired = true; status.isMaster = false; } } } catch (ex) { printjson(ex); // reset status and let it figure it out next time. status = {isMaster:true}; } db.getMongo().authStatus = status; return "> "; } replSetMemberStatePrompt = function() { var state = ''; var stateInfo = db.getSiblingDB( 'admin' ).runCommand( { replSetGetStatus:1, forShell:1 } ); if ( stateInfo.ok ) { // Report the self member's stateStr if it's present. stateInfo.members.forEach( function( member ) { if ( member.self ) { state = member.stateStr; } } ); // Otherwise fall back to reporting the numeric myState field (mongodb 1.6). if ( !state ) { state = stateInfo.myState; } state = '' + stateInfo.set + ':' + state; } else { var info = stateInfo.info; if ( info && info.length < 20 ) { state = info; // "mongos", "configsvr" } else { throw Error("Failed:" + info); } } return state + '> '; } isMasterStatePrompt = function() { var state = ''; var isMaster = db.runCommand({isMaster:1, forShell:1}); if ( isMaster.ok ) { var role = ""; if (isMaster.msg == "isdbgrid") { role = "mongos"; } if (isMaster.setName) { if (isMaster.ismaster) role = "PRIMARY"; else if (isMaster.secondary) role = "SECONDARY"; else if (isMaster.arbiterOnly) role = "ARBITER"; else { role = "OTHER" } state = isMaster.setName + ':'; } state = state + role; } else { throw Error("Failed: " + tojson(isMaster)); } return state + '> '; } if (typeof(_useWriteCommandsDefault) == 'undefined') { // This is for cases when the v8 engine is used other than the mongo shell, like map reduce. _useWriteCommandsDefault = function() { return false; }; }; if (typeof(_writeMode) == 'undefined') { // This is for cases when the v8 engine is used other than the mongo shell, like map reduce. _writeMode = function() { return "commands"; }; }; shellPrintHelper = function (x) { if (typeof (x) == "undefined") { // Make sure that we have a db var before we use it // TODO: This implicit calling of GLE can cause subtle, hard to track issues - remove? if (__callLastError && typeof( db ) != "undefined" && db.getMongo && db.getMongo().writeMode() == "legacy") { __callLastError = false; // explicit w:1 so that replset getLastErrorDefaults aren't used here which would be bad var err = db.getLastError(1); if (err != null) { print(err); } } return; } if (x == __magicNoPrint) return; if (x == null) { print("null"); return; } if (typeof x != "object") return print(x); var p = x.shellPrint; if (typeof p == "function") return x.shellPrint(); var p = x.tojson; if (typeof p == "function") print(x.tojson()); else print(tojson(x)); } shellAutocomplete = function ( /*prefix*/ ) { // outer scope function called on init. Actual function at end var universalMethods = "constructor prototype toString valueOf toLocaleString hasOwnProperty propertyIsEnumerable".split( ' ' ); var builtinMethods = {}; // uses constructor objects as keys builtinMethods[Array] = "length concat join pop push reverse shift slice sort splice unshift indexOf lastIndexOf every filter forEach map some isArray reduce reduceRight".split( ' ' ); builtinMethods[Boolean] = "".split( ' ' ); // nothing more than universal methods builtinMethods[Date] = "getDate getDay getFullYear getHours getMilliseconds getMinutes getMonth getSeconds getTime getTimezoneOffset getUTCDate getUTCDay getUTCFullYear getUTCHours getUTCMilliseconds getUTCMinutes getUTCMonth getUTCSeconds getYear parse setDate setFullYear setHours setMilliseconds setMinutes setMonth setSeconds setTime setUTCDate setUTCFullYear setUTCHours setUTCMilliseconds setUTCMinutes setUTCMonth setUTCSeconds setYear toDateString toGMTString toISOString toLocaleDateString toLocaleTimeString toTimeString toUTCString UTC now".split( ' ' ); if (typeof JSON != "undefined") { // JSON is new in V8 builtinMethods["[object JSON]"] = "parse stringify".split(' '); } builtinMethods[Math] = "E LN2 LN10 LOG2E LOG10E PI SQRT1_2 SQRT2 abs acos asin atan atan2 ceil cos exp floor log max min pow random round sin sqrt tan".split(' '); builtinMethods[Number] = "MAX_VALUE MIN_VALUE NEGATIVE_INFINITY POSITIVE_INFINITY toExponential toFixed toPrecision".split( ' ' ); builtinMethods[RegExp] = "global ignoreCase lastIndex multiline source compile exec test".split( ' ' ); builtinMethods[String] = "length charAt charCodeAt concat fromCharCode indexOf lastIndexOf match replace search slice split substr substring toLowerCase toUpperCase trim trimLeft trimRight".split(' '); builtinMethods[Function] = "call apply bind".split( ' ' ); builtinMethods[Object] = "bsonsize create defineProperty defineProperties getPrototypeOf keys seal freeze preventExtensions isSealed isFrozen isExtensible getOwnPropertyDescriptor getOwnPropertyNames".split(' '); builtinMethods[Mongo] = "find update insert remove".split(' '); builtinMethods[BinData] = "hex base64 length subtype".split(' '); var extraGlobals = "Infinity NaN undefined null true false decodeURI decodeURIComponent encodeURI encodeURIComponent escape eval isFinite isNaN parseFloat parseInt unescape Array Boolean Date Math Number RegExp String print load gc MinKey MaxKey Mongo NumberInt NumberLong ObjectId DBPointer UUID BinData HexData MD5 Map Timestamp JSON".split( ' ' ); var isPrivate = function( name ) { if ( shellAutocomplete.showPrivate ) return false; if ( name == '_id' ) return false; if ( name[0] == '_' ) return true; if ( name[name.length - 1] == '_' ) return true; // some native functions have an extra name_ method return false; } var customComplete = function( obj ) { try { if ( obj.__proto__.constructor.autocomplete ) { var ret = obj.constructor.autocomplete( obj ); if ( ret.constructor != Array ) { print( "\nautocompleters must return real Arrays" ); return []; } return ret; } else { return []; } } catch ( e ) { // print( e ); // uncomment if debugging custom completers return []; } } var worker = function( prefix ) { var global = ( function() { return this; } ).call(); // trick to get global object var curObj = global; var parts = prefix.split( '.' ); for ( var p = 0; p < parts.length - 1; p++ ) { // doesn't include last part curObj = curObj[parts[p]]; if ( curObj == null ) return []; } var lastPrefix = parts[parts.length - 1] || ''; var lastPrefixLowercase = lastPrefix.toLowerCase() var beginning = parts.slice( 0, parts.length - 1 ).join( '.' ); if ( beginning.length ) beginning += '.'; var possibilities = new Array().concat( universalMethods, Object.keySet( curObj ), Object.keySet( curObj.__proto__ ), builtinMethods[curObj] || [], // curObj is a builtin constructor builtinMethods[curObj.__proto__.constructor] || [], // curObj is made from a builtin constructor curObj == global ? extraGlobals : [], customComplete( curObj ) ); var noDuplicates = {}; // see http://dreaminginjavascript.wordpress.com/2008/08/22/eliminating-duplicates/ for ( var i = 0; i < possibilities.length; i++ ) { var p = possibilities[i]; if ( typeof ( curObj[p] ) == "undefined" && curObj != global ) continue; // extraGlobals aren't in the global object if ( p.length == 0 || p.length < lastPrefix.length ) continue; if ( lastPrefix[0] != '_' && isPrivate( p ) ) continue; if ( p.match( /^[0-9]+$/ ) ) continue; // don't array number indexes if ( p.substr( 0, lastPrefix.length ).toLowerCase() != lastPrefixLowercase ) continue; var completion = beginning + p; if ( curObj[p] && curObj[p].constructor == Function && p != 'constructor' ) completion += '('; noDuplicates[completion] = 0; } var ret = []; for ( var i in noDuplicates ) ret.push( i ); return ret; } // this is the actual function that gets assigned to shellAutocomplete return function( prefix ) { try { __autocomplete__ = worker( prefix ).sort(); } catch ( e ) { print( "exception during autocomplete: " + tojson( e.message ) ); __autocomplete__ = []; } } } (); shellAutocomplete.showPrivate = false; // toggle to show (useful when working on internals) shellHelper = function( command , rest , shouldPrint ){ command = command.trim(); var args = rest.trim().replace(/\s*;$/,"").split( "\s+" ); if ( ! shellHelper[command] ) throw Error( "no command [" + command + "]" ); var res = shellHelper[command].apply( null , args ); if ( shouldPrint ){ shellPrintHelper( res ); } return res; } shellHelper.use = function (dbname) { var s = "" + dbname; if (s == "") { print("bad use parameter"); return; } db = db.getMongo().getDB(dbname); print("switched to db " + db.getName()); } shellHelper.set = function (str) { if (str == "") { print("bad use parameter"); return; } tokens = str.split(" "); param = tokens[0]; value = tokens[1]; if ( value == undefined ) value = true; // value comes in as a string.. if ( value == "true" ) value = true; if ( value == "false" ) value = false; if (param == "verbose") { _verboseShell = value; } print("set " + param + " to " + value); } shellHelper.it = function(){ if ( typeof( ___it___ ) == "undefined" || ___it___ == null ){ print( "no cursor" ); return; } shellPrintHelper( ___it___ ); } shellHelper.show = function (what) { assert(typeof what == "string"); var args = what.split( /\s+/ ); what = args[0] args = args.splice(1) if (what == "profile") { if (db.system.profile.count() == 0) { print("db.system.profile is empty"); print("Use db.setProfilingLevel(2) will enable profiling"); print("Use db.system.profile.find() to show raw profile entries"); } else { print(); db.system.profile.find({ millis: { $gt: 0} }).sort({ $natural: -1 }).limit(5).forEach( function (x) { print("" + x.op + "\t" + x.ns + " " + x.millis + "ms " + String(x.ts).substring(0, 24)); var l = ""; for ( var z in x ){ if ( z == "op" || z == "ns" || z == "millis" || z == "ts" ) continue; var val = x[z]; var mytype = typeof(val); if ( mytype == "string" || mytype == "number" ) l += z + ":" + val + " "; else if ( mytype == "object" ) l += z + ":" + tojson(val ) + " "; else if ( mytype == "boolean" ) l += z + " "; else l += z + ":" + val + " "; } print( l ); print("\n"); } ) } return ""; } if (what == "users") { db.getUsers().forEach(printjson); return ""; } if (what == "roles") { db.getRoles({showBuiltinRoles: true}).forEach(printjson); return ""; } if (what == "collections" || what == "tables") { db.getCollectionNames().forEach(function (x) { print(x) }); return ""; } if (what == "dbs" || what == "databases") { var dbs = db.getMongo().getDBs(); var dbinfo = []; var maxNameLength = 0; var maxGbDigits = 0; dbs.databases.forEach(function (x){ var sizeStr = (x.sizeOnDisk / 1024 / 1024 / 1024).toFixed(3); var nameLength = x.name.length; var gbDigits = sizeStr.indexOf("."); if( nameLength > maxNameLength) maxNameLength = nameLength; if( gbDigits > maxGbDigits ) maxGbDigits = gbDigits; dbinfo.push({ name: x.name, size: x.sizeOnDisk, size_str: sizeStr, name_size: nameLength, gb_digits: gbDigits }); }); dbinfo.sort(compareOn('name')) dbinfo.forEach(function (db) { var namePadding = maxNameLength - db.name_size; var sizePadding = maxGbDigits - db.gb_digits; var padding = Array(namePadding + sizePadding + 3).join(" "); if (db.size > 1) { print(db.name + padding + db.size_str + "GB"); } else { print(db.name + padding + "(empty)"); } }); return ""; } if (what == "log" ) { var n = "global"; if ( args.length > 0 ) n = args[0] var res = db.adminCommand( { getLog : n } ); if ( ! res.ok ) { print("Error while trying to show " + n + " log: " + res.errmsg); return ""; } for ( var i=0; i 0 && s < 1 ) { var standardNormal = x * Math.sqrt( -2 * Math.log( s ) / s ); return mean + ( standardDeviation * standardNormal ); } } } Geo = {}; Geo.distance = function( a , b ){ var ax = null; var ay = null; var bx = null; var by = null; for ( var key in a ){ if ( ax == null ) ax = a[key]; else if ( ay == null ) ay = a[key]; } for ( var key in b ){ if ( bx == null ) bx = b[key]; else if ( by == null ) by = b[key]; } return Math.sqrt( Math.pow( by - ay , 2 ) + Math.pow( bx - ax , 2 ) ); } Geo.sphereDistance = function( a , b ){ var ax = null; var ay = null; var bx = null; var by = null; // TODO swap order of x and y when done on server for ( var key in a ){ if ( ax == null ) ax = a[key] * (Math.PI/180); else if ( ay == null ) ay = a[key] * (Math.PI/180); } for ( var key in b ){ if ( bx == null ) bx = b[key] * (Math.PI/180); else if ( by == null ) by = b[key] * (Math.PI/180); } var sin_x1=Math.sin(ax), cos_x1=Math.cos(ax); var sin_y1=Math.sin(ay), cos_y1=Math.cos(ay); var sin_x2=Math.sin(bx), cos_x2=Math.cos(bx); var sin_y2=Math.sin(by), cos_y2=Math.cos(by); var cross_prod = (cos_y1*cos_x1 * cos_y2*cos_x2) + (cos_y1*sin_x1 * cos_y2*sin_x2) + (sin_y1 * sin_y2); if (cross_prod >= 1 || cross_prod <= -1){ // fun with floats assert( Math.abs(cross_prod)-1 < 1e-6 ); return cross_prod > 0 ? 0 : Math.PI; } return Math.acos(cross_prod); } rs = function () { return "try rs.help()"; } /** * This method is intended to aid in the writing of tests. It takes a host's address, desired state, * and replicaset and waits either timeout milliseconds or until that reaches the desired state. * * It should be used instead of awaitRSClientHost when there is no MongoS with a connection to the * replica set. */ _awaitRSHostViaRSMonitor = function(hostAddr, desiredState, rsName, timeout) { timeout = timeout || 60 * 1000; if (desiredState == undefined) { desiredState = {ok: true}; } print("Awaiting " + hostAddr + " to be " + tojson(desiredState) + " in " + " rs " + rsName) var tests = 0; assert.soon(function() { var stats = _replMonitorStats(rsName); if (tests++ % 10 == 0) { printjson(stats); } for (var i=0; i= 0) { // closed connection. reconnect. db.getLastErrorObj(); var o = db.getLastErrorObj(); if (o.ok) { print("reconnected to server after rs command (which is normal)"); } else { printjson(o); } } else { print("shell got exception during repl set operation: " + e); print("in some circumstances, the primary steps down and closes connections on a reconfig"); } return ""; } return res; } rs.reconfig = function (cfg, options) { cfg.version = rs.conf().version + 1; cmd = { replSetReconfig: cfg }; for (var i in options) { cmd[i] = options[i]; } return this._runCmd(cmd); } rs.add = function (hostport, arb) { var cfg = hostport; var local = db.getSisterDB("local"); assert(local.system.replset.count() <= 1, "error: local.system.replset has unexpected contents"); var c = local.system.replset.findOne(); assert(c, "no config object retrievable from local.system.replset"); c.version++; var max = 0; for (var i in c.members) if (c.members[i]._id > max) max = c.members[i]._id; if (isString(hostport)) { cfg = { _id: max + 1, host: hostport }; if (arb) cfg.arbiterOnly = true; } if (cfg._id == null){ cfg._id = max+1; } c.members.push(cfg); return this._runCmd({ replSetReconfig: c }); } rs.syncFrom = function (host) { return db._adminCommand({replSetSyncFrom : host}); }; rs.stepDown = function (secs) { return db._adminCommand({ replSetStepDown:(secs === undefined) ? 60:secs}); } rs.freeze = function (secs) { return db._adminCommand({replSetFreeze:secs}); } rs.addArb = function (hn) { return this.add(hn, true); } rs.conf = function () { var resp = db._adminCommand({replSetGetConfig:1}); if (resp.ok && !(resp.errmsg) && resp.config) return resp.config; else if(res.errmsg && res.errmsg.startsWith( "no such cmd" )) return db.getSisterDB("local").system.replset.findOne(); throw new Error("Could not retrieve replica set config: " + tojson(resp)); } rs.config = rs.conf; rs.remove = function (hn) { var local = db.getSisterDB("local"); assert(local.system.replset.count() <= 1, "error: local.system.replset has unexpected contents"); var c = local.system.replset.findOne(); assert(c, "no config object retrievable from local.system.replset"); c.version++; for (var i in c.members) { if (c.members[i].host == hn) { c.members.splice(i, 1); return db._adminCommand({ replSetReconfig : c}); } } return "error: couldn't find "+hn+" in "+tojson(c.members); }; rs.debug = {}; rs.debug.nullLastOpWritten = function(primary, secondary) { var p = connect(primary+"/local"); var s = connect(secondary+"/local"); s.getMongo().setSlaveOk(); var secondToLast = s.oplog.rs.find().sort({$natural : -1}).limit(1).next(); var last = p.runCommand({findAndModify : "oplog.rs", query : {ts : {$gt : secondToLast.ts}}, sort : {$natural : 1}, update : {$set : {op : "n"}}}); if (!last.value.o || !last.value.o._id) { print("couldn't find an _id?"); } else { last.value.o = {_id : last.value.o._id}; } print("nulling out this op:"); printjson(last); }; rs.debug.getLastOpWritten = function(server) { var s = db.getSisterDB("local"); if (server) { s = connect(server+"/local"); } s.getMongo().setSlaveOk(); return s.oplog.rs.find().sort({$natural : -1}).limit(1).next(); }; help = shellHelper.help = function (x) { if (x == "mr") { print("\nSee also http://dochub.mongodb.org/core/mapreduce"); print("\nfunction mapf() {"); print(" // 'this' holds current document to inspect"); print(" emit(key, value);"); print("}"); print("\nfunction reducef(key,value_array) {"); print(" return reduced_value;"); print("}"); print("\ndb.mycollection.mapReduce(mapf, reducef[, options])"); print("\noptions"); print("{[query : ]"); print(" [, sort : ]"); print(" [, limit : ]"); print(" [, out : ]"); print(" [, keeptemp: ]"); print(" [, finalize : ]"); print(" [, scope : ]"); print(" [, verbose : true]}\n"); return; } else if (x == "connect") { print("\nNormally one specifies the server on the mongo shell command line. Run mongo --help to see those options."); print("Additional connections may be opened:\n"); print(" var x = new Mongo('host[:port]');"); print(" var mydb = x.getDB('mydb');"); print(" or"); print(" var mydb = connect('host[:port]/mydb');"); print("\nNote: the REPL prompt only auto-reports getLastError() for the shell command line connection.\n"); return; } else if (x == "keys") { print("Tab completion and command history is available at the command prompt.\n"); print("Some emacs keystrokes are available too:"); print(" Ctrl-A start of line"); print(" Ctrl-E end of line"); print(" Ctrl-K del to end of line"); print("\nMulti-line commands"); print("You can enter a multi line javascript expression. If parens, braces, etc. are not closed, you will see a new line "); print("beginning with '...' characters. Type the rest of your expression. Press Ctrl-C to abort the data entry if you"); print("get stuck.\n"); } else if (x == "misc") { print("\tb = new BinData(subtype,base64str) create a BSON BinData value"); print("\tb.subtype() the BinData subtype (0..255)"); print("\tb.length() length of the BinData data in bytes"); print("\tb.hex() the data as a hex encoded string"); print("\tb.base64() the data as a base 64 encoded string"); print("\tb.toString()"); print(); print("\tb = HexData(subtype,hexstr) create a BSON BinData value from a hex string"); print("\tb = UUID(hexstr) create a BSON BinData value of UUID subtype"); print("\tb = MD5(hexstr) create a BSON BinData value of MD5 subtype"); print("\t\"hexstr\" string, sequence of hex characters (no 0x prefix)"); print(); print("\to = new ObjectId() create a new ObjectId"); print("\to.getTimestamp() return timestamp derived from first 32 bits of the OID"); print("\to.isObjectId"); print("\to.toString()"); print("\to.equals(otherid)"); print(); print("\td = ISODate() like Date() but behaves more intuitively when used"); print("\td = ISODate('YYYY-MM-DD hh:mm:ss') without an explicit \"new \" prefix on construction"); return; } else if (x == "admin") { print("\tls([path]) list files"); print("\tpwd() returns current directory"); print("\tlistFiles([path]) returns file list"); print("\thostname() returns name of this host"); print("\tcat(fname) returns contents of text file as a string"); print("\tremoveFile(f) delete a file or directory"); print("\tload(jsfilename) load and execute a .js file"); print("\trun(program[, args...]) spawn a program and wait for its completion"); print("\trunProgram(program[, args...]) same as run(), above"); print("\tsleep(m) sleep m milliseconds"); print("\tgetMemInfo() diagnostic"); return; } else if (x == "test") { print("\tstartMongodEmpty(args) DELETES DATA DIR and then starts mongod"); print("\t returns a connection to the new server"); print("\tstartMongodTest(port,dir,options)"); print("\t DELETES DATA DIR"); print("\t automatically picks port #s starting at 27000 and increasing"); print("\t or you can specify the port as the first arg"); print("\t dir is /data/db// if not specified as the 2nd arg"); print("\t returns a connection to the new server"); print("\tresetDbpath(dirpathstr) deletes everything under the dir specified including subdirs"); print("\tstopMongoProgram(port[, signal])"); return; } else if (x == "") { print("\t" + "db.help() help on db methods"); print("\t" + "db.mycoll.help() help on collection methods"); print("\t" + "sh.help() sharding helpers"); print("\t" + "rs.help() replica set helpers"); print("\t" + "help admin administrative help"); print("\t" + "help connect connecting to a db help"); print("\t" + "help keys key shortcuts"); print("\t" + "help misc misc things to know"); print("\t" + "help mr mapreduce"); print(); print("\t" + "show dbs show database names"); print("\t" + "show collections show collections in current database"); print("\t" + "show users show users in current database"); print("\t" + "show profile show most recent system.profile entries with time >= 1ms"); print("\t" + "show logs show the accessible logger names"); print("\t" + "show log [name] prints out the last segment of log in memory, 'global' is default"); print("\t" + "use set current database"); print("\t" + "db.foo.find() list objects in collection foo"); print("\t" + "db.foo.find( { a : 1 } ) list objects in foo where a == 1"); print("\t" + "it result of the last line evaluated; use to further iterate"); print("\t" + "DBQuery.shellBatchSize = x set default number of items to display on shell"); print("\t" + "exit quit the mongo shell"); } else print("unknown help option"); }