target,flash: allow target_free_working_area on NULL area pointer

[openocd.git] / src / target / target.h

diff --git a/src/target/target.h b/src/target/target.h
index 99ec2be104b178a49fa08a241775045fa77ee04f..6ef8f10e0719396b027cd2f50edd9e9a0b41c3d0 100644 (file)
--- a/src/target/target.h
+++ b/src/target/target.h
@@ -726,6 +726,13 @@ int target_alloc_working_area(struct target *target,
  */
 int target_alloc_working_area_try(struct target *target,
                uint32_t size, struct working_area **area);
  */
 int target_alloc_working_area_try(struct target *target,
                uint32_t size, struct working_area **area);

+/**
+ * Free a working area.
+ * Restore target data if area backup is configured.
+ * @param target
+ * @param area Pointer to the area to be freed or NULL
+ * @returns ERROR_OK if successful; error code if restore failed
+ */

 int target_free_working_area(struct target *target, struct working_area *area);
 void target_free_all_working_areas(struct target *target);
 uint32_t target_get_working_area_avail(struct target *target);
 int target_free_working_area(struct target *target, struct working_area *area);
 void target_free_all_working_areas(struct target *target);
 uint32_t target_get_working_area_avail(struct target *target);