On Mon, Oct 12, 2026 at 12:57:56PM +0100, Jonathan Cameron wrote:
> On Mon, 12 Oct 2026 12:47:14 +0100
> Jonathan Cameron <[email protected]> wrote:
> 
> > On Sun, 11 Oct 2026 07:54:53 +0900
> > Anisa Su <[email protected]> wrote:
> > 
> > > From: Ira Weiny <[email protected]>
> > > 
> > > Devices which support Dynamic Capacity (DC) are configured via mailbox
> > > commands. CXL r4.0 section 9.13.3 describes the use of the Get DC
> > > Configuration command in order to obtain DCD partition characteristics.
> > > 
> > > Implement the DC mailbox commands as specified in CXL 4.0 section
> > > 8.2.10.9.9 (opcodes 48XXh) to read and store the DCD configuration
> > > information. Disable DCD if an invalid configuration is found.
> > > 
> > > Initial enablement for Linux only supports one dynamic capacity
> > > partition. Read all the partitions the device reports but validate
> > > only the first, and configure it as 'dynamic ram'.
> > > 
> > > The specification requires that volatile capacity starts at DPA 0 and
> > > pmem starts at the DPA immediately following it, but DC partitions only
> > > need to be 256MB aligned according to CXL r4.0 section 8.2.10.9.9.1
> > > Table 8-347. So a device could leave a gap between ram/pmem (static)
> > > capacity and its first DC partition, or between one DC partition and
> > > the next.
> > > 
> > > However, Linux chooses not to support gaps between static and dynamic
> > > capacity, and requires the first DC partition to begin at the DPA
> > > immediately following static capacity.
> > > 
> > > Based on an original patch by Navneet Singh.
> > > 
> > > Signed-off-by: Ira Weiny <[email protected]>
> > > Co-developed-by: Anisa Su <[email protected]>
> > > Signed-off-by: Anisa Su <[email protected]>
> > > Tested-by: Wonjae Lee <[email protected]>
> > > Tested-by: Junhee Park <[email protected]>
> > > Tested-by: Heesoo Kim <[email protected]>
> > >   
> > 
> > A couple of things inline.  Only one that matters I think is the
> > cleanup.h fragility  / readability thing about constructors and 
> > destructors needing to be near each other.  That bit of guidance
> > came from a specific (and I think correct) comment from Linus
> > that he really wanted them together and if that meant declaring
> > the variables inline rather than in old school c style, then so be
> > it.  That might be in category of things Dave could cleanup up whilst
> > applying if all else is ready but that's up to him.
> >
> Forgot to add, with that tweak
> 
> Reviewed-by: Jonathan Cameron <[email protected]>
>  
> > Jonathan
> > 
> > 
> > > diff --git a/drivers/cxl/core/mbox.c b/drivers/cxl/core/mbox.c
> > > index 199bb986d674..72af23ba288e 100644
> > > --- a/drivers/cxl/core/mbox.c
> > > +++ b/drivers/cxl/core/mbox.c  
> > 
> > > +/* Returns the number of partitions in dc_resp or -ERRNO */
> > > +static int cxl_get_dc_config(struct cxl_mailbox *mbox, u8 
> > > start_partition,
> > > +                      u8 partition_count,
> > > +                      struct cxl_mbox_get_dc_config_out *dc_resp,
> > > +                      size_t dc_resp_size)
> > > +{
> > > + struct cxl_mbox_get_dc_config_in get_dc = (struct 
> > > cxl_mbox_get_dc_config_in) {
> > > +         .partition_count = partition_count,
> > > +         .start_partition_index = start_partition,
> > > + };
> > > + struct cxl_mbox_cmd mbox_cmd = (struct cxl_mbox_cmd) {
> > > +         .opcode = CXL_MBOX_OP_GET_DC_CONFIG,
> > > +         .payload_in = &get_dc,
> > > +         .size_in = sizeof(get_dc),
> > > +         .size_out = dc_resp_size,
> > > +         .payload_out = dc_resp,
> > > +         /* The device must return at least the fixed header */
> > > +         .min_out = sizeof(*dc_resp),
> > > + };
> > > + size_t expected_sz;
> > > + int rc;
> > > +
> > > + rc = cxl_internal_send_cmd(mbox, &mbox_cmd);
> > > + if (rc < 0)
> > > +         return rc;
> > > +
> > > + if (dc_resp->partitions_returned > partition_count) {
> > > +         dev_err(mbox->host, "Device returned %u partitions, requested 
> > > %u\n",
> > > +                 dc_resp->partitions_returned, partition_count);
> > > +         return -EIO;
> > > + }
> > > +
> > > + /* The trailing extent/tag counts (CXL r4.0 Table 8-346) are not read */
> > > + expected_sz = struct_size(dc_resp, partition,
> > > +                           dc_resp->partitions_returned);
> > > +
> > > + if (mbox_cmd.size_out < expected_sz) {
> > > +         dev_err(mbox->host,
> > > +                 "Payload size %zu less than expected %zu for %u 
> > > partitions\n",
> > > +                 mbox_cmd.size_out,
> > > +                 expected_sz,
> > > +                 dc_resp->partitions_returned);  
> > 
> > Not important, but if you do end up respinning, maybe don't have one 
> > parameter per line.
> > To me it doesn't really help with readability here.
> > 
> > > +         return -EIO;
> > > + }
> > > +
> > > +/**
> > > + * cxl_dev_dc_identify() - Reads the dynamic capacity information from 
> > > the
> > > + *                         device.
> > > + * @mbox: Mailbox to query
> > > + * @dc_info: The dynamic partition information to return
> > > + *
> > > + * Read every partition the device reports, but validate only the first:
> > > + * Linux maps partition 0 and nothing else, so a defect in capacity the
> > > + * driver never touches is not a reason to refuse the device dynamic
> > > + * capacity.  The remaining partitions are read but not recorded.
> > > + *
> > > + * Return: 0 if identify was executed successfully, -ERRNO on error.
> > > + *         On error, @dc_info is left unchanged.
> > > + */
> > > +int cxl_dev_dc_identify(struct cxl_mailbox *mbox,
> > > +                 struct cxl_dc_partition_info *dc_info)
> > > +{
> > > + struct cxl_dc_partition_info partitions[CXL_MAX_DC_PARTITIONS] = { };
> > > + struct cxl_mbox_get_dc_config_out *dc_resp __free(kfree) = NULL;  
> > 
> > See the cleanup.h guidance.  This needs to move.
> > 
> > > + struct device *dev = mbox->host;
> > > + u8 avail_partitions = 0;
> > > + u8 start_partition;
> > > + u8 num_partitions;
> > > + u8 partition_count;
> > > + size_t dc_resp_size;
> > > +
> > > + /*
> > > +  * Bound requested number of partitions by mailbox payload size. The
> > > +  * 256 byte spec minimum, verified in cxl_pci_setup_mailbox(), keeps
> > > +  * the subtraction below from underflowing.
> > > +  */
> > > + partition_count = min(CXL_MAX_DC_PARTITIONS,
> > > +                       (mbox->payload_size - sizeof(*dc_resp) -
> > > +                        sizeof(struct cxl_mbox_get_dc_config_tail)) /
> > > +                       sizeof(struct cxl_dc_partition));
> > > + dc_resp_size = struct_size(dc_resp, partition, partition_count) +
> > > +                sizeof(struct cxl_mbox_get_dc_config_tail);
> > > +  
> > 
> >     struct cxl_mbox_get_dc_config_out *dc_resp __free(kfree) =
> >             kmalloc(dc_resp_size, GFP_KERNEL);
> >     if (!dc_resp)
> > 
> > Maybe if everything else is fine, Dave can tweak this whilst applying.
> > 
> > star> +     if (!dc_resp)
> > > +         return -ENOMEM;
> > > +
> > > + start_partition = 0;
> > > + num_partitions = 0;
> > > + do {
> > > +         int returned, rc;
> > > +
> > > +         returned = cxl_get_dc_config(mbox, start_partition,
> > > +                                      partition_count, dc_resp,
> > > +                                      dc_resp_size);
> > > +         if (returned < 0) {
> > > +                 dev_err(dev, "Failed to get DC config: %d\n", returned);
> > > +                 return returned;
> > > +         }
> > > +
> > > +         if (returned == 0) {
> > > +                 dev_err(dev,
> > > +                         "Device reported %u partitions available but 
> > > returned none at index %u\n",
> > > +                         dc_resp->avail_partition_count, 
> > > start_partition);
> > > +                 return -EIO;
> > > +         }
> > > +
> > > +         /* A DCD reports at least one partition (CXL r4.0 Table 8-346) 
> > > */
> > > +         if (dc_resp->avail_partition_count == 0) {
> > > +                 dev_err(dev, "Device reported no DC partitions\n");
> > > +                 return -EIO;
> > > +         }
> > > +
> > > +         avail_partitions = min(dc_resp->avail_partition_count,
> > > +                                CXL_MAX_DC_PARTITIONS);
> > > +
> > > +         /*
> > > +          * Only partition 0 is mapped, so it is the only one checked.
> > > +          * The rest are read to complete the enumeration and dropped.
> > > +          */
> > > +         if (start_partition == 0) {
> > > +                 rc = cxl_dc_check(dev, &partitions[0],
> > > +                                   &dc_resp->partition[0]);
> > > +                 if (rc)
> > > +                         return rc;
> > > +         }
> > > +
> > > +         num_partitions += returned;
> > > +         start_partition = num_partitions;  
> > 
> > I may be missing something subtle, but do start_partition and 
> > num_partitions ever
> > differ in value? Far as I can spot they are both only updated here.  If they
> > change in later patches and this is churn reduction ignore this comment!
> > 
Oh oops. I didn't clean up properly.
We used to copy each partition into a local array in batches:
                
        num_partitions += rc;
        for (i = start_partition, j = 0; i < num_partitions; i++, j++) {
                rc = cxl_dc_check(dev, partitions, i,
                                  &dc_resp->partition[j]);
                if (rc)
                        return rc;
        }
        start_partition = num_partitions;

But now we only validate the first, so it's no longer necessary. I removed the
loop but didn't clean up start_partitions/num_partitions.

Dave helped clean this up including the others you mentioned.

Thanks,
Anisa

> > 
> > > +
> > > + } while (num_partitions < avail_partitions);
> > > +
> > > + /* Linux only supports the 1st partition; nothing to do if it is 
> > > unavailable */
> > > + if (partitions[0].size == 0)
> > > +         return -ENODEV;
> > > +
> > > + *dc_info = partitions[0];
> > > + dev_dbg(dev, "Returning partition 0 %#llx size %#llx\n",
> > > +         dc_info->start, dc_info->size);
> > > +
> > > + return 0;
> > > +}
> > > +EXPORT_SYMBOL_NS_GPL(cxl_dev_dc_identify, "CXL");  
> > 
> 

Reply via email to