mirror of
https://gitlab.kitware.com/vtk/vtk-m
synced 2024-09-08 21:33:55 +00:00
8922f600e1
There appears to be a bug in GCC where if you mixed C++ attributes like `[[deprecated]]` with GNU attributes like `__attribute__(())`, you will get a compile error. This can be a problem when using attributes to both set the export (i.e. visibility) of an item and deprecating the same item. This problem has been encountered before. Commit 34b0bba84207a89e8fddfe62e7a1ff30b1b53a18 fixed the problem by using `[[gnu::visibility()]]` instead of `__attribute__()` in the export macros. This works fine for export macros defined by VTK-m headers such as `VTKM_ALWAYS_EXPORT`. Unfortunately, we have little control over the export macros that CMake automatically creates. Rather than rewrite the CMake export code, we go the other way and use `__attribute__()` for all exports _and_ the depreciated attribute.
131 lines
4.8 KiB
C
131 lines
4.8 KiB
C
//============================================================================
|
|
// Copyright (c) Kitware, Inc.
|
|
// All rights reserved.
|
|
// See LICENSE.txt for details.
|
|
//
|
|
// This software is distributed WITHOUT ANY WARRANTY; without even
|
|
// the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
|
|
// PURPOSE. See the above copyright notice for more information.
|
|
//============================================================================
|
|
#ifndef vtk_m_internal__ExportMacros_h
|
|
#define vtk_m_internal__ExportMacros_h
|
|
|
|
#include <vtkm/internal/Configure.h>
|
|
|
|
/*!
|
|
* Export macros for various parts of the VTKm library.
|
|
*/
|
|
|
|
#ifdef VTKM_HIP
|
|
|
|
#include "hip/hip_runtime.h"
|
|
#define VTKM_EXEC __device__ __host__
|
|
#define VTKM_EXEC_CONT __device__ __host__
|
|
#define VTKM_SUPPRESS_EXEC_WARNINGS
|
|
|
|
#elif defined(VTKM_CUDA)
|
|
|
|
#define VTKM_EXEC __device__ __host__
|
|
#define VTKM_EXEC_CONT __device__ __host__
|
|
|
|
#ifdef VTKM_MSVC
|
|
|
|
#if __CUDAVER__ >= 75000
|
|
#define VTKM_SUPPRESS_EXEC_WARNINGS __pragma(nv_exec_check_disable)
|
|
#else
|
|
#define VTKM_SUPPRESS_EXEC_WARNINGS __pragma(hd_warning_disable)
|
|
#endif
|
|
|
|
#else
|
|
|
|
#if __CUDAVER__ >= 75000
|
|
#define VTKM_SUPPRESS_EXEC_WARNINGS _Pragma("nv_exec_check_disable")
|
|
#else
|
|
#define VTKM_SUPPRESS_EXEC_WARNINGS _Pragma("hd_warning_disable")
|
|
#endif
|
|
|
|
#endif
|
|
|
|
#else // !VTKM_CUDA
|
|
|
|
#define VTKM_EXEC
|
|
#define VTKM_EXEC_CONT
|
|
#define VTKM_SUPPRESS_EXEC_WARNINGS
|
|
|
|
#endif // !VTKM_CUDA
|
|
|
|
#define VTKM_CONT
|
|
|
|
// Background:
|
|
// VTK-m libraries are built with the hidden symbol visibility by default.
|
|
// This means that all template classes that are defined in VTK-m headers are
|
|
// defined with hidden visibility when we are building VTK-m. But when those
|
|
// headers are included by a third-party which has differing visibility controls
|
|
// causing link time warnings ( external vs private ).
|
|
//
|
|
// Issue:
|
|
// Dynamic cast is not just based on the name of the class, but also the
|
|
// combined visibility of the class on OSX. When building the hash_code of
|
|
// an object the symbol visibility controls of the type are taken into
|
|
// consideration ( including symbol vis of template parameters ).
|
|
// Therefore if a class has a component with private/hidden vis than it
|
|
// can't be passed across library boundaries.
|
|
//
|
|
// Example is PolymorphicArrayHandleContainer<T,S> whose visibility affected
|
|
// by the visibility of both T and S.
|
|
//
|
|
// Solution:
|
|
// The solution is fairly simple, but annoying. You need to mark every single
|
|
// header only class that is tempgit lated on non value types to be marked as
|
|
// always exported ( or never pass fvisibility=hidden ).
|
|
//
|
|
// TL;DR:
|
|
// This markup is used when we want to make sure:
|
|
// - The class can be compiled into multiple libraries and at runtime will
|
|
// resolve to a single type instance
|
|
// - Be a type ( or component of a types signature ) that can be passed between
|
|
// dynamic libraries and requires RTTI support ( dynamic_cast ).
|
|
#if defined(VTKM_MSVC)
|
|
#define VTKM_ALWAYS_EXPORT
|
|
#define VTKM_NEVER_EXPORT
|
|
#else
|
|
#define VTKM_ALWAYS_EXPORT __attribute__((visibility("default")))
|
|
#define VTKM_NEVER_EXPORT __attribute__((visibility("hidden")))
|
|
#endif
|
|
|
|
// cuda 7.5 doesn't support static const or static constexpr variables
|
|
// that exist inside methods or classes, so in those cases we have to use
|
|
// just constexpr
|
|
#if defined(VTKM_CUDA_VERSION_MAJOR) && (VTKM_CUDA_VERSION_MAJOR < 8)
|
|
#define VTKM_STATIC_CONSTEXPR_ARRAY constexpr
|
|
// cuda 8-9 doesn't support static constexpr pointers/fixed size arrays
|
|
// that exist inside methods or classes, so in those cases we gracefully
|
|
// fall back to static const
|
|
#elif defined(VTKM_CUDA_VERSION_MAJOR) && (VTKM_CUDA_VERSION_MAJOR < 10)
|
|
#define VTKM_STATIC_CONSTEXPR_ARRAY static const
|
|
#else
|
|
#define VTKM_STATIC_CONSTEXPR_ARRAY static constexpr
|
|
#endif
|
|
|
|
// Clang will warn about weak vtables (-Wweak-vtables) on exception classes,
|
|
// but there's no good way to eliminate them in this case because MSVC (See
|
|
// http://stackoverflow.com/questions/24511376). These macros will silence the
|
|
// warning for classes defined within them.
|
|
#ifdef VTKM_CLANG
|
|
#define VTKM_SILENCE_WEAK_VTABLE_WARNING_START \
|
|
_Pragma("clang diagnostic push") _Pragma("clang diagnostic ignored \"-Wweak-vtables\"")
|
|
#define VTKM_SILENCE_WEAK_VTABLE_WARNING_END _Pragma("clang diagnostic pop")
|
|
#else // VTKM_CLANG
|
|
#define VTKM_SILENCE_WEAK_VTABLE_WARNING_START
|
|
#define VTKM_SILENCE_WEAK_VTABLE_WARNING_END
|
|
#endif // VTKM_CLANG
|
|
|
|
/// Simple macro to identify a parameter as unused. This allows you to name a
|
|
/// parameter that is not used. There are several instances where you might
|
|
/// want to do this. For example, when using a parameter to overload or
|
|
/// template a function but do not actually use the parameter. Another example
|
|
/// is providing a specialization that does not need that parameter.
|
|
#define vtkmNotUsed(parameter_name)
|
|
|
|
#endif //vtk_m_internal__ExportMacros_h
|