hadoop-hdfs-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "bc Wong (JIRA)" <j...@apache.org>
Subject [jira] Created: (HDFS-1123) Need HDFS Protocol Specification
Date Fri, 30 Apr 2010 00:58:54 GMT
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.


Mime
View raw message