hadoop-hdfs-issues mailing list archives

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

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

Jay Booth commented on HDFS-1123:
---------------------------------

A fully descriptive document might be a really useful thing to have while moving over to Avro,
as well.  Getting things into one place could clarify a lot, illuminate certain aspects (the
silly and the important-but-not-obviously-so) and reduce the risk of forgetting something
important.

> 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