hadoop-hdfs-issues mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "stack (JIRA)" <j...@apache.org>
Subject [jira] [Updated] (HDFS-6803) Documenting DFSClient#DFSInputStream expectations reading and preading in concurrent context
Date Tue, 04 Nov 2014 07:11:34 GMT

     [ https://issues.apache.org/jira/browse/HDFS-6803?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]

stack updated HDFS-6803:
------------------------
    Attachment: 9117.md.txt

Adding tenets 2.1 and 2.2. to fsdatainputstream.md

Changes the voice on the PositionedReadable notes so NOT being thread-safe is a problem rather
than as it was where thread-safety seemed like an inappropriate label.

[~stevel@apache.org] A few pointers please sir. What else would you like me do in this area?

> 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: 9117.md.txt, DocumentingDFSClientDFSInputStream (1).pdf, DocumentingDFSClientDFSInputStream.v2.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.3.4#6332)

Mime
View raw message