1CXL-SET-PARTITION(1)                                      CXL-SET-PARTITION(1)
2
3
4

NAME

6       cxl-set-partition - set the partitioning between volatile and
7       persistent capacity on a CXL memdev
8

SYNOPSIS

10       cxl set-partition <mem0> [ [<mem1>..<memN>] [<options>]
11

DESCRIPTION

13       CXL devices may support both volatile and persistent memory capacity.
14       The amount of device capacity set aside for each type is typically
15       established at the factory, but some devices also allow for dynamic
16       re-partitioning.
17
18       Use this command to partition a device into volatile and persistent
19       capacity. The change in partitioning becomes the “next” configuration,
20       to become active on the next device reset.
21
22       Use "cxl list -m <memdev> -I" to examine the partitioning capabilities
23       of a device. A partition_alignment_size value of zero means there is no
24       available capacity and therefore the partitions cannot be changed.
25
26       Using this command to change the size of the persistent capacity shall
27       result in the loss of data stored.
28

OPTIONS

30       <memory device(s)>
31           A memX device name, or a memdev id number. Restrict the operation
32           to the specified memdev(s). The keyword all can be specified to
33           indicate the lack of any restriction.
34
35       -S, --serial
36           Rather an a memdev id number, interpret the <memdev> argument(s) as
37           a list of serial numbers.
38
39       -b, --bus=
40           Restrict the operation to the specified bus.
41
42       -t, --type=
43           Type of partition, pmem or ram (volatile), to modify. Default: pmem
44
45       -s, --size=
46           Size of the <type> partition in bytes. Size must align to the
47           devices alignment requirement. Use cxl list -m <memdev> -I to find
48           partition_alignment_size, or, use the --align option. Default: All
49           available capacity is assigned to <type>.
50
51       -a, --align
52           Select this option to allow the automatic alignment of --size to
53           meet device alignment requirements. When using this option, specify
54           the minimum --size of the --type partition needed. When this option
55           is omitted, the command fails if --size is not properly aligned.
56           Use cxl list -m <memdev> -I to examine the
57           partition_alignment_size.
58
59       -v
60           Turn on verbose debug messages in the library (if libcxl was built
61           with logging and debug enabled).
62

64       Copyright © 2016 - 2022, Intel Corporation. License GPLv2: GNU GPL
65       version 2 http://gnu.org/licenses/gpl.html. This is free software: you
66       are free to change and redistribute it. There is NO WARRANTY, to the
67       extent permitted by law.
68

SEE ALSO

70       linkcxl:cxl-list[1], CXL-2.0 8.2.9.5.2
71
72
73
74                                  08/03/2023              CXL-SET-PARTITION(1)
Impressum