Vishal Verma wrote:
> Add a 'create-region' command to cxl-cli that walks the platform's CXL
> hierarchy to find an appropriate root decoder based on any options
> provided, and uses libcxl APIs to create a 'region' that is comprehended
> by libnvdimm and ndctl.
>
> Cc: Dan Williams <[email protected]>
> Signed-off-by: Vishal Verma <[email protected]>
> ---
> Documentation/cxl/cxl-create-region.txt | 111 +++++
> Documentation/cxl/region-description.txt | 7 +
> cxl/builtin.h | 1 +
> cxl/filter.h | 4 +-
> cxl/cxl.c | 1 +
> cxl/region.c | 527 +++++++++++++++++++++++
> Documentation/cxl/meson.build | 2 +
> cxl/meson.build | 1 +
> 8 files changed, 653 insertions(+), 1 deletion(-)
> create mode 100644 Documentation/cxl/cxl-create-region.txt
> create mode 100644 Documentation/cxl/region-description.txt
> create mode 100644 cxl/region.c
>
> diff --git a/Documentation/cxl/cxl-create-region.txt
> b/Documentation/cxl/cxl-create-region.txt
> new file mode 100644
> index 0000000..d91d76a
> --- /dev/null
> +++ b/Documentation/cxl/cxl-create-region.txt
> @@ -0,0 +1,111 @@
> +// SPDX-License-Identifier: GPL-2.0
> +
> +cxl-create-region(1)
> +====================
> +
> +NAME
> +----
> +cxl-create-region - Assemble a CXL region by setting up attributes of its
> +constituent CXL memdevs.
> +
> +SYNOPSIS
> +--------
> +[verse]
> +'cxl create-region [<options>]'
> +
> +include::region-description.txt[]
> +
> +For create-region, a size can optionally be specified, but if not, the
> maximum
> +possible size for each memdev will be used up to the available decode
> capacity
> +in the system for the given memory type. For persistent regions a UUID can
> +optionally be specified, but if not, one will be generated.
> +
> +If the region-creation operation is successful, a region object will be
> +emitted on stdout in JSON format (see examples). If the specified arguments
> +cannot be satisfied with a legal configuration, then an appropriate error
> will
> +be emitted on stderr.
> +
> +EXAMPLE
> +-------
> +----
> +# cxl create-region -m -d decoder0.1 -w 2 -g 1024 mem0 mem1
> +{
> + "region":"region0",
> + "resource":"0xc90000000",
> + "size":"512.00 MiB (536.87 MB)",
> + "interleave_ways":2,
> + "interleave_granularity":1024,
> + "mappings":[
> + {
> + "position":1,
> + "decoder":"decoder4.0"
> + },
> + {
> + "position":0,
> + "decoder":"decoder3.0"
> + }
> + ]
> +}
> +created 1 region
> +----
> +
> +OPTIONS
> +-------
> +<target(s)>::
> +The CXL targets that should be used to form the region. This is optional,
> +as they can be chosen automatically based on other options chosen. The
> number of
> +'target' arguments must match the '--interleave-ways' option (if provided).
> The
> +targets may be memdevs, or endpoints. The options below control what type of
> +targets are being used.
> +
> +-m::
> +--memdevs::
> + Indicate that the non-option arguments for 'target(s)' refer to memdev
> + names.
> +
> +-e::
> +--ep-decoders::
> + Indicate that the non-option arguments for 'target(s)' refer to endpoint
> + decoder names.
> +
> +-s::
> +--size=::
> + Specify the total size for the new region. This is optional, and by
> + default, the maximum possible size will be used.
> +
> +-t::
> +--type=::
> + Specify the region type - 'pmem' or 'ram'. Defaults to 'pmem'.
> +
> +-U::
> +--uuid=::
> + Specify a UUID for the new region. This shouldn't usually need to be
> + specified, as one will be generated by default.
> +
> +-w::
> +--interleave-ways=::
> + The number of interleave ways for the new region's interleave. This
> + should be equal to the number of memdevs specified in --memdevs, if
> + --memdevs is being supplied. If --memdevs is not specified, an
> + appropriate number of memdevs will be chosen based on the number of
> + interleave-ways specified.
> +
> +-g::
> +--interleave-granularity=::
> + The interleave granularity, for the new region's interleave.
> +
> +-d::
> +--decoder=::
> + The root decoder that the region should be created under. If not
> + supplied, the first cross-host bridge (if available), decoder that
> + supports the largest interleave will be chosen.
> +
> +include::human-option.txt[]
> +
> +include::debug-option.txt[]
> +
> +include::../copyright.txt[]
> +
> +SEE ALSO
> +--------
> +linkcxl:cxl-list[1],
> diff --git a/Documentation/cxl/region-description.txt
> b/Documentation/cxl/region-description.txt
> new file mode 100644
> index 0000000..d7e3077
> --- /dev/null
> +++ b/Documentation/cxl/region-description.txt
> @@ -0,0 +1,7 @@
> +// SPDX-License-Identifier: GPL-2.0
> +
> +DESCRIPTION
> +-----------
> +A CXL region is composed of one or more slices of CXL memdevs, with
> configurable
> +interleave settings - both the number of interleave ways, and the interleave
> +granularity.
> diff --git a/cxl/builtin.h b/cxl/builtin.h
> index 9e6fc62..843bada 100644
> --- a/cxl/builtin.h
> +++ b/cxl/builtin.h
> @@ -18,4 +18,5 @@ int cmd_disable_port(int argc, const char **argv, struct
> cxl_ctx *ctx);
> int cmd_enable_port(int argc, const char **argv, struct cxl_ctx *ctx);
> int cmd_set_partition(int argc, const char **argv, struct cxl_ctx *ctx);
> int cmd_disable_bus(int argc, const char **argv, struct cxl_ctx *ctx);
> +int cmd_create_region(int argc, const char **argv, struct cxl_ctx *ctx);
> #endif /* _CXL_BUILTIN_H_ */
> diff --git a/cxl/filter.h b/cxl/filter.h
> index 609433c..d22d8b1 100644
> --- a/cxl/filter.h
> +++ b/cxl/filter.h
> @@ -35,8 +35,10 @@ struct cxl_memdev *util_cxl_memdev_filter(struct
> cxl_memdev *memdev,
> struct cxl_port *util_cxl_port_filter_by_memdev(struct cxl_port *port,
> const char *ident,
> const char *serial);
> -struct cxl_region *util_cxl_region_filter(struct cxl_region *region,
> +struct cxl_decoder *util_cxl_decoder_filter(struct cxl_decoder *decoder,
> const char *__ident);
> +struct cxl_region *util_cxl_region_filter(struct cxl_region *region,
> + const char *__ident);
>
> enum cxl_port_filter_mode {
> CXL_PF_SINGLE,
> diff --git a/cxl/cxl.c b/cxl/cxl.c
> index ef4cda9..f0afcfe 100644
> --- a/cxl/cxl.c
> +++ b/cxl/cxl.c
> @@ -72,6 +72,7 @@ static struct cmd_struct commands[] = {
> { "enable-port", .c_fn = cmd_enable_port },
> { "set-partition", .c_fn = cmd_set_partition },
> { "disable-bus", .c_fn = cmd_disable_bus },
> + { "create-region", .c_fn = cmd_create_region },
> };
>
> int main(int argc, const char **argv)
> diff --git a/cxl/region.c b/cxl/region.c
> new file mode 100644
> index 0000000..9fe99b2
> --- /dev/null
> +++ b/cxl/region.c
> @@ -0,0 +1,527 @@
> +// SPDX-License-Identifier: GPL-2.0
> +/* Copyright (C) 2020-2022 Intel Corporation. All rights reserved. */
> +#include <stdio.h>
> +#include <errno.h>
> +#include <stdlib.h>
> +#include <unistd.h>
> +#include <limits.h>
> +#include <util/log.h>
> +#include <uuid/uuid.h>
> +#include <util/json.h>
> +#include <util/size.h>
> +#include <cxl/libcxl.h>
> +#include <json-c/json.h>
> +#include <util/parse-options.h>
> +#include <ccan/minmax/minmax.h>
> +#include <ccan/short_types/short_types.h>
> +
> +#include "filter.h"
> +#include "json.h"
> +
> +static struct region_params {
> + const char *size;
> + const char *ways;
> + const char *granularity;
> + const char *type;
> + const char *root_decoder;
> + const char *region;
> + bool memdevs;
> + bool ep_decoders;
> + bool force;
> + bool human;
> + bool debug;
> +} param;
> +
> +struct parsed_params {
> + u64 size;
> + u64 ep_min_size;
> + unsigned int ways;
> + unsigned int granularity;
> + const char **targets;
> + int num_targets;
> + struct cxl_decoder *root_decoder;
> + enum cxl_decoder_mode mode;
> +};
> +
> +enum region_actions {
> + ACTION_CREATE,
> +};
> +
> +static struct log_ctx rl;
> +
> +#define BASE_OPTIONS() \
> +OPT_STRING('d', "decoder", ¶m.root_decoder, "root decoder name", \
> + "Limit to / use the specified root decoder"), \
> +OPT_BOOLEAN(0, "debug", ¶m.debug, "turn on debug")
> +
> +#define CREATE_OPTIONS() \
> +OPT_STRING('s', "size", ¶m.size, \
> + "size in bytes or with a K/M/G etc. suffix", \
> + "total size desired for the resulting region."), \
> +OPT_STRING('w', "interleave-ways", ¶m.ways, \
> + "number of interleave ways", \
> + "number of memdevs participating in the regions interleave set"), \
> +OPT_STRING('g', "interleave-granularity", \
I think it's ok to drop 'interleave-' out of these 2 options.
> + ¶m.granularity, "interleave granularity", \
> + "granularity of the interleave set"), \
> +OPT_STRING('t', "type", ¶m.type, \
> + "region type", "region type - 'pmem' or 'ram'"), \
> +OPT_BOOLEAN('m', "memdevs", ¶m.memdevs, \
> + "non-option arguments are memdevs"), \
> +OPT_BOOLEAN('e', "ep-decoders", ¶m.ep_decoders, \
> + "non-option arguments are endpoint decoders"), \
> +OPT_BOOLEAN('u', "human", ¶m.human, "use human friendly number formats")
> +
> +static const struct option create_options[] = {
> + BASE_OPTIONS(),
> + CREATE_OPTIONS(),
> + OPT_END(),
> +};
> +
> +
> +
> +static int parse_create_options(int argc, const char **argv,
> + struct parsed_params *p)
> +{
> + int i;
> +
> + if (!param.root_decoder) {
> + log_err(&rl, "no root decoder specified\n");
> + return -EINVAL;
> + }
> +
> + if (param.type) {
> + if (strcmp(param.type, "ram") == 0)
> + p->mode = CXL_DECODER_MODE_RAM;
> + else if (strcmp(param.type, "volatile") == 0)
> + p->mode = CXL_DECODER_MODE_RAM;
> + else if (strcmp(param.type, "pmem") == 0)
> + p->mode = CXL_DECODER_MODE_PMEM;
Follow-on cleanup opportunity to have a string-mode-helper alongside
cxl_decoder_mode_name() as this same pattern appears in
add_cxl_decoder() and __reserve_dpa().
> + else {
> + log_err(&rl, "unsupported type: %s\n", param.type);
> + return -EINVAL;
> + }
> + } else
> + p->mode = CXL_DECODER_MODE_PMEM;
> +
> + if (param.size) {
> + p->size = parse_size64(param.size);
> + if (p->size == ULLONG_MAX) {
> + log_err(&rl, "Invalid size: %s\n", param.size);
> + return -EINVAL;
> + }
> + }
> +
> + if (param.ways) {
> + unsigned long ways = strtoul(param.ways, NULL, 0);
> +
> + if (ways == ULONG_MAX || (int)ways <= 0) {
> + log_err(&rl, "Invalid interleave ways: %s\n",
> + param.ways);
> + return -EINVAL;
> + }
> + p->ways = ways;
> + } else if (argc) {
> + p->ways = argc;
> + } else {
> + log_err(&rl,
> + "couldn't determine interleave ways from options or
> arguments\n");
> + return -EINVAL;
> + }
> +
> + if (param.granularity) {
> + unsigned long granularity = strtoul(param.granularity, NULL, 0);
> +
> + if (granularity == ULONG_MAX || (int)granularity <= 0) {
> + log_err(&rl, "Invalid interleave granularity: %s\n",
> + param.granularity);
> + return -EINVAL;
> + }
> + p->granularity = granularity;
> + }
> +
> +
> + if (argc > (int)p->ways) {
> + for (i = p->ways; i < argc; i++)
> + log_err(&rl, "extra argument: %s\n", p->targets[i]);
> + return -EINVAL;
> + }
> +
> + if (argc < (int)p->ways) {
> + log_err(&rl,
> + "too few target arguments (%d) for interleave ways
> (%u)\n",
> + argc, p->ways);
> + return -EINVAL;
> + }
> +
> + if (p->size && p->ways) {
> + if (p->size % p->ways) {
> + log_err(&rl,
> + "size (%lu) is not an integral multiple of
> interleave-ways (%u)\n",
> + p->size, p->ways);
> + return -EINVAL;
> + }
> + }
> +
> + return 0;
> +}
> +
> +static int parse_region_options(int argc, const char **argv,
> + struct cxl_ctx *ctx, enum region_actions action,
> + const struct option *options,
> + struct parsed_params *p, const char *usage)
> +{
> + const char * const u[] = {
> + usage,
> + NULL
> + };
> +
> + argc = parse_options(argc, argv, options, u, 0);
clang-format escape?
> + p->targets = argv;
> + p->num_targets = argc;
> +
> + if (param.debug) {
> + cxl_set_log_priority(ctx, LOG_DEBUG);
> + rl.log_priority = LOG_DEBUG;
> + } else
> + rl.log_priority = LOG_INFO;
> +
> + switch(action) {
> + case ACTION_CREATE:
> + return parse_create_options(argc, argv, p);
> + default:
> + return 0;
> + }
> +}
> +
> +static bool memdev_match_set_size(struct cxl_memdev *memdev, const char
> *target,
> + struct parsed_params *p)
> +{
> + const char *devname = cxl_memdev_get_devname(memdev);
> + u64 size = cxl_memdev_get_pmem_size(memdev);
Since the type option exists should this be gated by that now? Otherwise
just a reminder of a place to fixup when volatile region provisioning
arrives.
> +
> + if (strcmp(devname, target) != 0)
> + return false;
> +
> + size = cxl_memdev_get_pmem_size(memdev);
Hmm double-init? It was already retrieved above.
> + if (!p->ep_min_size)
> + p->ep_min_size = size;
> + else
> + p->ep_min_size = min(p->ep_min_size, size);
> +
> + return true;
> +}
> +
> +static int validate_config_memdevs(struct cxl_ctx *ctx, struct parsed_params
> *p)
> +{
> + unsigned int i, matched = 0;
> +
> + for (i = 0; i < p->ways; i++) {
> + struct cxl_memdev *memdev;
> +
> + cxl_memdev_foreach(ctx, memdev)
> + if (memdev_match_set_size(memdev, p->targets[i], p))
I am not sure memdev_match_set_size() is named properly for what it is
doing. It's also scanning for a min size? I think I'm just missing a
comment about where memdev_match_set_size() fits into the flow.
> + matched++;
> + }
> + if (matched != p->ways) {
> + log_err(&rl,
> + "one or more memdevs not found in CXL topology\n");
> + return -ENXIO;
> + }
> +
> + return 0;
> +}
> +
> +static int validate_config_ep_decoders(struct cxl_ctx *ctx,
> + struct parsed_params *p)
> +{
> + unsigned int i;
> +
> + for (i = 0; i < p->ways; i++) {
> + struct cxl_decoder *decoder;
> + struct cxl_memdev *memdev;
> +
> + decoder = cxl_decoder_get_by_name(ctx, p->targets[i]);
> + if (!decoder) {
> + log_err(&rl, "%s not found in CXL topology\n",
> + p->targets[i]);
> + return -ENXIO;
> + }
> +
> + memdev = cxl_ep_decoder_get_memdev(decoder);
> + if (!memdev) {
> + log_err(&rl, "could not get memdev from %s\n",
> + p->targets[i]);
> + return -ENXIO;
> + }
> +
> + if (!memdev_match_set_size(memdev,
> + cxl_memdev_get_devname(memdev), p))
> + return -ENXIO;
> + }
> +
> + return 0;
> +}
> +
> +static int validate_decoder(struct cxl_decoder *decoder,
> + struct parsed_params *p)
> +{
> + const char *devname = cxl_decoder_get_devname(decoder);
> +
> + switch(p->mode) {
> + case CXL_DECODER_MODE_RAM:
> + if (!cxl_decoder_is_volatile_capable(decoder)) {
> + log_err(&rl, "%s is not volatile capable\n", devname);
> + return -EINVAL;
> + }
> + break;
> + case CXL_DECODER_MODE_PMEM:
> + if (!cxl_decoder_is_pmem_capable(decoder)) {
> + log_err(&rl, "%s is not pmem capable\n", devname);
> + return -EINVAL;
> + }
> + break;
> + default:
> + log_err(&rl, "unknown type: %s\n", param.type);
> + return -EINVAL;
> + }
> +
> + /* TODO check if the interleave config is possible under this decoder */
> +
> + return 0;
> +}
> +
> +static int create_region_validate_config(struct cxl_ctx *ctx,
> + struct parsed_params *p)
> +{
> + struct cxl_bus *bus;
> + int rc;
> +
> + cxl_bus_foreach(ctx, bus) {
> + struct cxl_decoder *decoder;
> + struct cxl_port *port;
> +
> + port = cxl_bus_get_port(bus);
> + if (!cxl_port_is_root(port))
> + continue;
> +
> + cxl_decoder_foreach (port, decoder) {
> + if (util_cxl_decoder_filter(decoder,
> + param.root_decoder)) {
> + p->root_decoder = decoder;
> + goto found;
> + }
> + }
> + }
> +
> +found:
> + if (p->root_decoder == NULL) {
> + log_err(&rl, "%s not found in CXL topology\n",
> + param.root_decoder);
> + return -ENXIO;
> + }
> +
> + rc = validate_decoder(p->root_decoder, p);
> + if (rc)
> + return rc;
> +
> + if (param.memdevs)
> + return validate_config_memdevs(ctx, p);
> +
> + return validate_config_ep_decoders(ctx, p);
> +}
> +
> +static struct cxl_decoder *
> +cxl_memdev_target_find_decoder(struct cxl_ctx *ctx, const char *memdev_name)
> +{
> + struct cxl_endpoint *ep = NULL;
> + struct cxl_decoder *decoder;
> + struct cxl_memdev *memdev;
> + struct cxl_port *port;
> +
> + cxl_memdev_foreach(ctx, memdev) {
> + const char *devname = cxl_memdev_get_devname(memdev);
> +
> + if (strcmp(devname, memdev_name) != 0)
> + continue;
> +
> + ep = cxl_memdev_get_endpoint(memdev);
> + }
> +
> + if (!ep) {
> + log_err(&rl, "could not get an endpoint for %s\n",
> + memdev_name);
> + return NULL;
> + }
> +
> + port = cxl_endpoint_get_port(ep);
> + if (!port) {
> + log_err(&rl, "could not get a port for %s\n",
> + memdev_name);
> + return NULL;
> + }
> +
> + cxl_decoder_foreach(port, decoder)
> + if (cxl_decoder_get_size(decoder) == 0)
> + return decoder;
> +
> + log_err(&rl, "could not get a free decoder for %s\n", memdev_name);
> + return NULL;
> +}
> +
> +#define try(prefix, op, dev, p) \
> +do { \
> + int __rc = prefix##_##op(dev, p); \
> + if (__rc) { \
> + log_err(&rl, "%s: " #op " failed: %s\n", \
> + prefix##_get_devname(dev), \
> + strerror(abs(__rc))); \
> + rc = __rc; \
> + goto err_delete; \
> + } \
> +} while (0)
> +
> +static int create_region(struct cxl_ctx *ctx, int *count,
> + struct parsed_params *p)
> +{
> + unsigned long flags = UTIL_JSON_TARGETS;
> + struct json_object *jregion;
> + unsigned int i, granularity;
> + struct cxl_region *region;
> + const char *devname;
> + uuid_t uuid;
> + u64 size;
> + int rc;
> +
> + rc = create_region_validate_config(ctx, p);
> + if (rc)
> + return rc;
> +
> + if (p->size) {
> + size = p->size;
> + } else if (p->ep_min_size) {
> + size = p->ep_min_size * p->ways;
Here is where it would help to pre-validate that the requested size is
<= the available root decoder capacity and <= the max available extent.
I also wonder if it is worth augmenting all checks with a --force
override to give the option of "yes, I expect the kernel will reject
this, but lets try and see if the kernel actually does". That can be
another item for the backlog.
> + } else {
> + log_err(&rl, "%s: unable to determine region size\n", __func__);
> + return -ENXIO;
> + }
> +
> + if (p->mode == CXL_DECODER_MODE_PMEM) {
> + region = cxl_decoder_create_pmem_region(p->root_decoder);
> + if (!region) {
> + log_err(&rl, "failed to create region under %s\n",
> + param.root_decoder);
> + return -ENXIO;
> + }
> + } else {
> + log_err(&rl, "region type '%s' not supported yet\n",
> + param.type);
> + return -EOPNOTSUPP;
> + }
> +
> + devname = cxl_region_get_devname(region);
> +
> + /* Default granularity will be the root decoder's granularity */
> + granularity = cxl_decoder_get_interleave_granularity(p->root_decoder);
> + if (granularity == 0 || granularity == UINT_MAX) {
> + log_err(&rl, "%s: unable to determine root decoder
> granularity\n",
> + devname);
> + return -ENXIO;
> + }
> +
> + /* If the user supplied granularity was > the default, use it instead */
> + if (p->granularity && (p->granularity > granularity))
> + granularity = p->granularity;
Where does this check that the granularity is not smaller than the
region granularity? The kernel, for now, will fail that.
> +
> + uuid_generate(uuid);
> + try(cxl_region, set_interleave_granularity, region, granularity);
> + try(cxl_region, set_interleave_ways, region, p->ways);
> + try(cxl_region, set_size, region, size);
> + try(cxl_region, set_uuid, region, uuid);
> +
> + for (i = 0; i < p->ways; i++) {
> + struct cxl_decoder *ep_decoder = NULL;
> +
> + if (param.ep_decoders) {
> + ep_decoder =
> + cxl_decoder_get_by_name(ctx, p->targets[i]);
> + } else if (param.memdevs) {
> + ep_decoder = cxl_memdev_target_find_decoder(
> + ctx, p->targets[i]);
> + }
> + if (!ep_decoder) {
> + rc = -ENXIO;
> + goto err_delete;
> + }
> + if (cxl_decoder_get_mode(ep_decoder) != p->mode) {
This feels like it wants to be a --force operation rather than silently
fixing up the decoder if it was already set to something else.
> + try(cxl_decoder, set_dpa_size, ep_decoder, 0);
> + try(cxl_decoder, set_mode, ep_decoder, p->mode);
> + }
> + try(cxl_decoder, set_dpa_size, ep_decoder, size/p->ways);
> + rc = cxl_region_set_target(region, i, ep_decoder);
> + if (rc) {
> + log_err(&rl, "%s: failed to set target%d to %s\n",
> + devname, i, p->targets[i]);
> + goto err_delete;
> + }
> + }
> +
> + rc = cxl_region_commit(region);
> + if (rc) {
> + log_err(&rl, "%s: failed to commit: %s\n", devname,
> + strerror(-rc));
> + goto err_delete;
> + }
> +
> + rc = cxl_region_enable(region);
> + if (rc) {
> + log_err(&rl, "%s: failed to enable: %s\n", devname,
> + strerror(-rc));
> + goto err_delete;
> + }
> + *count = 1;
> +
> + if (isatty(1))
> + flags |= UTIL_JSON_HUMAN;
> + jregion = util_cxl_region_to_json(region, flags);
> + if (jregion)
> + printf("%s\n", json_object_to_json_string_ext(jregion,
> + JSON_C_TO_STRING_PRETTY));
> +
> + return 0;
> +
> +err_delete:
> + cxl_region_delete(region);
> + return rc;
> +}
> +
> +static int region_action(int argc, const char **argv, struct cxl_ctx *ctx,
> + enum region_actions action,
> + const struct option *options, struct parsed_params *p,
> + int *count, const char *u)
> +{
> + int rc = -ENXIO;
> +
> + log_init(&rl, "cxl region", "CXL_REGION_LOG");
> + rc = parse_region_options(argc, argv, ctx, action, options, p, u);
> + if (rc)
> + return rc;
> +
> + if (action == ACTION_CREATE)
Missing '{'?
I guess this must be fixed in a later patch?
> + return create_region(ctx, count, p);
> + }
> +
> + return rc;
> +}
> +
> +int cmd_create_region(int argc, const char **argv, struct cxl_ctx *ctx)
> +{
> + const char *u = "cxl create-region <target0> ... [<options>]";
> + struct parsed_params p = { 0 };
> + int rc, count = 0;
> +
> + rc = region_action(argc, argv, ctx, ACTION_CREATE, create_options, &p,
> + &count, u);
> + log_info(&rl, "created %d region%s\n", count, count == 1 ? "" : "s");
> + return rc == 0 ? 0 : EXIT_FAILURE;
> +}
> diff --git a/Documentation/cxl/meson.build b/Documentation/cxl/meson.build
> index 423be90..340cdee 100644
> --- a/Documentation/cxl/meson.build
> +++ b/Documentation/cxl/meson.build
> @@ -23,6 +23,7 @@ filedeps = [
> 'memdev-option.txt',
> 'labels-options.txt',
> 'debug-option.txt',
> + 'region-description.txt',
> ]
>
> cxl_manpages = [
> @@ -39,6 +40,7 @@ cxl_manpages = [
> 'cxl-set-partition.txt',
> 'cxl-reserve-dpa.txt',
> 'cxl-free-dpa.txt',
> + 'cxl-create-region.txt',
> ]
>
> foreach man : cxl_manpages
> diff --git a/cxl/meson.build b/cxl/meson.build
> index d63dcb1..f2474aa 100644
> --- a/cxl/meson.build
> +++ b/cxl/meson.build
> @@ -3,6 +3,7 @@ cxl_src = [
> 'list.c',
> 'port.c',
> 'bus.c',
> + 'region.c',
> 'memdev.c',
> 'json.c',
> 'filter.c',
> --
> 2.36.1
>
