* [PATCH] vfs: fix documentation of touch_atime()
@ 2016-07-19 12:37 Luis de Bethencourt
0 siblings, 0 replies; only message in thread
From: Luis de Bethencourt @ 2016-07-19 12:37 UTC (permalink / raw)
To: linux-kernel, mszeredi; +Cc: viro, linux-fsdevel, Luis de Bethencourt
The documentation of touch_atime() doesn't match the location of the
definition and list of parameters anymore. Updating it.
Fixes: e8d2e3f31127 ("vfs: update ovl inode before relatime check")
Signed-off-by: Luis de Bethencourt <luisbg@osg.samsung.com>
---
Hi,
This patch is based on Miklos' overlayfs-next branch [0]. When building the
docs with the latest changes in that branch you get the following warning:
.//fs/inode.c:1637: warning: No description found for parameter 'rcu'
Problem is that the documentation generator takes the parameter list of
__atime_needs_update for the description of touch_atime() due to the comments
being just above __atime_needs_update().
Moving down the comments to match the location of touch_atime and removing
the explanation of @inode since that parameter isn't there anymore.
Originally the comments were just above atime_needs_update(), should I keep
them above this function instead? Not sure since the comments say touch_atime.
Thanks,
Luis
[0] https://git.kernel.org/cgit/linux/kernel/git/mszeredi/vfs.git/log/?h=overlayfs-next
fs/inode.c | 17 ++++++++---------
1 file changed, 8 insertions(+), 9 deletions(-)
diff --git a/fs/inode.c b/fs/inode.c
index 6a2d447..43a8ca4 100644
--- a/fs/inode.c
+++ b/fs/inode.c
@@ -1621,15 +1621,6 @@ static int update_time(struct inode *inode, struct timespec *time, int flags)
return update_time(inode, time, flags);
}
-/**
- * touch_atime - update the access time
- * @path: the &struct path to update
- * @inode: inode to update
- *
- * Update the accessed time on an inode and mark it for writeback.
- * This function automatically handles read only file systems and media,
- * as well as the "noatime" flag and inode specific "noatime" markers.
- */
static bool __atime_needs_update(const struct path *path, struct inode *inode,
bool rcu)
{
@@ -1664,6 +1655,14 @@ bool atime_needs_update(const struct path *path, struct inode *inode)
return __atime_needs_update(path, inode, true);
}
+/**
+ * touch_atime - update the access time
+ * @path: the &struct path to update
+ *
+ * Update the accessed time on an a path's inode and mark it for writeback.
+ * This function automatically handles read only file systems and media,
+ * as well as the "noatime" flag and inode specific "noatime" markers.
+ */
void touch_atime(const struct path *path)
{
struct vfsmount *mnt = path->mnt;
--
2.6.4
^ permalink raw reply related [flat|nested] only message in thread
only message in thread, other threads:[~2016-07-19 12:38 UTC | newest]
Thread overview: (only message) (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2016-07-19 12:37 [PATCH] vfs: fix documentation of touch_atime() Luis de Bethencourt
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).