K 10
svn:author
V 4
ngie
K 8
svn:date
V 27
2022-04-11T02:08:52.824845Z
K 7
svn:log
V 841
extattr_get_file(2): clarify RETURN VALUES

While some of the syscalls' behavior were documented and implied in the
RETURN VALUES section by earlier, e.g., the DESCRIPTION sections, as having
behavior of the other calls (`*_fd` vs `*_file` vs `*_link`), there was a lot
of implied return value behavior in the section prior to this change.

Explicitly document the syscall behavior per the current implementation in
sys/kern/vfs_extattr.c so others can better develop based on its explicit
documented behavior instead of having to digest the context of the manpage to
understand the appropriate behavior.

MFC after:	1 week
MFC with:	r368431, r368433, r368434
Sponsored by:	DellEMC Isilon

(cherry picked from commit cf681016d47ed689da60c8cfe1a4fb894e036b4d)

Git Hash:   57d53eb6832f78cdf42e6ded97f7b5e64a829eb7
Git Author: ngie@FreeBSD.org
END