Changeset 89047 in vbox for trunk/include

Timestamp:

May 14, 2021 1:51:39 PM (4 years ago)

Author:

vboxsync

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

144387

Message:

iprt: Linux: introduce Ubuntu kernel version checker macros, ​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.x. */
+#if (LINUX_VERSION_CODE >= KERNEL_VERSION(3,13,0))
+# include <generated/utsrelease.h>
+# include <iprt/cdefs.h>
+#endif
 
 /** @def RTLNX_VER_MIN
@@ -116 +125 @@
 
 
+#if defined(UTS_UBUNTU_RELEASE_ABI)
+/* Ubuntu kernel ABI version is represented as a constant which can be interpreted
+ * by compiler as an octal constant (e.g. 050818). We add '0x' prefix to it in
+ * order to be able to treat it as a hexadecimal number. */
+# define RTLNX_UBUNTU_ABI(a_iAbi)   (RT_CONCAT(0x,a_iAbi))
+
+/** @def RTLNX_UBUNTU_ABI_MIN
+ * Require Ubuntu release to be equal or newer than specified version.
+ * Kernel version should exactly match to specified @a_iMajor, @a_iMinor
+ * and @a_iPatch. Number @a_iAbi should be equal or greater than current
+ * ABI 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_ABI_MIN(a_iMajor, a_iMinor, a_iPatch, a_iAbi) \
+    (   KERNEL_VERSION(a_iMajor, a_iMinor, a_iPatch) == LINUX_VERSION_CODE \
+     && RTLNX_UBUNTU_ABI(UTS_UBUNTU_RELEASE_ABI) >= RTLNX_UBUNTU_ABI(a_iAbi))
+
+/** @def RTLNX_UBUNTU_ABI_MAX
+ * Require Ubuntu release to be older than specified version.
+ * Kernel version should exactly match to specified @a_iMajor, @a_iMinor
+ * and @a_iPatch. Number @a_iAbi should be less than current ABI 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_ABI_MAX(a_iMajor, a_iMinor, a_iPatch, a_iAbi) \
+    (   KERNEL_VERSION(a_iMajor, a_iMinor, a_iPatch) == LINUX_VERSION_CODE \
+     && RTLNX_UBUNTU_ABI(UTS_UBUNTU_RELEASE_ABI) < RTLNX_UBUNTU_ABI(a_iAbi))
+
+/** @def RTLNX_UBUNTU_RANGE
+ * Require Ubuntu release to be in specified ABI versions range.
+ * Kernel version should exactly match to specified @a_iMajor, @a_iMinor
+ * and @a_iPatch. Numbers @a_iAbiMin and @a_iAbiMax specify ABI versions range.
+ * The max version is exclusive, the minimum inclusive.
+ *
+ * @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_iAbiMin     Ubuntu kernel ABI version number (minimum).
+ * @param a_iAbiMax     Ubuntu kernel ABI version number (maximum).
+ */
+# define RTLNX_UBUNTU_ABI_RANGE(a_iMajor, a_iMinor, a_iPatch, a_iAbiMin, a_iAbiMax) \
+    (   RTLNX_UBUNTU_ABI_MIN(a_iMajor, a_iMinor, a_iPatch, a_iAbiMin) \
+     && RTLNX_UBUNTU_ABI_MAX(a_iMajor, a_iMinor, a_iPatch, a_iAbiMax))
+
+#else /* !UTS_UBUNTU_RELEASE_ABI */
+
+# define RTLNX_UBUNTU_ABI_MIN(a_iMajor, a_iMinor, a_iPatch, a_iAbi) (0)
+# define RTLNX_UBUNTU_ABI_MAX(a_iMajor, a_iMinor, a_iPatch, a_iAbi) (0)
+# define RTLNX_UBUNTU_ABI_RANGE(a_iMajorMin, a_iMinorMin, a_iPatchMin, a_iAbiMin, \
+    a_iMajorMax, a_iMinorMax, a_iPatchMax, a_iAbiMax) (0)
+
+#endif /* !UTS_UBUNTU_RELEASE_ABI */
+
 #endif /* !IPRT_INCLUDED_linux_version_h */