1CXL-UPDATE-FIRMWAR(1)                                    CXL-UPDATE-FIRMWAR(1)
2
3
4

NAME

6       cxl-update-firmware - update the firmware on a CXL memdev
7

SYNOPSIS

9       cxl update-firmware <mem0> [<mem1>..<memN>] [<options>]
10

DESCRIPTION

12       Update the firmware on one or more CXL mem devices. The mem devices
13       must support the set of firmware related mailbox commands.
14
15       This command doesn’t directly issue the transfer / activate firmware
16       mailbox commands. Instead, the kernel’s firmware loader facility is
17       used to provide the kernel with the data, and the kernel handles
18       performing the actual update while also managing time slicing the
19       transfer w.r.t. other background commands.
20

EXAMPLE

22           # cxl update-firmware mem0 -F firmware.bin -w
23           [
24             {
25               "memdev":"mem0",
26               "pmem_size":1073741824,
27               "ram_size":1073741824,
28               "serial":0,
29               "numa_node":0,
30               "host":"cxl_mem.0",
31               "firmware":{
32                 "num_slots":3,
33                 "active_slot":2,
34                 "online_activate_capable":false,
35                 "slot_1_version":"cxl_test_fw_001",
36                 "slot_2_version":"cxl_test_fw_002",
37                 "slot_3_version":"cxl_test_new_fw",
38                 "fw_update_in_progress":false
39               }
40             }
41           ]
42           firmware update completed on 1 mem device
43

OPTIONS

45       -b, --bus=
46           Restrict the operation to the specified bus.
47
48       -F, --firmware-file
49           Firmware image file to use for the update.
50
51       -c, --cancel
52           Attempt to abort an in-progress firmware update. This may fail
53           depending on what stage the update process is in.
54
55       -w, --wait
56           By default, the update-firmware command only initiates the firmware
57           update, and returns, while the update operation happens
58           asynchronously in the background. This option makes the firmware
59           update command synchronous by waiting for it to complete before
60           returning.
61
62               If --wait is passed in without an accompanying firmware-file,
63               it will initiate a wait on any current in-progress firmware
64               updates, and then return.
65
66       -v, --verbose
67           Emit more debug messages
68

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

SEE ALSO

76       linkcxl:cxl-list[1],
77
78
79
80                                  08/03/2023             CXL-UPDATE-FIRMWAR(1)
Impressum