Changeset 88973 in vbox

Timestamp:

May 11, 2021 10:44:27 AM (4 years ago)

Author:

vboxsync

svn:sync-xref-src-repo-rev:

144310

Message:

iprt: introduce Ubuntu kernel version checkers, bugref:10007.

File:

• trunk/include/iprt/linux/version.h (modified) (2 diffs)

trunk/include/iprt/linux/version.h

@@ -32 +32 @@
 
 #include <linux/version.h>
+
+/* We need utsrelease.h in order to detect Ubuntu kernel,
+ * i.e. check if UTS_UBUNTU_RELEASE_ABI is defined. Support kernels
+ * starting from Ubuntu 14.04 Trusty which is based on upstream
+ * kernel 3.13.11. */
+#if (LINUX_VERSION_CODE >= KERNEL_VERSION(3,13,11))
+# include <generated/utsrelease.h>
+# include <iprt/cdefs.h>
+#endif
 
 /** @def RTLNX_VER_MIN
@@ -116 +125 @@
 
 
+#if defined(UTS_UBUNTU_RELEASE_ABI)
+/** @def RTLNX_UBUNTU_VERSION
+ * Ubuntu kernels are based on upstream kernels and provide
+ * version information with regular KERNEL_VERSION() macro. However,
+ * Ubuntu kernel additionally provides UTS_UBUNTU_RELEASE_ABI macro
+ * which increases with the kernel update while KERNEL_VERSION() info
+ * stays the same.
+ *
+ * UTS_UBUNTU_RELEASE_ABI does not increase constantly, but rather reset
+ * when the next kernel update is based on a newer upstream version (i.e.
+ * KERNEL_VERSION() value has changed). Therefore, in order to compare
+ * Ubuntu kernels, UTS_UBUNTU_RELEASE_ABI macro is treated as a KERNEL_VERSION()
+ * extension and appended to the end of it. So, regular 24-bit-value
+ * of KERNEL_VERSION() becomes 32-bit-value, as can be seen below.
+ *
+ * NOTE: @a_iVer is expected to be in range of [0x000000..0xFFFFFF],
+ * @a_iAbi is expected to be in range of [0x00..0xFF].
+ *
+ * @param a_iVer        The 24-bit-value of kernel version number, result
+ *                      of KERNEL_VERSION() macro.
+ * @param a_iAbi        8-bit Ubuntu kernel ABI version number.
+ */
+# define RTLNX_UBUNTU_VERSION(a_iVer, a_iAbi) \
+    (((a_iVer) << 8) | (RT_MIN((a_iAbi), 0xFF)))
+
+/** @def RTLNX_UBUNTU_MIN
+ * Require Ubuntu release to be equal or newer than specified version.
+ * @param a_iMajor      The major kernel version number.
+ * @param a_iMinor      The minor kernel version number.
+ * @param a_iPatch      The micro kernel version number.
+ * @param a_iAbi        Ubuntu kernel ABI version number.
+ */
+# define RTLNX_UBUNTU_MIN(a_iMajor, a_iMinor, a_iPatch, a_iAbi) \
+    (   RTLNX_UBUNTU_VERSION(LINUX_VERSION_CODE, UTS_UBUNTU_RELEASE_ABI) \
+     >= RTLNX_UBUNTU_VERSION(KERNEL_VERSION(a_iMajor, a_iMinor, a_iPatch), a_iAbi) )
+
+/** @def RTLNX_UBUNTU_MAX
+ * Require Ubuntu release to be older than specified version.
+ * @param a_iMajor      The major kernel version number.
+ * @param a_iMinor      The minor kernel version number.
+ * @param a_iPatch      The micro kernel version number.
+ * @param a_iAbi        Ubuntu kernel ABI version number.
+ */
+# define RTLNX_UBUNTU_MAX(a_iMajor, a_iMinor, a_iPatch, a_iAbi) \
+    (   RTLNX_UBUNTU_VERSION(LINUX_VERSION_CODE, UTS_UBUNTU_RELEASE_ABI) \
+     <  RTLNX_UBUNTU_VERSION(KERNEL_VERSION(a_iMajor, a_iMinor, a_iPatch), a_iAbi) )
+#else /* !UTS_UBUNTU_RELEASE_ABI */
+# define RTLNX_UBUNTU_MIN(a_iMajor, a_iMinor, a_iPatch, a_iAbi)  (0)
+# define RTLNX_UBUNTU_MAX(a_iMajor, a_iMinor, a_iPatch, a_iAbi)  (0)
+#endif /* !UTS_UBUNTU_RELEASE_ABI */
+
 #endif /* !IPRT_INCLUDED_linux_version_h */