Current File : //usr/src/vboxhost-7.0.26/vboxdrv/include/iprt/linux/version.h
/* $Id: version.h 155244 2023-01-17 14:15:46Z bird $ */
/** @file
* IPRT - Linux kernel version.
*/
/*
* Copyright (C) 2006-2023 Oracle and/or its affiliates.
*
* This file is part of VirtualBox base platform packages, as
* available from https://www.virtualbox.org.
*
* This program is free software; you can redistribute it and/or
* modify it under the terms of the GNU General Public License
* as published by the Free Software Foundation, in version 3 of the
* License.
*
* This program is distributed in the hope that it will be useful, but
* WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, see <https://www.gnu.org/licenses>.
*
* The contents of this file may alternatively be used under the terms
* of the Common Development and Distribution License Version 1.0
* (CDDL), a copy of it is provided in the "COPYING.CDDL" file included
* in the VirtualBox distribution, in which case the provisions of the
* CDDL are applicable instead of those of the GPL.
*
* You may elect to license modified versions of this file under the
* terms and conditions of either the GPL or the CDDL or both.
*
* SPDX-License-Identifier: GPL-3.0-only OR CDDL-1.0
*/
#ifndef IPRT_INCLUDED_linux_version_h
#define IPRT_INCLUDED_linux_version_h
#ifndef RT_WITHOUT_PRAGMA_ONCE
# pragma once
#endif
#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
* Evaluates to true if the linux kernel version is equal or higher to the
* one specfied. */
#define RTLNX_VER_MIN(a_Major, a_Minor, a_Patch) \
(LINUX_VERSION_CODE >= KERNEL_VERSION(a_Major, a_Minor, a_Patch))
/** @def RTLNX_VER_MAX
* Evaluates to true if the linux kernel version is less to the one specfied
* (exclusive). */
#define RTLNX_VER_MAX(a_Major, a_Minor, a_Patch) \
(LINUX_VERSION_CODE < KERNEL_VERSION(a_Major, a_Minor, a_Patch))
/** @def RTLNX_VER_RANGE
* Evaluates to true if the linux kernel version is equal or higher to the given
* minimum version and less (but not equal) to the maximum version (exclusive). */
#define RTLNX_VER_RANGE(a_MajorMin, a_MinorMin, a_PatchMin, a_MajorMax, a_MinorMax, a_PatchMax) \
( LINUX_VERSION_CODE >= KERNEL_VERSION(a_MajorMin, a_MinorMin, a_PatchMin) \
&& LINUX_VERSION_CODE < KERNEL_VERSION(a_MajorMax, a_MinorMax, a_PatchMax) )
/** @def RTLNX_RHEL_MIN
* Require a minium RedHat release.
* @param a_iMajor The major release number (RHEL_MAJOR).
* @param a_iMinor The minor release number (RHEL_MINOR).
* @sa RTLNX_RHEL_MAX, RTLNX_RHEL_RANGE, RTLNX_RHEL_MAJ_PREREQ
*/
#if defined(RHEL_MAJOR) && defined(RHEL_MINOR)
# define RTLNX_RHEL_MIN(a_iMajor, a_iMinor) \
((RHEL_MAJOR) > (a_iMajor) || ((RHEL_MAJOR) == (a_iMajor) && (RHEL_MINOR) >= (a_iMinor)))
#else
# define RTLNX_RHEL_MIN(a_iMajor, a_iMinor) (0)
#endif
/** @def RTLNX_RHEL_MAX
* Require a maximum RedHat release, true for all RHEL versions below it.
* @param a_iMajor The major release number (RHEL_MAJOR).
* @param a_iMinor The minor release number (RHEL_MINOR).
* @sa RTLNX_RHEL_MIN, RTLNX_RHEL_RANGE, RTLNX_RHEL_MAJ_PREREQ
*/
#if defined(RHEL_MAJOR) && defined(RHEL_MINOR)
# define RTLNX_RHEL_MAX(a_iMajor, a_iMinor) \
((RHEL_MAJOR) < (a_iMajor) || ((RHEL_MAJOR) == (a_iMajor) && (RHEL_MINOR) < (a_iMinor)))
#else
# define RTLNX_RHEL_MAX(a_iMajor, a_iMinor) (0)
#endif
/** @def RTLNX_RHEL_RANGE
* Check that it's a RedHat kernel in the given version range.
* The max version is exclusive, the minimum inclusive.
* @sa RTLNX_RHEL_MIN, RTLNX_RHEL_MAX, RTLNX_RHEL_MAJ_PREREQ
*/
#if defined(RHEL_MAJOR) && defined(RHEL_MINOR)
# define RTLNX_RHEL_RANGE(a_iMajorMin, a_iMinorMin, a_iMajorMax, a_iMinorMax) \
(RTLNX_RHEL_MIN(a_iMajorMin, a_iMinorMin) && RTLNX_RHEL_MAX(a_iMajorMax, a_iMinorMax))
#else
# define RTLNX_RHEL_RANGE(a_iMajorMin, a_iMinorMin, a_iMajorMax, a_iMinorMax) (0)
#endif
/** @def RTLNX_RHEL_MAJ_PREREQ
* Require a minimum minor release number for the given RedHat release.
* @param a_iMajor RHEL_MAJOR must _equal_ this.
* @param a_iMinor RHEL_MINOR must be greater or equal to this.
* @sa RTLNX_RHEL_MIN, RTLNX_RHEL_MAX
*/
#if defined(RHEL_MAJOR) && defined(RHEL_MINOR)
# define RTLNX_RHEL_MAJ_PREREQ(a_iMajor, a_iMinor) ((RHEL_MAJOR) == (a_iMajor) && (RHEL_MINOR) >= (a_iMinor))
#else
# define RTLNX_RHEL_MAJ_PREREQ(a_iMajor, a_iMinor) (0)
#endif
/** @def RTLNX_SUSE_MAJ_PREREQ
* Require a minimum minor release number for the given SUSE release.
* @param a_iMajor CONFIG_SUSE_VERSION must _equal_ this.
* @param a_iMinor CONFIG_SUSE_PATCHLEVEL must be greater or equal to this.
*/
#if defined(CONFIG_SUSE_VERSION) && defined(CONFIG_SUSE_PATCHLEVEL)
# define RTLNX_SUSE_MAJ_PREREQ(a_iMajor, a_iMinor) ((CONFIG_SUSE_VERSION) == (a_iMajor) && (CONFIG_SUSE_PATCHLEVEL) >= (a_iMinor))
#else
# define RTLNX_SUSE_MAJ_PREREQ(a_iMajor, a_iMinor) (0)
#endif
#if defined(UTS_UBUNTU_RELEASE_ABI) || defined(DOXYGEN_RUNNING)
/** Hack to make the UTS_UBUNTU_RELEASE_ABI palatable by the C preprocesor.
*
* While the Ubuntu kernel ABI version looks like a decimal number, some
* kernels has a leading zero (e.g. 050818) that makes the preprocessor think
* it's an octal number. To work around that, we turn it into an hexadecimal
* number by prefixing it with '0x'. */
# define RTLNX_UBUNTU_ABI(a_iAbi) (RT_CONCAT(0x,a_iAbi))
/** @def RTLNX_UBUNTU_ABI_MIN
* Require Ubuntu release ABI to be equal or newer than specified version.
*
* The kernel version should exactly match the specified @a a_iMajor, @a
* a_iMinor and @a a_iPatch. The @a a_iAbi number should be equal to or greater
* than the current ABI version.
*
* @param a_iMajor The major kernel version number.
* @param a_iMinor The minor kernel version number.
* @param a_iPatch The kernel patch level.
* @param a_iAbi Ubuntu kernel ABI version number (inclusive).
*/
# 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 ABI to be older than specified version.
*
* The kernel version should exactly match the specified @a a_iMajor, @a
* a_iMinor and @a a_iPatch. The @a a_iAbi number should be less than the
* current ABI version.
*
* @param a_iMajor The major kernel version number.
* @param a_iMinor The minor kernel version number.
* @param a_iPatch The kernel patch level.
* @param a_iAbi Ubuntu kernel ABI version number (exclusive).
*/
# 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_ABI_RANGE
* Require Ubuntu release ABI to be in specified range.
*
* The kernel version should exactly match the specified @a a_iMajor, @a
* a_iMinor and @a a_iPatch. The numbers @a a_iAbiMin and @a a_iAbiMax specify
* ABI versions range. The max ABI 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 kernel patch level.
* @param a_iAbiMin The minimum Ubuntu kernel ABI version number (inclusive).
* @param a_iAbiMax The maximum Ubuntu kernel ABI version number (exclusive).
*/
# 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_iAbiMax) (0)
#endif /* !UTS_UBUNTU_RELEASE_ABI */
#endif /* !IPRT_INCLUDED_linux_version_h */
Mini Shell