iov_iter: kernel-doc import_iovec() and rw_copy_check_uvector()
authorVegard Nossum <vegard.nossum@oracle.com>
Sat, 8 Oct 2016 09:18:07 +0000 (11:18 +0200)
committerAl Viro <viro@zeniv.linux.org.uk>
Sat, 15 Oct 2016 00:00:34 +0000 (20:00 -0400)
commitffecee4f2442bb8cb6b34c3335fef4eb50c22fdd
tree53d6e7bcb5ff21f6f72d12d905b5173b35c2987a
parentde34f4da7f62ff59ac6e1ef320b0fcfa3296fce3
iov_iter: kernel-doc import_iovec() and rw_copy_check_uvector()

Both import_iovec() and rw_copy_check_uvector() take an array
(typically small and on-stack) which is used to hold an iovec array copy
from userspace. This is to avoid an expensive memory allocation in the
fast path (i.e. few iovec elements).

The caller may have to check whether these functions actually used
the provided buffer or allocated a new one -- but this differs between
the too. Let's just add a kernel doc to clarify what the semantics are
for each function.

Signed-off-by: Vegard Nossum <vegard.nossum@oracle.com>
Signed-off-by: Al Viro <viro@zeniv.linux.org.uk>
fs/read_write.c
lib/iov_iter.c