Mercurial > repos > rliterman > csp2

comparison CSP2/CSP2_env/env-d9b9114564458d9d-741b3de822f2aaca6c6caa4325c4afce/include/alsa/global.h @ 69:33d812a61356

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
planemo upload commit 2e9511a184a1ca667c7be0c6321a36dc4e3d116d
author jpayne
date Tue, 18 Mar 2025 17:55:14 -0400
parents
children
comparison
equal deleted inserted replaced
67:0e9998148a16 69:33d812a61356
1 /**
2 * \file include/global.h
3 * \brief Application interface library for the ALSA driver
4 * \author Jaroslav Kysela <perex@perex.cz>
5 * \author Abramo Bagnara <abramo@alsa-project.org>
6 * \author Takashi Iwai <tiwai@suse.de>
7 * \date 1998-2001
8 *
9 * Application interface library for the ALSA driver
10 */
11 /*
12 * This library is free software; you can redistribute it and/or modify
13 * it under the terms of the GNU Lesser General Public License as
14 * published by the Free Software Foundation; either version 2.1 of
15 * the License, or (at your option) any later version.
16 *
17 * This program is distributed in the hope that it will be useful,
18 * but WITHOUT ANY WARRANTY; without even the implied warranty of
19 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
20 * GNU Lesser General Public License for more details.
21 *
22 * You should have received a copy of the GNU Lesser General Public
23 * License along with this library; if not, write to the Free Software
24 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
25 *
26 */
27
28 #ifndef __ALSA_GLOBAL_H_
29 #define __ALSA_GLOBAL_H_
30
31 /* for timeval and timespec */
32 #include <time.h>
33
34 #ifdef __cplusplus
35 extern "C" {
36 #endif
37
38 /**
39 * \defgroup Global Global defines and functions
40 * Global defines and functions.
41 * \par
42 * The ALSA library implementation uses these macros and functions.
43 * Most applications probably do not need them.
44 * \{
45 */
46
47 const char *snd_asoundlib_version(void);
48
49 #ifndef ATTRIBUTE_UNUSED
50 /** do not print warning (gcc) when function parameter is not used */
51 #define ATTRIBUTE_UNUSED __attribute__ ((__unused__))
52 #endif
53
54 #ifdef PIC /* dynamic build */
55
56 /** \hideinitializer \brief Helper macro for #SND_DLSYM_BUILD_VERSION. */
57 #define __SND_DLSYM_VERSION(name, version) _ ## name ## version
58 /**
59 * \hideinitializer
60 * \brief Appends the build version to the name of a versioned dynamic symbol.
61 */
62 #define SND_DLSYM_BUILD_VERSION(name, version) char __SND_DLSYM_VERSION(name, version);
63
64 #else /* static build */
65
66 struct snd_dlsym_link {
67 struct snd_dlsym_link *next;
68 const char *dlsym_name;
69 const void *dlsym_ptr;
70 };
71
72 extern struct snd_dlsym_link *snd_dlsym_start;
73
74 /** \hideinitializer \brief Helper macro for #SND_DLSYM_BUILD_VERSION. */
75 #define __SND_DLSYM_VERSION(prefix, name, version) _ ## prefix ## name ## version
76 /**
77 * \hideinitializer
78 * \brief Appends the build version to the name of a versioned dynamic symbol.
79 */
80 #define SND_DLSYM_BUILD_VERSION(name, version) \
81 static struct snd_dlsym_link __SND_DLSYM_VERSION(snd_dlsym_, name, version); \
82 void __SND_DLSYM_VERSION(snd_dlsym_constructor_, name, version) (void) __attribute__ ((constructor)); \
83 void __SND_DLSYM_VERSION(snd_dlsym_constructor_, name, version) (void) { \
84 __SND_DLSYM_VERSION(snd_dlsym_, name, version).next = snd_dlsym_start; \
85 __SND_DLSYM_VERSION(snd_dlsym_, name, version).dlsym_name = # name; \
86 __SND_DLSYM_VERSION(snd_dlsym_, name, version).dlsym_ptr = (void *)&name; \
87 snd_dlsym_start = &__SND_DLSYM_VERSION(snd_dlsym_, name, version); \
88 }
89
90 #endif
91
92 #ifndef __STRING
93 /** \brief Return 'x' argument as string */
94 #define __STRING(x) #x
95 #endif
96
97 /** \brief Returns the version of a dynamic symbol as a string. */
98 #define SND_DLSYM_VERSION(version) __STRING(version)
99
100 int snd_dlpath(char *path, size_t path_len, const char *name);
101 void *snd_dlopen(const char *file, int mode, char *errbuf, size_t errbuflen);
102 void *snd_dlsym(void *handle, const char *name, const char *version);
103 int snd_dlclose(void *handle);
104
105
106 /** \brief alloca helper macro. */
107 #define __snd_alloca(ptr,type) do { *ptr = (type##_t *) alloca(type##_sizeof()); memset(*ptr, 0, type##_sizeof()); } while (0)
108
109 /**
110 * \brief Internal structure for an async notification client handler.
111 *
112 * The ALSA library uses a pointer to this structure as a handle to an async
113 * notification object. Applications don't access its contents directly.
114 */
115 typedef struct _snd_async_handler snd_async_handler_t;
116
117 /**
118 * \brief Async notification callback.
119 *
120 * See the #snd_async_add_handler function for details.
121 */
122 typedef void (*snd_async_callback_t)(snd_async_handler_t *handler);
123
124 int snd_async_add_handler(snd_async_handler_t **handler, int fd,
125 snd_async_callback_t callback, void *private_data);
126 int snd_async_del_handler(snd_async_handler_t *handler);
127 int snd_async_handler_get_fd(snd_async_handler_t *handler);
128 int snd_async_handler_get_signo(snd_async_handler_t *handler);
129 void *snd_async_handler_get_callback_private(snd_async_handler_t *handler);
130
131 struct snd_shm_area *snd_shm_area_create(int shmid, void *ptr);
132 struct snd_shm_area *snd_shm_area_share(struct snd_shm_area *area);
133 int snd_shm_area_destroy(struct snd_shm_area *area);
134
135 int snd_user_file(const char *file, char **result);
136
137 #ifdef __GLIBC__
138 #if !defined(_POSIX_C_SOURCE) && !defined(_POSIX_SOURCE)
139 struct timeval {
140 time_t tv_sec; /* seconds */
141 long tv_usec; /* microseconds */
142 };
143
144 struct timespec {
145 time_t tv_sec; /* seconds */
146 long tv_nsec; /* nanoseconds */
147 };
148 #endif
149 #endif
150
151 /** Timestamp */
152 typedef struct timeval snd_timestamp_t;
153 /** Hi-res timestamp */
154 typedef struct timespec snd_htimestamp_t;
155
156 /** \} */
157
158 #ifdef __cplusplus
159 }
160 #endif
161
162 #endif /* __ALSA_GLOBAL_H */