8 files changed, 32 insertions, 0 deletions

diff --git a/sys/amd64/include/param.h b/sys/amd64/include/param.h
index 7cf1286721d8..16c30adc6700 100644
--- a/sys/amd64/include/param.h
+++ b/sys/amd64/include/param.h
@@ -89,6 +89,10 @@
 #define	ALIGN(p)		_ALIGN(p)
 #define	ALIGNED_POINTER(p,t)	_ALIGNED_POINTER(p,t)
 
+/*
+ * CACHE_LINE_SIZE is the compile-time maximum cache line size for an
+ * architecture.  It should be used with appropriate caution.
+ */
 #ifndef CACHE_LINE_SHIFT
 #define	CACHE_LINE_SHIFT	6
 #endif
diff --git a/sys/arm/include/param.h b/sys/arm/include/param.h
index 6e3ee5929bc3..4a83e2721f30 100644
--- a/sys/arm/include/param.h
+++ b/sys/arm/include/param.h
@@ -81,6 +81,10 @@
 #define	ALIGNBYTES	_ALIGNBYTES
 #define	ALIGN(p)	_ALIGN(p)
 
+/*
+ * CACHE_LINE_SIZE is the compile-time maximum cache line size for an
+ * architecture.  It should be used with appropriate caution.
+ */
 #ifndef CACHE_LINE_SHIFT
 #define	CACHE_LINE_SHIFT	6
 #endif
diff --git a/sys/i386/include/param.h b/sys/i386/include/param.h
index d9a3cdaf3434..abf855d06620 100644
--- a/sys/i386/include/param.h
+++ b/sys/i386/include/param.h
@@ -74,6 +74,10 @@
 #define ALIGNBYTES	_ALIGNBYTES
 #define ALIGN(p)	_ALIGN(p)
 
+/*
+ * CACHE_LINE_SIZE is the compile-time maximum cache line size for an
+ * architecture.  It should be used with appropriate caution.
+ */
 #ifndef CACHE_LINE_SHIFT
 #define	CACHE_LINE_SHIFT	6
 #endif
diff --git a/sys/ia64/include/param.h b/sys/ia64/include/param.h
index f9a9c4a0b0a2..4130ec475321 100644
--- a/sys/ia64/include/param.h
+++ b/sys/ia64/include/param.h
@@ -99,6 +99,10 @@
 #define	ALIGN(p)		_ALIGN(p)
 #define ALIGNED_POINTER(p,t)	_ALIGNED_POINTER(p,t)
 
+/*
+ * CACHE_LINE_SIZE is the compile-time maximum cache line size for an
+ * architecture.  It should be used with appropriate caution.
+ */
 #ifndef CACHE_LINE_SHIFT
 #define	CACHE_LINE_SHIFT	6
 #endif
diff --git a/sys/mips/include/param.h b/sys/mips/include/param.h
index 55f877f17e7a..af1e06fad3e1 100644
--- a/sys/mips/include/param.h
+++ b/sys/mips/include/param.h
@@ -89,6 +89,10 @@
 #define	ALIGNBYTES	_ALIGNBYTES
 #define	ALIGN(p)	_ALIGN(p)
 
+/*
+ * CACHE_LINE_SIZE is the compile-time maximum cache line size for an
+ * architecture.  It should be used with appropriate caution.
+ */
 #ifndef CACHE_LINE_SHIFT
 #define	CACHE_LINE_SHIFT	6
 #endif
diff --git a/sys/powerpc/include/param.h b/sys/powerpc/include/param.h
index 7dddb30b9160..cab873efc1c3 100644
--- a/sys/powerpc/include/param.h
+++ b/sys/powerpc/include/param.h
@@ -79,6 +79,10 @@
 #define	ALIGNBYTES	_ALIGNBYTES
 #define	ALIGN(p)	_ALIGN(p)
 
+/*
+ * CACHE_LINE_SIZE is the compile-time maximum cache line size for an
+ * architecture.  It should be used with appropriate caution.
+ */
 #ifndef CACHE_LINE_SHIFT
 #define	CACHE_LINE_SHIFT	7
 #endif
diff --git a/sys/sparc64/include/param.h b/sys/sparc64/include/param.h
index e8f783f180b4..b90997176d42 100644
--- a/sys/sparc64/include/param.h
+++ b/sys/sparc64/include/param.h
@@ -71,6 +71,10 @@
 #define ALIGNBYTES	_ALIGNBYTES
 #define ALIGN(p)	_ALIGN(p)
 
+/*
+ * CACHE_LINE_SIZE is the compile-time maximum cache line size for an
+ * architecture.  It should be used with appropriate caution.
+ */
 #ifndef CACHE_LINE_SHIFT
 #define	CACHE_LINE_SHIFT	6
 #endif
diff --git a/sys/sun4v/include/param.h b/sys/sun4v/include/param.h
index 4d7b42ebdead..aca3c375e3c9 100644
--- a/sys/sun4v/include/param.h
+++ b/sys/sun4v/include/param.h
@@ -71,6 +71,10 @@
 #define ALIGNBYTES	_ALIGNBYTES
 #define ALIGN(p)	_ALIGN(p)
 
+/*
+ * CACHE_LINE_SIZE is the compile-time maximum cache line size for an
+ * architecture.  It should be used with appropriate caution.
+ */
 #ifndef CACHE_LINE_SHIFT
 #define	CACHE_LINE_SHIFT	6
 #endif