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., 59 Temple Place, Suite 330, Boston, MA  02111-1307 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
35extern "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
47const 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
66struct snd_dlsym_link {
67	struct snd_dlsym_link *next;
68	const char *dlsym_name;
69	const void *dlsym_ptr;
70};
71
72extern 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
100void *snd_dlopen(const char *file, int mode);
101void *snd_dlsym(void *handle, const char *name, const char *version);
102int snd_dlclose(void *handle);
103
104
105/** \brief alloca helper macro. */
106#define __snd_alloca(ptr,type) do { *ptr = (type##_t *) alloca(type##_sizeof()); memset(*ptr, 0, type##_sizeof()); } while (0)
107
108/**
109 * \brief Internal structure for an async notification client handler.
110 *
111 * The ALSA library uses a pointer to this structure as a handle to an async
112 * notification object. Applications don't access its contents directly.
113 */
114typedef struct _snd_async_handler snd_async_handler_t;
115
116/**
117 * \brief Async notification callback.
118 *
119 * See the #snd_async_add_handler function for details.
120 */
121typedef void (*snd_async_callback_t)(snd_async_handler_t *handler);
122
123int snd_async_add_handler(snd_async_handler_t **handler, int fd,
124			  snd_async_callback_t callback, void *private_data);
125int snd_async_del_handler(snd_async_handler_t *handler);
126int snd_async_handler_get_fd(snd_async_handler_t *handler);
127int snd_async_handler_get_signo(snd_async_handler_t *handler);
128void *snd_async_handler_get_callback_private(snd_async_handler_t *handler);
129
130struct snd_shm_area *snd_shm_area_create(int shmid, void *ptr);
131struct snd_shm_area *snd_shm_area_share(struct snd_shm_area *area);
132int snd_shm_area_destroy(struct snd_shm_area *area);
133
134int snd_user_file(const char *file, char **result);
135
136#if !defined(_POSIX_C_SOURCE) && !defined(_POSIX_SOURCE)
137struct timeval {
138	time_t		tv_sec;		/* seconds */
139	long		tv_usec;	/* microseconds */
140};
141
142struct timespec {
143	time_t		tv_sec;		/* seconds */
144	long		tv_nsec;	/* nanoseconds */
145};
146#endif
147
148/** Timestamp */
149typedef struct timeval snd_timestamp_t;
150/** Hi-res timestamp */
151typedef struct timespec snd_htimestamp_t;
152
153/** \} */
154
155#ifdef __cplusplus
156}
157#endif
158
159#endif /* __ALSA_GLOBAL_H */
160