[HADOOP-18407] Improve vectored IO api spec.

• Type: Sub-task
• Status: Resolved
• Priority: Minor
• Resolution: Fixed
• Fix Version/s: 3.3.5
• Component/s: fs, fs/s3
• Labels: pull-request-available
• Assignee: Mukund Thakur
• Reporter: Mukund Thakur
• Created: 16/Aug/22 21:38
• Updated: 22/Dec/22 18:49
• Resolved: 31/Aug/22 16:48

Description

Let's add more details to the vectored IO api spec for better clarity. 

• the position returned by getPos(); is undefined afterwards.
• note that if a file is changed during a read, the output is again undefined. some ranges may be old data, some may be new, *and some may be both
• note that while reads are active, normal fs api calls may block.

Issue Links

• links to: GitHub Pull Request #4760