From: Debarshi Ray <rishi@fedoraproject.org>
Date: Thu, 29 Jun 2023 11:04:41 +0000 (+0200)
Subject: libmount: update documentation for MNT_ERR_APPLYFLAGS
X-Git-Tag: v2.40-rc1~355^2
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=5a17b1b626d49914afd4869090c1890859515360;p=thirdparty%2Futil-linux.git

libmount: update documentation for MNT_ERR_APPLYFLAGS

The implementation using the new FD based mount kernel API (ie.,
fsconfig/fsopen) uses MNT_ERR_APPLYFLAGS for failed mount_setattr(2)
calls, which involves more mount attributes (eg., MOUNT_ATTR_RDONLY,
MOUNT_ATTR_NOSUID, etc.) in addition to the MS_PROPAGATION flags (eg.,
MS_SHARED, MS_UNBINDABLE, etc.).

Note that mount_setattr(2) is part of the new FD based mount kernel API,
and is not used by the classic mount(2) based version.

Fallout from 987d844cdbc0f91ca81de3c1e5d0628a60eb458f

Signed-off-by: Debarshi Ray <rishi@fedoraproject.org>
---

diff --git a/libmount/src/libmount.h.in b/libmount/src/libmount.h.in
index 73a2802f49..f156483b6e 100644
--- a/libmount/src/libmount.h.in
+++ b/libmount/src/libmount.h.in
@@ -188,7 +188,8 @@ enum {
 /**
  * MNT_ERR_APPLYFLAGS:
  *
- * failed to apply MS_PROPAGATION flags
+ * failed to apply MS_PROPAGATION flags, and MOUNT_ATTR_* attributes for
+ * mount_setattr(2)
  */
 #define MNT_ERR_APPLYFLAGS   5005
 /**