On 2025-08-08, Askar Safin <safinaskar@xxxxxxxxxxxx> wrote: > In "man open_tree": > > > As with "*at()" system calls, fspick() uses the dirfd argument in conjunction > > You meant "open_tree" > > > If flags does not contain OPEN_TREE_CLONE, open_tree() returns > > a file descriptor that is exactly equivalent to one produced by open(2). > > Please, change "by open(2)" to "by openat(2) with O_PATH" (and other similar places). I think the more common pattern in man-pages is to prefer to refer to open(2) unless you are explicitly talking about openat(2) features (like passing a dirfd). If it's just "a file descriptor with O_PATH" then most man-pages I've seen reference open(2) even if they were written post-openat(2). Though in this case, since we are talking about open_tree(2) as an open operation that takes a dirfd, you're right that openat(2) might be better. -- Aleksa Sarai Senior Software Engineer (Containers) SUSE Linux GmbH https://www.cyphar.com/
Attachment:
signature.asc
Description: PGP signature