Need HDFS Protocol Specification
--------------------------------
Key: HDFS-1123
URL: https://issues.apache.org/jira/browse/HDFS-1123
Project: Hadoop HDFS
Issue Type: Improvement
Components: documentation
Reporter: bc Wong
It'd be great to document (in a spec, not in the code) the HDFS wire protocol:
* The layout of the different request and reply messages.
* The semantics of the various calls.
* The semantics of the various fields.
For example, I stumbled upon the goldmine of comments around
DataNode.java:1150. It looks correct, but the version number of 9 doesn't
inspire confidence that it's up-to-date. (It's also a random place to put such
an important comment.)
Having a formal spec is a big step forward for compatibility. It also
highlights design decisions and helps with protocol evolution.
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
