Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[REBASE && FF] Fix DeviceStateLib Formatting and Move Unit Test Mode to Fixed PCD #542

Conversation

TaylorBeebe
Copy link
Contributor

@TaylorBeebe TaylorBeebe commented Aug 29, 2023

Description

DeviceStateLib provides an interface to get and set various device
state indicators (secure boot, unit test mode, etc.). This change
removes the unit test mode setting from the DeviceStateLib interface
and transitions it to a fixed at build PCD so it cannot be changed
at runtime. The one instance in this repo where
DEVICE_STATE_UNIT_TEST_MODE was referenced has been updated to
reference the PCD.

  • Impacts functionality?
    • Functionality - Does the change ultimately impact how firmware functions?
    • Examples: Add a new library, publish a new PPI, update an algorithm, ...
  • Impacts security?
    • Security - Does the change have a direct security impact on an application,
      flow, or firmware?
    • Examples: Crypto algorithm change, buffer overflow fix, parameter
      validation improvement, ...
  • Breaking change?
    • Breaking change - Will anyone consuming this change experience a break
      in build or boot behavior?
    • Examples: Add a new library class, move a module to a different repo, call
      a function in a new library class in a pre-existing module, ...
  • Includes tests?
    • Tests - Does the change include any explicit test code?
    • Examples: Unit tests, integration tests, robot tests, ...
  • Includes documentation?
    • Documentation - Does the change contain explicit documentation additions
      outside direct code modifications (and comments)?
    • Examples: Update readme file, add feature readme file, link to documentation
      on an a separate Web page, ...

How This Was Tested

Tested on Q35

Integration Instructions

References to DEVICE_STATE_UNIT_TEST_MODE will need to be removed
from platform code and platforms which want to set unit test mode
will need to set the PCD in their platform DSC file(s).

@TaylorBeebe TaylorBeebe force-pushed the update_device_state_unit_test_2 branch from 3fadad3 to e8e1b6e Compare August 29, 2023 22:53
@makubacki makubacki added impact:breaking-change Requires integration attention type:design-change A new proposal or modification to a feature design labels Aug 30, 2023
@makubacki
Copy link
Member

makubacki commented Aug 30, 2023

Feel free to review the labels, I marked as a design change and breaking change.

Though this will be rebased, I think it'd still be good to copy the integration instructions to the PR description since that will be the main reference point for the change in the release notes.

Description

- [ ] Impacts functionality?
  - **Functionality** - Does the change ultimately impact how firmware functions?
  - Examples: Add a new library, publish a new PPI, update an algorithm, ...
- [ ] Impacts security?
  - **Security** - Does the change have a direct security impact on an application,
    flow, or firmware?
  - Examples: Crypto algorithm change, buffer overflow fix, parameter
    validation improvement, ...
- [ ] Breaking change?
  - **Breaking change** - Will anyone consuming this change experience a break
    in build or boot behavior?
  - Examples: Add a new library class, move a module to a different repo, call
    a function in a new library class in a pre-existing module, ...
- [ ] Includes tests?
  - **Tests** - Does the change include any explicit test code?
  - Examples: Unit tests, integration tests, robot tests, ...
- [ ] Includes documentation?
  - **Documentation** - Does the change contain explicit documentation additions
    outside direct code modifications (and comments)?
  - Examples: Update readme file, add feature readme file, link to documentation
    on an a separate Web page, ...

How This Was Tested

N/A

Integration Instructions

N/A
Description

DeviceStateLib provides an interface to get and set various device
state indicators (secure boot, unit test mode, etc.). This change
removes the unit test mode setting from the DeviceStateLib interface
and transitions it to a fixed at build PCD so it cannot be changed
at runtime. The one instance in this repo where
DEVICE_STATE_UNIT_TEST_MODE was referenced has been updated to
reference the PCD.

- [x] Impacts functionality?
  - **Functionality** - Does the change ultimately impact how firmware functions?
  - Examples: Add a new library, publish a new PPI, update an algorithm, ...
- [x] Impacts security?
  - **Security** - Does the change have a direct security impact on an application,
    flow, or firmware?
  - Examples: Crypto algorithm change, buffer overflow fix, parameter
    validation improvement, ...
- [x] Breaking change?
  - **Breaking change** - Will anyone consuming this change experience a break
    in build or boot behavior?
  - Examples: Add a new library class, move a module to a different repo, call
    a function in a new library class in a pre-existing module, ...
- [ ] Includes tests?
  - **Tests** - Does the change include any explicit test code?
  - Examples: Unit tests, integration tests, robot tests, ...
- [ ] Includes documentation?
  - **Documentation** - Does the change contain explicit documentation additions
    outside direct code modifications (and comments)?
  - Examples: Update readme file, add feature readme file, link to documentation
    on an a separate Web page, ...

How This Was Tested

Tested on Q35

Integration Instructions

References to DEVICE_STATE_UNIT_TEST_MODE will need to be removed
from platform code and platforms which want to set unit test mode
will need to set the PCD in their platform DSC file(s).
@TaylorBeebe TaylorBeebe force-pushed the update_device_state_unit_test_2 branch from e8e1b6e to 2a94654 Compare August 31, 2023 16:49
#define DEVICE_STATE_DEVELOPMENT_BUILD_ENABLED (1 << (2))
#define DEVICE_STATE_SOURCE_DEBUG_ENABLED (1 << (3))
#define DEVICE_STATE_UNDEFINED (1 << (4))
#define DEVICE_STATE_UNIT_TEST_MODE (1 << (5))
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

i don't think we should delete this state.

@github-actions github-actions bot added the impact:security Has a security impact label Aug 31, 2023
@TaylorBeebe TaylorBeebe closed this Sep 6, 2023
@TaylorBeebe TaylorBeebe deleted the update_device_state_unit_test_2 branch September 6, 2023 18:25
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
impact:breaking-change Requires integration attention impact:security Has a security impact type:design-change A new proposal or modification to a feature design
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants