diff --git a/sys/include/saul_reg.h b/sys/include/saul_reg.h index 624e1db1b3..ec2ae81588 100644 --- a/sys/include/saul_reg.h +++ b/sys/include/saul_reg.h @@ -72,6 +72,16 @@ int saul_reg_add(saul_reg_t *dev); /** * @brief Unregister a device from the SAUL registry * + * @warning Removing the device at runtime can send applications that have + * looked up that device into invalid states, and should thus be + * avoided. + * + * @warning This function must only be used by drivers that advise developers + * using them on how to prevent race conditions when using SAUL. + * + * @deprecated This function will be removed soon as it is practically unusable + * for the above reasons. + * * @param[in] dev pointer to a registry entry * * @return 0 on success