vmkdrivers/BLD/build/HEADERS/vmkapi-current-all-public-bincomp/generic/release/lib/vmkapi_compiler.h

/* **********************************************************
 * Copyright 2007 - 2009 VMware, Inc.  All rights reserved.
 * **********************************************************/

/*
 * @VMKAPIMOD_LICENSE@
 */

/*
 ***********************************************************************
 * Compiler Utilities                                             */ /**
 * \addtogroup Lib
 * @{
 * \defgroup Compiler Compiler utilities
 *
 * These interfaces allow easy access to special compiler-specific
 * information and tags.
 *
 * @{
 ***********************************************************************
 */

#ifndef _VMKAPI_COMPILER_H_
#define _VMKAPI_COMPILER_H_

/** \cond never */
#ifndef VMK_HEADER_INCLUDED_FROM_VMKAPI_H
#error This vmkapi file should never be included directly but only via vmkapi.h
#endif
/** \endcond never */

/*
 ***********************************************************************
 * VMK_ATTRIBUTE_NORETURN --                                      */ /**
 *
 * \brief Indicate to the compiler that the function never returns
 *
 ***********************************************************************
 */
#define VMK_ATTRIBUTE_NORETURN \
   __attribute__((__noreturn__))

/*
 ***********************************************************************
 * VMK_ATTRIBUTE_ALWAYS_INLINE --                                 */ /**
 *
 * \brief Indicate to the compiler that an inlined function should
 *        always be inlined.
 *
 ***********************************************************************
 */
#define VMK_ATTRIBUTE_ALWAYS_INLINE \
   __attribute__((__always_inline__))

/*
 ***********************************************************************
 * VMK_ATTRIBUTE_PRINTF --                                        */ /**
 *
 * \brief Compiler format checking for printf-like functions
 *
 * \param[in]  fmt      Argument number of the format string
 * \param[in]  vararg   Argument number of the first vararg
 *
 ***********************************************************************
 */
#define VMK_ATTRIBUTE_PRINTF(fmt, vararg) \
   __attribute__((__format__(__printf__, fmt, vararg)))

/*
 ***********************************************************************
 * VMK_ATTRIBUTE_SCANF --                                         */ /**
 *
 * \brief Compiler format checking for scanf-like functions
 *
 * \param[in]  fmt      Argument number of the format string
 * \param[in]  vararg   Argument number of the first vararg
 *
 ***********************************************************************
 */
#define VMK_ATTRIBUTE_SCANF(fmt, vararg) \
   __attribute__((__format__(__scanf__, fmt, vararg)))

/*
 ***********************************************************************
 * VMK_INLINE --                                                  */ /**
 *
 * \brief Indicate to the compiler that a function should be inlined.
 *
 ***********************************************************************
 */
#define VMK_INLINE inline

/*
 ***********************************************************************
 * VMK_ALWAYS_INLINE --                                           */ /**
 *
 * \brief Indicate to the compiler that a function should be inlined
 *        and that it should always be inlined.
 *
 ***********************************************************************
 */
#define VMK_ALWAYS_INLINE \
   inline VMK_ATTRIBUTE_ALWAYS_INLINE

/*
 ***********************************************************************
 * VMK_ATTRIBUTE_ALIGN --                                         */ /**
 *
 * \brief Align the data structure on "n" bytes.
 *
 * \param[in] n   Number of bytes to align the data structure on.
 *
 ***********************************************************************
 */
#define VMK_ATTRIBUTE_ALIGN(n) \
   __attribute__((__aligned__(n)))

/*
 ***********************************************************************
 * VMK_ATTRIBUTE_PACKED --                                        */ /**
 *
 * \brief Pack a data structure into the minumum number of bytes.
 *
 ***********************************************************************
 */
#define VMK_ATTRIBUTE_PACKED \
   __attribute__((__packed__))

/*
 ***********************************************************************
 * VMK_ATTRIBUTE_SECTION --                                       */ /**
 *
 * \brief Place a function in a particular section.
 *
 * \param[in] sec The section to place the function in.
 *
 ***********************************************************************
 */
