{"record":{"id":"2d4de4fc6c1083d3","repo":"apache/hadoop","slug":"pathhandle-specified-but-unsuported","errorCode":null,"errorMessage":"PathHandle specified, but unsuported","messagePattern":"PathHandle specified, but unsuported","errorType":"exception","errorClass":"IOException","httpStatus":null,"severity":"error","filePath":"hadoop-hdfs-project/hadoop-hdfs/src/main/java/org/apache/hadoop/hdfs/server/datanode/ProvidedReplica.java","lineNumber":194,"sourceCode":"      return new Path(pathSuffix).toUri();\n    } else {\n      return new Path(pathPrefix, pathSuffix).toUri();\n    }\n  }\n\n  @Override\n  public InputStream getDataInputStream(long seekOffset) throws IOException {\n    if (remoteFS != null) {\n      FSDataInputStream ins;\n      try {\n        if (pathHandle != null) {\n          ins = remoteFS.open(pathHandle, conf.getInt(IO_FILE_BUFFER_SIZE_KEY,\n              IO_FILE_BUFFER_SIZE_DEFAULT));\n        } else {\n          ins = remoteFS.open(new Path(getRemoteURI()));\n        }\n      } catch (UnsupportedOperationException e) {\n        throw new IOException(\"PathHandle specified, but unsuported\", e);\n      }\n\n      ins.seek(fileOffset + seekOffset);\n      return new BoundedInputStream(\n          new FSDataInputStream(ins), getBlockDataLength());\n    } else {\n      throw new IOException(\"Remote filesystem for provided replica \" + this +\n          \" does not exist\");\n    }\n  }\n\n  @Override\n  public OutputStream getDataOutputStream(boolean append) throws IOException {\n    throw new UnsupportedOperationException(\n        \"OutputDataStream is not implemented for ProvidedReplica\");\n  }\n\n  @Override","sourceCodeStart":176,"sourceCodeEnd":212,"githubUrl":"https://github.com/apache/hadoop/blob/2add9630210752f88ceb1bb74eb65e37bf41da8e/hadoop-hdfs-project/hadoop-hdfs/src/main/java/org/apache/hadoop/hdfs/server/datanode/ProvidedReplica.java#L176-L212","documentation":"Error \"PathHandle specified, but unsuported\" thrown in apache/hadoop.","triggerScenarios":"A PathHandle (file-handle-based open) is requested for a ProvidedReplica backed by external storage that does not support handles.","commonSituations":"A PathHandle was supplied for an operation the provided-storage replica does not support. Remove PathHandle usage for provided replicas.","solutions":["Do not use PathHandle-based open with provided storage; the provided storage implementation does not support path handles.","Read provided replicas through standard streams instead of PathHandles."],"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"}