qcacmn: Add qdf debug domain support

In order to support resource leak detection during a specific period of
time, add APIs to allow setting the current debug domain. This allows
for each resource allocation to be tracked against the current debug
domain at the time of allocation. Consumers can then check to ensure
the resources allocated for the current domain are released before
transitioning to a different debug domain.

Change-Id: I1158abbc7e5bd9bd8dc0c47b303386c6229a1b3c
CRs-Fixed: 2144304

qdf/inc/qdf_debug_domain.h

@@ -0,0 +1,66 @@
+/*
+ * Copyright (c) 2017 The Linux Foundation. All rights reserved.
+ *
+ * Permission to use, copy, modify, and/or distribute this software for
+ * any purpose with or without fee is hereby granted, provided that the
+ * above copyright notice and this permission notice appear in all
+ * copies.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL
+ * WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED
+ * WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE
+ * AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
+ * DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
+ * PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
+ * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+ * PERFORMANCE OF THIS SOFTWARE.
+ */
+
+/**
+ * DOC: qdf_debug_domain
+ * QCA driver framework (QDF) debug domain APIs. Debug domains are used to track
+ * resource allocations across different driver states, particularly for runtime
+ * leak detection.
+ */
+
+#ifndef __QDF_DEBUG_DOMAIN_H
+#define __QDF_DEBUG_DOMAIN_H
+
+/**
+ * struct qdf_debug_domain - debug domains for tracking resource allocations
+ * @QDF_DEBUG_DOMAIN_INIT: The default debug domain, tied to driver load
+ * @QDF_DEBUG_DOMAIN_ACTIVE: The active debug domain, tied some "running" state
+ * @QDF_DEBUG_DOMAIN_COUNT: The number of debug domains for iterating, etc.
+ */
+enum qdf_debug_domain {
+	QDF_DEBUG_DOMAIN_INIT,
+	QDF_DEBUG_DOMAIN_ACTIVE,
+
+	/* keep last */
+	QDF_DEBUG_DOMAIN_COUNT,
+};
+
+/**
+ * qdf_debug_domain_get() - Get the current debug domain
+ *
+ * Return: the current debug domain
+ */
+enum qdf_debug_domain qdf_debug_domain_get(void);
+
+/**
+ * qdf_debug_domain_set() - Set the current debug domain
+ * @domain: the domain to change to
+ *
+ * Return: None
+ */
+void qdf_debug_domain_set(enum qdf_debug_domain domain);
+
+/**
+ * qdf_debug_domain_name() - Get the human readable name of a debug domain
+ * @domain: The domain to return the name of
+ *
+ * Return: name of the given domain
+ */
+const char *qdf_debug_domain_name(enum qdf_debug_domain domain);
+
+#endif /* __QDF_DEBUG_DOMAIN_H */

qdf/src/qdf_debug_domain.c

@@ -0,0 +1,59 @@
+/*
+ * Copyright (c) 2017 The Linux Foundation. All rights reserved.
+ *
+ * Permission to use, copy, modify, and/or distribute this software for
+ * any purpose with or without fee is hereby granted, provided that the
+ * above copyright notice and this permission notice appear in all
+ * copies.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL
+ * WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED
+ * WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE
+ * AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
+ * DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
+ * PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
+ * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+ * PERFORMANCE OF THIS SOFTWARE.
+ */
+
+/**
+ * DOC: qdf_debug_domain
+ * QCA driver framework (QDF) debug domain APIs. Debug domains are used to track
+ * resource allocations across different driver states, particularly for runtime
+ * leak detection.
+ */
+
+#include "qdf_debug_domain.h"
+#include "qdf_trace.h"
+
+static enum qdf_debug_domain qdf_debug_domain_current = QDF_DEBUG_DOMAIN_INIT;
+
+enum qdf_debug_domain qdf_debug_domain_get(void)
+{
+	return qdf_debug_domain_current;
+}
+
+void qdf_debug_domain_set(enum qdf_debug_domain domain)
+{
+	QDF_BUG(domain >= QDF_DEBUG_DOMAIN_INIT);
+	if (domain < QDF_DEBUG_DOMAIN_INIT)
+		return;
+
+	QDF_BUG(domain < QDF_DEBUG_DOMAIN_COUNT);
+	if (domain >= QDF_DEBUG_DOMAIN_COUNT)
+		return;
+
+	qdf_debug_domain_current = domain;
+}
+
+const char *qdf_debug_domain_name(enum qdf_debug_domain domain)
+{
+	switch (domain) {
+	case QDF_DEBUG_DOMAIN_INIT:
+		return "Init";
+	case QDF_DEBUG_DOMAIN_ACTIVE:
+		return "Active";
+	default:
+		return "Invalid";
+	}
+}