ifr(3)

📦
version 1.3.1 · 3 versions
, in epel 10

💖 ifr(3) — Library Functions Manual 💖

okay so this is the ifr(3) page from the Library Functions Manual, and it's giving very "reference material but make it cute" energy. Buckle up bestie, because this one is a long one and we're keeping every last detail. ✨

🌸 NAME 🌸

ifr - Ifr — that's the name, no cap. Minimal, iconic, periodt. 💅

🦋 SYNOPSIS 🦋

🧵 Topics 🧵

  • IGSC_IFR_RUN_TEST_STATUSES

🔮 Enumerations 🔮

  • enum igsc_ifr_tiles — the ifr tiles masks, slay:
enum igsc_ifr_tiles { IGSC_IFR_TILE_0 = 0x0001, IGSC_IFR_TILE_1 = 0x0002 }
  • enum igsc_supported_ifr_tests — the ifr supported test masks, literally:
enum igsc_supported_ifr_tests { IGSC_IFR_SUPPORTED_TEST_SCAN = 0x00000001, IGSC_IFR_SUPPORTED_TEST_ARRAY = 0x00000002 }
  • enum igsc_ifr_repairs — the ifr repairs masks, obsessed:
enum igsc_ifr_repairs { IGSC_IFR_REPAIR_DSS_EN = 0x00000001, IGSC_IFR_REPAIR_ARRAY = 0x00000002 }

🛠️ Functions 🛠️

  • IGSC_EXPORT void igsc_library_version (uint32_t *major, uint32_t *minor, uint32_t *patch, uint32_t *build) — Return the library version. That's the whole vibe. 💖

🎀 Variables 🎀

bestie, this is the full variable roster — no skips, no summaries, we're doing all of them:

  • char igsc_fw_version::project [4]
  • uint16_t igsc_fw_version::hotfix
  • uint16_t igsc_fw_version::build
  • uint16_t igsc_ifr_bin_version::major
  • uint16_t igsc_ifr_bin_version::minor
  • uint16_t igsc_ifr_bin_version::hotfix
  • uint16_t igsc_ifr_bin_version::build
  • uint32_t igsc_psc_version::date
  • uint32_t igsc_psc_version::cfg_version
  • uint16_t igsc_oem_version::length
  • uint8_t igsc_oem_version::version [IGSC_MAX_OEM_VERSION_LENGTH]
  • uint16_t igsc_oem_serial_number::length
  • uint8_t igsc_oem_serial_number::sn [IGSC_MAX_OEM_SN_LENGTH]
  • uint32_t igsc_fwdata_version::oem_manuf_data_version
  • uint16_t igsc_fwdata_version::major_version
  • uint16_t igsc_fwdata_version::major_vcn
  • uint32_t igsc_fwdata_version2::format_version
  • uint32_t igsc_fwdata_version2::oem_manuf_data_version
  • uint32_t igsc_fwdata_version2::oem_manuf_data_version_fitb
  • uint16_t igsc_fwdata_version2::major_version
  • uint16_t igsc_fwdata_version2::major_vcn
  • uint32_t igsc_fwdata_version2::flags
  • uint32_t igsc_fwdata_version2::data_arb_svn
  • uint32_t igsc_fwdata_version2::data_arb_svn_fitb
  • uint8_t igsc_oprom_version::version [IGSC_OPROM_VER_SIZE]
  • uint16_t igsc_oprom_device_info::subsys_vendor_id
  • uint16_t igsc_oprom_device_info::subsys_device_id
  • uint16_t igsc_oprom_device_info_4ids::vendor_id
  • uint16_t igsc_oprom_device_info_4ids::device_id
  • uint16_t igsc_oprom_device_info_4ids::subsys_vendor_id
  • uint16_t igsc_oprom_device_info_4ids::subsys_device_id
  • uint16_t igsc_fwdata_device_info::vendor_id
  • uint16_t igsc_fwdata_device_info::device_id
  • uint16_t igsc_fwdata_device_info::subsys_vendor_id
  • uint16_t igsc_fwdata_device_info::subsys_device_id
  • char igsc_device_info::name [IGSC_INFO_NAME_SIZE]
  • uint16_t igsc_device_info::domain
  • uint8_t igsc_device_info::bus
  • uint8_t igsc_device_info::dev
  • uint8_t igsc_device_info::func
  • uint16_t igsc_device_info::device_id
  • uint16_t igsc_device_info::vendor_id
  • uint16_t igsc_device_info::subsys_device_id
  • uint16_t igsc_device_info::subsys_vendor_id
  • uint32_t igsc_hw_config::format_version
  • uint8_t igsc_hw_config::blob [IGSC_HW_CONFIG_BLOB_SIZE]
  • uint16_t igsc_subsystem_ids::ssvid
  • uint16_t igsc_subsystem_ids::ssdid
  • struct igsc_lib_ctx * igsc_device_handle::ctx
  • uint32_t igsc_fw_update_flags::force_update: 1
  • uint32_t igsc_fw_update_flags::reserved: 31
  • uint32_t igsc_gfsp_tile_mem_err::corr_err
  • uint32_t igsc_gfsp_tile_mem_err::uncorr_err
  • uint32_t igsc_gfsp_mem_err::num_of_tiles
  • struct igsc_gfsp_tile_mem_err igsc_gfsp_mem_err::errors []
  • uint32_t igsc_device_mbist_ppr_status::mbist_test_status
  • uint32_t igsc_device_mbist_ppr_status::num_of_ppr_fuses_used_by_fw
  • uint32_t igsc_device_mbist_ppr_status::num_of_remaining_ppr_fuses
  • uint8_t igsc_ppr_status::boot_time_memory_correction_pending
  • uint8_t igsc_ppr_status::ppr_mode
  • uint8_t igsc_ppr_status::test_run_status
  • uint8_t igsc_ppr_status::reserved
  • uint32_t igsc_ppr_status::ras_ppr_applied
  • uint32_t igsc_ppr_status::mbist_completed
  • uint32_t igsc_ppr_status::num_devices
  • struct igsc_device_mbist_ppr_status igsc_ppr_status::device_mbist_ppr_status []

