freebsd-dev/share/man
Ka Ho Ng 1eaa36523c fspacectl(2): Clarifies the return values
rmacklem@ spotted two things in the system call:
- Upon returning from a successful operation, vop_stddeallocate can
  update rmsr.r_offset to a value greater than file size. This behavior,
  although being harmless, can be confusing.
- The EINVAL return value for rqsr.r_offset + rqsr.r_len > OFF_MAX is
  undocumented.

This commit has the following changes:
- vop_stddeallocate and shm_deallocate to bound the the affected area
  further by the file size.
- The EINVAL case for rqsr.r_offset + rqsr.r_len > OFF_MAX is
  documented.
- The fspacectl(2), vn_deallocate(9) and VOP_DEALLOCATE(9)'s return
  len is explicitly documented the be the value 0, and the return offset
  is restricted to be the smallest of off + len and current file size
  suggested by kib@. This semantic allows callers to interact better
  with potential file size growth after the call.

Sponsored by:	The FreeBSD Foundation
Reviewed by:	imp, kib
Differential Revision:	https://reviews.freebsd.org/D31604
2021-08-24 17:08:28 +08:00
..
man1 pkgbase: move man pages from runtime-manual to runtime 2019-07-19 15:12:20 +00:00
man3 bitstring(3): Add bitstring traversal macros. 2021-08-16 23:24:05 +03:00
man3lua flua: Add a libjail module 2020-10-24 17:08:59 +00:00
man4 pci: Add an ioctl to perform I/O to BARs 2021-08-14 10:59:03 -04:00
man5 src.conf.5: Regen after fe52b7f60e, PROFILE default off 2021-08-07 20:51:44 -04:00
man6 pkgbase: move man pages from runtime-manual to runtime 2019-07-19 15:12:20 +00:00
man7 build.7: Describe the default value for LOCAL_MODULES 2021-08-10 21:18:34 -04:00
man8 man: Install more man pages unconditionally 2021-08-06 18:34:07 +02:00
man9 fspacectl(2): Clarifies the return values 2021-08-24 17:08:28 +08:00
Makefile flua: Add a libjail module 2020-10-24 17:08:59 +00:00