CLEANUP: lists/tree-wide: rename some list operations to avoid some confusion
The current "ADD" vs "ADDQ" is confusing because when thinking in terms
of appending at the end of a list, "ADD" naturally comes to mind, but
here it does the opposite, it inserts. Several times already it's been
incorrectly used where ADDQ was expected, the latest of which was a
fortunate accident explained in 6fa922562 ("CLEANUP: stream: explain
why we queue the stream at the head of the server list").
Let's use more explicit (but slightly longer) names now:
LIST_ADD -> LIST_INSERT
LIST_ADDQ -> LIST_APPEND
LIST_ADDED -> LIST_INLIST
LIST_DEL -> LIST_DELETE
The same is true for MT_LISTs, including their "TRY" variant.
LIST_DEL_INIT keeps its short name to encourage to use it instead of the
lazier LIST_DELETE which is often less safe.
The change is large (~674 non-comment entries) but is mechanical enough
to remain safe. No permutation was performed, so any out-of-tree code
can easily map older names to new ones.
The list doc was updated.
diff --git a/addons/ot/include/define.h b/addons/ot/include/define.h
index 8769161..d34f6b9 100644
--- a/addons/ot/include/define.h
+++ b/addons/ot/include/define.h
@@ -53,7 +53,7 @@
#define FLT_OT_RUN_ONCE(f) do { static bool __f = 1; if (__f) { __f = 0; f; } } while (0)
#define FLT_OT_LIST_ISVALID(a) (((a) != NULL) && ((a)->n != NULL) && ((a)->p != NULL))
-#define FLT_OT_LIST_DEL(a) do { if (FLT_OT_LIST_ISVALID(a)) LIST_DEL(a); } while (0)
+#define FLT_OT_LIST_DEL(a) do { if (FLT_OT_LIST_ISVALID(a)) LIST_DELETE(a); } while (0)
#define FLT_OT_LIST_DESTROY(t,h) \
do { \
struct flt_ot_conf_##t *_ptr, *_back; \
diff --git a/addons/ot/src/conf.c b/addons/ot/src/conf.c
index 626d418..71db967 100644
--- a/addons/ot/src/conf.c
+++ b/addons/ot/src/conf.c
@@ -67,7 +67,7 @@
retptr->cfg_line = linenum;
if (head != NULL)
- LIST_ADDQ(head, &(retptr->list));
+ LIST_APPEND(head, &(retptr->list));
} else {
FLT_OT_ERR("out of memory");
}
@@ -680,7 +680,7 @@
}
FLT_OT_DBG(2, "- deleting proxy_log.logsrvs list %s", flt_ot_list_debug(&((*ptr)->proxy_log.logsrvs)));
list_for_each_entry_safe(logsrv, logsrvback, &((*ptr)->proxy_log.logsrvs), list) {
- LIST_DEL(&(logsrv->list));
+ LIST_DELETE(&(logsrv->list));
FLT_OT_FREE(logsrv);
}
FLT_OT_LIST_DESTROY(ph_group, &((*ptr)->ph_groups));
diff --git a/addons/ot/src/scope.c b/addons/ot/src/scope.c
index ace8a22..8305f24 100644
--- a/addons/ot/src/scope.c
+++ b/addons/ot/src/scope.c
@@ -256,7 +256,7 @@
retptr->ref_type = ref_type;
retptr->ref_span = ref_span;
retptr->ref_ctx = ref_ctx;
- LIST_ADD(&(rt_ctx->spans), &(retptr->list));
+ LIST_INSERT(&(rt_ctx->spans), &(retptr->list));
FLT_OT_DBG_SCOPE_SPAN("new span ", retptr);
@@ -352,7 +352,7 @@
retptr->id_len = id_len;
retptr->smp_opt_dir = dir;
retptr->context = span_ctx;
- LIST_ADD(&(rt_ctx->contexts), &(retptr->list));
+ LIST_INSERT(&(rt_ctx->contexts), &(retptr->list));
FLT_OT_DBG_SCOPE_CONTEXT("new context ", retptr);