🌈 Detailed Description 🌈

There's no extra prose here in the original, bestie — it's literally just the heading doing its main character thing. ✨

👑 Enumeration Type Documentation 👑

💅 enum igsc_ifr_repairs 💅

ifr repairs masks. That's the description, and it ate.

Definition at line 1279 of file igsc_lib.h.

🦋 enum igsc_ifr_tiles 🦋

ifr tiles masks. Lowkey iconic.

Definition at line 1263 of file igsc_lib.h.

⭐ enum igsc_supported_ifr_tests ⭐

ifr supported test masks. Periodt.

Definition at line 1271 of file igsc_lib.h.

🔥 Function Documentation 🔥

🌟 IGSC_EXPORT void igsc_library_version (uint32_t * major, uint32_t * minor, uint32_t * patch, uint32_t * build) 🌟

Return the library version.

🫶 Parameters 🫶

  • major — pointer to fill for major version part
  • minor — pointer to fill for minor version part
  • patch — pointer to fill for patch version part
  • build — pointer to fill for build version part

✨ Variable Documentation ✨

Okay bestie, this is the full variable roll call — every type, every field, every definition line. No skipping, no cap. 💅

  • uint8_t igsc_hw_config::blob[IGSC_HW_CONFIG_BLOB_SIZE] — the original gives no extra description here, just the declaration. Definition at line 351 of file igsc_lib.h.
  • uint8_t igsc_ppr_status::boot_time_memory_correction_pending — 0 means no pending boot time memory correction; 1 means pending boot time memory correction. Definition at line 1839 of file igsc_lib.h.
  • uint16_t igsc_fw_version::build — FW Build Number 💖. Definition at line 128 of file igsc_lib.h.
  • uint16_t igsc_ifr_bin_version::build — IFR Binary Build Number ✨. Definition at line 138 of file igsc_lib.h.
  • uint8_t igsc_device_info::bus — pci bus number for GFX device. Definition at line 304 of file igsc_lib.h.
  • uint32_t igsc_psc_version::cfg_version — PSC configuration version. Definition at line 146 of file igsc_lib.h.
  • uint32_t igsc_gfsp_tile_mem_err::corr_err — correctable memory errors on this boot and tile. Definition at line 1349 of file igsc_lib.h.
  • struct igsc_lib_ctx* igsc_device_handle::ctx — internal library context 🫶. Definition at line 376 of file igsc_lib.h.
  • uint32_t igsc_fwdata_version2::data_arb_svn — GSC in-field data firmware SVN. Definition at line 219 of file igsc_lib.h.
  • uint32_t igsc_fwdata_version2::data_arb_svn_fitb — GSC in-field data firmware SVN from FITB. Definition at line 220 of file igsc_lib.h.
  • uint32_t igsc_psc_version::date — PSC date. Definition at line 145 of file igsc_lib.h.
  • uint8_t igsc_device_info::dev — device number on pci bus. Definition at line 305 of file igsc_lib.h.
  • uint16_t igsc_device_info::device_id — gfx device id. Definition at line 308 of file igsc_lib.h.
  • uint16_t igsc_fwdata_device_info::device_id — device id. Definition at line 269 of file igsc_lib.h.
  • uint16_t igsc_oprom_device_info_4ids::device_id — device id. Definition at line 258 of file igsc_lib.h.
  • struct igsc_device_mbist_ppr_status igsc_ppr_status::device_mbist_ppr_status[] — array of PPR statuses per device. Definition at line 1848 of file igsc_lib.h.
  • uint16_t igsc_device_info::domain — pci domain for GFX device. Definition at line 303 of file igsc_lib.h.
  • struct igsc_gfsp_tile_mem_err igsc_gfsp_mem_err::errors[] — array of memory errors structs for each tile. Definition at line 1359 of file igsc_lib.h.
  • uint32_t igsc_fwdata_version2::flags — GSC in-field data firmware flags. Definition at line 218 of file igsc_lib.h.
  • uint32_t igsc_fw_update_flags::force_update — no extra description in the original, just the field. Definition at line 648 of file igsc_lib.h.
  • uint32_t igsc_fwdata_version2::format_version — GSC in-field data firmware version format. Definition at line 213 of file igsc_lib.h.
  • uint32_t igsc_hw_config::format_version — no extra description in the original, just the field. Definition at line 350 of file igsc_lib.h.
  • uint8_t igsc_device_info::func — device function number. Definition at line 306 of file igsc_lib.h.
  • uint16_t igsc_fw_version::hotfix — FW Hotfix Number. Definition at line 127 of file igsc_lib.h.
  • uint16_t igsc_ifr_bin_version::hotfix — IFR Binary Hotfix Number. Definition at line 137 of file igsc_lib.h.
  • uint16_t igsc_oem_serial_number::length — actual OEM serial number length. Definition at line 165 of file igsc_lib.h.
  • uint16_t igsc_oem_version::length — actual OEM version length. Definition at line 155 of file igsc_lib.h.
  • uint16_t igsc_ifr_bin_version::major — IFR Binary Major Number. Definition at line 135 of file igsc_lib.h.
  • uint16_t igsc_fwdata_version2::major_vcn — GSC in-field data firmware major VCN. Definition at line 217 of file igsc_lib.h.
  • uint16_t igsc_fwdata_version::major_vcn — GSC in-field data firmware major VCN. Definition at line 200 of file igsc_lib.h.
  • uint16_t igsc_fwdata_version2::major_version — GSC in-field data firmware major version. Definition at line 216 of file igsc_lib.h.
  • uint16_t igsc_fwdata_version::major_version — GSC in-field data firmware major version. Definition at line 199 of file igsc_lib.h.
  • uint32_t igsc_ppr_status::mbist_completed — 0 means not applied; any set bit represents mbist completed. Definition at line 1846 of file igsc_lib.h.
  • uint32_t igsc_device_mbist_ppr_status::mbist_test_status — 0 – Pass; any set bit represents that MBIST on the matching channel has failed. Definition at line 1830 of file igsc_lib.h.
  • uint16_t igsc_ifr_bin_version::minor — IFR Binary Minor Number. Definition at line 136 of file igsc_lib.h.
  • char igsc_device_info::name[IGSC_INFO_NAME_SIZE] — the device node path. Definition at line 301 of file igsc_lib.h.
  • uint32_t igsc_ppr_status::num_devices — real number of devices in the array (on Xe_HP SDV, PVC <= 8). Definition at line 1847 of file igsc_lib.h.
  • uint32_t igsc_device_mbist_ppr_status::num_of_ppr_fuses_used_by_fw — number of PPR fuses used by the firmware. Definition at line 1831 of file igsc_lib.h.
  • uint32_t igsc_device_mbist_ppr_status::num_of_remaining_ppr_fuses — number of remaining PPR fuses. Definition at line 1832 of file igsc_lib.h.
  • uint32_t igsc_gfsp_mem_err::num_of_tiles — number of entries in errors array (number of available entries when passed to the function and number of filled entries when returned). Definition at line 1357 of file igsc_lib.h.
  • uint32_t igsc_fwdata_version2::oem_manuf_data_version — GSC in-field data firmware OEM manufacturing data version. Definition at line 214 of file igsc_lib.h.
  • uint32_t igsc_fwdata_version::oem_manuf_data_version — GSC in-field data firmware OEM manufacturing data version. Definition at line 198 of file igsc_lib.h.
  • uint32_t igsc_fwdata_version2::oem_manuf_data_version_fitb — GSC in-field data firmware OEM manufacturing data version from FITB. Definition at line 215 of file igsc_lib.h.
  • uint8_t igsc_ppr_status::ppr_mode — 0 – PPR enabled, 1 – PPR disabled, 2 – PPR test mode, 3 – PPR auto run on next boot. Definition at line 1841 of file igsc_lib.h.
  • char igsc_fw_version::project[4] — Project code name. Definition at line 126 of file igsc_lib.h.
  • uint32_t igsc_ppr_status::ras_ppr_applied — 0 - ppr not applied, 1 - ppr applied, 2 - ppr exhausted. Definition at line 1845 of file igsc_lib.h.
  • uint32_t igsc_fw_update_flags::reserved — no extra description in the original, just the field. Definition at line 649 of file igsc_lib.h.
  • uint8_t igsc_ppr_status::reserved — no extra description in the original, just the field. Definition at line 1844 of file igsc_lib.h.
  • uint8_t igsc_oem_serial_number::sn[IGSC_MAX_OEM_SN_LENGTH] — buffer to store the oem serial number. Definition at line 166 of file igsc_lib.h.
  • uint16_t igsc_subsystem_ids::ssdid — no extra description in the original, just the field. Definition at line 361 of file igsc_lib.h.
  • uint16_t igsc_subsystem_ids::ssvid — no extra description in the original, just the field. Definition at line 360 of file igsc_lib.h.
  • uint16_t igsc_device_info::subsys_device_id — gfx device subsystem device id. Definition at line 310 of file igsc_lib.h.
  • uint16_t igsc_fwdata_device_info::subsys_device_id — subsystem device id. Definition at line 271 of file igsc_lib.h.
  • uint16_t igsc_oprom_device_info::subsys_device_id — subsystem device id. Definition at line 249 of file igsc_lib.h.
  • uint16_t igsc_oprom_device_info_4ids::subsys_device_id — subsystem device id. Definition at line 260 of file igsc_lib.h.
  • uint16_t igsc_device_info::subsys_vendor_id — gfx device subsystem vendor id. Definition at line 311 of file igsc_lib.h.
  • uint16_t igsc_fwdata_device_info::subsys_vendor_id — subsystem vendor id. Definition at line 270 of file igsc_lib.h.
  • uint16_t igsc_oprom_device_info::subsys_vendor_id — subsystem vendor id. Definition at line 248 of file igsc_lib.h.
  • uint16_t igsc_oprom_device_info_4ids::subsys_vendor_id — subsystem vendor id. Definition at line 259 of file igsc_lib.h.
  • uint8_t igsc_ppr_status::test_run_status — test status. See also: enum igsc_ppr_test_status_mask. Definition at line 1843 of file igsc_lib.h.
  • uint32_t igsc_gfsp_tile_mem_err::uncorr_err — uncorrectable memory errors on this boot and tile. Definition at line 1350 of file igsc_lib.h.
  • uint16_t igsc_device_info::vendor_id — gfx device vendor id. Definition at line 309 of file igsc_lib.h.
  • uint16_t igsc_fwdata_device_info::vendor_id — vendor id. Definition at line 268 of file igsc_lib.h.
  • uint16_t igsc_oprom_device_info_4ids::vendor_id — vendor id. Definition at line 257 of file igsc_lib.h.
  • uint8_t igsc_oem_version::version[IGSC_MAX_OEM_VERSION_LENGTH] — buffer to store oem version. Definition at line 156 of file igsc_lib.h.
  • uint8_t igsc_oprom_version::version[IGSC_OPROM_VER_SIZE] — OPROM Version string. Definition at line 231 of file igsc_lib.h.

🫶 Author 🫶

Generated automatically by Doxygen for Intel Graphics System Controller Firmware Update Library from the source code. 💖

source/version: Intel Graphics System Controller Firmware Update Library · page: ifr(3) · date: as printed in the original footer, bestie — this excerpt doesn’t show the actual date 🎀

📦 where this page comes from