]> git.sesse.net Git - vlc/blob - include/vlc_common.h
* B-search macro
[vlc] / include / vlc_common.h
1 /*****************************************************************************
2  * common.h: common definitions
3  * Collection of useful common types and macros definitions
4  *****************************************************************************
5  * Copyright (C) 1998-2005 the VideoLAN team
6  * $Id$
7  *
8  * Authors: Samuel Hocevar <sam@via.ecp.fr>
9  *          Vincent Seguin <seguin@via.ecp.fr>
10  *          Gildas Bazin <gbazin@videolan.org>
11  *
12  * This program is free software; you can redistribute it and/or modify
13  * it under the terms of the GNU General Public License as published by
14  * the Free Software Foundation; either version 2 of the License, or
15  * (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 General Public License for more details.
21  *
22  * You should have received a copy of the GNU General Public License
23  * along with this program; if not, write to the Free Software
24  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
25  *****************************************************************************/
26
27
28 /**
29  * \file
30  * This file is a collection of common definitions and types
31  */
32
33 /*****************************************************************************
34  * Required vlc headers
35  *****************************************************************************/
36 #if defined( __BORLANDC__ )
37 #   undef PACKAGE
38 #endif
39
40 #include "config.h"
41
42 #if defined(PACKAGE)
43 #   undef PACKAGE_NAME
44 #   define PACKAGE_NAME PACKAGE
45 #endif
46 #if defined(VERSION)
47 #   undef PACKAGE_VERSION
48 #   define PACKAGE_VERSION VERSION
49 #endif
50
51 #if defined( __BORLANDC__ )
52 #   undef HAVE_VARIADIC_MACROS
53 #   undef HAVE_STDINT_H
54 #   undef HAVE_INTTYPES_H
55 #   undef off_t
56 #elif defined( _MSC_VER )
57 #   pragma warning( disable : 4244 )
58 #endif
59
60 #include "vlc_config.h"
61 #include "modules_inner.h"
62
63 /*****************************************************************************
64  * Required system headers
65  *****************************************************************************/
66 #include <stdlib.h>
67 #include <stdarg.h>
68
69 #ifdef HAVE_STRING_H
70 #   include <string.h>                                         /* strerror() */
71 #endif
72
73 #ifdef HAVE_SYS_TYPES_H
74 #   include <sys/types.h>
75 #endif
76
77 /*****************************************************************************
78  * Basic types definitions
79  *****************************************************************************/
80 #if defined( HAVE_STDINT_H )
81 #   include <stdint.h>
82 #elif defined( HAVE_INTTYPES_H )
83 #   include <inttypes.h>
84 #elif defined( SYS_CYGWIN )
85 #   include <sys/types.h>
86     /* Cygwin only defines half of these... */
87     typedef u_int8_t            uint8_t;
88     typedef u_int16_t           uint16_t;
89     typedef u_int32_t           uint32_t;
90     typedef u_int64_t           uint64_t;
91 #else
92     /* Fallback types (very x86-centric, sorry) */
93     typedef unsigned char       uint8_t;
94     typedef signed char         int8_t;
95     typedef unsigned short      uint16_t;
96     typedef signed short        int16_t;
97     typedef unsigned int        uint32_t;
98     typedef signed int          int32_t;
99 #   if defined( _MSC_VER ) \
100       || defined( UNDER_CE ) \
101       || ( defined( WIN32 ) && !defined( __MINGW32__ ) )
102     typedef unsigned __int64    uint64_t;
103     typedef signed __int64      int64_t;
104 #   else
105     typedef unsigned long long  uint64_t;
106     typedef signed long long    int64_t;
107 #   endif
108     typedef uint32_t            uintptr_t;
109     typedef int32_t             intptr_t;
110 #endif
111
112 typedef uint8_t                 byte_t;
113
114 /* Systems that don't have stdint.h may not define INT64_MIN and
115    INT64_MAX */
116 #ifndef INT64_MIN
117 #define INT64_MIN (-9223372036854775807LL-1)
118 #endif
119 #ifndef INT64_MAX
120 #define INT64_MAX (9223372036854775807LL)
121 #endif
122
123 /* ptrdiff_t definition */
124 #ifdef HAVE_STDDEF_H
125 #   include <stddef.h>
126 #else
127 #   include <malloc.h>
128 #   ifndef _PTRDIFF_T
129 #       define _PTRDIFF_T
130 /* Not portable in a 64-bit environment. */
131 typedef int                 ptrdiff_t;
132 #   endif
133 #endif
134
135 #if defined( WIN32 ) || defined( UNDER_CE )
136 #   include <malloc.h>
137 #   ifndef PATH_MAX
138 #       define PATH_MAX MAX_PATH
139 #   endif
140 #endif
141
142 #if (defined( WIN32 ) || defined( UNDER_CE )) && !defined( _SSIZE_T_ )
143 typedef int                 ssize_t;
144 #endif
145
146 /* Counter for statistics and profiling */
147 typedef unsigned long       count_t;
148
149 /* DCT elements types */
150 typedef int16_t             dctelem_t;
151
152 /* Video buffer types */
153 typedef uint8_t             yuv_data_t;
154
155 /* Audio volume */
156 typedef uint16_t            audio_volume_t;
157
158 #ifndef HAVE_SOCKLEN_T
159 typedef int                 socklen_t;
160 #endif
161
162 /**
163  * High precision date or time interval
164  *
165  * Store a high precision date or time interval. The maximum precision is the
166  * microsecond, and a 64 bits integer is used to avoid overflows (maximum
167  * time interval is then 292271 years, which should be long enough for any
168  * video). Dates are stored as microseconds since a common date (usually the
169  * epoch). Note that date and time intervals can be manipulated using regular
170  * arithmetic operators, and that no special functions are required.
171  */
172 typedef int64_t mtime_t;
173
174 /**
175  * The vlc_fourcc_t type.
176  *
177  * See http://www.webartz.com/fourcc/ for a very detailed list.
178  */
179 typedef uint32_t vlc_fourcc_t;
180
181 #ifdef WORDS_BIGENDIAN
182 #   define VLC_FOURCC( a, b, c, d ) \
183         ( ((uint32_t)d) | ( ((uint32_t)c) << 8 ) \
184            | ( ((uint32_t)b) << 16 ) | ( ((uint32_t)a) << 24 ) )
185 #   define VLC_TWOCC( a, b ) \
186         ( (uint16_t)(b) | ( (uint16_t)(a) << 8 ) )
187
188 #else
189 #   define VLC_FOURCC( a, b, c, d ) \
190         ( ((uint32_t)a) | ( ((uint32_t)b) << 8 ) \
191            | ( ((uint32_t)c) << 16 ) | ( ((uint32_t)d) << 24 ) )
192 #   define VLC_TWOCC( a, b ) \
193         ( (uint16_t)(a) | ( (uint16_t)(b) << 8 ) )
194
195 #endif
196
197 /*****************************************************************************
198  * Classes declaration
199  *****************************************************************************/
200
201 /* Internal types */
202 typedef struct libvlc_t libvlc_t;
203 typedef struct vlc_t vlc_t;
204 typedef struct variable_t variable_t;
205 typedef struct date_t date_t;
206 typedef struct dict_entry_t dict_entry_t;
207 typedef struct dict_t dict_t;
208 typedef struct gc_object_t gc_object_t ;
209
210 /* Messages */
211 typedef struct msg_bank_t msg_bank_t;
212 typedef struct msg_queue_t msg_queue_t;
213 typedef struct msg_subscription_t msg_subscription_t;
214
215 /* Playlist */
216
217 /* FIXME */
218 /**
219  * Playlist commands
220  */
221 typedef enum {
222     PLAYLIST_PLAY,      /**< No arg.                            res=can fail*/
223     PLAYLIST_AUTOPLAY,  /**< No arg.                            res=cant fail*/
224     PLAYLIST_VIEWPLAY,  /**< arg1= playlist_item_t*,*/
225                         /**  arg2 = playlist_item_t*          , res=can fail */
226     PLAYLIST_PAUSE,     /**< No arg                             res=can fail*/
227     PLAYLIST_STOP,      /**< No arg                             res=can fail*/
228     PLAYLIST_SKIP,      /**< arg1=int,                          res=can fail*/
229 } playlist_command_t;
230
231
232 typedef struct playlist_t playlist_t;
233 typedef struct playlist_item_t playlist_item_t;
234 typedef struct playlist_view_t playlist_view_t;
235 typedef struct playlist_export_t playlist_export_t;
236 typedef struct services_discovery_t services_discovery_t;
237 typedef struct services_discovery_sys_t services_discovery_sys_t;
238 typedef struct playlist_add_t playlist_add_t;
239 typedef struct playlist_preparse_t playlist_preparse_t;
240
241 /* Modules */
242 typedef struct module_bank_t module_bank_t;
243 typedef struct module_t module_t;
244 typedef struct module_config_t module_config_t;
245 typedef struct module_symbols_t module_symbols_t;
246 typedef struct module_cache_t module_cache_t;
247
248 typedef struct config_category_t config_category_t;
249
250 /* Interface */
251 typedef struct intf_thread_t intf_thread_t;
252 typedef struct intf_sys_t intf_sys_t;
253 typedef struct intf_console_t intf_console_t;
254 typedef struct intf_msg_t intf_msg_t;
255 typedef struct interaction_t interaction_t;
256 typedef struct interaction_dialog_t interaction_dialog_t;
257 typedef struct user_widget_t user_widget_t;
258
259 /* Input */
260 typedef struct input_thread_t input_thread_t;
261 typedef struct input_thread_sys_t input_thread_sys_t;
262 typedef struct input_item_t input_item_t;
263 typedef struct access_t access_t;
264 typedef struct access_sys_t access_sys_t;
265 typedef struct stream_t     stream_t;
266 typedef struct stream_sys_t stream_sys_t;
267 typedef struct demux_t  demux_t;
268 typedef struct demux_sys_t demux_sys_t;
269 typedef struct es_out_t     es_out_t;
270 typedef struct es_out_id_t  es_out_id_t;
271 typedef struct es_out_sys_t es_out_sys_t;
272 typedef struct es_descriptor_t es_descriptor_t;
273 typedef struct seekpoint_t seekpoint_t;
274 typedef struct info_t info_t;
275 typedef struct info_category_t info_category_t;
276
277 /* Format */
278 typedef struct audio_format_t audio_format_t;
279 typedef struct video_format_t video_format_t;
280 typedef struct subs_format_t subs_format_t;
281 typedef struct es_format_t es_format_t;
282 typedef struct video_palette_t video_palette_t;
283
284 /* Audio */
285 typedef struct aout_instance_t aout_instance_t;
286 typedef struct aout_sys_t aout_sys_t;
287 typedef struct aout_fifo_t aout_fifo_t;
288 typedef struct aout_input_t aout_input_t;
289 typedef struct aout_buffer_t aout_buffer_t;
290 typedef audio_format_t audio_sample_format_t;
291 typedef struct audio_date_t audio_date_t;
292 typedef struct aout_filter_t aout_filter_t;
293
294 /* Video */
295 typedef struct vout_thread_t vout_thread_t;
296 typedef struct vout_sys_t vout_sys_t;
297 typedef struct vout_synchro_t vout_synchro_t;
298 typedef struct chroma_sys_t chroma_sys_t;
299
300 typedef video_format_t video_frame_format_t;
301 typedef struct picture_t picture_t;
302 typedef struct picture_sys_t picture_sys_t;
303 typedef struct picture_heap_t picture_heap_t;
304
305 /* Subpictures */
306 typedef struct spu_t spu_t;
307 typedef struct subpicture_t subpicture_t;
308 typedef struct subpicture_sys_t subpicture_sys_t;
309 typedef struct subpicture_region_t subpicture_region_t;
310 typedef struct text_style_t text_style_t;
311
312 typedef struct image_handler_t image_handler_t;
313
314 /* Stream output */
315 typedef struct sout_instance_t sout_instance_t;
316 typedef struct sout_instance_sys_t sout_instance_sys_t;
317
318 typedef struct sout_input_t sout_input_t;
319 typedef struct sout_packetizer_input_t sout_packetizer_input_t;
320
321 typedef struct sout_access_out_t sout_access_out_t;
322 typedef struct sout_access_out_sys_t   sout_access_out_sys_t;
323
324 typedef struct sout_mux_t sout_mux_t;
325 typedef struct sout_mux_sys_t sout_mux_sys_t;
326
327 typedef struct sout_stream_t    sout_stream_t;
328 typedef struct sout_stream_sys_t sout_stream_sys_t;
329
330 typedef struct sout_cfg_t       sout_cfg_t;
331 typedef struct sap_session_t    sap_session_t;
332 typedef struct sap_address_t sap_address_t;
333 typedef struct session_descriptor_t session_descriptor_t;
334 typedef struct announce_method_t announce_method_t;
335 typedef struct announce_handler_t announce_handler_t;
336 typedef struct sap_handler_t sap_handler_t;
337
338 typedef struct sout_std_t sout_std_t;
339 typedef struct sout_display_t sout_display_t;
340 typedef struct sout_duplicate_t sout_duplicate_t;
341 typedef struct sout_transcode_t sout_transcode_t;
342 typedef struct sout_chain_t sout_chain_t;
343 typedef struct streaming_profile_t streaming_profile_t;
344 typedef struct sout_module_t sout_module_t;
345 typedef struct sout_gui_descr_t sout_gui_descr_t;
346
347 /* Decoders */
348 typedef struct decoder_t      decoder_t;
349 typedef struct decoder_sys_t  decoder_sys_t;
350
351 /* Encoders */
352 typedef struct encoder_t      encoder_t;
353 typedef struct encoder_sys_t  encoder_sys_t;
354
355 /* Filters */
356 typedef struct filter_t filter_t;
357 typedef struct filter_sys_t filter_sys_t;
358
359 /* Network */
360 typedef struct network_socket_t network_socket_t;
361 typedef struct virtual_socket_t v_socket_t;
362 typedef struct sockaddr sockaddr;
363 typedef struct addrinfo addrinfo;
364 typedef struct vlc_acl_t vlc_acl_t;
365
366 /* Misc */
367 typedef struct iso639_lang_t iso639_lang_t;
368 typedef struct device_t device_t;
369 typedef struct device_probe_t device_probe_t;
370 typedef struct probe_sys_t probe_sys_t;
371 typedef struct localized_string_t localized_string_t;
372 typedef struct i18n_string_t i18n_string_t;
373
374 /* block */
375 typedef struct block_t      block_t;
376 typedef struct block_fifo_t block_fifo_t;
377
378 /* httpd */
379 typedef struct httpd_t          httpd_t;
380 typedef struct httpd_host_t     httpd_host_t;
381 typedef struct httpd_url_t      httpd_url_t;
382 typedef struct httpd_client_t   httpd_client_t;
383 typedef struct httpd_callback_sys_t httpd_callback_sys_t;
384 typedef struct httpd_message_t  httpd_message_t;
385 typedef int    (*httpd_callback_t)( httpd_callback_sys_t *, httpd_client_t *, httpd_message_t *answer, httpd_message_t *query );
386 typedef struct httpd_file_t     httpd_file_t;
387 typedef struct httpd_file_sys_t httpd_file_sys_t;
388 typedef int (*httpd_file_callback_t)( httpd_file_sys_t *, httpd_file_t *, uint8_t *psz_request, uint8_t **pp_data, int *pi_data );
389 typedef struct httpd_handler_t  httpd_handler_t;
390 typedef struct httpd_handler_sys_t httpd_handler_sys_t;
391 typedef int (*httpd_handler_callback_t)( httpd_handler_sys_t *, httpd_handler_t *, char *psz_url, uint8_t *psz_request, int i_type, uint8_t *p_in, int i_in, char *psz_remote_addr, char *psz_remote_host, uint8_t **pp_data, int *pi_data );
392 typedef struct httpd_redirect_t httpd_redirect_t;
393 typedef struct httpd_stream_t httpd_stream_t;
394
395 /* TLS support */
396 typedef struct tls_t tls_t;
397 typedef struct tls_server_t tls_server_t;
398 typedef struct tls_session_t tls_session_t;
399
400 /* Hashing */
401 typedef struct md5_s md5_t;
402
403 /* XML */
404 typedef struct xml_t xml_t;
405 typedef struct xml_sys_t xml_sys_t;
406 typedef struct xml_reader_t xml_reader_t;
407 typedef struct xml_reader_sys_t xml_reader_sys_t;
408
409 /* vod server */
410 typedef struct vod_t     vod_t;
411 typedef struct vod_sys_t vod_sys_t;
412 typedef struct vod_media_t vod_media_t;
413
414 /* opengl */
415 typedef struct opengl_t     opengl_t;
416 typedef struct opengl_sys_t opengl_sys_t;
417
418 /* osdmenu */
419 typedef struct osd_menu_t   osd_menu_t;
420 typedef struct osd_state_t  osd_state_t;
421 typedef struct osd_event_t  osd_event_t;
422 typedef struct osd_button_t osd_button_t;
423 typedef struct osd_menu_state_t osd_menu_state_t;
424
425 /* VLM */
426 typedef struct vlm_t         vlm_t;
427 typedef struct vlm_message_t vlm_message_t;
428 typedef struct vlm_media_t   vlm_media_t;
429 typedef struct vlm_schedule_t vlm_schedule_t;
430
431 /* divers */
432 typedef struct vlc_meta_t    vlc_meta_t;
433
434 /* Stats */
435 typedef struct counter_t     counter_t;
436 typedef struct counter_sample_t counter_sample_t;
437 typedef struct stats_handler_t stats_handler_t;
438 typedef struct input_stats_t input_stats_t;
439 typedef struct global_stats_t global_stats_t;
440
441 /* Update */
442 typedef struct update_t update_t;
443 typedef struct update_iterator_t update_iterator_t;
444
445 /*****************************************************************************
446  * Variable callbacks
447  *****************************************************************************/
448 typedef int ( * vlc_callback_t ) ( vlc_object_t *,      /* variable's object */
449                                    char const *,            /* variable name */
450                                    vlc_value_t,                 /* old value */
451                                    vlc_value_t,                 /* new value */
452                                    void * );                /* callback data */
453
454 /*****************************************************************************
455  * Plug-in stuff
456  *****************************************************************************/
457 #if !defined (__PLUGIN__) || defined (HAVE_SHARED_LIBVLC)
458 #   ifdef __cplusplus
459 #      define VLC_EXPORT( type, name, args ) extern "C" type name args
460 #   else
461 #      define VLC_EXPORT( type, name, args ) type name args
462 #   endif
463 #else
464 #   define VLC_EXPORT( type, name, args ) struct _u_n_u_s_e_d_
465     extern module_symbols_t* p_symbols;
466 #endif
467
468 /*****************************************************************************
469  * OS-specific headers and thread types
470  *****************************************************************************/
471 #if defined( WIN32 ) || defined( UNDER_CE )
472 #   define WIN32_LEAN_AND_MEAN
473 #   include <windows.h>
474 #   if defined( UNDER_CE )
475 #      define IS_WINNT 0
476 #   else
477 #      define IS_WINNT ( GetVersion() < 0x80000000 )
478 #   endif
479 #endif
480
481 #include "vlc_threads.h"
482
483 /*****************************************************************************
484  * Common structure members
485  *****************************************************************************/
486
487 /* VLC_COMMON_MEMBERS : members common to all basic vlc objects */
488 #define VLC_COMMON_MEMBERS                                                  \
489 /** \name VLC_COMMON_MEMBERS                                                \
490  * these members are common for all vlc objects                             \
491  */                                                                         \
492 /**@{*/                                                                     \
493     int   i_object_id;                                                      \
494     int   i_object_type;                                                    \
495     const char *psz_object_type;                                            \
496     char *psz_object_name;                                                  \
497                                                                             \
498     /* Messages header */                                                   \
499     char *psz_header;                                                       \
500     int  i_flags;                                                           \
501                                                                             \
502     /* Thread properties, if any */                                         \
503     vlc_bool_t   b_thread;                                                  \
504     vlc_thread_t thread_id;                                                 \
505                                                                             \
506     /* Object access lock */                                                \
507     vlc_mutex_t  object_lock;                                               \
508     vlc_cond_t   object_wait;                                               \
509                                                                             \
510     /* Object properties */                                                 \
511     volatile vlc_bool_t b_error;                  /**< set by the object */ \
512     volatile vlc_bool_t b_die;                   /**< set by the outside */ \
513     volatile vlc_bool_t b_dead;                   /**< set by the object */ \
514     volatile vlc_bool_t b_attached;               /**< set by the object */ \
515     vlc_bool_t b_force;      /**< set by the outside (eg. module_Need()) */ \
516                                                                             \
517     /* Object variables */                                                  \
518     vlc_mutex_t     var_lock;                                               \
519     int             i_vars;                                                 \
520     variable_t *    p_vars;                                                 \
521                                                                             \
522     /* Stuff related to the libvlc structure */                             \
523     libvlc_t *      p_libvlc;                      /**< root of all evil */ \
524     vlc_t *         p_vlc;                   /**< (root of all evil) - 1 */ \
525                                                                             \
526     volatile int    i_refcount;                         /**< usage count */ \
527     vlc_object_t *  p_parent;                            /**< our parent */ \
528     vlc_object_t ** pp_children;                       /**< our children */ \
529     volatile int    i_children;                                             \
530                                                                             \
531     /* Private data */                                                      \
532     void *          p_private;                                              \
533                                                                             \
534     /** Just a reminder so that people don't cast garbage */                \
535     int be_sure_to_add_VLC_COMMON_MEMBERS_to_struct;                        \
536 /**@}*/                                                                     \
537
538 /* VLC_OBJECT: attempt at doing a clever cast */
539 #define VLC_OBJECT( x ) \
540     ((vlc_object_t *)(x))+0*(x)->be_sure_to_add_VLC_COMMON_MEMBERS_to_struct
541
542 #define VLC_GC_MEMBERS                                                       \
543 /** \name VLC_GC_MEMBERS                                                     \
544  * these members are common to all objects that wish to be garbage-collected \
545  */                                                                          \
546 /**@{*/                                                                      \
547     int i_gc_refcount;                                                       \
548     void (*pf_destructor) ( gc_object_t * );                                 \
549     void *p_destructor_arg;                                                  \
550 /**@}*/
551
552 struct gc_object_t
553 {
554             VLC_GC_MEMBERS
555 };
556
557 static inline void __vlc_gc_incref( gc_object_t * p_gc )
558 {
559     p_gc->i_gc_refcount ++;
560 };
561
562 static inline void __vlc_gc_decref( gc_object_t *p_gc )
563 {
564     p_gc->i_gc_refcount -- ;
565
566     if( p_gc->i_gc_refcount == 0 )
567     {
568         p_gc->pf_destructor( p_gc );
569         /* Do not use the p_gc pointer from now on ! */
570      }
571 }
572
573 #define vlc_gc_incref( a ) __vlc_gc_incref( (gc_object_t *)a )
574 #define vlc_gc_decref( a ) __vlc_gc_decref( (gc_object_t *)a )
575 #define vlc_gc_init( a,b,c ) {  ((gc_object_t *)a)->i_gc_refcount = 0; \
576                               ((gc_object_t *)a)->pf_destructor = b; \
577                               ((gc_object_t *)a)->p_destructor_arg = c; }
578
579
580 /*****************************************************************************
581  * Macros and inline functions
582  *****************************************************************************/
583 #ifdef NTOHL_IN_SYS_PARAM_H
584 #   include <sys/param.h>
585
586 #elif !defined(WIN32) && !defined( UNDER_CE )
587 #   include <netinet/in.h>
588
589 #endif /* NTOHL_IN_SYS_PARAM_H || WIN32 */
590
591 /* CEIL: division with round to nearest greater integer */
592 #define CEIL(n, d)  ( ((n) / (d)) + ( ((n) % (d)) ? 1 : 0) )
593
594 /* PAD: PAD(n, d) = CEIL(n ,d) * d */
595 #define PAD(n, d)   ( ((n) % (d)) ? ((((n) / (d)) + 1) * (d)) : (n) )
596
597 /* __MAX and __MIN: self explanatory */
598 #ifndef __MAX
599 #   define __MAX(a, b)   ( ((a) > (b)) ? (a) : (b) )
600 #endif
601 #ifndef __MIN
602 #   define __MIN(a, b)   ( ((a) < (b)) ? (a) : (b) )
603 #endif
604
605 static int64_t GCD( int64_t a, int64_t b )
606 {
607     if( b ) return GCD( b, a % b );
608     else return a;
609 }
610
611 /* Malloc with automatic error */
612 #define MALLOC_VOID( var, type ) { var = (type*)malloc( sizeof( type) ); \
613                                    if( !var ) return; }
614 #define MALLOC_NULL( var, type ) { var = (type*)malloc( sizeof( type) ); \
615                                    if( !var ) return NULL; }
616 #define MALLOC_ERR( var, type ) { var = (type*)malloc( sizeof( type) ); \
617                                    if( !var ) return VLC_ENOMEM; }
618 #define MALLOC_GOTOERR( var, type ) { var = (type*)malloc( sizeof( type) ); \
619                                       if( !var ) goto error; }
620 #define DECMALLOC_VOID( var, type ) type* var = (type*)malloc( sizeof(type) );\
621                                     if( !var ) return;
622 #define DECMALLOC_ERR( var, type ) type* var = (type*)malloc( sizeof(type) );\
623                                     if( !var ) return VLC_ENOMEM;
624 #define DECMALLOC_NULL( var, type ) type* var = (type*)malloc( sizeof(type) );\
625                                     if( !var ) return NULL;
626
627 #define FREENULL(a) if( a ) { free( a ); a = NULL; }
628 #define FREE(a) if( a ) { free( a ); }
629
630 /* Dynamic array handling: realloc array, move data, increment position */
631 #if defined( _MSC_VER ) && _MSC_VER < 1300 && !defined( UNDER_CE )
632 #   define VLCCVP (void**) /* Work-around for broken compiler */
633 #else
634 #   define VLCCVP
635 #endif
636 #define INSERT_ELEM( p_ar, i_oldsize, i_pos, elem )                           \
637     do                                                                        \
638     {                                                                         \
639         if( !i_oldsize ) (p_ar) = NULL;                                       \
640         (p_ar) = VLCCVP realloc( p_ar, ((i_oldsize) + 1) * sizeof(*(p_ar)) ); \
641         if( (i_oldsize) - (i_pos) )                                           \
642         {                                                                     \
643             memmove( (p_ar) + (i_pos) + 1, (p_ar) + (i_pos),                  \
644                      ((i_oldsize) - (i_pos)) * sizeof( *(p_ar) ) );           \
645         }                                                                     \
646         (p_ar)[i_pos] = elem;                                                 \
647         (i_oldsize)++;                                                        \
648     }                                                                         \
649     while( 0 )
650
651 #define REMOVE_ELEM( p_ar, i_oldsize, i_pos )                                 \
652     do                                                                        \
653     {                                                                         \
654         if( (i_oldsize) - (i_pos) - 1 )                                       \
655         {                                                                     \
656             memmove( (p_ar) + (i_pos),                                        \
657                      (p_ar) + (i_pos) + 1,                                    \
658                      ((i_oldsize) - (i_pos) - 1) * sizeof( *(p_ar) ) );       \
659         }                                                                     \
660         if( i_oldsize > 1 )                                                   \
661         {                                                                     \
662             (p_ar) = realloc( p_ar, ((i_oldsize) - 1) * sizeof( *(p_ar) ) );  \
663         }                                                                     \
664         else                                                                  \
665         {                                                                     \
666             free( p_ar );                                                     \
667             (p_ar) = NULL;                                                    \
668         }                                                                     \
669         (i_oldsize)--;                                                        \
670     }                                                                         \
671     while( 0 )
672
673
674 #define TAB_APPEND( count, tab, p )             \
675     if( (count) > 0 )                           \
676     {                                           \
677         (tab) = realloc( tab, sizeof( void ** ) * ( (count) + 1 ) ); \
678     }                                           \
679     else                                        \
680     {                                           \
681         (tab) = malloc( sizeof( void ** ) );    \
682     }                                           \
683     (tab)[count] = (p);        \
684     (count)++
685
686 #define TAB_FIND( count, tab, p, index )        \
687     {                                           \
688         int _i_;                                \
689         (index) = -1;                           \
690         for( _i_ = 0; _i_ < (count); _i_++ )    \
691         {                                       \
692             if( (tab)[_i_] == (p) )  \
693             {                                   \
694                 (index) = _i_;                  \
695                 break;                          \
696             }                                   \
697         }                                       \
698     }
699
700 #define TAB_REMOVE( count, tab, p )             \
701     {                                           \
702         int _i_index_;                          \
703         TAB_FIND( count, tab, p, _i_index_ );   \
704         if( _i_index_ >= 0 )                    \
705         {                                       \
706             if( (count) > 1 )                     \
707             {                                   \
708                 memmove( ((void**)(tab) + _i_index_),    \
709                          ((void**)(tab) + _i_index_+1),  \
710                          ( (count) - _i_index_ - 1 ) * sizeof( void* ) );\
711             }                                   \
712             (count)--;                          \
713             if( (count) == 0 )                  \
714             {                                   \
715                 free( tab );                    \
716                 (tab) = NULL;                   \
717             }                                   \
718         }                                       \
719     }
720
721 /* Binary search in an array */
722 #define BSEARCH( entries, count, elem, zetype, key, answer ) {  \
723     int low = 0, high = count - 1;   \
724     answer = -1; \
725     while( low <= high ) {\
726         int mid = (low + high ) / 2; /* Just don't care about 2^30 tables */ \
727         zetype mid_val = entries[mid] elem;\
728         if( mid_val < key ) \
729             low = mid + 1; \
730         else if ( mid_val > key ) \
731             high = mid -1;  \
732         else    \
733         {   \
734             answer = mid;  break;   \
735         }\
736     } \
737 }
738
739 /* Dictionnary handling */
740 struct dict_entry_t
741 {
742     int       i_int;
743     char     *psz_string;
744     uint64_t  i_hash;
745     void     *p_data;
746 };
747
748 struct dict_t
749 {
750     dict_entry_t *p_entries;
751     int i_entries;
752 };
753
754 VLC_EXPORT( dict_t *, vlc_DictNew, (void) );
755 VLC_EXPORT( void, vlc_DictClear, (dict_t * ) );
756 VLC_EXPORT( void, vlc_DictInsert, (dict_t *, int, const char *, void * ) );
757 VLC_EXPORT( void*, vlc_DictGet, (dict_t *, int, const char * ) );
758 VLC_EXPORT( int, vlc_DictLookup, (dict_t *, int, const char * ) );
759
760 /* MSB (big endian)/LSB (little endian) conversions - network order is always
761  * MSB, and should be used for both network communications and files. Note that
762  * byte orders other than little and big endians are not supported, but only
763  * the VAX seems to have such exotic properties. */
764 static inline uint16_t U16_AT( void const * _p )
765 {
766     uint8_t * p = (uint8_t *)_p;
767     return ( ((uint16_t)p[0] << 8) | p[1] );
768 }
769 static inline uint32_t U32_AT( void const * _p )
770 {
771     uint8_t * p = (uint8_t *)_p;
772     return ( ((uint32_t)p[0] << 24) | ((uint32_t)p[1] << 16)
773               | ((uint32_t)p[2] << 8) | p[3] );
774 }
775 static inline uint64_t U64_AT( void const * _p )
776 {
777     uint8_t * p = (uint8_t *)_p;
778     return ( ((uint64_t)p[0] << 56) | ((uint64_t)p[1] << 48)
779               | ((uint64_t)p[2] << 40) | ((uint64_t)p[3] << 32)
780               | ((uint64_t)p[4] << 24) | ((uint64_t)p[5] << 16)
781               | ((uint64_t)p[6] << 8) | p[7] );
782 }
783
784 static inline uint16_t GetWLE( void const * _p )
785 {
786     uint8_t * p = (uint8_t *)_p;
787     return ( ((uint16_t)p[1] << 8) | p[0] );
788 }
789 static inline uint32_t GetDWLE( void const * _p )
790 {
791     uint8_t * p = (uint8_t *)_p;
792     return ( ((uint32_t)p[3] << 24) | ((uint32_t)p[2] << 16)
793               | ((uint32_t)p[1] << 8) | p[0] );
794 }
795 static inline uint64_t GetQWLE( void const * _p )
796 {
797     uint8_t * p = (uint8_t *)_p;
798     return ( ((uint64_t)p[7] << 56) | ((uint64_t)p[6] << 48)
799               | ((uint64_t)p[5] << 40) | ((uint64_t)p[4] << 32)
800               | ((uint64_t)p[3] << 24) | ((uint64_t)p[2] << 16)
801               | ((uint64_t)p[1] << 8) | p[0] );
802 }
803
804 #define GetWBE( p )     U16_AT( p )
805 #define GetDWBE( p )    U32_AT( p )
806 #define GetQWBE( p )    U64_AT( p )
807
808 /* Helper writer functions */
809 #define SetWLE( p, v ) _SetWLE( (uint8_t*)p, v)
810 static inline void _SetWLE( uint8_t *p, uint16_t i_dw )
811 {
812     p[1] = ( i_dw >>  8 )&0xff;
813     p[0] = ( i_dw       )&0xff;
814 }
815
816 #define SetDWLE( p, v ) _SetDWLE( (uint8_t*)p, v)
817 static inline void _SetDWLE( uint8_t *p, uint32_t i_dw )
818 {
819     p[3] = ( i_dw >> 24 )&0xff;
820     p[2] = ( i_dw >> 16 )&0xff;
821     p[1] = ( i_dw >>  8 )&0xff;
822     p[0] = ( i_dw       )&0xff;
823 }
824 #define SetQWLE( p, v ) _SetQWLE( (uint8_t*)p, v)
825 static inline void _SetQWLE( uint8_t *p, uint64_t i_qw )
826 {
827     SetDWLE( p,   i_qw&0xffffffff );
828     SetDWLE( p+4, ( i_qw >> 32)&0xffffffff );
829 }
830 #define SetWBE( p, v ) _SetWBE( (uint8_t*)p, v)
831 static inline void _SetWBE( uint8_t *p, uint16_t i_dw )
832 {
833     p[0] = ( i_dw >>  8 )&0xff;
834     p[1] = ( i_dw       )&0xff;
835 }
836
837 #define SetDWBE( p, v ) _SetDWBE( (uint8_t*)p, v)
838 static inline void _SetDWBE( uint8_t *p, uint32_t i_dw )
839 {
840     p[0] = ( i_dw >> 24 )&0xff;
841     p[1] = ( i_dw >> 16 )&0xff;
842     p[2] = ( i_dw >>  8 )&0xff;
843     p[3] = ( i_dw       )&0xff;
844 }
845 #define SetQWBE( p, v ) _SetQWBE( (uint8_t*)p, v)
846 static inline void _SetQWBE( uint8_t *p, uint64_t i_qw )
847 {
848     SetDWBE( p+4,   i_qw&0xffffffff );
849     SetDWBE( p, ( i_qw >> 32)&0xffffffff );
850 }
851
852 #if WORDS_BIGENDIAN
853 #   define hton16(i)   ( i )
854 #   define hton32(i)   ( i )
855 #   define hton64(i)   ( i )
856 #   define ntoh16(i)   ( i )
857 #   define ntoh32(i)   ( i )
858 #   define ntoh64(i)   ( i )
859 #else
860 #   define hton16(i)   U16_AT(&i)
861 #   define hton32(i)   U32_AT(&i)
862 #   define hton64(i)   U64_AT(&i)
863 #   define ntoh16(i)   U16_AT(&i)
864 #   define ntoh32(i)   U32_AT(&i)
865 #   define ntoh64(i)   U64_AT(&i)
866 #endif
867
868 /* Format string sanity checks */
869 #ifdef HAVE_ATTRIBUTE_FORMAT
870 #   define ATTRIBUTE_FORMAT(x,y) __attribute__ ((format(printf,x,y)))
871 #else
872 #   define ATTRIBUTE_FORMAT(x,y)
873 #endif
874
875 /* Alignment of critical static data structures */
876 #ifdef ATTRIBUTE_ALIGNED_MAX
877 #   define ATTR_ALIGN(align) __attribute__ ((__aligned__ ((ATTRIBUTE_ALIGNED_MAX < align) ? ATTRIBUTE_ALIGNED_MAX : align)))
878 #else
879 #   define ATTR_ALIGN(align)
880 #endif
881
882 /* Alignment of critical dynamic data structure
883  *
884  * Not all platforms support memalign so we provide a vlc_memalign wrapper
885  * void *vlc_memalign( size_t align, size_t size, void **pp_orig )
886  * *pp_orig is the pointer that has to be freed afterwards.
887  */
888 #if 0
889 #ifdef HAVE_POSIX_MEMALIGN
890 #   define vlc_memalign(align,size,pp_orig) \
891     ( !posix_memalign( pp_orig, align, size ) ? *(pp_orig) : NULL )
892 #endif
893 #endif
894 #ifdef HAVE_MEMALIGN
895     /* Some systems have memalign() but no declaration for it */
896     void * memalign( size_t align, size_t size );
897
898 #   define vlc_memalign(pp_orig,align,size) \
899     ( *(pp_orig) = memalign( align, size ) )
900
901 #else /* We don't have any choice but to align manually */
902 #   define vlc_memalign(pp_orig,align,size) \
903     (( *(pp_orig) = malloc( size + align - 1 )) \
904         ? (void *)( (((unsigned long)*(pp_orig)) + (unsigned long)(align-1) ) \
905                        & (~(unsigned long)(align-1)) ) \
906         : NULL )
907
908 #endif
909
910 /* Stuff defined in src/extras/libc.c */
911 #ifndef HAVE_STRDUP
912 #   define strdup vlc_strdup
913     VLC_EXPORT( char *, vlc_strdup, ( const char *s ) );
914 #elif !defined(__PLUGIN__)
915 #   define vlc_strdup NULL
916 #endif
917
918 #if !defined(HAVE_VASPRINTF) || defined(__APPLE__) || defined(SYS_BEOS)
919 #   define vasprintf vlc_vasprintf
920     VLC_EXPORT( int, vlc_vasprintf, (char **, const char *, va_list ) );
921 #elif !defined(__PLUGIN__)
922 #   define vlc_vasprintf NULL
923 #endif
924
925 #if !defined(HAVE_ASPRINTF) || defined(__APPLE__) || defined(SYS_BEOS)
926 #   define asprintf vlc_asprintf
927     VLC_EXPORT( int, vlc_asprintf, (char **, const char *, ... ) );
928 #elif !defined(__PLUGIN__)
929 #   define vlc_asprintf NULL
930 #endif
931
932 #ifndef HAVE_STRNDUP
933 #   if defined(STRNDUP_IN_GNOME_H) && \
934         (defined(MODULE_NAME_IS_gnome)||defined(MODULE_NAME_IS_gnome_main)||\
935          defined(MODULE_NAME_IS_gnome2)||defined(MODULE_NAME_IS_gnome2_main))
936         /* Do nothing: gnome.h defines strndup for us */
937 #   else
938 #       define strndup vlc_strndup
939         VLC_EXPORT( char *, vlc_strndup, ( const char *s, size_t n ) );
940 #   endif
941 #elif !defined(__PLUGIN__)
942 #   define vlc_strndup NULL
943 #endif
944
945 #ifndef HAVE_STRLCPY
946 #   define strlcpy vlc_strlcpy
947     VLC_EXPORT( size_t, vlc_strlcpy, ( char *, const char *, size_t ) );
948 #elif !defined(__PLUGIN__)
949 #   define vlc_strlcpy NULL
950 #endif
951
952 #ifndef HAVE_ATOF
953 #   define atof vlc_atof
954     VLC_EXPORT( double, vlc_atof, ( const char *nptr ) );
955 #elif !defined(__PLUGIN__)
956 #   define vlc_atof NULL
957 #endif
958
959 #ifndef HAVE_STRTOF
960 #   ifdef HAVE_STRTOD
961 #       define strtof strtod
962 #   endif
963 #endif
964
965 #ifndef HAVE_ATOLL
966 #   define atoll vlc_atoll
967     VLC_EXPORT( int64_t, vlc_atoll, ( const char *nptr ) );
968 #elif !defined(__PLUGIN__)
969 #   define vlc_atoll NULL
970 #endif
971
972 #ifndef HAVE_STRTOLL
973 #   define strtoll vlc_strtoll
974     VLC_EXPORT( int64_t, vlc_strtoll, ( const char *nptr, char **endptr, int base ) );
975 #elif !defined(__PLUGIN__)
976 #   define vlc_strtoll NULL
977 #endif
978
979 #if defined(SYS_BEOS)
980     typedef struct {
981         long long quot; /* Quotient. */
982         long long rem;  /* Remainder. */
983     } lldiv_t;
984 #   define lldiv vlc_lldiv
985     VLC_EXPORT( lldiv_t, vlc_lldiv, ( long long numer, long long denom ) );
986 #elif !defined(__PLUGIN__)
987 #   define vlc_lldiv NULL
988 #endif
989
990 #ifndef HAVE_SCANDIR
991 #   define scandir vlc_scandir
992 #   define alphasort vlc_alphasort
993     struct dirent;
994     VLC_EXPORT( int, vlc_scandir, ( const char *name, struct dirent ***namelist, int (*filter) ( const struct dirent * ), int (*compar) ( const struct dirent **, const struct dirent ** ) ) );
995     VLC_EXPORT( int, vlc_alphasort, ( const struct dirent **a, const struct dirent **b ) );
996 #elif !defined(__PLUGIN__)
997 #   define vlc_scandir NULL
998 #   define vlc_alphasort NULL
999 #endif
1000
1001 #ifndef HAVE_GETENV
1002 #   define getenv vlc_getenv
1003     VLC_EXPORT( char *, vlc_getenv, ( const char *name ) );
1004 #elif !defined(__PLUGIN__)
1005 #   define vlc_getenv NULL
1006 #endif
1007
1008 #ifndef HAVE_STRCASECMP
1009 #   ifndef HAVE_STRICMP
1010 #       define strcasecmp vlc_strcasecmp
1011         VLC_EXPORT( int, vlc_strcasecmp, ( const char *s1, const char *s2 ) );
1012 #   else
1013 #       define strcasecmp stricmp
1014 #       if !defined(__PLUGIN__)
1015 #           define vlc_strcasecmp NULL
1016 #       endif
1017 #   endif
1018 #elif !defined(__PLUGIN__)
1019 #   define vlc_strcasecmp NULL
1020 #endif
1021
1022 #ifndef HAVE_STRNCASECMP
1023 #   ifndef HAVE_STRNICMP
1024 #       define strncasecmp vlc_strncasecmp
1025         VLC_EXPORT( int, vlc_strncasecmp, ( const char *s1, const char *s2, size_t n ) );
1026 #   else
1027 #       define strncasecmp strnicmp
1028 #       if !defined(__PLUGIN__)
1029 #           define vlc_strncasecmp NULL
1030 #       endif
1031 #   endif
1032 #elif !defined(__PLUGIN__)
1033 #   define vlc_strncasecmp NULL
1034 #endif
1035
1036 #ifndef HAVE_STRCASESTR
1037 #   ifndef HAVE_STRISTR
1038 #       define strcasestr vlc_strcasestr
1039         VLC_EXPORT( char *, vlc_strcasestr, ( const char *s1, const char *s2 ) );
1040 #   else
1041 #       define strcasestr stristr
1042 #       if !defined(__PLUGIN__)
1043 #           define vlc_strcasestr NULL
1044 #       endif
1045 #   endif
1046 #elif !defined(__PLUGIN__)
1047 #   define vlc_strcasestr NULL
1048 #endif
1049
1050 #ifndef HAVE_DIRENT_H
1051     typedef void DIR;
1052 #   ifndef FILENAME_MAX
1053 #       define FILENAME_MAX (260)
1054 #   endif
1055     struct dirent
1056     {
1057         long            d_ino;          /* Always zero. */
1058         unsigned short  d_reclen;       /* Always zero. */
1059         unsigned short  d_namlen;       /* Length of name in d_name. */
1060         char            d_name[FILENAME_MAX]; /* File name. */
1061     };
1062 #   define opendir vlc_opendir
1063 #   define readdir vlc_readdir
1064 #   define closedir vlc_closedir
1065     VLC_EXPORT( void *, vlc_opendir, ( const char * ) );
1066     VLC_EXPORT( void *, vlc_readdir, ( void * ) );
1067     VLC_EXPORT( int, vlc_closedir, ( void * ) );
1068 #else
1069     struct dirent;  /* forward declaration for vlc_symbols.h */
1070 #   if !defined(__PLUGIN__)
1071 #       define vlc_opendir  NULL
1072 #       define vlc_readdir  NULL
1073 #       define vlc_closedir NULL
1074 #   endif
1075 #endif
1076
1077     VLC_EXPORT( void *, vlc_opendir_wrapper, ( const char * ) );
1078     VLC_EXPORT( struct dirent *, vlc_readdir_wrapper, ( void * ) );
1079     VLC_EXPORT( int, vlc_closedir_wrapper, ( void * ) );
1080
1081 /* Format type specifiers for 64 bits numbers */
1082 #if defined(__CYGWIN32__) || (!defined(WIN32) && !defined(UNDER_CE))
1083 #   if defined(__WORDSIZE) && __WORDSIZE == 64
1084 #       define I64Fd "%ld"
1085 #       define I64Fi "%li"
1086 #       define I64Fo "%lo"
1087 #       define I64Fu "%lu"
1088 #       define I64Fx "%lx"
1089 #       define I64FX "%lX"
1090 #   else
1091 #       define I64Fd "%lld"
1092 #       define I64Fi "%lli"
1093 #       define I64Fo "%llo"
1094 #       define I64Fu "%llu"
1095 #       define I64Fx "%llx"
1096 #       define I64FX "%llX"
1097 #   endif
1098 #else
1099 #   define I64Fd "%I64d"
1100 #   define I64Fi "%I64i"
1101 #   define I64Fo "%I64o"
1102 #   define I64Fu "%I64u"
1103 #   define I64Fx "%I64x"
1104 #   define I64FX "%I64X"
1105 #endif /* defined(WIN32)||defined(UNDER_CE) */
1106
1107 /* 64 bits integer constant suffix */
1108 #if defined( __MINGW32__ ) || (!defined(WIN32) && !defined(UNDER_CE))
1109 #   if defined(__WORDSIZE) && __WORDSIZE == 64
1110 #       define I64C(x)         x##L
1111 #       define UI64C(x)        x##UL
1112 #   else
1113 #       define I64C(x)         x##LL
1114 #       define UI64C(x)        x##ULL
1115 #   endif
1116 #else
1117 #   define I64C(x)         x##i64
1118 #   define UI64C(x)        x##ui64
1119 #endif /* defined(WIN32)||defined(UNDER_CE) */
1120
1121 #if defined(WIN32) || defined(UNDER_CE)
1122 /* win32, cl and icl support */
1123 #   if defined( _MSC_VER ) || !defined( __MINGW32__ )
1124 #       define __attribute__(x)
1125 #       define __inline__      __inline
1126 #       define S_IFBLK         0x3000  /* Block */
1127 #       define S_ISBLK(m)      (0)
1128 #       define S_ISCHR(m)      (0)
1129 #       define S_ISFIFO(m)     (((m)&_S_IFMT) == _S_IFIFO)
1130 #       define S_ISREG(m)      (((m)&_S_IFMT) == _S_IFREG)
1131 #   endif
1132
1133 /* several type definitions */
1134 #   if defined( __MINGW32__ )
1135 #       if !defined( _OFF_T_ )
1136             typedef long long _off_t;
1137             typedef _off_t off_t;
1138 #           define _OFF_T_
1139 #       else
1140 #           ifdef off_t
1141 #               undef off_t
1142 #           endif
1143 #           define off_t long long
1144 #       endif
1145 #   endif
1146
1147 #   if defined( _MSC_VER ) && !defined( __WXMSW__ )
1148 #       if !defined( _OFF_T_DEFINED )
1149             typedef __int64 off_t;
1150 #           define _OFF_T_DEFINED
1151 #       else
1152             /* for wx compatibility typedef long off_t; */
1153 #           define off_t __int64
1154 #       endif
1155 #   endif
1156
1157 #   if defined( __BORLANDC__ )
1158 #       undef off_t
1159 #       define off_t unsigned __int64
1160 #   endif
1161
1162 #   ifndef O_NONBLOCK
1163 #       define O_NONBLOCK 0
1164 #   endif
1165
1166 #   ifndef alloca
1167 #       define alloca _alloca
1168 #   endif
1169
1170     /* These two are not defined in mingw32 (bug?) */
1171 #   ifndef snprintf
1172 #       define snprintf _snprintf
1173 #   endif
1174 #   ifndef vsnprintf
1175 #       define vsnprintf _vsnprintf
1176 #   endif
1177
1178 #   include <tchar.h>
1179 #endif
1180
1181 VLC_EXPORT( vlc_bool_t, vlc_ureduce, ( unsigned *, unsigned *, uint64_t, uint64_t, uint64_t ) );
1182 VLC_EXPORT( char **, vlc_parse_cmdline, ( const char *, int * ) );
1183
1184 /* vlc_wraptext (defined in src/extras/libc.c) */
1185 #define wraptext vlc_wraptext
1186 VLC_EXPORT( char *, vlc_wraptext, ( const char *, int ) );
1187
1188 /* iconv wrappers (defined in src/extras/libc.c) */
1189 typedef void *vlc_iconv_t;
1190 VLC_EXPORT( vlc_iconv_t, vlc_iconv_open, ( const char *, const char * ) );
1191 VLC_EXPORT( size_t, vlc_iconv, ( vlc_iconv_t, const char **, size_t *, char **, size_t * ) );
1192 VLC_EXPORT( int, vlc_iconv_close, ( vlc_iconv_t ) );
1193
1194 /* execve wrapper (defined in src/extras/libc.c) */
1195 VLC_EXPORT( int, __vlc_execve, ( vlc_object_t *p_object, int i_argc, char **pp_argv, char **pp_env, char *psz_cwd, char *p_in, int i_in, char **pp_data, int *pi_data ) );
1196 #define vlc_execve(a,b,c,d,e,f,g,h,i) __vlc_execve(VLC_OBJECT(a),b,c,d,e,f,g,h,i)
1197
1198 /*****************************************************************************
1199  * CPU capabilities
1200  *****************************************************************************/
1201 #define CPU_CAPABILITY_NONE    0
1202 #define CPU_CAPABILITY_486     (1<<0)
1203 #define CPU_CAPABILITY_586     (1<<1)
1204 #define CPU_CAPABILITY_PPRO    (1<<2)
1205 #define CPU_CAPABILITY_MMX     (1<<3)
1206 #define CPU_CAPABILITY_3DNOW   (1<<4)
1207 #define CPU_CAPABILITY_MMXEXT  (1<<5)
1208 #define CPU_CAPABILITY_SSE     (1<<6)
1209 #define CPU_CAPABILITY_SSE2    (1<<7)
1210 #define CPU_CAPABILITY_ALTIVEC (1<<16)
1211 #define CPU_CAPABILITY_FPU     (1<<31)
1212
1213 /*****************************************************************************
1214  * I18n stuff
1215  *****************************************************************************/
1216 #if defined (WIN32) || !defined (HAVE_SHARED_LIBVLC)
1217 VLC_EXPORT( char *, vlc_dgettext, ( const char *package, const char *msgid ) );
1218 #endif
1219
1220 #if defined( ENABLE_NLS ) && \
1221      (defined(MODULE_NAME_IS_gnome)||defined(MODULE_NAME_IS_gnome_main)||\
1222       defined(MODULE_NAME_IS_gnome2)||defined(MODULE_NAME_IS_gnome2_main)||\
1223       defined(MODULE_NAME_IS_pda))
1224     /* Declare nothing: gnome.h will do it for us */
1225 #elif defined( ENABLE_NLS )
1226 #   if defined( HAVE_INCLUDED_GETTEXT )
1227 #       include "libintl.h"
1228 #   else
1229 #       include <libintl.h>
1230 #   endif
1231 #   undef _
1232 #   if defined (WIN32) || !defined (HAVE_SHARED_LIBVLC)
1233 #       define _(String) vlc_dgettext (PACKAGE_NAME, String)
1234 #   else
1235 #       define _(String) dgettext(PACKAGE_NAME, String)
1236 #   endif
1237 #   define N_(String) ((char*)(String))
1238 #else
1239 #   define _(String) ((char*)(String))
1240 #   define N_(String) ((char*)(String))
1241 #endif
1242
1243 /*****************************************************************************
1244  * libvlc features
1245  *****************************************************************************/
1246 VLC_EXPORT( const char *, VLC_Version, ( void ) );
1247 VLC_EXPORT( const char *, VLC_CompileBy, ( void ) );
1248 VLC_EXPORT( const char *, VLC_CompileHost, ( void ) );
1249 VLC_EXPORT( const char *, VLC_CompileDomain, ( void ) );
1250 VLC_EXPORT( const char *, VLC_Compiler, ( void ) );
1251 VLC_EXPORT( const char *, VLC_Error, ( int ) );
1252
1253 /*****************************************************************************
1254  * Additional vlc stuff
1255  *****************************************************************************/
1256 #ifndef HAVE_SHARED_LIBVLC
1257 VLC_EXPORT( const char *, VLC_Changeset, ( void ) );
1258 #   include "vlc_symbols.h"
1259 #else
1260 #   define VLC_Changeset( ) ("exported")
1261 #endif
1262 #include "os_specific.h"
1263 #include "vlc_messages.h"
1264 #include "variables.h"
1265 #include "vlc_objects.h"
1266 #include "vlc_threads_funcs.h"
1267 #include "mtime.h"
1268 #include "modules.h"
1269 #include "main.h"
1270 #include "configuration.h"
1271
1272 #if defined( __BORLANDC__ )
1273 #   undef PACKAGE
1274 #   define PACKAGE
1275 #endif
1276