From: Jan Kara <jack@suse.cz> To: Eric Biggers <ebiggers@kernel.org> Cc: linux-fsdevel@vger.kernel.org, linux-xfs@vger.kernel.org, linux-ext4@vger.kernel.org, linux-f2fs-devel@lists.sourceforge.net, Theodore Ts'o <tytso@mit.edu>, Christoph Hellwig <hch@lst.de> Subject: Re: [PATCH v2 02/12] fs: correctly document the inode dirty flags Date: Mon, 11 Jan 2021 15:48:57 +0100 [thread overview] Message-ID: <20210111144857.GA18475@quack2.suse.cz> (raw) In-Reply-To: <20210109075903.208222-3-ebiggers@kernel.org> On Fri 08-01-21 23:58:53, Eric Biggers wrote: > From: Eric Biggers <ebiggers@google.com> > > The documentation for I_DIRTY_SYNC and I_DIRTY_DATASYNC is a bit > misleading, and I_DIRTY_TIME isn't documented at all. Fix this. > > Reviewed-by: Christoph Hellwig <hch@lst.de> > Signed-off-by: Eric Biggers <ebiggers@google.com> Looks good to me. You can add: Reviewed-by: Jan Kara <jack@suse.cz> Honza > --- > include/linux/fs.h | 18 +++++++++++++----- > 1 file changed, 13 insertions(+), 5 deletions(-) > > diff --git a/include/linux/fs.h b/include/linux/fs.h > index fd47deea7c176..45a0303b2aeb6 100644 > --- a/include/linux/fs.h > +++ b/include/linux/fs.h > @@ -2084,8 +2084,8 @@ static inline void kiocb_clone(struct kiocb *kiocb, struct kiocb *kiocb_src, > /* > * Inode state bits. Protected by inode->i_lock > * > - * Three bits determine the dirty state of the inode, I_DIRTY_SYNC, > - * I_DIRTY_DATASYNC and I_DIRTY_PAGES. > + * Four bits determine the dirty state of the inode: I_DIRTY_SYNC, > + * I_DIRTY_DATASYNC, I_DIRTY_PAGES, and I_DIRTY_TIME. > * > * Four bits define the lifetime of an inode. Initially, inodes are I_NEW, > * until that flag is cleared. I_WILL_FREE, I_FREEING and I_CLEAR are set at > @@ -2094,12 +2094,20 @@ static inline void kiocb_clone(struct kiocb *kiocb, struct kiocb *kiocb_src, > * Two bits are used for locking and completion notification, I_NEW and I_SYNC. > * > * I_DIRTY_SYNC Inode is dirty, but doesn't have to be written on > - * fdatasync(). i_atime is the usual cause. > - * I_DIRTY_DATASYNC Data-related inode changes pending. We keep track of > + * fdatasync() (unless I_DIRTY_DATASYNC is also set). > + * Timestamp updates are the usual cause. > + * I_DIRTY_DATASYNC Data-related inode changes pending. We keep track of > * these changes separately from I_DIRTY_SYNC so that we > * don't have to write inode on fdatasync() when only > - * mtime has changed in it. > + * e.g. the timestamps have changed. > * I_DIRTY_PAGES Inode has dirty pages. Inode itself may be clean. > + * I_DIRTY_TIME The inode itself only has dirty timestamps, and the > + * lazytime mount option is enabled. We keep track of this > + * separately from I_DIRTY_SYNC in order to implement > + * lazytime. This gets cleared if I_DIRTY_INODE > + * (I_DIRTY_SYNC and/or I_DIRTY_DATASYNC) gets set. I.e. > + * either I_DIRTY_TIME *or* I_DIRTY_INODE can be set in > + * i_state, but not both. I_DIRTY_PAGES may still be set. > * I_NEW Serves as both a mutex and completion notification. > * New inodes set I_NEW. If two processes both create > * the same inode, one of them will release its inode and > -- > 2.30.0 > -- Jan Kara <jack@suse.com> SUSE Labs, CR
WARNING: multiple messages have this Message-ID (diff)
From: Jan Kara <jack@suse.cz> To: Eric Biggers <ebiggers@kernel.org> Cc: Theodore Ts'o <tytso@mit.edu>, linux-f2fs-devel@lists.sourceforge.net, linux-xfs@vger.kernel.org, linux-fsdevel@vger.kernel.org, linux-ext4@vger.kernel.org, Christoph Hellwig <hch@lst.de> Subject: Re: [f2fs-dev] [PATCH v2 02/12] fs: correctly document the inode dirty flags Date: Mon, 11 Jan 2021 15:48:57 +0100 [thread overview] Message-ID: <20210111144857.GA18475@quack2.suse.cz> (raw) In-Reply-To: <20210109075903.208222-3-ebiggers@kernel.org> On Fri 08-01-21 23:58:53, Eric Biggers wrote: > From: Eric Biggers <ebiggers@google.com> > > The documentation for I_DIRTY_SYNC and I_DIRTY_DATASYNC is a bit > misleading, and I_DIRTY_TIME isn't documented at all. Fix this. > > Reviewed-by: Christoph Hellwig <hch@lst.de> > Signed-off-by: Eric Biggers <ebiggers@google.com> Looks good to me. You can add: Reviewed-by: Jan Kara <jack@suse.cz> Honza > --- > include/linux/fs.h | 18 +++++++++++++----- > 1 file changed, 13 insertions(+), 5 deletions(-) > > diff --git a/include/linux/fs.h b/include/linux/fs.h > index fd47deea7c176..45a0303b2aeb6 100644 > --- a/include/linux/fs.h > +++ b/include/linux/fs.h > @@ -2084,8 +2084,8 @@ static inline void kiocb_clone(struct kiocb *kiocb, struct kiocb *kiocb_src, > /* > * Inode state bits. Protected by inode->i_lock > * > - * Three bits determine the dirty state of the inode, I_DIRTY_SYNC, > - * I_DIRTY_DATASYNC and I_DIRTY_PAGES. > + * Four bits determine the dirty state of the inode: I_DIRTY_SYNC, > + * I_DIRTY_DATASYNC, I_DIRTY_PAGES, and I_DIRTY_TIME. > * > * Four bits define the lifetime of an inode. Initially, inodes are I_NEW, > * until that flag is cleared. I_WILL_FREE, I_FREEING and I_CLEAR are set at > @@ -2094,12 +2094,20 @@ static inline void kiocb_clone(struct kiocb *kiocb, struct kiocb *kiocb_src, > * Two bits are used for locking and completion notification, I_NEW and I_SYNC. > * > * I_DIRTY_SYNC Inode is dirty, but doesn't have to be written on > - * fdatasync(). i_atime is the usual cause. > - * I_DIRTY_DATASYNC Data-related inode changes pending. We keep track of > + * fdatasync() (unless I_DIRTY_DATASYNC is also set). > + * Timestamp updates are the usual cause. > + * I_DIRTY_DATASYNC Data-related inode changes pending. We keep track of > * these changes separately from I_DIRTY_SYNC so that we > * don't have to write inode on fdatasync() when only > - * mtime has changed in it. > + * e.g. the timestamps have changed. > * I_DIRTY_PAGES Inode has dirty pages. Inode itself may be clean. > + * I_DIRTY_TIME The inode itself only has dirty timestamps, and the > + * lazytime mount option is enabled. We keep track of this > + * separately from I_DIRTY_SYNC in order to implement > + * lazytime. This gets cleared if I_DIRTY_INODE > + * (I_DIRTY_SYNC and/or I_DIRTY_DATASYNC) gets set. I.e. > + * either I_DIRTY_TIME *or* I_DIRTY_INODE can be set in > + * i_state, but not both. I_DIRTY_PAGES may still be set. > * I_NEW Serves as both a mutex and completion notification. > * New inodes set I_NEW. If two processes both create > * the same inode, one of them will release its inode and > -- > 2.30.0 > -- Jan Kara <jack@suse.com> SUSE Labs, CR _______________________________________________ Linux-f2fs-devel mailing list Linux-f2fs-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/linux-f2fs-devel
next prev parent reply other threads:[~2021-01-11 14:49 UTC|newest] Thread overview: 82+ messages / expand[flat|nested] mbox.gz Atom feed top 2021-01-09 7:58 [PATCH v2 00/12] lazytime fix and cleanups Eric Biggers 2021-01-09 7:58 ` [f2fs-dev] " Eric Biggers 2021-01-09 7:58 ` [PATCH v2 01/12] fs: fix lazytime expiration handling in __writeback_single_inode() Eric Biggers 2021-01-09 7:58 ` [f2fs-dev] " Eric Biggers 2021-01-11 10:48 ` Christoph Hellwig 2021-01-11 10:48 ` [f2fs-dev] " Christoph Hellwig 2021-01-11 14:46 ` Jan Kara 2021-01-11 14:46 ` [f2fs-dev] " Jan Kara 2021-01-09 7:58 ` [PATCH v2 02/12] fs: correctly document the inode dirty flags Eric Biggers 2021-01-09 7:58 ` [f2fs-dev] " Eric Biggers 2021-01-11 14:48 ` Jan Kara [this message] 2021-01-11 14:48 ` Jan Kara 2021-01-09 7:58 ` [PATCH v2 03/12] fs: only specify I_DIRTY_TIME when needed in generic_update_time() Eric Biggers 2021-01-09 7:58 ` [f2fs-dev] " Eric Biggers 2021-01-11 14:50 ` Jan Kara 2021-01-11 14:50 ` [f2fs-dev] " Jan Kara 2021-01-09 7:58 ` [PATCH v2 04/12] fat: only specify I_DIRTY_TIME when needed in fat_update_time() Eric Biggers 2021-01-09 7:58 ` [f2fs-dev] " Eric Biggers 2021-01-11 10:52 ` Christoph Hellwig 2021-01-11 10:52 ` [f2fs-dev] " Christoph Hellwig 2021-01-11 19:50 ` Eric Biggers 2021-01-11 19:50 ` [f2fs-dev] " Eric Biggers 2021-01-12 5:21 ` Dave Chinner 2021-01-12 5:21 ` [f2fs-dev] " Dave Chinner 2021-01-12 13:23 ` Christoph Hellwig 2021-01-12 13:23 ` [f2fs-dev] " Christoph Hellwig 2021-01-11 14:52 ` Jan Kara 2021-01-11 14:52 ` [f2fs-dev] " Jan Kara 2021-01-09 7:58 ` [PATCH v2 05/12] fs: don't call ->dirty_inode for lazytime timestamp updates Eric Biggers 2021-01-09 7:58 ` [f2fs-dev] " Eric Biggers 2021-01-11 14:54 ` Jan Kara 2021-01-11 14:54 ` [f2fs-dev] " Jan Kara 2021-01-09 7:58 ` [PATCH v2 06/12] fs: pass only I_DIRTY_INODE flags to ->dirty_inode Eric Biggers 2021-01-09 7:58 ` [f2fs-dev] " Eric Biggers 2021-01-11 14:56 ` Jan Kara 2021-01-11 14:56 ` [f2fs-dev] " Jan Kara 2021-01-09 7:58 ` [PATCH v2 07/12] fs: clean up __mark_inode_dirty() a bit Eric Biggers 2021-01-09 7:58 ` [f2fs-dev] " Eric Biggers 2021-01-11 14:59 ` Jan Kara 2021-01-11 14:59 ` [f2fs-dev] " Jan Kara 2021-01-09 7:58 ` [PATCH v2 08/12] fs: drop redundant check from __writeback_single_inode() Eric Biggers 2021-01-09 7:58 ` [f2fs-dev] " Eric Biggers 2021-01-11 10:52 ` Christoph Hellwig 2021-01-11 10:52 ` [f2fs-dev] " Christoph Hellwig 2021-01-11 15:00 ` Jan Kara 2021-01-11 15:00 ` [f2fs-dev] " Jan Kara 2021-01-09 7:59 ` [PATCH v2 09/12] fs: improve comments for writeback_single_inode() Eric Biggers 2021-01-09 7:59 ` [f2fs-dev] " Eric Biggers 2021-01-11 10:53 ` Christoph Hellwig 2021-01-11 10:53 ` [f2fs-dev] " Christoph Hellwig 2021-01-11 15:05 ` Jan Kara 2021-01-11 15:05 ` [f2fs-dev] " Jan Kara 2021-01-09 7:59 ` [PATCH v2 10/12] gfs2: don't worry about I_DIRTY_TIME in gfs2_fsync() Eric Biggers 2021-01-09 7:59 ` [f2fs-dev] " Eric Biggers 2021-01-11 15:06 ` Jan Kara 2021-01-11 15:06 ` [f2fs-dev] " Jan Kara 2021-01-09 7:59 ` [PATCH v2 11/12] ext4: simplify i_state checks in __ext4_update_other_inode_time() Eric Biggers 2021-01-09 7:59 ` [f2fs-dev] " Eric Biggers 2021-01-11 10:53 ` Christoph Hellwig 2021-01-11 10:53 ` [f2fs-dev] " Christoph Hellwig 2021-01-11 20:23 ` Eric Biggers 2021-01-11 20:23 ` [f2fs-dev] " Eric Biggers 2021-01-12 13:25 ` Christoph Hellwig 2021-01-12 13:25 ` [f2fs-dev] " Christoph Hellwig 2021-02-03 5:16 ` Theodore Ts'o 2021-02-03 5:16 ` [f2fs-dev] " Theodore Ts'o 2021-01-11 15:11 ` Jan Kara 2021-01-11 15:11 ` [f2fs-dev] " Jan Kara 2021-01-09 7:59 ` [PATCH v2 12/12] xfs: remove a stale comment from xfs_file_aio_write_checks() Eric Biggers 2021-01-09 7:59 ` [f2fs-dev] " Eric Biggers 2021-01-12 17:31 ` Darrick J. Wong 2021-01-12 17:31 ` [f2fs-dev] " Darrick J. Wong 2021-01-11 15:15 ` [PATCH v2 00/12] lazytime fix and cleanups Jan Kara 2021-01-11 15:15 ` [f2fs-dev] " Jan Kara 2021-01-11 20:44 ` Eric Biggers 2021-01-11 20:44 ` [f2fs-dev] " Eric Biggers 2021-02-03 5:11 ` Theodore Ts'o 2021-02-03 5:11 ` [f2fs-dev] " Theodore Ts'o 2021-02-03 5:22 ` Eric Biggers 2021-02-03 5:22 ` [f2fs-dev] " Eric Biggers 2021-02-03 15:49 ` Theodore Ts'o 2021-02-03 15:49 ` [f2fs-dev] " Theodore Ts'o
Reply instructions: You may reply publicly to this message via plain-text email using any one of the following methods: * Save the following mbox file, import it into your mail client, and reply-to-all from there: mbox Avoid top-posting and favor interleaved quoting: https://en.wikipedia.org/wiki/Posting_style#Interleaved_style * Reply using the --to, --cc, and --in-reply-to switches of git-send-email(1): git send-email \ --in-reply-to=20210111144857.GA18475@quack2.suse.cz \ --to=jack@suse.cz \ --cc=ebiggers@kernel.org \ --cc=hch@lst.de \ --cc=linux-ext4@vger.kernel.org \ --cc=linux-f2fs-devel@lists.sourceforge.net \ --cc=linux-fsdevel@vger.kernel.org \ --cc=linux-xfs@vger.kernel.org \ --cc=tytso@mit.edu \ /path/to/YOUR_REPLY https://kernel.org/pub/software/scm/git/docs/git-send-email.html * If your mail client supports setting the In-Reply-To header via mailto: links, try the mailto: linkBe sure your reply has a Subject: header at the top and a blank line before the message body.
This is an external index of several public inboxes, see mirroring instructions on how to clone and mirror all data and code used by this external index.