| Message ID | 20210309003540.197600-1-russell.h.weight@intel.com (mailing list archive) |
|---|---|
| Headers | show |
| Series | FPGA Security Manager Class Driver | expand |
Moritz, This and the next patchset apply to today's char-misc-next. However they conflicts with other in flight linux-fpga patchsets. Since I believe these patchsets came first, I think they should have preference. This feature of updating is needed for the basic operation of the fpga. Tom On 3/8/21 4:35 PM, Russ Weight wrote: > The FPGA Security Manager class driver provides a common > API for user-space tools to manage updates for secure FPGA > devices. Device drivers that instantiate the FPGA Security > Manager class driver will interact with a HW secure update > engine in order to transfer new FPGA and BMC images to FLASH so > that they will be automatically loaded when the FPGA card reboots. > > A significant difference between the FPGA Manager and the FPGA > Security Manager is that the FPGA Manager does a live update (Partial > Reconfiguration) to a device whereas the FPGA Security Manager > updates the FLASH images for the Static Region and the BMC so that > they will be loaded the next time the FPGA card boots. Security is > enforced by hardware and firmware. The security manager interacts > with the firmware to initiate an update, pass in the necessary data, > and collect status on the update. > > The n3000bmc-secure driver is the first driver to use the FPGA > Security Manager. This driver was previously submitted in the same > patch set, but has been split out into a separate patch set starting > with V2. Future devices will also make use of this common API for > secure updates. > > In addition to managing secure updates of the FPGA and BMC images, > the FPGA Security Manager update process may also be used to > program root entry hashes and cancellation keys for the FPGA static > region, the FPGA partial reconfiguration region, and the BMC. > The image files are self-describing, and contain a header describing > the image type. > > Secure updates make use of the request_firmware framework, which > requires that image files are accessible under /lib/firmware. A request > for a secure update returns immediately, while the update itself > proceeds in the context of a kernel worker thread. Sysfs files provide > a means for monitoring the progress of a secure update and for > retrieving error information in the event of a failure. > > The API includes a "name" sysfs file to export the name of the parent > driver. It also includes an "update" sub-directory containing files that > that can be used to instantiate and monitor a secure update. > > Changelog v9 -> v10: > - Rebased to 5.12-rc2 next > - Updated Date and KernelVersion in ABI documentation > > Changelog v8 -> v9: > - Rebased patches for 5.11-rc2 > - Updated Date and KernelVersion in ABI documentation > > Changelog v7 -> v8: > - Fixed grammatical error in Documentation/fpga/fpga-sec-mgr.rst > > Changelog v6 -> v7: > - Changed dates in documentation file to December 2020 > - Changed filename_store() to use kmemdup_nul() instead of > kstrndup() and changed the count to not assume a line-return. > > Changelog v5 -> v6: > - Removed sysfs support and documentation for the display of the > flash count, root entry hashes, and code-signing-key cancelation > vectors from the class driver. This information can vary by device > and will instead be displayed by the device-specific parent driver. > > Changelog v4 -> v5: > - Added the devm_fpga_sec_mgr_unregister() function, following recent > changes to the fpga_manager() implementation. > - Changed most of the *_show() functions to use sysfs_emit() > instead of sprintf( > - When checking the return values for functions of type enum > fpga_sec_err err_code, test for FPGA_SEC_ERR_NONE instead of 0 > > Changelog v3 -> v4: > - This driver is generic enough that it could be used for non Intel > FPGA devices. Changed from "Intel FPGA Security Manager" to FPGA > Security Manager" and removed unnecessary references to "Intel". > - Changed: iops -> sops, imgr -> smgr, IFPGA_ -> FPGA_, ifpga_ to fpga_ > Note that this also affects some filenames. > > Changelog v2 -> v3: > - Use dev_err() to report invalid progress in sec_progress() > - Use dev_err() to report invalid error code in sec_error() > - Modified sysfs handler check in check_sysfs_handler() to make > it more readable. > - Removed unnecessary "goto done" > - Added a comment to explain imgr->driver_unload in > ifpga_sec_mgr_unregister() > > Changelog v1 -> v2: > - Separated out the MAX10 BMC Security Engine to be submitted in > a separate patch-set. > - Bumped documentation dates and versions > - Split ifpga_sec_mgr_register() into create() and register() functions > - Added devm_ifpga_sec_mgr_create() > - Added Documentation/fpga/ifpga-sec-mgr.rst > - Changed progress state "read_file" to "reading" > - Added sec_error() function (similar to sec_progress()) > - Removed references to bmc_flash_count & smbus_flash_count (not supported) > - Removed typedefs for imgr ops > - Removed explicit value assignments in enums > - Other minor code cleanup per review comments > > Russ Weight (7): > fpga: sec-mgr: fpga security manager class driver > fpga: sec-mgr: enable secure updates > fpga: sec-mgr: expose sec-mgr update status > fpga: sec-mgr: expose sec-mgr update errors > fpga: sec-mgr: expose sec-mgr update size > fpga: sec-mgr: enable cancel of secure update > fpga: sec-mgr: expose hardware error info > > .../ABI/testing/sysfs-class-fpga-sec-mgr | 81 +++ > Documentation/fpga/fpga-sec-mgr.rst | 44 ++ > Documentation/fpga/index.rst | 1 + > MAINTAINERS | 9 + > drivers/fpga/Kconfig | 9 + > drivers/fpga/Makefile | 3 + > drivers/fpga/fpga-sec-mgr.c | 652 ++++++++++++++++++ > include/linux/fpga/fpga-sec-mgr.h | 100 +++ > 8 files changed, 899 insertions(+) > create mode 100644 Documentation/ABI/testing/sysfs-class-fpga-sec-mgr > create mode 100644 Documentation/fpga/fpga-sec-mgr.rst > create mode 100644 drivers/fpga/fpga-sec-mgr.c > create mode 100644 include/linux/fpga/fpga-sec-mgr.h >
Hi Tom, On Tue, Mar 09, 2021 at 08:03:09AM -0800, Tom Rix wrote: > Moritz, > > This and the next patchset apply to today's char-misc-next. > > However they conflicts with other in flight linux-fpga patchsets. > > Since I believe these patchsets came first, I think they should have preference. I'm not sure what the ask here is, do you expect me to back out the applied patches? Conflicts will happen, it's part of working with git. > This feature of updating is needed for the basic operation of the fpga. > > Tom > > On 3/8/21 4:35 PM, Russ Weight wrote: > > The FPGA Security Manager class driver provides a common > > API for user-space tools to manage updates for secure FPGA > > devices. Device drivers that instantiate the FPGA Security > > Manager class driver will interact with a HW secure update > > engine in order to transfer new FPGA and BMC images to FLASH so > > that they will be automatically loaded when the FPGA card reboots. > > > > A significant difference between the FPGA Manager and the FPGA > > Security Manager is that the FPGA Manager does a live update (Partial > > Reconfiguration) to a device whereas the FPGA Security Manager > > updates the FLASH images for the Static Region and the BMC so that > > they will be loaded the next time the FPGA card boots. Security is > > enforced by hardware and firmware. The security manager interacts > > with the firmware to initiate an update, pass in the necessary data, > > and collect status on the update. > > > > The n3000bmc-secure driver is the first driver to use the FPGA > > Security Manager. This driver was previously submitted in the same > > patch set, but has been split out into a separate patch set starting > > with V2. Future devices will also make use of this common API for > > secure updates. > > > > In addition to managing secure updates of the FPGA and BMC images, > > the FPGA Security Manager update process may also be used to > > program root entry hashes and cancellation keys for the FPGA static > > region, the FPGA partial reconfiguration region, and the BMC. > > The image files are self-describing, and contain a header describing > > the image type. > > > > Secure updates make use of the request_firmware framework, which > > requires that image files are accessible under /lib/firmware. A request > > for a secure update returns immediately, while the update itself > > proceeds in the context of a kernel worker thread. Sysfs files provide > > a means for monitoring the progress of a secure update and for > > retrieving error information in the event of a failure. > > > > The API includes a "name" sysfs file to export the name of the parent > > driver. It also includes an "update" sub-directory containing files that > > that can be used to instantiate and monitor a secure update. > > > > Changelog v9 -> v10: > > - Rebased to 5.12-rc2 next > > - Updated Date and KernelVersion in ABI documentation > > > > Changelog v8 -> v9: > > - Rebased patches for 5.11-rc2 > > - Updated Date and KernelVersion in ABI documentation > > > > Changelog v7 -> v8: > > - Fixed grammatical error in Documentation/fpga/fpga-sec-mgr.rst > > > > Changelog v6 -> v7: > > - Changed dates in documentation file to December 2020 > > - Changed filename_store() to use kmemdup_nul() instead of > > kstrndup() and changed the count to not assume a line-return. > > > > Changelog v5 -> v6: > > - Removed sysfs support and documentation for the display of the > > flash count, root entry hashes, and code-signing-key cancelation > > vectors from the class driver. This information can vary by device > > and will instead be displayed by the device-specific parent driver. > > > > Changelog v4 -> v5: > > - Added the devm_fpga_sec_mgr_unregister() function, following recent > > changes to the fpga_manager() implementation. > > - Changed most of the *_show() functions to use sysfs_emit() > > instead of sprintf( > > - When checking the return values for functions of type enum > > fpga_sec_err err_code, test for FPGA_SEC_ERR_NONE instead of 0 > > > > Changelog v3 -> v4: > > - This driver is generic enough that it could be used for non Intel > > FPGA devices. Changed from "Intel FPGA Security Manager" to FPGA > > Security Manager" and removed unnecessary references to "Intel". > > - Changed: iops -> sops, imgr -> smgr, IFPGA_ -> FPGA_, ifpga_ to fpga_ > > Note that this also affects some filenames. > > > > Changelog v2 -> v3: > > - Use dev_err() to report invalid progress in sec_progress() > > - Use dev_err() to report invalid error code in sec_error() > > - Modified sysfs handler check in check_sysfs_handler() to make > > it more readable. > > - Removed unnecessary "goto done" > > - Added a comment to explain imgr->driver_unload in > > ifpga_sec_mgr_unregister() > > > > Changelog v1 -> v2: > > - Separated out the MAX10 BMC Security Engine to be submitted in > > a separate patch-set. > > - Bumped documentation dates and versions > > - Split ifpga_sec_mgr_register() into create() and register() functions > > - Added devm_ifpga_sec_mgr_create() > > - Added Documentation/fpga/ifpga-sec-mgr.rst > > - Changed progress state "read_file" to "reading" > > - Added sec_error() function (similar to sec_progress()) > > - Removed references to bmc_flash_count & smbus_flash_count (not supported) > > - Removed typedefs for imgr ops > > - Removed explicit value assignments in enums > > - Other minor code cleanup per review comments > > > > Russ Weight (7): > > fpga: sec-mgr: fpga security manager class driver > > fpga: sec-mgr: enable secure updates > > fpga: sec-mgr: expose sec-mgr update status > > fpga: sec-mgr: expose sec-mgr update errors > > fpga: sec-mgr: expose sec-mgr update size > > fpga: sec-mgr: enable cancel of secure update > > fpga: sec-mgr: expose hardware error info > > > > .../ABI/testing/sysfs-class-fpga-sec-mgr | 81 +++ > > Documentation/fpga/fpga-sec-mgr.rst | 44 ++ > > Documentation/fpga/index.rst | 1 + > > MAINTAINERS | 9 + > > drivers/fpga/Kconfig | 9 + > > drivers/fpga/Makefile | 3 + > > drivers/fpga/fpga-sec-mgr.c | 652 ++++++++++++++++++ > > include/linux/fpga/fpga-sec-mgr.h | 100 +++ > > 8 files changed, 899 insertions(+) > > create mode 100644 Documentation/ABI/testing/sysfs-class-fpga-sec-mgr > > create mode 100644 Documentation/fpga/fpga-sec-mgr.rst > > create mode 100644 drivers/fpga/fpga-sec-mgr.c > > create mode 100644 include/linux/fpga/fpga-sec-mgr.h > > >
On 3/9/21 6:51 PM, Moritz Fischer wrote: > Hi Tom, > On Tue, Mar 09, 2021 at 08:03:09AM -0800, Tom Rix wrote: >> Moritz, >> >> This and the next patchset apply to today's char-misc-next. >> >> However they conflicts with other in flight linux-fpga patchsets. >> >> Since I believe these patchsets came first, I think they should have preference. > I'm not sure what the ask here is, do you expect me to back out the > applied patches? > > Conflicts will happen, it's part of working with git. When I say in-flight, I mean yet to be accepted patches. I track these here https://github.com/trixirt/linux-fpga/tree/fpga-testing I am sure everyone wants their patch in 5.13, I am plugging for these because they are oldest and most useful. This is an old patchset, from the changelog in this patchset it has been rebased for the last 2 releases without change. AFAIK, the dfl fpga's bitstream can not be updated with the mainline kernel without these patches. Since updating is why you would use an fpga, this is an important feature. While I am plugging for 5.13 A fix for dfl port enable logic https://lore.kernel.org/linux-fpga/20210303014543.68292-1-russell.h.weight@intel.com/ A patchset with a fix for stable https://lore.kernel.org/linux-fpga/8fe75a64-0457-16ac-5049-ee8b756ae1ea@linux.intel.com/ Tom >> This feature of updating is needed for the basic operation of the fpga. >> >> Tom >> >> On 3/8/21 4:35 PM, Russ Weight wrote: >>> The FPGA Security Manager class driver provides a common >>> API for user-space tools to manage updates for secure FPGA >>> devices. Device drivers that instantiate the FPGA Security >>> Manager class driver will interact with a HW secure update >>> engine in order to transfer new FPGA and BMC images to FLASH so >>> that they will be automatically loaded when the FPGA card reboots. >>> >>> A significant difference between the FPGA Manager and the FPGA >>> Security Manager is that the FPGA Manager does a live update (Partial >>> Reconfiguration) to a device whereas the FPGA Security Manager >>> updates the FLASH images for the Static Region and the BMC so that >>> they will be loaded the next time the FPGA card boots. Security is >>> enforced by hardware and firmware. The security manager interacts >>> with the firmware to initiate an update, pass in the necessary data, >>> and collect status on the update. >>> >>> The n3000bmc-secure driver is the first driver to use the FPGA >>> Security Manager. This driver was previously submitted in the same >>> patch set, but has been split out into a separate patch set starting >>> with V2. Future devices will also make use of this common API for >>> secure updates. >>> >>> In addition to managing secure updates of the FPGA and BMC images, >>> the FPGA Security Manager update process may also be used to >>> program root entry hashes and cancellation keys for the FPGA static >>> region, the FPGA partial reconfiguration region, and the BMC. >>> The image files are self-describing, and contain a header describing >>> the image type. >>> >>> Secure updates make use of the request_firmware framework, which >>> requires that image files are accessible under /lib/firmware. A request >>> for a secure update returns immediately, while the update itself >>> proceeds in the context of a kernel worker thread. Sysfs files provide >>> a means for monitoring the progress of a secure update and for >>> retrieving error information in the event of a failure. >>> >>> The API includes a "name" sysfs file to export the name of the parent >>> driver. It also includes an "update" sub-directory containing files that >>> that can be used to instantiate and monitor a secure update. >>> >>> Changelog v9 -> v10: >>> - Rebased to 5.12-rc2 next >>> - Updated Date and KernelVersion in ABI documentation >>> >>> Changelog v8 -> v9: >>> - Rebased patches for 5.11-rc2 >>> - Updated Date and KernelVersion in ABI documentation >>> >>> Changelog v7 -> v8: >>> - Fixed grammatical error in Documentation/fpga/fpga-sec-mgr.rst >>> >>> Changelog v6 -> v7: >>> - Changed dates in documentation file to December 2020 >>> - Changed filename_store() to use kmemdup_nul() instead of >>> kstrndup() and changed the count to not assume a line-return. >>> >>> Changelog v5 -> v6: >>> - Removed sysfs support and documentation for the display of the >>> flash count, root entry hashes, and code-signing-key cancelation >>> vectors from the class driver. This information can vary by device >>> and will instead be displayed by the device-specific parent driver. >>> >>> Changelog v4 -> v5: >>> - Added the devm_fpga_sec_mgr_unregister() function, following recent >>> changes to the fpga_manager() implementation. >>> - Changed most of the *_show() functions to use sysfs_emit() >>> instead of sprintf( >>> - When checking the return values for functions of type enum >>> fpga_sec_err err_code, test for FPGA_SEC_ERR_NONE instead of 0 >>> >>> Changelog v3 -> v4: >>> - This driver is generic enough that it could be used for non Intel >>> FPGA devices. Changed from "Intel FPGA Security Manager" to FPGA >>> Security Manager" and removed unnecessary references to "Intel". >>> - Changed: iops -> sops, imgr -> smgr, IFPGA_ -> FPGA_, ifpga_ to fpga_ >>> Note that this also affects some filenames. >>> >>> Changelog v2 -> v3: >>> - Use dev_err() to report invalid progress in sec_progress() >>> - Use dev_err() to report invalid error code in sec_error() >>> - Modified sysfs handler check in check_sysfs_handler() to make >>> it more readable. >>> - Removed unnecessary "goto done" >>> - Added a comment to explain imgr->driver_unload in >>> ifpga_sec_mgr_unregister() >>> >>> Changelog v1 -> v2: >>> - Separated out the MAX10 BMC Security Engine to be submitted in >>> a separate patch-set. >>> - Bumped documentation dates and versions >>> - Split ifpga_sec_mgr_register() into create() and register() functions >>> - Added devm_ifpga_sec_mgr_create() >>> - Added Documentation/fpga/ifpga-sec-mgr.rst >>> - Changed progress state "read_file" to "reading" >>> - Added sec_error() function (similar to sec_progress()) >>> - Removed references to bmc_flash_count & smbus_flash_count (not supported) >>> - Removed typedefs for imgr ops >>> - Removed explicit value assignments in enums >>> - Other minor code cleanup per review comments >>> >>> Russ Weight (7): >>> fpga: sec-mgr: fpga security manager class driver >>> fpga: sec-mgr: enable secure updates >>> fpga: sec-mgr: expose sec-mgr update status >>> fpga: sec-mgr: expose sec-mgr update errors >>> fpga: sec-mgr: expose sec-mgr update size >>> fpga: sec-mgr: enable cancel of secure update >>> fpga: sec-mgr: expose hardware error info >>> >>> .../ABI/testing/sysfs-class-fpga-sec-mgr | 81 +++ >>> Documentation/fpga/fpga-sec-mgr.rst | 44 ++ >>> Documentation/fpga/index.rst | 1 + >>> MAINTAINERS | 9 + >>> drivers/fpga/Kconfig | 9 + >>> drivers/fpga/Makefile | 3 + >>> drivers/fpga/fpga-sec-mgr.c | 652 ++++++++++++++++++ >>> include/linux/fpga/fpga-sec-mgr.h | 100 +++ >>> 8 files changed, 899 insertions(+) >>> create mode 100644 Documentation/ABI/testing/sysfs-class-fpga-sec-mgr >>> create mode 100644 Documentation/fpga/fpga-sec-mgr.rst >>> create mode 100644 drivers/fpga/fpga-sec-mgr.c >>> create mode 100644 include/linux/fpga/fpga-sec-mgr.h >>>
The FPGA Security Manager class driver provides a common API for user-space tools to manage updates for secure FPGA devices. Device drivers that instantiate the FPGA Security Manager class driver will interact with a HW secure update engine in order to transfer new FPGA and BMC images to FLASH so that they will be automatically loaded when the FPGA card reboots. A significant difference between the FPGA Manager and the FPGA Security Manager is that the FPGA Manager does a live update (Partial Reconfiguration) to a device whereas the FPGA Security Manager updates the FLASH images for the Static Region and the BMC so that they will be loaded the next time the FPGA card boots. Security is enforced by hardware and firmware. The security manager interacts with the firmware to initiate an update, pass in the necessary data, and collect status on the update. The n3000bmc-secure driver is the first driver to use the FPGA Security Manager. This driver was previously submitted in the same patch set, but has been split out into a separate patch set starting with V2. Future devices will also make use of this common API for secure updates. In addition to managing secure updates of the FPGA and BMC images, the FPGA Security Manager update process may also be used to program root entry hashes and cancellation keys for the FPGA static region, the FPGA partial reconfiguration region, and the BMC. The image files are self-describing, and contain a header describing the image type. Secure updates make use of the request_firmware framework, which requires that image files are accessible under /lib/firmware. A request for a secure update returns immediately, while the update itself proceeds in the context of a kernel worker thread. Sysfs files provide a means for monitoring the progress of a secure update and for retrieving error information in the event of a failure. The API includes a "name" sysfs file to export the name of the parent driver. It also includes an "update" sub-directory containing files that that can be used to instantiate and monitor a secure update. Changelog v9 -> v10: - Rebased to 5.12-rc2 next - Updated Date and KernelVersion in ABI documentation Changelog v8 -> v9: - Rebased patches for 5.11-rc2 - Updated Date and KernelVersion in ABI documentation Changelog v7 -> v8: - Fixed grammatical error in Documentation/fpga/fpga-sec-mgr.rst Changelog v6 -> v7: - Changed dates in documentation file to December 2020 - Changed filename_store() to use kmemdup_nul() instead of kstrndup() and changed the count to not assume a line-return. Changelog v5 -> v6: - Removed sysfs support and documentation for the display of the flash count, root entry hashes, and code-signing-key cancelation vectors from the class driver. This information can vary by device and will instead be displayed by the device-specific parent driver. Changelog v4 -> v5: - Added the devm_fpga_sec_mgr_unregister() function, following recent changes to the fpga_manager() implementation. - Changed most of the *_show() functions to use sysfs_emit() instead of sprintf( - When checking the return values for functions of type enum fpga_sec_err err_code, test for FPGA_SEC_ERR_NONE instead of 0 Changelog v3 -> v4: - This driver is generic enough that it could be used for non Intel FPGA devices. Changed from "Intel FPGA Security Manager" to FPGA Security Manager" and removed unnecessary references to "Intel". - Changed: iops -> sops, imgr -> smgr, IFPGA_ -> FPGA_, ifpga_ to fpga_ Note that this also affects some filenames. Changelog v2 -> v3: - Use dev_err() to report invalid progress in sec_progress() - Use dev_err() to report invalid error code in sec_error() - Modified sysfs handler check in check_sysfs_handler() to make it more readable. - Removed unnecessary "goto done" - Added a comment to explain imgr->driver_unload in ifpga_sec_mgr_unregister() Changelog v1 -> v2: - Separated out the MAX10 BMC Security Engine to be submitted in a separate patch-set. - Bumped documentation dates and versions - Split ifpga_sec_mgr_register() into create() and register() functions - Added devm_ifpga_sec_mgr_create() - Added Documentation/fpga/ifpga-sec-mgr.rst - Changed progress state "read_file" to "reading" - Added sec_error() function (similar to sec_progress()) - Removed references to bmc_flash_count & smbus_flash_count (not supported) - Removed typedefs for imgr ops - Removed explicit value assignments in enums - Other minor code cleanup per review comments Russ Weight (7): fpga: sec-mgr: fpga security manager class driver fpga: sec-mgr: enable secure updates fpga: sec-mgr: expose sec-mgr update status fpga: sec-mgr: expose sec-mgr update errors fpga: sec-mgr: expose sec-mgr update size fpga: sec-mgr: enable cancel of secure update fpga: sec-mgr: expose hardware error info .../ABI/testing/sysfs-class-fpga-sec-mgr | 81 +++ Documentation/fpga/fpga-sec-mgr.rst | 44 ++ Documentation/fpga/index.rst | 1 + MAINTAINERS | 9 + drivers/fpga/Kconfig | 9 + drivers/fpga/Makefile | 3 + drivers/fpga/fpga-sec-mgr.c | 652 ++++++++++++++++++ include/linux/fpga/fpga-sec-mgr.h | 100 +++ 8 files changed, 899 insertions(+) create mode 100644 Documentation/ABI/testing/sysfs-class-fpga-sec-mgr create mode 100644 Documentation/fpga/fpga-sec-mgr.rst create mode 100644 drivers/fpga/fpga-sec-mgr.c create mode 100644 include/linux/fpga/fpga-sec-mgr.h