Hi folks,
This series introduce 2 man pages for file_getattr() and file_setattr()
syscalls.
Changes from v5:
- rebase to 6.20 and dropped "struct file_attr" patch (merged)
- change description of dirfd & path args to reference openat(2)
Changes from v4:
- Split single patch into 3 separate ones
- Mark examples for linters
- Use special char for empty lines in examples
- Use w64/w32 in printf() in examples
- Use const fattr in file_setattr() definition
- Other minor fixes
- A few fixes found by lint in examples
Changes from v3:
- dropped VERSIONS section in file_attr.2type
- reference arguments and errors from file_setattr to file_getattr
- Minor wording fixes
- Minor formatting fixes
- Removed zero-initialized requirement
- Interdiff with v3 below
Changes from v2:
- a few grammar fixes
- styling fixes
- sashiko.dev fixes (wrong AT_FDCWD combined with AT_EMPTY_PATH
description, unused "dfd")
- dropped requirement to zero fattr before using file_setattr()
- Pathname -> path
- Dropped description of why FS_IOC_ aren't usable with special files
- Fixed backslashes in the code examples
Andrey Albershteyn (2):
man/man2: introduce man page for file_getattr(2) syscall
man/man2: introduce man page for file_setattr(2) syscall
man/man2/file_getattr.2 | 252 ++++++++++++++++++++++++++++++++++++++++
man/man2/file_setattr.2 | 183 +++++++++++++++++++++++++++++
2 files changed, 435 insertions(+)
create mode 100644 man/man2/file_getattr.2
create mode 100644 man/man2/file_setattr.2
Range-diff against v5:
1: bfff306908cf ! 1: c7df8a930c70 man/man2: introduce man page for file_getattr(2) syscall
@@ man/man2/file_getattr.2 (new)
+of the file
+specified by path.
+.P
-+As with
++The
++.I dirfd
++and
++.I path
++arguments behave in the same way as in
+.BR openat (2),
-+if
++with the difference that
+.I path
-+is relative,
-+then it is interpreted relative to the directory
-+referred to by the file descriptor
-+.IR dirfd .
-+The special
-+.I dirfd
-+value
-+.B AT_FDCWD
-+can be used to refer to the current working directory of the calling process.
-+If
-+.I path
-+is absolute,
-+then
-+.I dirfd
-+is ignored.
++can be NULL meaning an empty string.
+.P
+The
+.I fattr
2: d81d763c4223 = 2: 9c7fbaab27e5 man/man2: introduce man page for file_setattr(2) syscall
--
2.56.0