include/tools.h: fix checkpatch.pl warnings

Fix all of the warnings/errors reported by Linux Kernel's checkpatch.pl,
except SPDX_LICENSE_TAG.  It also introduces reverse xmas tree local
variable declarations and header file reordering.

In summary, this patch fixes the following checkpatch.pl
recommendations:
total: 1 errors, 3 warnings, 73 lines checked

Signed-off-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>

diff --git a/include/libcgroup/tools.h b/include/libcgroup/tools.h
index 2381fa65ff05949f5412bb231d73a076d7e54567..9fcbb151f7c8e9eb8261a2567440f98f2f421896 100644 (file)
--- a/include/libcgroup/tools.h
+++ b/include/libcgroup/tools.h
@@ -32,13 +32,13 @@ extern "C" {
  *
  * @param cg Input/Output cgroup. Must be initialized and freed by the caller
  * @param version Cgroup version of cg  If set to CGROUP_UNK, the versions
- *               stored within each controller will be used.  Otherwise this
- *               value will be used to override the cg param's controller
- *               versions
+ *               stored within each controller will be used.  Otherwise this
+ *               value will be used to override the cg param's controller
+ *               versions
  * @param ignore_unmappable Ignore failures due to settings that cannot be
- *                          converted from one cgroup version to another
+ *                         converted from one cgroup version to another
  */
-int cgroup_cgxget(struct cgroup ** cg,
+int cgroup_cgxget(struct cgroup **cg,
                  enum cg_version_t version, bool ignore_unmappable);
 
 /**