source4/lib/util/attr.h

   1 /*
   2    Unix SMB/CIFS implementation.
   3    Samba utility functions
   4    Copyright (C) Jelmer Vernooij <jelmer@samba.org> 2007
   5
   6    This program is free software; you can redistribute it and/or modify
   7    it under the terms of the GNU General Public License as published by
   8    the Free Software Foundation; either version 3 of the License, or
   9    (at your option) any later version.
  10
  11    This program is distributed in the hope that it will be useful,
  12    but WITHOUT ANY WARRANTY; without even the implied warranty of
  13    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14    GNU General Public License for more details.
  15
  16    You should have received a copy of the GNU General Public License
  17    along with this program.  If not, see <http://www.gnu.org/licenses/>.
  18 */
  19
  20 #ifndef __UTIL_ATTR_H__
  21 #define __UTIL_ATTR_H__
  22
  23 #ifdef __GNUC__
  24 /** gcc attribute used on function parameters so that it does not emit
  25  * warnings about them being unused. **/
  26 #  define UNUSED(param) param __attribute__ ((unused))
  27 #else
  28 #  define UNUSED(param) param
  29 /** Feel free to add definitions for other compilers here. */
  30 #endif
  31
  32 #ifndef _PUBLIC_
  33 #ifdef HAVE_VISIBILITY_ATTR
  34 #  define _PUBLIC_ __attribute__((visibility("default")))
  35 #else
  36 #  define _PUBLIC_
  37 #endif
  38 #endif
  39
  40 #ifndef _DEPRECATED_
  41 #if (__GNUC__ >= 3) && (__GNUC_MINOR__ >= 1 )
  42 #define _DEPRECATED_ __attribute__ ((deprecated))
  43 #else
  44 #define _DEPRECATED_
  45 #endif
  46 #endif
  47
  48 #ifndef _WARN_UNUSED_RESULT_
  49 #if (__GNUC__ >= 3) && (__GNUC_MINOR__ >= 1 )
  50 #define _WARN_UNUSED_RESULT_ __attribute__ ((warn_unused_result))
  51 #else
  52 #define _WARN_UNUSED_RESULT_
  53 #endif
  54 #endif
  55
  56 #ifndef _NORETURN_
  57 #if (__GNUC__ >= 3) && (__GNUC_MINOR__ >= 1 )
  58 #define _NORETURN_ __attribute__ ((noreturn))
  59 #else
  60 #define _NORETURN_
  61 #endif
  62 #endif
  63
  64 #ifndef _PURE_
  65 #if (__GNUC__ >= 3) && (__GNUC_MINOR__ >= 1)
  66 #define _PURE_ __attribute__((pure))
  67 #else
  68 #define _PURE_
  69 #endif
  70 #endif
  71
  72 #ifndef NONNULL
  73 #if (__GNUC__ >= 3) && (__GNUC_MINOR__ >= 1)
  74 #define NONNULL(param) param __attribute__((nonnull))
  75 #else
  76 #define NONNULL(param) param
  77 #endif
  78 #endif
  79
  80 #endif /* __UTIL_ATTR_H__ */