Thread (3 messages) 3 messages, 1 author, 23h ago

[PATCH v6 0/2] Introduce man pages for file_getattr() and file_setattr()

flat view
HOTtoday

From: Andrey Albershteyn <aalbersh@kernel.org>
Date: 2026-10-21 14:10:48
Also in: linux-fsdevel, linux-man, linux-xfs

Revision v6 of 2 in this series.

Revisions (2)
  1. v5 [diff vs current]
  2. v6 current
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
Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help