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 20986df2a1SAndrew Jeffery### Changed 21986df2a1SAndrew Jeffery 22986df2a1SAndrew Jeffery1. requester: Mark pldm_close() as LIBPLDM_ABI_TESTING 235fb9680bSAndrew Jeffery2. requester: Expose pldm_close() in header 24986df2a1SAndrew Jeffery 256409c8a0SAndrew Jeffery### Removed 266409c8a0SAndrew Jeffery 276409c8a0SAndrew Jeffery1. bios_table: Remove deprecated APIs sanitized by assert(): 286409c8a0SAndrew Jeffery 296409c8a0SAndrew Jeffery - pldm_bios_table_string_entry_encode() 306409c8a0SAndrew Jeffery - pldm_bios_table_string_entry_decode_string() 316409c8a0SAndrew Jeffery - pldm_bios_table_attr_entry_enum_encode() 326409c8a0SAndrew Jeffery - pldm_bios_table_attr_entry_enum_decode_pv_num() 336409c8a0SAndrew Jeffery - pldm_bios_table_attr_entry_enum_decode_def_num() 346409c8a0SAndrew Jeffery - pldm_bios_table_attr_entry_enum_decode_pv_hdls() 356409c8a0SAndrew Jeffery - pldm_bios_table_attr_entry_string_encode() 366409c8a0SAndrew Jeffery - pldm_bios_table_attr_entry_string_decode_def_string_length() 376409c8a0SAndrew Jeffery 3809778a82SAndrew Jeffery### Fixed 39ffd5342cSPavithra Barithaya 40ffd5342cSPavithra Barithaya1. pdr: Return success for pldm_pdr_find_child_container_id_range_exclude() API 418cf70456SPavithra Barithaya2. pdr: Rework pldm_pdr_find_container_id_range_exclude() API 42a4da6858SAndrew Jeffery3. transport: mctp-demux: Don't test socket for non-zero value 43*4e1ba8a7SAndrew Jeffery4. requester: Return PLDM_REQUESTER_OPEN_FAIL from pldm_open() on error 44ffd5342cSPavithra Barithaya 45291da195SAndrew Jeffery## [0.3.0] - 2023-06-23 46291da195SAndrew Jeffery 477c250340SDung Cao### Added 487c250340SDung Cao 497c250340SDung Cao1. Add encode/decode pldmMessagePollEvent data 5083841fb5SAndrew Jeffery2. README: Add a section on working with libpldm 5139bd2ea5SArchanaKakani3. pdr: Introduce remote_container_id and associated APIs 529947f9d6SPavithra Barithaya4. pdr: Add APIs for creating and locating remote PDRs 534d694346SPavithra Barithaya5. pdr: Add pldm_pdr_find_last_in_range() 5425ddbccfSPavithra Barithaya6. pdr: Add pldm_entity_association_pdr_add_from_node_with_record_handle() 555dc02571SPavithra Barithaya7. pdr: Add pldm_pdr_find_container_id_range_exclude() 567c250340SDung Cao 57b443b487SRashmica Gupta### Changed 58b443b487SRashmica Gupta 59b443b487SRashmica Gupta1. include: Move installed transport.h under libpldm/ 6083841fb5SAndrew Jeffery2. libpldm: Explicit deprecated, stable and testing ABI classes 618de8e1ecSAndrew Jeffery3. meson: Reduce strength of oem-ibm requirements from enabled to allowed 628de8e1ecSAndrew Jeffery 638de8e1ecSAndrew Jeffery The `oem-ibm` feature is now enabled by the default meson configuration, for 648de8e1ecSAndrew Jeffery CI purposes. `oem-ibm` is still disabled by default in the `libpldm` bitbake 658de8e1ecSAndrew Jeffery recipe: 668de8e1ecSAndrew Jeffery 678de8e1ecSAndrew Jeffery https://github.com/openbmc/openbmc/blob/master/meta-phosphor/recipes-phosphor/libpldm/libpldm_git.bb#L10 688de8e1ecSAndrew Jeffery 698de8e1ecSAndrew Jeffery To disable `oem-ibm` in your development builds, pass `-Doem-ibm=disabled` 708de8e1ecSAndrew Jeffery when invoking `meson setup` 71b443b487SRashmica Gupta 7298c1e69dSAndrew Jeffery4. bios_table: Relax pldm_bios_table_string_entry_decode_string_check() 730c9f5a8aSAndrew Jeffery5. bios_table: Relax pldm_bios_table_attr_entry_enum_decode_pv_hdls_check() 7498c1e69dSAndrew Jeffery 75d47e8ab8SAndrew Jeffery### Deprecated 76d47e8ab8SAndrew Jeffery 77d47e8ab8SAndrew Jeffery1. bios_table: Deprecate APIs with arguments sanitized using assert() 78d47e8ab8SAndrew Jeffery 79d47e8ab8SAndrew Jeffery C provides enough foot-guns without us encoding them into library APIs. 80d47e8ab8SAndrew Jeffery Specifically, deprecate the following in favour of their `*_check()` variants 81d47e8ab8SAndrew Jeffery which ensure assertions won't fail or otherwise invoke UB: 82d47e8ab8SAndrew Jeffery 83d47e8ab8SAndrew Jeffery - pldm_bios_table_string_entry_encode() 84d47e8ab8SAndrew Jeffery - pldm_bios_table_string_entry_decode_string() 85d47e8ab8SAndrew Jeffery - pldm_bios_table_attr_entry_enum_encode() 86d47e8ab8SAndrew Jeffery - pldm_bios_table_attr_entry_enum_decode_pv_num() 87d47e8ab8SAndrew Jeffery - pldm_bios_table_attr_entry_enum_decode_def_num() 88d47e8ab8SAndrew Jeffery - pldm_bios_table_attr_entry_enum_decode_pv_hdls() 89d47e8ab8SAndrew Jeffery - pldm_bios_table_attr_entry_string_encode() 90d47e8ab8SAndrew Jeffery - pldm_bios_table_attr_entry_string_decode_def_string_length() 91d47e8ab8SAndrew Jeffery 924b4603b3SAndrew Jeffery### Removed 934b4603b3SAndrew Jeffery 944b4603b3SAndrew Jeffery1. libpldm: Remove the requester-api option 954b4603b3SAndrew Jeffery 9639f88325SRashmica Gupta### Fixed 9739f88325SRashmica Gupta 9839f88325SRashmica Gupta1. requester: Make pldm_open() return existing fd 99abaf61f4SDung Cao2. transport: Prevent sticking in waiting for response 100b01fb1ccSThu Nguyen3. transport: Match on response in pldm_transport_send_recv_msg() 101a3035938SRashmica Gupta4. requester: Add check before accessing hdr in pldm_recv() 102df02e360SAndrew Jeffery5. bios_table: pldm_bios_table_attr_entry_string_info_check() NULL deref 103