Thread (33 messages) 33 messages, 2 authors, 2021-08-07

Re: [PATCH v2 00/29] xfsprogs: Drop the 'platform_' prefix

From: Pavel Reichl <hidden>
Date: 2021-08-07 15:13:40

On 8/7/21 1:05 AM, Dave Chinner wrote:
On Fri, Aug 06, 2021 at 11:22:49PM +0200, Pavel Reichl wrote:
quoted
Stop using commands with 'platform_' prefix. Either use directly linux
standard command or drop the prefix from the function name.
Looks like all of the patches in this series are missing
signed-off-by lines.  Most of them have empty commit messages, too,
Sorry about the missing signed-off-by, I really need to have a
check-list before posting patches...or send more patches :-).
which we don't tend to do very often.
quoted
  51 files changed, 284 insertions(+), 151 deletions(-)
IMO, 29 patches for such a small change is way too fine grained for
working through efficiently.  Empty commit messages tend to be a
sign that you can aggregate patches together.... i.e.  One patch for
all the uuid changes (currently 7 patches) with a description of why
you're changing the platform_uuid interface, one for all the mount
related stuff (at least 5 patches now), one for all the block device
stuff (8 or so patches), one for all the path bits, and then one for
whatever is left over.
OK, I'll do this in the next version.
Every patch has overhead, be it to produce, maintain, review, test,
merge, etc. Breaking stuff down unnecessarily just increases the
amount of work everyone has to do at every step. So if you find that
you are writing dozens of patches that each have a trivial change in
them that you are boiler-plating commit messages, you've probably
made the overall changeset too fine grained.
OK, sincerely thank you for the 'rules-of-thump'. However, In the
first version of the patch set I grouped the changes into way less patches
and passed along a question about the preferred granularity of patches
and got the following answer:
  * What would be best for the reviewer - should I prepare a separate
  patch for every function rename or should I squash the changes into
  one huge patch?
One patch per function, please.
However, I agree that I should have mentioned that some patches would
be too small and not blindly follow the request...I'll do better next
time.
Also....
quoted
  libxfs/init.c               | 32 ++++++------
  libxfs/libxfs_io.h          |  2 +-
  libxfs/libxfs_priv.h        |  3 +-
  libxfs/rdwr.c               |  4 +-
  libxfs/xfs_ag.c             |  6 +--
  libxfs/xfs_attr_leaf.c      |  2 +-
  libxfs/xfs_attr_remote.c    |  2 +-
  libxfs/xfs_btree.c          |  4 +-
  libxfs/xfs_da_btree.c       |  2 +-
  libxfs/xfs_dir2_block.c     |  2 +-
  libxfs/xfs_dir2_data.c      |  2 +-
  libxfs/xfs_dir2_leaf.c      |  2 +-
  libxfs/xfs_dir2_node.c      |  2 +-
  libxfs/xfs_dquot_buf.c      |  2 +-
  libxfs/xfs_ialloc.c         |  4 +-
  libxfs/xfs_inode_buf.c      |  2 +-
  libxfs/xfs_sb.c             |  6 +--
  libxfs/xfs_symlink_remote.c |  2 +-
Why are all these libxfs files being changed?
I believe this is because of patch #6 - xfsprogs: Stop using 
platform_uuid_copy()

Here I dropped the usage of platform_uuid_copy() even in libxfs by:

1) removing the uuid_copy() macro that was implemented by calling
    platform_uuid_copy() in libxfs/libxfs_priv.h

  -#define uuid_copy(s,d) platform_uuid_copy((s),(d))

2) using directly standard uuid_copy() instead
    Which resulted into plenty of trivial changes all over libxfs, the
    core of the changes being that uuid params are passed-by-value to
    standard uuid_copy(), but to libxfs' uuid_copy() it is
    passed-by-reference.

    E.g.
- uuid_copy(&agf->agf_uuid, &mp->m_sb.sb_meta_uuid);
+               uuid_copy(agf->agf_uuid, mp->m_sb.sb_meta_uuid);
Cheers,

Dave.
Hi Dave,
Thank you for you comments, please see reactions above.
Have a nice day.


Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help