From 677048bed502bd09ba29e0de3c4ccf31c25095ac Mon Sep 17 00:00:00 2001
From: Federico Vaga <federico.vaga@gmail.com>
Date: Tue, 14 Aug 2012 14:31:31 +0200
Subject: [PATCH] zio.h: add comments to explain ZIO_OBJ_NAME_LEN and
 ZIO_NAME_LEN

Signed-off-by: Federico Vaga <federico.vaga@gmail.com>
Acked-by: Alessandro Rubini <rubini@gnudd.com>
---
 include/linux/zio.h | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/include/linux/zio.h b/include/linux/zio.h
index 08b4f4d..54de5f4 100644
--- a/include/linux/zio.h
+++ b/include/linux/zio.h
@@ -7,10 +7,20 @@
 #define ZIO_MAJOR_VERSION 0
 #define ZIO_MINOR_VERSION 6
 
-#define ZIO_OBJ_NAME_LEN 12 /* name for registered object and ctrl struct */
+/*
+ * ZIO_OBJ_NAME_LEN is the name's length used for registered objects
+ * (such as trigger_type, buffer_type and zio_device) and thus shown in
+ * the control structure.
+ */
+#define ZIO_OBJ_NAME_LEN 12
 
 #ifdef __KERNEL__ /* Nothing more is for user space */
 
+/*
+ * ZIO_NAME_LEN is the full name length used in the head structures.
+ * It is sometimes built at run time, for example buffer instances
+ * have composite names. Also, all attributes names are this long.
+ */
 #define ZIO_NAME_LEN 32 /* full name */
 
 #include <linux/sysfs.h>
-- 
GitLab