hadoop-hdfs-issues mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Todd Lipcon (JIRA)" <j...@apache.org>
Subject [jira] Commented: (HDFS-1123) Need HDFS Protocol Specification
Date Fri, 30 Apr 2010 05:08:53 GMT

    [ https://issues.apache.org/jira/browse/HDFS-1123?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12862535#action_12862535
] 

Todd Lipcon commented on HDFS-1123:
-----------------------------------

I agree that we should do a better job of documenting the current protocol, but we shouldn't
spend *too* much time on it, since everyone is in agreement that we'd like to move to Avro
this year. A quick pass to update the comments is probably worth doing, but a formal spec
may be overkill for a protocol we plan to deprecate imminently.

> 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