From: John Garry <john.g.garry@oracle.com>
To: "Darrick J. Wong" <djwong@kernel.org>, aalbersh@kernel.org
Cc: catherine.hoang@oracle.com, linux-xfs@vger.kernel.org
Subject: Re: [PATCH 2/7] xfs_db: create an untorn_max subcommand
Date: Wed, 9 Jul 2025 16:39:12 +0100 [thread overview]
Message-ID: <ede6d2ff-62e5-4b82-95e7-edb683199aca@oracle.com> (raw)
In-Reply-To: <175139303875.916168.18071503400698892291.stgit@frogsfrogsfrogs>
> };
Generally it looks ok, just some small comments.
If you are not too concerned with any comment, then feel free to add the
following:
Reviewed-by: John Garry <john.g.garry@oracle.com>
>
> +STATIC void
> +untorn_cow_limits(
> + struct xfs_mount *mp,
> + unsigned int logres,
> + unsigned int desired_max)
> +{
> + const unsigned int efi = xfs_efi_log_space(1);
> + const unsigned int efd = xfs_efd_log_space(1);
> + const unsigned int rui = xfs_rui_log_space(1);
> + const unsigned int rud = xfs_rud_log_space();
> + const unsigned int cui = xfs_cui_log_space(1);
> + const unsigned int cud = xfs_cud_log_space();
> + const unsigned int bui = xfs_bui_log_space(1);
> + const unsigned int bud = xfs_bud_log_space();
> +
> + /*
> + * Maximum overhead to complete an untorn write ioend in software:
> + * remove data fork extent + remove cow fork extent + map extent into
> + * data fork.
> + *
> + * tx0: Creates a BUI and a CUI and that's all it needs.
> + *
> + * tx1: Roll to finish the BUI. Need space for the BUD, an RUI, and
> + * enough space to relog the CUI (== CUI + CUD).
> + *
> + * tx2: Roll again to finish the RUI. Need space for the RUD and space
> + * to relog the CUI.
> + *
> + * tx3: Roll again, need space for the CUD and possibly a new EFI.
> + *
> + * tx4: Roll again, need space for an EFD.
> + *
> + * If the extent referenced by the pair of BUI/CUI items is not the one
> + * being currently processed, then we need to reserve space to relog
> + * both items.
> + */
> + const unsigned int tx0 = bui + cui;
> + const unsigned int tx1 = bud + rui + cui + cud;
> + const unsigned int tx2 = rud + cui + cud;
> + const unsigned int tx3 = cud + efi;
> + const unsigned int tx4 = efd;
> + const unsigned int relog = bui + bud + cui + cud;
> +
> + const unsigned int per_intent = max(max3(tx0, tx1, tx2),
> + max3(tx3, tx4, relog));
> +
> + /* Overhead to finish one step of each intent item type */
> + const unsigned int f1 = libxfs_calc_finish_efi_reservation(mp, 1);
> + const unsigned int f2 = libxfs_calc_finish_rui_reservation(mp, 1);
> + const unsigned int f3 = libxfs_calc_finish_cui_reservation(mp, 1);
> + const unsigned int f4 = libxfs_calc_finish_bui_reservation(mp, 1);
> +
> + /* We only finish one item per transaction in a chain */
> + const unsigned int step_size = max(f4, max3(f1, f2, f3));
This all looks to match xfs_calc_atomic_write_ioend_geometry(). I assume
that there is a good reason why that code cannot be reused.
> +
> + if (desired_max) {
> + dbprintf(
> + "desired_max: %u\nstep_size: %u\nper_intent: %u\nlogres: %u\n",
> + desired_max, step_size, per_intent,
> + (desired_max * per_intent) + step_size);
> + } else if (logres) {
> + dbprintf(
> + "logres: %u\nstep_size: %u\nper_intent: %u\nmax_awu: %u\n",
> + logres, step_size, per_intent,
> + logres >= step_size ? (logres - step_size) / per_intent : 0);
> + }
> +}
> +
> +static void
> +untorn_max_help(void)
> +{
> + dbprintf(_(
> +"\n"
> +" The 'untorn_max' command computes either the log reservation needed to\n"
> +" complete an untorn write of a given block count; or the maximum number of\n"
> +" blocks that can be completed given a specific log reservation.\n"
> +"\n"
> + ));
> +}
> +
> +static int
> +untorn_max_f(
> + int argc,
> + char **argv)
> +{
> + unsigned int logres = 0;
> + unsigned int desired_max = 0;
> + int c;
> +
> + while ((c = getopt(argc, argv, "l:b:")) != EOF) {
> + switch (c) {
> + case 'l':
> + logres = atoi(optarg);
> + break;
> + case 'b':
> + desired_max = atoi(optarg);
> + break;
> + default:
> + untorn_max_help();
> + return 0;
> + }
> + }
From untorn_cow_limits(), it seems that it's best not give both 'l' and
'b', as we only ever print one value. As such, would be better to set
argmax = 1 (or whatever is needed to only accept only 'l' or 'b')?
> +
> + if (!logres && !desired_max) {
> + dbprintf("untorn_max needs -l or -b option\n");
> + return 0;
similar db command handlers use -1, but I guess that it's not important
here since you just rely on the print message output always
> + }
> +
> + if (xfs_has_reflink(mp))
this check could be put earlier
> + untorn_cow_limits(mp, logres, desired_max);
> + else
> + dbprintf("untorn write emulation not supported\n");
> +
> + return 0;
> +}
> +
> +static const struct cmdinfo untorn_max_cmd = {
it would be nice to use untorn_write_max_cmd
> + .name = "untorn_max",
> + .altname = NULL,
> + .cfunc = untorn_max_f,
> + .argmin = 0,
> + .argmax = -1,
> + .canpush = 0,
> + .args = NULL,
> + .oneline = N_("compute untorn write max"),
> + .help = logres_help,
> +};
> +
> void
> logres_init(void)
> {
> add_command(&logres_cmd);
> + add_command(&untorn_max_cmd);
> }
> diff --git a/man/man8/xfs_db.8 b/man/man8/xfs_db.8
> index 2a9322560584b0..d4531fc0e380a3 100644
> --- a/man/man8/xfs_db.8
> +++ b/man/man8/xfs_db.8
> @@ -1366,6 +1366,16 @@ .SH COMMANDS
> .IR name .
> The file being targetted will not be put on the iunlink list.
> .TP
> +.BI "untorn_max [\-b " blockcount "|\-l " logres "]"
> +If
> +.B -l
> +is specified, compute the maximum (in fsblocks) untorn write that we can
> +emulate with copy on write given a log reservation size (in bytes).
> +If
> +.B -b
> +is specified,
> compute the log reservation size that would be needed to
> +emulate an untorn write of the given number of fsblocks.
> +.TP
> .BI "uuid [" uuid " | " generate " | " rewrite " | " restore ]
> Set the filesystem universally unique identifier (UUID).
> The filesystem UUID can be used by
>
next prev parent reply other threads:[~2025-07-09 15:39 UTC|newest]
Thread overview: 33+ messages / expand[flat|nested] mbox.gz Atom feed top
2025-07-01 18:03 [PATCHBOMB] xfsprogs: ports and new code for 6.16 Darrick J. Wong
2025-07-01 18:04 ` [PATCHSET 1/3] xfsprogs: new libxfs code from kernel 6.16 Darrick J. Wong
2025-07-01 18:05 ` [PATCH 1/6] xfs: add helpers to compute transaction reservation for finishing intent items Darrick J. Wong
2025-07-01 18:05 ` [PATCH 2/6] xfs: allow block allocator to take an alignment hint Darrick J. Wong
2025-07-01 18:06 ` [PATCH 3/6] xfs: commit CoW-based atomic writes atomically Darrick J. Wong
2025-07-01 18:06 ` [PATCH 4/6] libxfs: add helpers to compute log item overhead Darrick J. Wong
2025-07-01 18:06 ` [PATCH 5/6] xfs: add xfs_calc_atomic_write_unit_max() Darrick J. Wong
2025-07-01 18:06 ` [PATCH 6/6] xfs: allow sysadmins to specify a maximum atomic write limit at mount time Darrick J. Wong
2025-07-01 18:05 ` [PATCHSET 2/3] xfsprogs: atomic writes Darrick J. Wong
2025-07-01 18:07 ` [PATCH 1/7] libfrog: move statx.h from io/ to libfrog/ Darrick J. Wong
2025-07-02 9:13 ` John Garry
2025-07-01 18:07 ` [PATCH 2/7] xfs_db: create an untorn_max subcommand Darrick J. Wong
2025-07-09 15:39 ` John Garry [this message]
2025-07-09 16:35 ` Darrick J. Wong
2025-07-01 18:07 ` [PATCH 3/7] xfs_io: dump new atomic_write_unit_max_opt statx field Darrick J. Wong
2025-07-02 8:23 ` John Garry
2025-07-01 18:07 ` [PATCH 4/7] mkfs: don't complain about overly large auto-detected log stripe units Darrick J. Wong
2025-07-08 14:38 ` John Garry
2025-07-08 15:05 ` Darrick J. Wong
2025-07-08 15:07 ` John Garry
2025-07-01 18:08 ` [PATCH 5/7] mkfs: autodetect log stripe unit for external log devices Darrick J. Wong
2025-07-09 15:57 ` John Garry
2025-07-09 16:45 ` Darrick J. Wong
2025-07-01 18:08 ` [PATCH 6/7] mkfs: try to align AG size based on atomic write capabilities Darrick J. Wong
2025-07-02 9:03 ` John Garry
2025-07-02 19:00 ` Darrick J. Wong
2025-07-01 18:08 ` [PATCH 7/7] mkfs: allow users to configure the desired maximum atomic write size Darrick J. Wong
2025-07-02 8:50 ` John Garry
2025-07-02 19:01 ` Darrick J. Wong
2025-07-01 18:05 ` [PATCHSET 3/3] xfs_scrub: drop EXPERIMENTAL warning Darrick J. Wong
2025-07-01 18:09 ` [PATCH 1/1] xfs_scrub: remove EXPERIMENTAL warnings Darrick J. Wong
2025-07-03 13:45 ` Christoph Hellwig
-- strict thread matches above, loose matches on Subject: below --
2025-07-15 5:16 [PATCHSET 2/3] xfsprogs: atomic writes Darrick J. Wong
2025-07-15 5:18 ` [PATCH 2/7] xfs_db: create an untorn_max subcommand Darrick J. Wong
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=ede6d2ff-62e5-4b82-95e7-edb683199aca@oracle.com \
--to=john.g.garry@oracle.com \
--cc=aalbersh@kernel.org \
--cc=catherine.hoang@oracle.com \
--cc=djwong@kernel.org \
--cc=linux-xfs@vger.kernel.org \
/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: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
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).