Linux CXL
 help / color / mirror / Atom feed
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


  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