mirror of
https://gitlab.freedesktop.org/NetworkManager/NetworkManager.git
synced 2025-12-24 23:00:07 +01:00
9c4d86ee80
Add versioned NM_DEPRECATED_IN_* and NM_AVAILABLE_IN_* macros, and tag new/deprecated functions accordingly. (All currently-deprecated functions are assumed to have been deprecated in 0.9.10.) Add NM_VERSION_MIN_REQUIRED and NM_VERSION_MAX_ALLOWED macros which can be set to determine which versions will cause warnings. With the current settings, external consumers of the libnm-util/libnm-glib APIs will have MIN_REQUIRED and MAX_ALLOWED both set to NM_VERSION_0_9_8 by default, meaning they will get warnings about functions added in 0.9.10. NM internally sets NM_VERSION_MAX_ALLOWED to NM_VERSION_NEXT_STABLE to ensure that it is always allowed to use all APIs.
118 lines
3.9 KiB
C
118 lines
3.9 KiB
C
/* -*- Mode: C; tab-width: 4; indent-tabs-mode: t; c-basic-offset: 4 -*- */
|
|
/*
|
|
* This library is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Lesser General Public
|
|
* License as published by the Free Software Foundation; either
|
|
* version 2 of the License, or (at your option) any later version.
|
|
*
|
|
* This library 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
|
|
* Lesser General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Lesser General Public
|
|
* License along with this library; if not, write to the
|
|
* Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
|
|
* Boston, MA 02110-1301 USA.
|
|
*
|
|
* Copyright (C) 2011 Red Hat, Inc.
|
|
*/
|
|
|
|
#ifndef NM_VERSION_H
|
|
#define NM_VERSION_H
|
|
|
|
/**
|
|
* NM_MAJOR_VERSION:
|
|
*
|
|
* Evaluates to the major version number of NetworkManager which this source
|
|
* is compiled against.
|
|
*/
|
|
#define NM_MAJOR_VERSION (@NM_MAJOR_VERSION@)
|
|
|
|
/**
|
|
* NM_MINOR_VERSION:
|
|
*
|
|
* Evaluates to the minor version number of NetworkManager which this source
|
|
* is compiled against.
|
|
*/
|
|
#define NM_MINOR_VERSION (@NM_MINOR_VERSION@)
|
|
|
|
/**
|
|
* NM_MICRO_VERSION:
|
|
*
|
|
* Evaluates to the micro version number of NetworkManager which this source
|
|
* compiled against.
|
|
*/
|
|
#define NM_MICRO_VERSION (@NM_MICRO_VERSION@)
|
|
|
|
/**
|
|
* NM_CHECK_VERSION:
|
|
* @major: major version (e.g. 1 for version 1.2.5)
|
|
* @minor: minor version (e.g. 2 for version 1.2.5)
|
|
* @micro: micro version (e.g. 5 for version 1.2.5)
|
|
*
|
|
* Returns %TRUE if the version of the NetworkManager header files
|
|
* is the same as or newer than the passed-in version.
|
|
*/
|
|
#define NM_CHECK_VERSION(major,minor,micro) \
|
|
(NM_MAJOR_VERSION > (major) || \
|
|
(NM_MAJOR_VERSION == (major) && NM_MINOR_VERSION > (minor)) || \
|
|
(NM_MAJOR_VERSION == (major) && NM_MINOR_VERSION == (minor) && NM_MICRO_VERSION >= (micro)))
|
|
|
|
|
|
/* Deprecation / Availability macros */
|
|
|
|
#define NM_ENCODE_VERSION(major,minor,micro) ((major) << 16 | (minor) << 8 | (micro))
|
|
|
|
#define NM_VERSION_0_9_8 (NM_ENCODE_VERSION (0, 9, 8))
|
|
#define NM_VERSION_0_9_10 (NM_ENCODE_VERSION (0, 9, 10))
|
|
|
|
#if (NM_MICRO_VERSION % 2)
|
|
#define NM_VERSION_CUR_STABLE (NM_ENCODE_VERSION (NM_MAJOR_VERSION, NM_MINOR_VERSION, NM_MICRO_VERSION - 1))
|
|
#else
|
|
#define NM_VERSION_CUR_STABLE (NM_ENCODE_VERSION (NM_MAJOR_VERSION, NM_MINOR_VERSION, NM_MICRO_VERSION))
|
|
#endif
|
|
|
|
#if (NM_MICRO_VERSION % 2)
|
|
#define NM_VERSION_NEXT_STABLE (NM_ENCODE_VERSION (NM_MAJOR_VERSION, NM_MINOR_VERSION, NM_MICRO_VERSION +1))
|
|
#else
|
|
#define NM_VERSION_NEXT_STABLE (NM_ENCODE_VERSION (NM_MAJOR_VERSION, NM_MINOR_VERSION, NM_MICRO_VERSION + 2))
|
|
#endif
|
|
|
|
#if !defined (NM_VERSION_MIN_REQUIRED) || (NM_VERSION_MIN_REQUIRED == 0)
|
|
# undef NM_VERSION_MIN_REQUIRED
|
|
# define NM_VERSION_MIN_REQUIRED (NM_VERSION_CUR_STABLE)
|
|
#endif
|
|
|
|
#if !defined (NM_VERSION_MAX_ALLOWED) || (NM_VERSION_MAX_ALLOWED == 0)
|
|
# undef NM_VERSION_MAX_ALLOWED
|
|
# define NM_VERSION_MAX_ALLOWED (NM_VERSION_CUR_STABLE)
|
|
#endif
|
|
|
|
/* sanity checks */
|
|
#if NM_VERSION_MIN_REQUIRED > NM_VERSION_NEXT_STABLE
|
|
#error "NM_VERSION_MIN_REQUIRED must be <= NM_VERSION_NEXT_STABLE"
|
|
#endif
|
|
#if NM_VERSION_MAX_ALLOWED < NM_VERSION_MIN_REQUIRED
|
|
#error "NM_VERSION_MAX_ALLOWED must be >= NM_VERSION_MIN_REQUIRED"
|
|
#endif
|
|
#if NM_VERSION_MIN_REQUIRED < NM_VERSION_0_9_8
|
|
#error "NM_VERSION_MIN_REQUIRED must be >= NM_VERSION_0_9_8"
|
|
#endif
|
|
|
|
#if NM_VERSION_MIN_REQUIRED >= NM_VERSION_0_9_10
|
|
# define NM_DEPRECATED_IN_0_9_10 G_DEPRECATED
|
|
# define NM_DEPRECATED_IN_0_9_10_FOR(f) G_DEPRECATED_FOR(f)
|
|
#else
|
|
# define NM_DEPRECATED_IN_0_9_10
|
|
# define NM_DEPRECATED_IN_0_9_10_FOR(f)
|
|
#endif
|
|
|
|
#if NM_VERSION_MAX_ALLOWED < NM_VERSION_0_9_10
|
|
# define NM_AVAILABLE_IN_0_9_10 G_UNAVAILABLE(0.9,10)
|
|
#else
|
|
# define NM_AVAILABLE_IN_0_9_10
|
|
#endif
|
|
|
|
#endif /* NM_VERSION_H */
|
|
|