ALSA project - the C library reference: /builddir/build/BUILD/alsa-lib-1.1.8/include/global.h Source File

ALSA project - the C library reference

- Main Page
- Related Pages
- Modules
- Data Structures
- Files
- Examples

- File List
- Globals

All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
global.h
Go to the documentation of this file.
1
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
47 const char *snd_asoundlib_version(void);
48
49 #ifndef ATTRIBUTE_UNUSED
50
51 #define ATTRIBUTE_UNUSED __attribute__ ((__unused__))
52 #endif
53
54 #ifdef PIC /* dynamic build */
55
57 #define __SND_DLSYM_VERSION(name, version) _ ## name ## version
58
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
75 #define __SND_DLSYM_VERSION(prefix, name, version) _ ## prefix ## name ## version
76
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
94 #define __STRING(x) #x
95 #endif
96
98 #define SND_DLSYM_VERSION(version) __STRING(version)
99
100 void *snd_dlopen(const char *file, int mode, char *errbuf, size_t errbuflen);
101 void *snd_dlsym(void *handle, const char *name, const char *version);
102 int snd_dlclose(void *handle);
103
104
106 #define __snd_alloca(ptr,type) do { *ptr = (type##_t *) alloca(type##_sizeof()); memset(*ptr, 0, type##_sizeof()); } while (0)
107
114 typedef struct _snd_async_handler snd_async_handler_t;
115
121 typedef void (*snd_async_callback_t)(snd_async_handler_t *handler);
122
123 int snd_async_add_handler(snd_async_handler_t **handler, int fd,
124 snd_async_callback_t callback, void *private_data);
125 int snd_async_del_handler(snd_async_handler_t *handler);
126 int snd_async_handler_get_fd(snd_async_handler_t *handler);
127 int snd_async_handler_get_signo(snd_async_handler_t *handler);
128 void *snd_async_handler_get_callback_private(snd_async_handler_t *handler);
129
130 struct snd_shm_area *snd_shm_area_create(int shmid, void *ptr);
131 struct snd_shm_area *snd_shm_area_share(struct snd_shm_area *area);
132 int snd_shm_area_destroy(struct snd_shm_area *area);
133
134 int snd_user_file(const char *file, char **result);
135
136 #ifdef __GLIBC__
137 #if !defined(_POSIX_C_SOURCE) && !defined(_POSIX_SOURCE)
138 struct timeval {
139 time_t tv_sec; /* seconds */
140 long tv_usec; /* microseconds */
141 };
142
143 struct timespec {
144 time_t tv_sec; /* seconds */
145 long tv_nsec; /* nanoseconds */
146 };
147 #endif
148 #endif
149
151 typedef struct timeval snd_timestamp_t;
153 typedef struct timespec snd_htimestamp_t;
154
157 #ifdef __cplusplus
158 }
159 #endif
160
161 #endif /* __ALSA_GLOBAL_H */
snd_dlsym
void * snd_dlsym(void *handle, const char *name, const char *version)
Resolves a symbol from a dynamic library - ALSA wrapper for dlsym.
Definition: dlmisc.c:190
snd_async_handler_get_signo
int snd_async_handler_get_signo(snd_async_handler_t *handler)
Returns the signal number assigned to an async handler.
Definition: async.c:185
snd_async_callback_t
void(* snd_async_callback_t)(snd_async_handler_t *handler)
Async notification callback.
Definition: global.h:121
snd_async_add_handler
int snd_async_add_handler(snd_async_handler_t **handler, int fd, snd_async_callback_t callback, void *private_data)
Registers an async handler.
Definition: async.c:100
snd_asoundlib_version
const char * snd_asoundlib_version(void)
Returns the ALSA sound library version in ASCII format.
Definition: error.c:143
snd_async_handler_get_fd
int snd_async_handler_get_fd(snd_async_handler_t *handler)
Returns the file descriptor assigned to an async handler.
Definition: async.c:196
snd_dlopen
void * snd_dlopen(const char *file, int mode, char *errbuf, size_t errbuflen)
Opens a dynamic library - ALSA wrapper for dlopen.
Definition: dlmisc.c:56
snd_htimestamp_t
struct timespec snd_htimestamp_t
Definition: global.h:153
snd_dlclose
int snd_dlclose(void *handle)
Closes a dynamic library - ALSA wrapper for dlclose.
Definition: dlmisc.c:130
snd_async_handler_t
struct _snd_async_handler snd_async_handler_t
Internal structure for an async notification client handler.
Definition: global.h:114
snd_timestamp_t
struct timeval snd_timestamp_t
Definition: global.h:151
snd_user_file
int snd_user_file(const char *file, char **result)
Get the full file name.
Definition: userfile.c:72
snd_async_handler_get_callback_private
void * snd_async_handler_get_callback_private(snd_async_handler_t *handler)
Returns the private data assigned to an async handler.
Definition: async.c:207
snd_async_del_handler
int snd_async_del_handler(snd_async_handler_t *handler)
Deletes an async handler.
Definition: async.c:138
ptr
void * ptr
Definition: seq_event.h:199