From: Andre Noll <maan@systemlinux.org>
Date: Sat, 31 May 2008 17:18:31 +0000 (+0200)
Subject: Fix a design flaw in osl_rbtree_loop() and osl_rbtree_loop_reverse().
X-Git-Tag: v0.1.0~93
X-Git-Url: http://git.tuebingen.mpg.de/?p=osl.git;a=commitdiff_plain;h=666bc65dbbdad3ae9b4abbaf2683104cffe08b1e

Fix a design flaw in osl_rbtree_loop() and osl_rbtree_loop_reverse().

In case the loop was terminated because the user-supplied loop function
returned a negative value, the old code returned this value back to
the caller of osl_rbtree_loop(). This is bad because osl functions
should only return osl error codes.

Moreover, the return value of the loop function might coincide with an
osl error code making it impossible to distinguish between the two
errors.

The fix is to introduce a new osl error code E_OSL_LOOP which is returned
by osl_rbtree_loop() in case the loop function returned a negative value.
It's up to the caller to save any further information about the error
in the private_data struct.
---

diff --git a/osl.c b/osl.c
index e1b535c..81b035d 100644
--- a/osl.c
+++ b/osl.c
@@ -1739,7 +1739,7 @@ __export int osl_get_row(const struct osl_table *t, unsigned col_num,
 	return 1;
 }
 
-static int rbtree_loop(struct osl_column *col,  void *private_data,
+static int rbtree_loop(struct osl_column *col, void *private_data,
 		osl_rbtree_loop_func *func)
 {
 	struct rb_node *n, *tmp;
@@ -1749,14 +1749,13 @@ static int rbtree_loop(struct osl_column *col,  void *private_data,
 			n;
 			n = tmp, tmp = tmp? rb_next(tmp) : NULL) {
 		struct osl_row *r = get_row_pointer(n, col->rbtree_num);
-		int ret = func(r, private_data);
-		if (ret < 0)
-			return ret;
+		if (func(r, private_data) < 0)
+			return -E_OSL_LOOP;
 	}
 	return 1;
 }
 
-static int rbtree_loop_reverse(struct osl_column *col,  void *private_data,
+static int rbtree_loop_reverse(struct osl_column *col, void *private_data,
 		osl_rbtree_loop_func *func)
 {
 	struct rb_node *n, *tmp;
@@ -1766,9 +1765,8 @@ static int rbtree_loop_reverse(struct osl_column *col,  void *private_data,
 			n;
 			n = tmp, tmp = tmp? rb_prev(tmp) : NULL) {
 		struct osl_row *r = get_row_pointer(n, col->rbtree_num);
-		int ret = func(r, private_data);
-		if (ret < 0)
-			return ret;
+		if (func(r, private_data) < 0)
+			return -E_OSL_LOOP;
 	}
 	return 1;
 }
@@ -1792,7 +1790,7 @@ static int rbtree_loop_reverse(struct osl_column *col,  void *private_data,
  *
  *
  * \return Standard. If the termination of the loop was caused by \a func
- * returning a negative value, this value is returned.
+ * returning a negative value, \p -E_OSL_LOOP is returned.
  *
  * \sa osl_storage_flags, osl_rbtree_loop_reverse(), osl_compare_func.
  */