[ https://issues.apache.org/jira/browse/HDFS-6803?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=14226405#comment-14226405 ]
Steve Loughran commented on HDFS-6803: -------------------------------------- hang on to it until I need you to vote up something of mine > Documenting DFSClient#DFSInputStream expectations reading and preading in > concurrent context > -------------------------------------------------------------------------------------------- > > Key: HDFS-6803 > URL: https://issues.apache.org/jira/browse/HDFS-6803 > Project: Hadoop HDFS > Issue Type: Sub-task > Components: hdfs-client > Affects Versions: 2.4.1 > Reporter: stack > Assignee: stack > Fix For: 2.7.0 > > Attachments: 9117.md.txt, DocumentingDFSClientDFSInputStream (1).pdf, > DocumentingDFSClientDFSInputStream.v2.pdf, HDFS-6803v2.txt, HDFS-6803v3.txt, > fsdatainputstream.md.v3.html > > > Reviews of the patch posted the parent task suggest that we be more explicit > about how DFSIS is expected to behave when being read by contending threads. > It is also suggested that presumptions made internally be made explicit > documenting expectations. > Before we put up a patch we've made a document of assertions we'd like to > make into tenets of DFSInputSteam. If agreement, we'll attach to this issue > a patch that weaves the assumptions into DFSIS as javadoc and class comments. -- This message was sent by Atlassian JIRA (v6.3.4#6332)