9p: document short read behaviour with O_NONBLOCK

Regular files opened with O_NONBLOCK allow read to return after a single
round-trip with the server instead of trying to fill buffer.
Add a few lines in 9p documentation to describe that.

Link: http://lkml.kernel.org/r/1586193572-1375-1-git-send-email-asmadeus@codewreck.org
Signed-off-by: Dominique Martinet <dominique.martinet@cea.fr>
This commit is contained in:
Dominique Martinet 2020-04-06 19:19:32 +02:00
parent 43657496e4
commit c6f141412d
1 changed files with 10 additions and 0 deletions

View File

@ -133,6 +133,16 @@ OPTIONS
cache tags for existing cache sessions can be listed at
/sys/fs/9p/caches. (applies only to cache=fscache)
BEHAVIOR
========
This section aims at describing 9p 'quirks' that can be different
from a local filesystem behaviors.
- Setting O_NONBLOCK on a file will make client reads return as early
as the server returns some data instead of trying to fill the read
buffer with the requested amount of bytes or end of file is reached.
RESOURCES
=========