stack created HDFS-6803:
---------------------------
Summary: 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
Attachments: DocumentingDFSClientDFSInputStream (1).pdf
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.2#6252)