#define VMK_ATTRIBUTE_SECTION(sec) \
   __attribute__((__section__(sec)))

/*
 ***********************************************************************
 * VMK_ATTRIBUTE_USED --                                          */ /**
 *
 * \brief Force the compiler to treat the symbol as referenced.
 *
 ***********************************************************************
 */
#define VMK_ATTRIBUTE_USED \
   __attribute__((__used__))

/*
 ***********************************************************************
 * VMK_ATTRIBUTE_TRANSPARENT_UNION --                             */ /**
 *
 * \brief Auto-cast union to its members and modify calling convention.
 *
 ***********************************************************************
 */
#define VMK_ATTRIBUTE_TRANSPARENT_UNION \
   __attribute__((__transparent_union__))

/*
 ***********************************************************************
 * VMK_LIKELY --                                                 */ /**
 *
 * \brief Branch prediction hint to the compiler that the supplied
 *        expression will likely evaluate to true.
 *
 * \note Be aware that using this in an if-statement may mean
 *       the compiler will fail to issue some warnings on the
 *       given expression.
 *
 * \param[in] _exp   Expression that will likely evaluate to true.
 *
 ***********************************************************************
 */
#define VMK_LIKELY(_exp)     __builtin_expect(!!(_exp), 1)

/*
 ***********************************************************************
 * VMK_UNLIKELY --                                                */ /**
 *
 * \brief Branch prediction hint to the compiler that the supplied
 *        expression will likely evaluate to false.
 *
 * \note Be aware that using this in an if-statement may mean
 *       the compiler will fail to issue some warnings on the
 *       given expression.
 *
 * \param[in] _exp   Expression that will likely evaluate to false.
 *
 ***********************************************************************
 */
#define VMK_UNLIKELY(_exp)   __builtin_expect(!!(_exp), 0)

/*
 ***********************************************************************
 * VMK_IS_COMPILE_TIME --                                         */ /**
 *
 * \brief If a given expression is known to be constant at compile-time.
 *
 * \note This is used to enable some optimizations when an expression is
 *       known to be constant at compile time, and fall back to a more
 *       generic method when it is not.
 *
 * \param[in] _exp   Expression that is tested.
 *
 ***********************************************************************
 */
#define VMK_IS_COMPILE_TIME(_exp)   __builtin_constant_p(_exp)

/*
 ***********************************************************************
 * VMK_PADDED_STRUCT --                                           */ /**
 *
 * \brief Macro used for padding a struct
 *
 * \param _align_sz_ Align the struct to this size
 * \param _fields_ fields of the struct
 *
 ***********************************************************************
 */
#define VMK_PADDED_STRUCT(_align_sz_, _fields_)                   \
   union {                                                        \
      struct _fields_;                                            \
      char pad[((((sizeof(struct _fields_)) + (_align_sz_) - 1) / \
                (_align_sz_)) * (_align_sz_))]; \
   };

/*
 ***********************************************************************
 * vmk_offsetof --                                               */ /**
 *
 * \brief Get the offset of a member of in a type
 *
 * \param[in]  TYPE     Type the member is a part of.
 * \param[in]  MEMBER   Member to get the offset of.
 *
 * \returns The offset in bytes of MEMBER in TYPE.
 *
 ***********************************************************************
 */
#define vmk_offsetof(TYPE, MEMBER) ((vmk_ByteCount) &((TYPE *)0)->MEMBER)

/*
 ******************************************************************************
 * VMK_DEBUG_ONLY --                                                     */ /**
 *
 * \brief Compile code only for debug builds.
 *
 * \par Example usage:
 *
 * \code
 * VMK_DEBUG_ONLY(
 *    myFunc();
 *    x = 1;
 *    y = 3;
 * )
 * \endcode
 *
 ******************************************************************************
 */
#if defined(VMX86_DEBUG)
#define VMK_DEBUG_ONLY(x) x
#else
#define VMK_DEBUG_ONLY(x)
#endif


#endif /* _VMKAPI_COMPILER_H_ */
/** @} */
/** @} */