libudev

Releases

1. ▸▾0.3.017 Jan 2021Breaking2 sources agree

   There are, however, some breaking changes to the API that are unrelated to the changes in resource management:

   This release changes the resource management strategy. Tracking lifetimes of dependent resources makes for a less-ergonomic API. That has been replaced with reference-counting. There are no known backwards-compatibility issues with this change, so existing code should not have to be updated for compatibility with reference-counting.

   There are, however, some breaking changes to the API that are unrelated to the changes in resource management:

   1. Context::device_from_syspath() has been moved to Device::from_syspath(). Upgrading involves a search-and-replace. Anywhere you have the following code:

      context.device_from_syspath(path);

      should be replaced with:

      Device::from_syspath(&context, path);

   2. Several methods on Device changed their return type to account for the possibility of the C library returning NULL pointers:

      • Device::syspath() returns Option<&Path> instead of &Path.
      • Device::devpath() returns Option<&OsStr> instead of &OsStr.
      • Device::subsystem() returns Option<&OsStr> instead of &OsStr.
      • Device::sysname() returns Option<&OsStr> instead of &OsStr.

      Client code will have to decide how to handle a None return value.

   Added

   • Implemented Clone for Context.

   Fixed

   • Fixed several issues related to lifetimes.
   • Handled possible NULL return from udev_device_get_syspath(), udev_device_get_devpath(), udev_device_get_subsystem(), and udev_device_get_sysname().
   • Reduced memory footprint of several types to a single pointer.
   • Reduced unnecessary memory allocations when iterating devices and setting up a monitor.

   Changed

   • Replaced explicit lifetimes with reference counting.
   • Moved Context::device_from_syspath() to Device::from_syspath().
   • Changed return type of Device::syspath(), Device::devpath(), Device::subsystem(), and
     Device::sysname() to Option<...>.