CXL-CREATE-REGION(1)              cxl Manual              CXL-CREATE-REGION(1)

<?><?><?> (NAME)
       cxl-create-region - <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> CXL <?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> CXL <?><?><?><?><?><?><?><?><?><?><?>

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       cxl create-region [<options>]

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?> <?><?><?><?><?> CXL <?><?> <?><?> <?><?> <?><?><?> <?><?><?><?>
       (slice) <?><?> memdev<?><?><?> CXL <?><?><?><?><?> <?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> (interleave)
       <?><?><?><?><?><?><?><?><?><?><?><?><?> - <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> (interleave
       ways) <?> <?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> (interleave granularity).

       <?><?><?><?> create-region<?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?> <?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?>
       memdev <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
       (decode capacity) <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>. <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> (persistent regions)<?>
       <?><?><?><?><?><?><?> <?><?> UUID <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>.

       <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?> JSON <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> (stdout) <?><?><?><?> <?><?><?><?><?><?>
       (<?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>).
       <?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?> (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)>
           <?><?><?><?><?><?><?> CXL <?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>.
           <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> target
           <?><?><?><?> <?><?> <?><?><?><?><?> --ways (<?><?> <?><?><?><?>
           <?><?><?><?><?>) <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>.

       -b, --bus=
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>
           <?><?><?><?><?><?> (bus) <?><?><?><?><?><?><?><?>.

       -m, --memdevs
           <?><?><?><?> <?><?><?><?><?><?> <?><?>
           <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
           <?><?><?><?> target(s) <?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?> memdev <?><?><?><?><?>
           <?><?><?><?><?>. <?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?>
           <?><?><?> <?> <?><?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?> create-region <?><?> <?><?><?> <?><?><?><?><?>
           <?><?> <?><?><?><?><?> cxl list -M -d $decoder <?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?><?>. <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
           <?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>
           <?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?>
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?>
           <?><?><?><?><?><?> <?><?><?>.

       -s, --size=
           <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?><?><?>. <?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?> <?> <?><?> <?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>.
           <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?> <?><?><?><?> <?> <?><?><?><?><?><?> HPA
           <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
           (root decoder) <?> <?><?><?><?><?><?> <?><?><?><?> DPA <?><?>
           <?><?><?><?><?> <?><?> memdev<?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?>.

       -t, --type=
           <?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?> - pmem <?><?>
           ram. <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
           <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?> <?> <?><?> <?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?> pmem <?><?><?><?><?>
           <?><?><?>.

       -U, --uuid=
           <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
           (UUID) <?><?><?><?> <?><?><?><?><?> <?><?><?><?>.
           <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?> <?><?> <?><?>
           <?><?><?> <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?>. <?><?><?> <?><?><?><?><?> <?><?><?><?>
           <?><?><?><?> <?><?><?><?><?> pmem <?><?><?><?><?><?> <?><?><?><?>.

       -w, --ways=
           <?><?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>.
           <?><?> <?><?><?><?> <?><?><?><?><?> --memdevs<?> <?><?><?>
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
           memdev<?><?><?> <?><?><?><?><?><?><?><?> <?><?> --memdevs
           <?><?><?><?>. <?><?><?> --ways <?><?><?><?> <?><?><?><?><?> <?><?>
           <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> memdev
           <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>.

       -g, --granularity=
           <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
           (interleave granularity) <?><?><?><?> <?><?><?><?><?> <?><?><?><?>.
           <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?> <?><?><?><?><?><?><?><?><?><?> (<?><?> <?><?><?><?>
           <?><?><?><?><?>) <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>.
           <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?> <?><?>
           <?><?> <?><?> <?><?><?><?><?><?> (host-bridge)
           <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>
           <?><?><?><?><?> <?><?><?><?> <?><?> <?><?>
           <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?>. <?><?> <?><?><?> <?><?><?> <?><?><?><?><?>
           <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?>
           <?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
           <?><?><?><?> <?><?><?> <?><?> <?><?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?>.

       -d, --decoder=
           <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?> <?><?><?>. <?><?>
           <?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?> (cross-
           host bridge) <?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?>
           <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?> <?><?>.

       -Q, --enforce-qos
           <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
           <?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?> qos_class. <?><?><?>
           qos_class <?><?><?><?><?> <?><?><?><?> <?> <?><?><?> <?><?>
           memdev<?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?>.

       -u, --human
           <?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>. <?><?>
           <?><?><?> <?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?> <?><?><?><?>
           <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
           <?><?>.

       --debug
           <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>.

<?><?> <?><?><?> (COPYRIGHT)
       Copyright (C) 2016 - 2022, Intel Corporation. License GPLv2: GNU GPL
       version 2  <http://gnu.org/licenses/gpl.html>.  <?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?>: <?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?> <?> <?><?><?><?><?> <?><?><?><?>
       <?><?> <?><?><?><?><?>. <?><?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?>.

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       cxl-list(1)

cxl                               2026-06-30              CXL-CREATE-REGION(1)