You are viewing a plain text version of this content. The canonical link for it is here.

Posted to hdfs-dev@hadoop.apache.org by "bc Wong (JIRA)" <ji...@apache.org> on 2010/04/30 02:58:54 UTC

[jira] Created: (HDFS-1123) Need HDFS Protocol Specification

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.