]> code.delx.au - pulseaudio/blob - src/pulse/gccmacro.h
Merge dead branch 'glitch-free'
[pulseaudio] / src / pulse / gccmacro.h
1 #ifndef foopulsegccmacrohfoo
2 #define foopulsegccmacrohfoo
3
4 /***
5 This file is part of PulseAudio.
6
7 Copyright 2004-2006 Lennart Poettering
8
9 PulseAudio is free software; you can redistribute it and/or modify
10 it under the terms of the GNU Lesser General Public License as published
11 by the Free Software Foundation; either version 2 of the License,
12 or (at your option) any later version.
13
14 PulseAudio is distributed in the hope that it will be useful, but
15 WITHOUT ANY WARRANTY; without even the implied warranty of
16 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
17 General Public License for more details.
18
19 You should have received a copy of the GNU Lesser General Public License
20 along with PulseAudio; if not, write to the Free Software
21 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
22 USA.
23 ***/
24
25 #ifdef __GNUC__
26 #define PA_GCC_PRINTF_ATTR(a,b) __attribute__ ((format (printf, a, b)))
27 #else
28 /** If we're in GNU C, use some magic for detecting invalid format strings */
29 #define PA_GCC_PRINTF_ATTR(a,b)
30 #endif
31
32 #if defined(__GNUC__) && (__GNUC__ >= 4)
33 #define PA_GCC_SENTINEL __attribute__ ((sentinel))
34 #else
35 /** Macro for usage of GCC's sentinel compilation warnings */
36 #define PA_GCC_SENTINEL
37 #endif
38
39 #ifdef __GNUC__
40 #define PA_GCC_NORETURN __attribute__((noreturn))
41 #else
42 /** Macro for no-return functions */
43 #define PA_GCC_NORETURN
44 #endif
45
46 #ifdef __GNUC__
47 #define PA_GCC_UNUSED __attribute__ ((unused))
48 #else
49 /** Macro for not used parameter */
50 #define PA_GCC_UNUSED
51 #endif
52
53 #ifdef __GNUC__
54 #define PA_GCC_DESTRUCTOR __attribute__ ((destructor))
55 #else
56 /** Call this function when process terminates */
57 #define PA_GCC_DESTRUCTOR
58 #endif
59
60 #ifndef PA_GCC_PURE
61 #ifdef __GNUC__
62 #define PA_GCC_PURE __attribute__ ((pure))
63 #else
64 /** This function's return value depends only the arguments list and global state **/
65 #define PA_GCC_PURE
66 #endif
67 #endif
68
69 #ifndef PA_GCC_CONST
70 #ifdef __GNUC__
71 #define PA_GCC_CONST __attribute__ ((const))
72 #else
73 /** This function's return value depends only the arguments list (stricter version of PA_GCC_PURE) **/
74 #define PA_GCC_CONST
75 #endif
76 #endif
77
78 #ifndef PA_GCC_DEPRECATED
79 #ifdef __GNUC__
80 #define PA_GCC_DEPRECATED __attribute__ ((deprecated))
81 #else
82 /** This function is deprecated **/
83 #define PA_GCC_DEPRECATED
84 #endif
85 #endif
86
87 #ifndef PA_GCC_PACKED
88 #ifdef __GNUCC__
89 #define PA_GCC_PACKED __attribute__ ((packed))
90 #else
91 /** Structure shall be packed in memory **/
92 #define PA_GCC_PACKED
93 #endif
94 #endif
95
96 #endif