This library is only partially API and ABI stable. Keeping unused, unsafe and deprecated functions around forever is a maintenance burden and so symbols are removed when branching for new minor versions.
Use ./contrib/migrate.py
to migrate up out-of-tree plugins to the new API.
Remember: Plugins should be upstream!
fu_common_is_cpu_intel()
: Usefu_common_get_cpu_vendor()
instead.fu_firmware_strparse_uintXX()
: Usefu_firmware_strparse_uintXX_safe()
instead.fu_plugin_get_usb_context()
: Remove, as no longer required.fu_plugin_set_usb_context()
: Remove, as no longer required.fu_plugin_runner_usb_device_added()
: Usefu_plugin_runner_backend_device_added()
instead.fu_plugin_runner_udev_device_added()
: Usefu_plugin_runner_backend_device_added()
instead.fu_plugin_runner_udev_device_changed()
: Usefu_plugin_runner_backend_device_added()
instead.FuHidDevice->open()
: Use theFuDevice
superclass instead.FuHidDevice->close()
: Use theFuDevice
superclass instead.FuUsbDevice->probe()
: Use theFuDevice
superclass instead.FuUsbDevice->open()
: Use theFuDevice
superclass instead.FuUsbDevice->close()
: Use theFuDevice
superclass instead.FuUdevDevice->to_string()
: Use theFuDevice
superclass instead.FuUdevDevice->probe()
: Use theFuDevice
superclass instead.FuUdevDevice->open()
: Use theFuDevice
superclass instead.FuUdevDevice->close()
: Use theFuDevice
superclass instead.
fu_device_get_protocol()
: Usefu_device_get_protocols()
instead.fu_device_set_protocol()
: Usefu_device_add_protocol()
instead.
fu_device_has_custom_flag()
: Usefu_device_has_private_flag()
instead.
fu_device_sleep_with_progress()
: Usefu_progress_sleep()
instead -- but be aware the unit of time has changed from seconds to milliseconds.fu_device_get_status()
: Usefu_progress_get_status()
instead.fu_device_set_status()
: Usefu_progress_set_status()
instead.fu_device_get_progress()
: Usefu_progress_get_percentage()
instead.fu_device_set_progress_full()
: Usefu_progress_set_percentage_full()
instead.fu_device_set_progress()
: Usefu_progress_set_steps()
,fu_progress_add_step()
andfu_progress_done()
-- see theFuProgress
docs for more details!
fu_udev_device_pread_full()
: Usefu_udev_device_pread()
instead -- as the latter now specifies the buffer length.fu_udev_device_pread_full()
: Usefu_udev_device_pwrite()
instead -- as the latter now specifies the buffer length.fu_udev_device_ioctl_full()
: Usefu_udev_device_ioctl()
instead -- as the latter now always specifies the timeout.fu_udev_device_new_full()
: Usefu_udev_device_new()
instead -- as the latter always specifies the context.fu_usb_device_new_full()
: Usefu_usb_device_new()
instead -- as the latter always specifies the context.fu_device_new_with_context()
: Usefu_device_new()
instead -- as the latter always specifies the context.fu_plugin_has_custom_flag()
: Usefu_plugin_has_private_flag()
instead.fu_efivar_secure_boot_enabled_full()
: Usefu_efivars_get_secure_boot()
instead -- as the latter always specifies the error.fu_progress_add_step()
: Add a 4th parameter to the function to specify the nice name for the step, or NULL.fu_backend_setup()
: Now requires aFuProgress
, although it can be ignored.fu_backend_coldplug
: Now requires aFuProgress
, although it can be ignored.FuPluginVfuncs->setup
: Now requires aFuProgress
, although it can be ignored.FuPluginVfuncs->coldplug
: Now requires aFuProgress
, although it can be ignored.fu_common_crc*
: Usefu_crc
prefix, i.e. remove the_common
fu_common_sum*
: Usefu_sum
prefix, i.e. remove the_common
fu_byte_array_set_size_full()
: Usefu_byte_array_set_size
instead -- as the latter now always specifies the fill char.fu_common_string*
: Usefu_string
prefix, i.e. remove the_common
fu_common_bytes*
: Usefu_bytes
prefix, i.e. remove the_common
fu_common_set_contents_bytes()
: Usefu_bytes_set_contents()
insteadfu_common_get_contents_bytes()
: Usefu_bytes_get_contents()
insteadfu_common_read*
: Usefu_memread
prefix, i.e. replace the_common
with_mem
fu_common_write*
: Usefu_memwrite
prefix, i.e. replace the_common
with_mem
fu_common_bytes_compare_raw()
: Usefu_memcmp_safe()
insteadfu_common_spawn_sync()
: Useg_spawn_sync()
instead, or ideally not at all!fu_common_extract_archive()
: UseFuArchiveFirmware()
instead.fu_common_instance_id_strsafe()
: Usefu_device_add_instance_strsafe()
instead.fu_common_kernel_locked_down()
: Usefu_kernel_locked_down
instead.fu_common_check_kernel_version()
: Usefu_kernel_check_version
instead.fu_common_get_firmware_search_path()
: Usefu_kernel_get_firmware_search_path
instead.fu_common_set_firmware_search_path()
: Usefu_kernel_set_firmware_search_path
instead.fu_common_reset_firmware_search_path()
: Usefu_kernel_reset_firmware_search_path
instead.fu_common_firmware_builder()
: You should not be using this.fu_common_realpath()
: You should not be using this.fu_common_uri_get_scheme()
: You should not be using this.fu_common_dump*
: Usefu_dump
prefix, i.e. remove the_common
fu_common_error_array_get_best()
: You should not be using this.fu_common_cpuid()
: Usefu_cpuid
instead.fu_common_get_cpu_vendor()
: Usefu_cpu_get_vendor
instead.fu_common_vercmp_full()
: Usefu_version_compare()
instead.fu_common_version_ensure_semver()
: Usefu_version_ensure_semver()
instead.fu_common_version_from_uint*()
: Usefu_version_from_uint*()
instead.fu_common_strtoull()
: Usefu_strtoull()
instead -- as the latter always specifies the error.fu_smbios_to_string()
: Usefu_firmware_to_string()
instead -- asFuSmbios
is aFuFirmware
superclass.fu_common_cab_build_silo()
: You should not be using this.fu_i2c_device_read_full()
: Usefu_i2c_device_read
instead.fu_i2c_device_write_full()
: Usefu_i2c_device_write
instead.fu_firmware_parse_full()
: Remove theaddr_end
parameter, and ensure thatoffset
is agsize
.
fu_volume_new_esp_default()
: Usefu_context_get_esp_volumes()
instead.fu_plugin_set_secure_config_value()
: SetFWUPD_PLUGIN_FLAG_SECURE_CONFIG
and usefu_plugin_set_config_value()
fu_mei_device_connect()
: Drop the explicit GUID parameter and match in the quirk file instead.fu_context_get_smbios_data()
: Add aGError
fu_plugin_get_config_value()
: Add the default value as the last parameterfu_plugin_get_config_value_boolean()
: Add the default value as the last parameter
fu_security_attrs_get_by_appstream_id()
: Add aGError
fu_device_build_instance_id_quirk": rename to
fu_device_build_instance_id_full()`fu_smbios_get_data()
: Now returns a array ofGByte
sfu_udev_device_get_fd()
: Usefu_udev_device_get_io_channel()
insteadfu_device_emit_request()
: AddFuProgress
andGError
fu_device_set_version_from_uint16()
: Usefu_version_from_uint16()
fromFuDeviceClass->convert_version
insteadfu_device_set_version_from_uint24()
: Usefu_version_from_uint24()
fromFuDeviceClass->convert_version
insteadfu_device_set_version_from_uint32()
: Usefu_version_from_uint32()
fromFuDeviceClass->convert_version
insteadfu_device_set_version_from_uint64()
: Usefu_version_from_uint64()
fromFuDeviceClass->convert_version
instead
fu_hid_device_parse_descriptor()
: Usefu_hid_device_parse_descriptors()
insteadfu_io_channel_new_file()
: Add someFuIoChannelOpenFlag
, e.g.FU_IO_CHANNEL_OPEN_FLAG_READ|FU_IO_CHANNEL_OPEN_FLAG_WRITE
fu_udev_device_set_flags()
: Usefu_udev_device_add_flag()
insteadfu_udev_device_get_slot_depth()
: Usefu_udev_device_get_subsystem_depth()
insteadfu_usb_device_is_open()
: Usefu_device_has_internal_flag(device, FU_DEVICE_INTERNAL_FLAG_IS_OPEN)
insteadfu_udev_device_ioctl
: Add someFuUdevDeviceIoctlFlags
, e.g.FU_UDEV_DEVICE_IOCTL_FLAG_RETRY
fu_udev_device_write_sysfs()
: Add a timeout in millisecondsfu_udev_device_get_sysfs_attr_uint64()
: Usefu_udev_device_read_sysfs()
insteadfu_udev_device_get_sysfs_attr
: Usefu_udev_device_read_sysfs()
insteadfu_i2c_device_get_bus_number()
: Usefu_udev_device_get_number()
insteadfu_usb_device_set_open_retry_count()
: UseFU_DEVICE_INTERNAL_FLAG_RETRY_OPEN
instead