From: Dave Jiang <dave.jiang@intel.com>
To: Alison Schofield <alison.schofield@intel.com>,
Davidlohr Bueso <dave@stgolabs.net>,
Jonathan Cameron <jic23@kernel.org>,
Vishal Verma <vishal.l.verma@intel.com>,
Ira Weiny <iweiny@kernel.org>, Li Ming <ming.li@zohomail.com>,
Richard Cheng <icheng@nvidia.com>
Cc: linux-cxl@vger.kernel.org
Subject: Re: [PATCH v4 2/2] cxl/Documentation: Describe clearing a region targetN position
Date: Tue, 3 Nov 2026 16:07:38 -0700 [thread overview]
Message-ID: <c93ac992-a797-4779-b618-c2a5d4e03288@intel.com> (raw)
In-Reply-To: <4d2fa8561a443d9859ca08c04950e6c15e168f98.1793724885.git.alison.schofield@intel.com>
On 11/3/26 10:07 AM, Alison Schofield wrote:
> The region targetN ABI documents that writing to an occupied position
> returns EBUSY, but does not describe how to clear the position after
> assigning the wrong endpoint decoder.
>
> Document how to clear a position by writing an empty string, how clearing a
> position decommits a committed region, and how the region can be committed
> again after all positions are filled.
>
> Signed-off-by: Alison Schofield <alison.schofield@intel.com>
Reviewed-by: Dave Jiang <dave.jiang@intel.com>
this change for the most part is unrelated to 1/2 right?
> ---
>
> Changes in v4:
> - Minor wordsmithing in commit log
> v3: https://lore.kernel.org/linux-cxl/e87248b8d13d3f07741243a45891365450c66881.1793653629.git.alison.schofield@intel.com/
>
> Changes in v3:
> - Restore the original entry text and append how to clear a position
> v2: https://lore.kernel.org/linux-cxl/efa1a098550077dc3571796ba0102ddabe1e9b0d.1792989098.git.alison.schofield@intel.com/
>
> Changes in v2:
> - Say that writing the endpoint decoder already at a position succeeds
> - Split the entry into paragraphs and drop the v1 error code reordering
> v1: https://lore.kernel.org/linux-cxl/a007c751d88ee64c9d0b7bb3c69a486c42358b36.1790829690.git.alison.schofield@intel.com/
> ---
> Documentation/ABI/testing/sysfs-bus-cxl | 4 ++++
> 1 file changed, 4 insertions(+)
>
> diff --git a/Documentation/ABI/testing/sysfs-bus-cxl b/Documentation/ABI/testing/sysfs-bus-cxl
> index 7352dbd70bc7..3629c983f05c 100644
> --- a/Documentation/ABI/testing/sysfs-bus-cxl
> +++ b/Documentation/ABI/testing/sysfs-bus-cxl
> @@ -568,6 +568,10 @@ Description:
> not an endpoint decoder. Once all positions have been
> successfully written a final validation for decode conflicts is
> performed before activating the region.
> + To clear a position, for example to replace an endpoint
> + decoder, write an empty string (echo > targetX). Clearing
> + a position in a committed region also decommits the region.
> + It can be committed again after all positions are filled.
>
>
> What: /sys/bus/cxl/devices/regionZ/commit
next prev parent reply other threads:[~2026-11-03 23:07 UTC|newest]
Thread overview: 8+ messages / expand[flat|nested] mbox.gz Atom feed top
2026-11-03 17:07 [PATCH v4 1/2] cxl/region: Reject a repeat write of an endpoint decoder to targetN Alison Schofield
2026-11-03 17:07 ` [PATCH v4 2/2] cxl/Documentation: Describe clearing a region targetN position Alison Schofield
2026-11-03 23:07 ` Dave Jiang [this message]
2026-11-04 3:19 ` Alison Schofield
2026-11-03 21:27 ` [PATCH v4 1/2] cxl/region: Reject a repeat write of an endpoint decoder to targetN Cheatham, Benjamin
2026-11-03 23:06 ` Dave Jiang
2026-11-11 19:47 ` Jonathan Cameron
2026-11-16 22:12 ` Dave Jiang
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=c93ac992-a797-4779-b618-c2a5d4e03288@intel.com \
--to=dave.jiang@intel.com \
--cc=alison.schofield@intel.com \
--cc=dave@stgolabs.net \
--cc=icheng@nvidia.com \
--cc=iweiny@kernel.org \
--cc=jic23@kernel.org \
--cc=linux-cxl@vger.kernel.org \
--cc=ming.li@zohomail.com \
--cc=vishal.l.verma@intel.com \
/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