xref: /openbmc/libpldm/CHANGELOG.md (revision 8cf704566037707713e75e23e75854eea4f32670)
16fd81a51SAndrew Jeffery# Changelog
26fd81a51SAndrew Jeffery
36fd81a51SAndrew JefferyAll notable changes to this project will be documented in this file.
46fd81a51SAndrew Jeffery
56fd81a51SAndrew JefferyThe format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
66fd81a51SAndrew Jefferyand this project adheres to
76fd81a51SAndrew Jeffery[Semantic Versioning](https://semver.org/spec/v2.0.0.html).
86fd81a51SAndrew Jeffery
96fd81a51SAndrew JefferyChange categories:
106fd81a51SAndrew Jeffery
116fd81a51SAndrew Jeffery- Added
126fd81a51SAndrew Jeffery- Changed
136fd81a51SAndrew Jeffery- Deprecated
146fd81a51SAndrew Jeffery- Removed
156fd81a51SAndrew Jeffery- Fixed
166fd81a51SAndrew Jeffery- Security
176fd81a51SAndrew Jeffery
186fd81a51SAndrew Jeffery## [Unreleased]
1939f88325SRashmica Gupta
206409c8a0SAndrew Jeffery### Removed
216409c8a0SAndrew Jeffery
226409c8a0SAndrew Jeffery1. bios_table: Remove deprecated APIs sanitized by assert():
236409c8a0SAndrew Jeffery
246409c8a0SAndrew Jeffery   - pldm_bios_table_string_entry_encode()
256409c8a0SAndrew Jeffery   - pldm_bios_table_string_entry_decode_string()
266409c8a0SAndrew Jeffery   - pldm_bios_table_attr_entry_enum_encode()
276409c8a0SAndrew Jeffery   - pldm_bios_table_attr_entry_enum_decode_pv_num()
286409c8a0SAndrew Jeffery   - pldm_bios_table_attr_entry_enum_decode_def_num()
296409c8a0SAndrew Jeffery   - pldm_bios_table_attr_entry_enum_decode_pv_hdls()
306409c8a0SAndrew Jeffery   - pldm_bios_table_attr_entry_string_encode()
316409c8a0SAndrew Jeffery   - pldm_bios_table_attr_entry_string_decode_def_string_length()
326409c8a0SAndrew Jeffery
33ffd5342cSPavithra Barithaya### Fixes
34ffd5342cSPavithra Barithaya
35ffd5342cSPavithra Barithaya1. pdr: Return success for pldm_pdr_find_child_container_id_range_exclude() API
36*8cf70456SPavithra Barithaya2. pdr: Rework pldm_pdr_find_container_id_range_exclude() API
37ffd5342cSPavithra Barithaya
38291da195SAndrew Jeffery## [0.3.0] - 2023-06-23
39291da195SAndrew Jeffery
407c250340SDung Cao### Added
417c250340SDung Cao
427c250340SDung Cao1. Add encode/decode pldmMessagePollEvent data
4383841fb5SAndrew Jeffery2. README: Add a section on working with libpldm
4439bd2ea5SArchanaKakani3. pdr: Introduce remote_container_id and associated APIs
459947f9d6SPavithra Barithaya4. pdr: Add APIs for creating and locating remote PDRs
464d694346SPavithra Barithaya5. pdr: Add pldm_pdr_find_last_in_range()
4725ddbccfSPavithra Barithaya6. pdr: Add pldm_entity_association_pdr_add_from_node_with_record_handle()
485dc02571SPavithra Barithaya7. pdr: Add pldm_pdr_find_container_id_range_exclude()
497c250340SDung Cao
50b443b487SRashmica Gupta### Changed
51b443b487SRashmica Gupta
52b443b487SRashmica Gupta1. include: Move installed transport.h under libpldm/
5383841fb5SAndrew Jeffery2. libpldm: Explicit deprecated, stable and testing ABI classes
548de8e1ecSAndrew Jeffery3. meson: Reduce strength of oem-ibm requirements from enabled to allowed
558de8e1ecSAndrew Jeffery
568de8e1ecSAndrew Jeffery   The `oem-ibm` feature is now enabled by the default meson configuration, for
578de8e1ecSAndrew Jeffery   CI purposes. `oem-ibm` is still disabled by default in the `libpldm` bitbake
588de8e1ecSAndrew Jeffery   recipe:
598de8e1ecSAndrew Jeffery
608de8e1ecSAndrew Jeffery   https://github.com/openbmc/openbmc/blob/master/meta-phosphor/recipes-phosphor/libpldm/libpldm_git.bb#L10
618de8e1ecSAndrew Jeffery
628de8e1ecSAndrew Jeffery   To disable `oem-ibm` in your development builds, pass `-Doem-ibm=disabled`
638de8e1ecSAndrew Jeffery   when invoking `meson setup`
64b443b487SRashmica Gupta
6598c1e69dSAndrew Jeffery4. bios_table: Relax pldm_bios_table_string_entry_decode_string_check()
660c9f5a8aSAndrew Jeffery5. bios_table: Relax pldm_bios_table_attr_entry_enum_decode_pv_hdls_check()
6798c1e69dSAndrew Jeffery
68d47e8ab8SAndrew Jeffery### Deprecated
69d47e8ab8SAndrew Jeffery
70d47e8ab8SAndrew Jeffery1. bios_table: Deprecate APIs with arguments sanitized using assert()
71d47e8ab8SAndrew Jeffery
72d47e8ab8SAndrew Jeffery   C provides enough foot-guns without us encoding them into library APIs.
73d47e8ab8SAndrew Jeffery   Specifically, deprecate the following in favour of their `*_check()` variants
74d47e8ab8SAndrew Jeffery   which ensure assertions won't fail or otherwise invoke UB:
75d47e8ab8SAndrew Jeffery
76d47e8ab8SAndrew Jeffery   - pldm_bios_table_string_entry_encode()
77d47e8ab8SAndrew Jeffery   - pldm_bios_table_string_entry_decode_string()
78d47e8ab8SAndrew Jeffery   - pldm_bios_table_attr_entry_enum_encode()
79d47e8ab8SAndrew Jeffery   - pldm_bios_table_attr_entry_enum_decode_pv_num()
80d47e8ab8SAndrew Jeffery   - pldm_bios_table_attr_entry_enum_decode_def_num()
81d47e8ab8SAndrew Jeffery   - pldm_bios_table_attr_entry_enum_decode_pv_hdls()
82d47e8ab8SAndrew Jeffery   - pldm_bios_table_attr_entry_string_encode()
83d47e8ab8SAndrew Jeffery   - pldm_bios_table_attr_entry_string_decode_def_string_length()
84d47e8ab8SAndrew Jeffery
854b4603b3SAndrew Jeffery### Removed
864b4603b3SAndrew Jeffery
874b4603b3SAndrew Jeffery1. libpldm: Remove the requester-api option
884b4603b3SAndrew Jeffery
8939f88325SRashmica Gupta### Fixed
9039f88325SRashmica Gupta
9139f88325SRashmica Gupta1. requester: Make pldm_open() return existing fd
92abaf61f4SDung Cao2. transport: Prevent sticking in waiting for response
93b01fb1ccSThu Nguyen3. transport: Match on response in pldm_transport_send_recv_msg()
94a3035938SRashmica Gupta4. requester: Add check before accessing hdr in pldm_recv()
95df02e360SAndrew Jeffery5. bios_table: pldm_bios_table_attr_entry_string_info_check() NULL deref
96