{"record":{"id":"a67af7eb5a2c1f82","repo":"apache/hadoop","slug":"unknown-command","errorCode":null,"errorMessage":"Unknown command","messagePattern":"Unknown command","errorType":"validation","errorClass":"UnknownCommandException","httpStatus":null,"severity":"error","filePath":"hadoop-common-project/hadoop-common/src/main/java/org/apache/hadoop/fs/FsShell.java","lineNumber":316,"sourceCode":"   * run\n   */\n  @Override\n  public int run(String[] argv) {\n    // initialize FsShell\n    init();\n    Tracer tracer = new Tracer.Builder(\"FsShell\").\n        conf(TraceUtils.wrapHadoopConf(SHELL_HTRACE_PREFIX, getConf())).\n        build();\n    int exitCode = -1;\n    if (argv.length < 1) {\n      printUsage(System.err);\n    } else {\n      String cmd = argv[0];\n      Command instance = null;\n      try {\n        instance = commandFactory.getInstance(cmd);\n        if (instance == null) {\n          throw new UnknownCommandException();\n        }\n        TraceScope scope = tracer.newScope(instance.getCommandName());\n        if (scope.getSpan() != null) {\n          String args = StringUtils.join(\" \", argv);\n          if (args.length() > 2048) {\n            args = args.substring(0, 2048);\n          }\n          scope.getSpan().addKVAnnotation(\"args\", args);\n        }\n        try {\n          exitCode = instance.run(Arrays.copyOfRange(argv, 1, argv.length));\n        } finally {\n          scope.close();\n        }\n      } catch (IllegalArgumentException e) {\n        if (e.getMessage() == null) {\n          displayError(cmd, \"Null exception message\");\n          e.printStackTrace(System.err);","sourceCodeStart":298,"sourceCodeEnd":334,"githubUrl":"https://github.com/apache/hadoop/blob/2add9630210752f88ceb1bb74eb65e37bf41da8e/hadoop-common-project/hadoop-common/src/main/java/org/apache/hadoop/fs/FsShell.java#L298-L334","documentation":"Error \"Unknown command\" thrown in apache/hadoop.","triggerScenarios":"Thrown at hadoop-common-project/hadoop-common/src/main/java/org/apache/hadoop/fs/FsShell.java:316 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Use a valid FsShell command name; see 'hadoop fs -help'.","Ensure the command class is registered in the shell's command factory."],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"2add9630210752f88ceb1bb74eb65e37bf41da8e","analyzedAt":"2026-08-22T19:55:07.957Z","schemaVersion":2},"datasetVersion":"2026-08-22T20:17:22.307Z"}