]> git.sesse.net Git - vlc/blob - src/libvlc.c
libvlc: Put vlc_usage in the same file than where it is used.
[vlc] / src / libvlc.c
1 /*****************************************************************************
2  * libvlc.c: libvlc instances creation and deletion, interfaces handling
3  *****************************************************************************
4  * Copyright (C) 1998-2008 the VideoLAN team
5  * $Id$
6  *
7  * Authors: Vincent Seguin <seguin@via.ecp.fr>
8  *          Samuel Hocevar <sam@zoy.org>
9  *          Gildas Bazin <gbazin@videolan.org>
10  *          Derk-Jan Hartman <hartman at videolan dot org>
11  *          RĂ©mi Denis-Courmont <rem # videolan : org>
12  *
13  * This program is free software; you can redistribute it and/or modify
14  * it under the terms of the GNU General Public License as published by
15  * the Free Software Foundation; either version 2 of the License, or
16  * (at your option) any later version.
17  *
18  * This program is distributed in the hope that it will be useful,
19  * but WITHOUT ANY WARRANTY; without even the implied warranty of
20  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
21  * GNU General Public License for more details.
22  *
23  * You should have received a copy of the GNU General Public License
24  * along with this program; if not, write to the Free Software
25  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
26  *****************************************************************************/
27
28 /** \file
29  * This file contains functions to create and destroy libvlc instances
30  */
31
32 /*****************************************************************************
33  * Preamble
34  *****************************************************************************/
35 #ifdef HAVE_CONFIG_H
36 # include "config.h"
37 #endif
38
39 #include <vlc_common.h>
40 #include "control/libvlc_internal.h"
41 #include <vlc_input.h>
42
43 #include "modules/modules.h"
44 #include "config/configuration.h"
45
46 #include <errno.h>                                                 /* ENOMEM */
47 #include <stdio.h>                                              /* sprintf() */
48 #include <string.h>
49 #include <stdlib.h>                                                /* free() */
50
51 #ifndef WIN32
52 #   include <netinet/in.h>                            /* BSD: struct in_addr */
53 #endif
54
55 #ifdef HAVE_UNISTD_H
56 #   include <unistd.h>
57 #elif defined( WIN32 ) && !defined( UNDER_CE )
58 #   include <io.h>
59 #endif
60
61 #ifdef WIN32                       /* optind, getopt(), included in unistd.h */
62 #   include "extras/getopt.h"
63 #endif
64
65 #ifdef HAVE_LOCALE_H
66 #   include <locale.h>
67 #endif
68
69 #ifdef ENABLE_NLS
70 # include <libintl.h> /* bindtextdomain */
71 #endif
72
73 #ifdef HAVE_DBUS
74 /* used for one-instance mode */
75 #   include <dbus/dbus.h>
76 #endif
77
78 #ifdef HAVE_HAL
79 #   include <hal/libhal.h>
80 #endif
81
82 #include <vlc_playlist.h>
83 #include <vlc_interface.h>
84
85 #include <vlc_aout.h>
86 #include "audio_output/aout_internal.h"
87
88 #include <vlc_charset.h>
89
90 #include "libvlc.h"
91
92 #include "playlist/playlist_internal.h"
93
94 #include <vlc_vlm.h>
95
96 #ifdef __APPLE__
97 # include <libkern/OSAtomic.h>
98 #endif
99
100 #include <assert.h>
101
102 /*****************************************************************************
103  * The evil global variables. We handle them with care, don't worry.
104  *****************************************************************************/
105 static unsigned          i_instances = 0;
106
107 #ifndef WIN32
108 static bool b_daemon = false;
109 #endif
110
111 #undef vlc_gc_init
112 #undef vlc_hold
113 #undef vlc_release
114
115 /**
116  * Atomically set the reference count to 1.
117  * @param p_gc reference counted object
118  * @param pf_destruct destruction calback
119  * @return p_gc.
120  */
121 void *vlc_gc_init (gc_object_t *p_gc, void (*pf_destruct) (gc_object_t *))
122 {
123     /* There is no point in using the GC if there is no destructor... */
124     assert (pf_destruct);
125     p_gc->pf_destructor = pf_destruct;
126
127     p_gc->refs = 1;
128 #if defined (__GCC_HAVE_SYNC_COMPARE_AND_SWAP_4)
129     __sync_synchronize ();
130 #elif defined (WIN32) && defined (__GNUC__)
131 #elif defined(__APPLE__)
132     OSMemoryBarrier ();
133 #else
134     /* Nobody else can possibly lock the spin - it's there as a barrier */
135     vlc_spin_init (&p_gc->spin);
136     vlc_spin_lock (&p_gc->spin);
137     vlc_spin_unlock (&p_gc->spin);
138 #endif
139     return p_gc;
140 }
141
142 /**
143  * Atomically increment the reference count.
144  * @param p_gc reference counted object
145  * @return p_gc.
146  */
147 void *vlc_hold (gc_object_t * p_gc)
148 {
149     uintptr_t refs;
150     assert( p_gc );
151     assert ((((uintptr_t)&p_gc->refs) & (sizeof (void *) - 1)) == 0); /* alignment */
152
153 #if defined (__GCC_HAVE_SYNC_COMPARE_AND_SWAP_4)
154     refs = __sync_add_and_fetch (&p_gc->refs, 1);
155 #elif defined (WIN64)
156     refs = InterlockedIncrement64 (&p_gc->refs);
157 #elif defined (WIN32)
158     refs = InterlockedIncrement (&p_gc->refs);
159 #elif defined(__APPLE__)
160     refs = OSAtomicIncrement32Barrier((int*)&p_gc->refs);
161 #else
162     vlc_spin_lock (&p_gc->spin);
163     refs = ++p_gc->refs;
164     vlc_spin_unlock (&p_gc->spin);
165 #endif
166     assert (refs != 1); /* there had to be a reference already */
167     return p_gc;
168 }
169
170 /**
171  * Atomically decrement the reference count and, if it reaches zero, destroy.
172  * @param p_gc reference counted object.
173  */
174 void vlc_release (gc_object_t *p_gc)
175 {
176     unsigned refs;
177
178     assert( p_gc );
179     assert ((((uintptr_t)&p_gc->refs) & (sizeof (void *) - 1)) == 0); /* alignment */
180
181 #if defined (__GCC_HAVE_SYNC_COMPARE_AND_SWAP_4)
182     refs = __sync_sub_and_fetch (&p_gc->refs, 1);
183 #elif defined (WIN64)
184     refs = InterlockedDecrement64 (&p_gc->refs);
185 #elif defined (WIN32)
186     refs = InterlockedDecrement (&p_gc->refs);
187 #elif defined(__APPLE__)
188     refs = OSAtomicDecrement32Barrier((int*)&p_gc->refs);
189 #else
190     vlc_spin_lock (&p_gc->spin);
191     refs = --p_gc->refs;
192     vlc_spin_unlock (&p_gc->spin);
193 #endif
194
195     assert (refs != (uintptr_t)(-1)); /* reference underflow?! */
196     if (refs == 0)
197     {
198 #if defined (__GCC_HAVE_SYNC_COMPARE_AND_SWAP_4)
199 #elif defined (WIN32) && defined (__GNUC__)
200 #elif defined(__APPLE__)
201 #else
202         vlc_spin_destroy (&p_gc->spin);
203 #endif
204         p_gc->pf_destructor (p_gc);
205     }
206 }
207
208 /*****************************************************************************
209  * Local prototypes
210  *****************************************************************************/
211 #if defined( ENABLE_NLS ) && (defined (__APPLE__) || defined (WIN32)) && \
212     ( defined( HAVE_GETTEXT ) || defined( HAVE_INCLUDED_GETTEXT ) )
213 static void SetLanguage   ( char const * );
214 #endif
215 static inline int LoadMessages (void);
216 static int  GetFilenames  ( libvlc_int_t *, int, const char *[] );
217 static void Help          ( libvlc_int_t *, char const *psz_help_name );
218 static void Usage         ( libvlc_int_t *, char const *psz_search );
219 static void ListModules   ( libvlc_int_t *, bool );
220 static void Version       ( void );
221
222 #ifdef WIN32
223 static void ShowConsole   ( bool );
224 static void PauseConsole  ( void );
225 #endif
226 static int  ConsoleWidth  ( void );
227
228 static void InitDeviceValues( libvlc_int_t * );
229
230 static vlc_mutex_t global_lock = VLC_STATIC_MUTEX;
231
232 /**
233  * Allocate a libvlc instance, initialize global data if needed
234  * It also initializes the threading system
235  */
236 libvlc_int_t * libvlc_InternalCreate( void )
237 {
238     libvlc_int_t *p_libvlc;
239     libvlc_priv_t *priv;
240     char *psz_env = NULL;
241
242     /* Now that the thread system is initialized, we don't have much, but
243      * at least we have variables */
244     vlc_mutex_lock( &global_lock );
245     if( i_instances == 0 )
246     {
247         /* Guess what CPU we have */
248         cpu_flags = CPUCapabilities();
249         /* The module bank will be initialized later */
250     }
251
252     /* Allocate a libvlc instance object */
253     p_libvlc = __vlc_custom_create( NULL, sizeof (*priv),
254                                   VLC_OBJECT_GENERIC, "libvlc" );
255     if( p_libvlc != NULL )
256         i_instances++;
257     vlc_mutex_unlock( &global_lock );
258
259     if( p_libvlc == NULL )
260         return NULL;
261
262     priv = libvlc_priv (p_libvlc);
263     priv->p_playlist = NULL;
264     priv->p_dialog_provider = NULL;
265     priv->p_vlm = NULL;
266     /* Avoid being called "memcpy":*/
267     vlc_internals(p_libvlc)->psz_object_name = strdup( "libvlc" );
268
269     /* Initialize message queue */
270     msg_Create( p_libvlc );
271
272     /* Find verbosity from VLC_VERBOSE environment variable */
273     psz_env = getenv( "VLC_VERBOSE" );
274     if( psz_env != NULL )
275         priv->i_verbose = atoi( psz_env );
276     else
277         priv->i_verbose = 3;
278 #if defined( HAVE_ISATTY ) && !defined( WIN32 )
279     priv->b_color = isatty( 2 ); /* 2 is for stderr */
280 #else
281     priv->b_color = false;
282 #endif
283
284     /* Initialize mutexes */
285     vlc_mutex_init( &priv->timer_lock );
286     vlc_cond_init( &priv->exiting );
287
288     return p_libvlc;
289 }
290
291 /**
292  * Initialize a libvlc instance
293  * This function initializes a previously allocated libvlc instance:
294  *  - CPU detection
295  *  - gettext initialization
296  *  - message queue, module bank and playlist initialization
297  *  - configuration and commandline parsing
298  */
299 int libvlc_InternalInit( libvlc_int_t *p_libvlc, int i_argc,
300                          const char *ppsz_argv[] )
301 {
302     libvlc_priv_t *priv = libvlc_priv (p_libvlc);
303     char         p_capabilities[200];
304     char *       p_tmp = NULL;
305     char *       psz_modules = NULL;
306     char *       psz_parser = NULL;
307     char *       psz_control = NULL;
308     bool   b_exit = false;
309     int          i_ret = VLC_EEXIT;
310     playlist_t  *p_playlist = NULL;
311     vlc_value_t  val;
312 #if defined( ENABLE_NLS ) \
313      && ( defined( HAVE_GETTEXT ) || defined( HAVE_INCLUDED_GETTEXT ) )
314 # if defined (WIN32) || defined (__APPLE__)
315     char *       psz_language;
316 #endif
317 #endif
318
319     /* System specific initialization code */
320     system_Init( p_libvlc, &i_argc, ppsz_argv );
321
322     /*
323      * Support for gettext
324      */
325     LoadMessages ();
326
327     /* Initialize the module bank and load the configuration of the
328      * main module. We need to do this at this stage to be able to display
329      * a short help if required by the user. (short help == main module
330      * options) */
331     module_InitBank( p_libvlc );
332
333     if( config_LoadCmdLine( p_libvlc, &i_argc, ppsz_argv, true ) )
334     {
335         module_EndBank( p_libvlc, false );
336         return VLC_EGENERIC;
337     }
338
339     priv->i_verbose = config_GetInt( p_libvlc, "verbose" );
340     /* Announce who we are - Do it only for first instance ? */
341     msg_Dbg( p_libvlc, "%s", COPYRIGHT_MESSAGE );
342     msg_Dbg( p_libvlc, "libvlc was configured with %s", CONFIGURE_LINE );
343     /*xgettext: Translate "C" to the language code: "fr", "en_GB", "nl", "ru"... */
344     msg_Dbg( p_libvlc, "translation test: code is \"%s\"", _("C") );
345
346     /* Check for short help option */
347     if( config_GetInt( p_libvlc, "help" ) > 0 )
348     {
349         Help( p_libvlc, "help" );
350         b_exit = true;
351         i_ret = VLC_EEXITSUCCESS;
352     }
353     /* Check for version option */
354     else if( config_GetInt( p_libvlc, "version" ) > 0 )
355     {
356         Version();
357         b_exit = true;
358         i_ret = VLC_EEXITSUCCESS;
359     }
360
361     /* Check for plugins cache options */
362     bool b_cache_delete = config_GetInt( p_libvlc, "reset-plugins-cache" ) > 0;
363
364     /* Check for daemon mode */
365 #ifndef WIN32
366     if( config_GetInt( p_libvlc, "daemon" ) > 0 )
367     {
368 #ifdef HAVE_DAEMON
369         char *psz_pidfile = NULL;
370
371         if( daemon( 1, 0) != 0 )
372         {
373             msg_Err( p_libvlc, "Unable to fork vlc to daemon mode" );
374             b_exit = true;
375         }
376         b_daemon = true;
377
378         /* lets check if we need to write the pidfile */
379         psz_pidfile = config_GetPsz( p_libvlc, "pidfile" );
380         if( psz_pidfile != NULL )
381         {
382             FILE *pidfile;
383             pid_t i_pid = getpid ();
384             msg_Dbg( p_libvlc, "PID is %d, writing it to %s",
385                                i_pid, psz_pidfile );
386             pidfile = utf8_fopen( psz_pidfile,"w" );
387             if( pidfile != NULL )
388             {
389                 utf8_fprintf( pidfile, "%d", (int)i_pid );
390                 fclose( pidfile );
391             }
392             else
393             {
394                 msg_Err( p_libvlc, "cannot open pid file for writing: %s (%m)",
395                          psz_pidfile );
396             }
397         }
398         free( psz_pidfile );
399
400 #else
401         pid_t i_pid;
402
403         if( ( i_pid = fork() ) < 0 )
404         {
405             msg_Err( p_libvlc, "unable to fork vlc to daemon mode" );
406             b_exit = true;
407         }
408         else if( i_pid )
409         {
410             /* This is the parent, exit right now */
411             msg_Dbg( p_libvlc, "closing parent process" );
412             b_exit = true;
413             i_ret = VLC_EEXITSUCCESS;
414         }
415         else
416         {
417             /* We are the child */
418             msg_Dbg( p_libvlc, "daemon spawned" );
419             close( STDIN_FILENO );
420             close( STDOUT_FILENO );
421             close( STDERR_FILENO );
422
423             b_daemon = true;
424         }
425 #endif
426     }
427 #endif
428
429     if( b_exit )
430     {
431         module_EndBank( p_libvlc, false );
432         return i_ret;
433     }
434
435     /* Check for translation config option */
436 #if defined( ENABLE_NLS ) \
437      && ( defined( HAVE_GETTEXT ) || defined( HAVE_INCLUDED_GETTEXT ) )
438 # if defined (WIN32) || defined (__APPLE__)
439     /* This ain't really nice to have to reload the config here but it seems
440      * the only way to do it. */
441
442     if( !config_GetInt( p_libvlc, "ignore-config" ) )
443         config_LoadConfigFile( p_libvlc, "main" );
444     config_LoadCmdLine( p_libvlc, &i_argc, ppsz_argv, true );
445     priv->i_verbose = config_GetInt( p_libvlc, "verbose" );
446
447     /* Check if the user specified a custom language */
448     psz_language = config_GetPsz( p_libvlc, "language" );
449     if( psz_language && *psz_language && strcmp( psz_language, "auto" ) )
450     {
451         /* Reset the default domain */
452         SetLanguage( psz_language );
453
454         /* Translate "C" to the language code: "fr", "en_GB", "nl", "ru"... */
455         msg_Dbg( p_libvlc, "translation test: code is \"%s\"", _("C") );
456
457         module_EndBank( p_libvlc, false );
458         module_InitBank( p_libvlc );
459         if( !config_GetInt( p_libvlc, "ignore-config" ) )
460             config_LoadConfigFile( p_libvlc, "main" );
461         config_LoadCmdLine( p_libvlc, &i_argc, ppsz_argv, true );
462         priv->i_verbose = config_GetInt( p_libvlc, "verbose" );
463     }
464     free( psz_language );
465 # endif
466 #endif
467
468     /*
469      * Load the builtins and plugins into the module_bank.
470      * We have to do it before config_Load*() because this also gets the
471      * list of configuration options exported by each module and loads their
472      * default values.
473      */
474     module_LoadPlugins( p_libvlc, b_cache_delete );
475     if( p_libvlc->b_die )
476     {
477         b_exit = true;
478     }
479
480     size_t module_count;
481     module_t **list = module_list_get( &module_count );
482     module_list_free( list );
483     msg_Dbg( p_libvlc, "module bank initialized (%zu modules)", module_count );
484
485     /* Check for help on modules */
486     if( (p_tmp = config_GetPsz( p_libvlc, "module" )) )
487     {
488         Help( p_libvlc, p_tmp );
489         free( p_tmp );
490         b_exit = true;
491         i_ret = VLC_EEXITSUCCESS;
492     }
493     /* Check for full help option */
494     else if( config_GetInt( p_libvlc, "full-help" ) > 0 )
495     {
496         config_PutInt( p_libvlc, "advanced", 1);
497         config_PutInt( p_libvlc, "help-verbose", 1);
498         Help( p_libvlc, "full-help" );
499         b_exit = true;
500         i_ret = VLC_EEXITSUCCESS;
501     }
502     /* Check for long help option */
503     else if( config_GetInt( p_libvlc, "longhelp" ) > 0 )
504     {
505         Help( p_libvlc, "longhelp" );
506         b_exit = true;
507         i_ret = VLC_EEXITSUCCESS;
508     }
509     /* Check for module list option */
510     else if( config_GetInt( p_libvlc, "list" ) > 0 )
511     {
512         ListModules( p_libvlc, false );
513         b_exit = true;
514         i_ret = VLC_EEXITSUCCESS;
515     }
516     else if( config_GetInt( p_libvlc, "list-verbose" ) > 0 )
517     {
518         ListModules( p_libvlc, true );
519         b_exit = true;
520         i_ret = VLC_EEXITSUCCESS;
521     }
522
523     /* Check for config file options */
524     if( !config_GetInt( p_libvlc, "ignore-config" ) )
525     {
526         if( config_GetInt( p_libvlc, "reset-config" ) > 0 )
527         {
528             config_ResetAll( p_libvlc );
529             config_LoadCmdLine( p_libvlc, &i_argc, ppsz_argv, true );
530             config_SaveConfigFile( p_libvlc, NULL );
531         }
532         if( config_GetInt( p_libvlc, "save-config" ) > 0 )
533         {
534             config_LoadConfigFile( p_libvlc, NULL );
535             config_LoadCmdLine( p_libvlc, &i_argc, ppsz_argv, true );
536             config_SaveConfigFile( p_libvlc, NULL );
537         }
538     }
539
540     if( b_exit )
541     {
542         module_EndBank( p_libvlc, true );
543         return i_ret;
544     }
545
546     /*
547      * Init device values
548      */
549     InitDeviceValues( p_libvlc );
550
551     /*
552      * Override default configuration with config file settings
553      */
554     if( !config_GetInt( p_libvlc, "ignore-config" ) )
555         config_LoadConfigFile( p_libvlc, NULL );
556
557     /*
558      * Override configuration with command line settings
559      */
560     if( config_LoadCmdLine( p_libvlc, &i_argc, ppsz_argv, false ) )
561     {
562 #ifdef WIN32
563         ShowConsole( false );
564         /* Pause the console because it's destroyed when we exit */
565         fprintf( stderr, "The command line options couldn't be loaded, check "
566                  "that they are valid.\n" );
567         PauseConsole();
568 #endif
569         module_EndBank( p_libvlc, true );
570         return VLC_EGENERIC;
571     }
572     priv->i_verbose = config_GetInt( p_libvlc, "verbose" );
573
574     /*
575      * System specific configuration
576      */
577     system_Configure( p_libvlc, &i_argc, ppsz_argv );
578
579 /* FIXME: could be replaced by using Unix sockets */
580 #ifdef HAVE_DBUS
581     dbus_threads_init_default();
582
583     if( config_GetInt( p_libvlc, "one-instance" ) > 0
584         || ( config_GetInt( p_libvlc, "one-instance-when-started-from-file" )
585              && config_GetInt( p_libvlc, "started-from-file" ) ) )
586     {
587         /* Initialise D-Bus interface, check for other instances */
588         DBusConnection  *p_conn = NULL;
589         DBusError       dbus_error;
590
591         dbus_error_init( &dbus_error );
592
593         /* connect to the session bus */
594         p_conn = dbus_bus_get( DBUS_BUS_SESSION, &dbus_error );
595         if( !p_conn )
596         {
597             msg_Err( p_libvlc, "Failed to connect to D-Bus session daemon: %s",
598                     dbus_error.message );
599             dbus_error_free( &dbus_error );
600         }
601         else
602         {
603             /* check if VLC is available on the bus
604              * if not: D-Bus control is not enabled on the other
605              * instance and we can't pass MRLs to it */
606             DBusMessage *p_test_msg = NULL;
607             DBusMessage *p_test_reply = NULL;
608             p_test_msg =  dbus_message_new_method_call(
609                     "org.mpris.vlc", "/",
610                     "org.freedesktop.MediaPlayer", "Identity" );
611             /* block until a reply arrives */
612             p_test_reply = dbus_connection_send_with_reply_and_block(
613                     p_conn, p_test_msg, -1, &dbus_error );
614             dbus_message_unref( p_test_msg );
615             if( p_test_reply == NULL )
616             {
617                 dbus_error_free( &dbus_error );
618                 msg_Dbg( p_libvlc, "No Media Player is running. "
619                         "Continuing normally." );
620             }
621             else
622             {
623                 int i_input;
624                 DBusMessage* p_dbus_msg = NULL;
625                 DBusMessageIter dbus_args;
626                 DBusPendingCall* p_dbus_pending = NULL;
627                 dbus_bool_t b_play;
628
629                 dbus_message_unref( p_test_reply );
630                 msg_Warn( p_libvlc, "Another Media Player is running. Exiting");
631
632                 for( i_input = optind;i_input < i_argc;i_input++ )
633                 {
634                     msg_Dbg( p_libvlc, "Adds %s to the running Media Player",
635                             ppsz_argv[i_input] );
636
637                     p_dbus_msg = dbus_message_new_method_call(
638                             "org.mpris.vlc", "/TrackList",
639                             "org.freedesktop.MediaPlayer", "AddTrack" );
640
641                     if ( NULL == p_dbus_msg )
642                     {
643                         msg_Err( p_libvlc, "D-Bus problem" );
644                         system_End( p_libvlc );
645                         exit( 1 );
646                     }
647
648                     /* append MRLs */
649                     dbus_message_iter_init_append( p_dbus_msg, &dbus_args );
650                     if ( !dbus_message_iter_append_basic( &dbus_args,
651                                 DBUS_TYPE_STRING, &ppsz_argv[i_input] ) )
652                     {
653                         dbus_message_unref( p_dbus_msg );
654                         system_End( p_libvlc );
655                         exit( 1 );
656                     }
657                     b_play = TRUE;
658                     if( config_GetInt( p_libvlc, "playlist-enqueue" ) > 0 )
659                         b_play = FALSE;
660                     if ( !dbus_message_iter_append_basic( &dbus_args,
661                                 DBUS_TYPE_BOOLEAN, &b_play ) )
662                     {
663                         dbus_message_unref( p_dbus_msg );
664                         system_End( p_libvlc );
665                         exit( 1 );
666                     }
667
668                     /* send message and get a handle for a reply */
669                     if ( !dbus_connection_send_with_reply ( p_conn,
670                                 p_dbus_msg, &p_dbus_pending, -1 ) )
671                     {
672                         msg_Err( p_libvlc, "D-Bus problem" );
673                         dbus_message_unref( p_dbus_msg );
674                         system_End( p_libvlc );
675                         exit( 1 );
676                     }
677
678                     if ( NULL == p_dbus_pending )
679                     {
680                         msg_Err( p_libvlc, "D-Bus problem" );
681                         dbus_message_unref( p_dbus_msg );
682                         system_End( p_libvlc );
683                         exit( 1 );
684                     }
685                     dbus_connection_flush( p_conn );
686                     dbus_message_unref( p_dbus_msg );
687                     /* block until we receive a reply */
688                     dbus_pending_call_block( p_dbus_pending );
689                     dbus_pending_call_unref( p_dbus_pending );
690                 } /* processes all command line MRLs */
691
692                 /* bye bye */
693                 system_End( p_libvlc );
694                 exit( 0 );
695             }
696         }
697         /* we unreference the connection when we've finished with it */
698         if( p_conn ) dbus_connection_unref( p_conn );
699     }
700 #endif
701
702     /*
703      * Message queue options
704      */
705     char * psz_verbose_objects = config_GetPsz( p_libvlc, "verbose-objects" );
706     if( psz_verbose_objects )
707     {
708         char * psz_object, * iter = psz_verbose_objects;
709         while( (psz_object = strsep( &iter, "," )) )
710         {
711             switch( psz_object[0] )
712             {
713                 printf("%s\n", psz_object+1);
714                 case '+': msg_EnableObjectPrinting(p_libvlc, psz_object+1); break;
715                 case '-': msg_DisableObjectPrinting(p_libvlc, psz_object+1); break;
716                 default:
717                     msg_Err( p_libvlc, "verbose-objects usage: \n"
718                             "--verbose-objects=+printthatobject,"
719                             "-dontprintthatone\n"
720                             "(keyword 'all' to applies to all objects)");
721                     free( psz_verbose_objects );
722                     /* FIXME: leaks!!!! */
723                     return VLC_EGENERIC;
724             }
725         }
726         free( psz_verbose_objects );
727     }
728
729     /* Last chance to set the verbosity. Once we start interfaces and other
730      * threads, verbosity becomes read-only. */
731     var_Create( p_libvlc, "verbose", VLC_VAR_INTEGER | VLC_VAR_DOINHERIT );
732     if( config_GetInt( p_libvlc, "quiet" ) > 0 )
733     {
734         var_SetInteger( p_libvlc, "verbose", -1 );
735         priv->i_verbose = -1;
736     }
737     vlc_threads_setup( p_libvlc );
738
739     if( priv->b_color )
740         priv->b_color = config_GetInt( p_libvlc, "color" ) > 0;
741
742     if( !config_GetInt( p_libvlc, "fpu" ) )
743         cpu_flags &= ~CPU_CAPABILITY_FPU;
744
745 #if defined( __i386__ ) || defined( __x86_64__ )
746     if( !config_GetInt( p_libvlc, "mmx" ) )
747         cpu_flags &= ~CPU_CAPABILITY_MMX;
748     if( !config_GetInt( p_libvlc, "3dn" ) )
749         cpu_flags &= ~CPU_CAPABILITY_3DNOW;
750     if( !config_GetInt( p_libvlc, "mmxext" ) )
751         cpu_flags &= ~CPU_CAPABILITY_MMXEXT;
752     if( !config_GetInt( p_libvlc, "sse" ) )
753         cpu_flags &= ~CPU_CAPABILITY_SSE;
754     if( !config_GetInt( p_libvlc, "sse2" ) )
755         cpu_flags &= ~CPU_CAPABILITY_SSE2;
756 #endif
757 #if defined( __powerpc__ ) || defined( __ppc__ ) || defined( __ppc64__ )
758     if( !config_GetInt( p_libvlc, "altivec" ) )
759         cpu_flags &= ~CPU_CAPABILITY_ALTIVEC;
760 #endif
761
762 #define PRINT_CAPABILITY( capability, string )                              \
763     if( vlc_CPU() & capability )                                            \
764     {                                                                       \
765         strncat( p_capabilities, string " ",                                \
766                  sizeof(p_capabilities) - strlen(p_capabilities) );         \
767         p_capabilities[sizeof(p_capabilities) - 1] = '\0';                  \
768     }
769
770     p_capabilities[0] = '\0';
771     PRINT_CAPABILITY( CPU_CAPABILITY_486, "486" );
772     PRINT_CAPABILITY( CPU_CAPABILITY_586, "586" );
773     PRINT_CAPABILITY( CPU_CAPABILITY_PPRO, "Pentium Pro" );
774     PRINT_CAPABILITY( CPU_CAPABILITY_MMX, "MMX" );
775     PRINT_CAPABILITY( CPU_CAPABILITY_3DNOW, "3DNow!" );
776     PRINT_CAPABILITY( CPU_CAPABILITY_MMXEXT, "MMXEXT" );
777     PRINT_CAPABILITY( CPU_CAPABILITY_SSE, "SSE" );
778     PRINT_CAPABILITY( CPU_CAPABILITY_SSE2, "SSE2" );
779     PRINT_CAPABILITY( CPU_CAPABILITY_ALTIVEC, "AltiVec" );
780     PRINT_CAPABILITY( CPU_CAPABILITY_FPU, "FPU" );
781     msg_Dbg( p_libvlc, "CPU has capabilities %s", p_capabilities );
782
783     /*
784      * Choose the best memcpy module
785      */
786     priv->p_memcpy_module = module_need( p_libvlc, "memcpy", "$memcpy", false );
787
788     priv->b_stats = config_GetInt( p_libvlc, "stats" ) > 0;
789     priv->i_timers = 0;
790     priv->pp_timers = NULL;
791
792     priv->i_last_input_id = 0; /* Not very safe, should be removed */
793
794     /*
795      * Initialize hotkey handling
796      */
797     var_Create( p_libvlc, "key-pressed", VLC_VAR_INTEGER );
798     var_Create( p_libvlc, "key-action", VLC_VAR_INTEGER );
799     {
800         struct hotkey *p_keys =
801             malloc( (libvlc_actions_count + 1) * sizeof (*p_keys) );
802
803         /* Initialize from configuration */
804         for( size_t i = 0; i < libvlc_actions_count; i++ )
805         {
806             p_keys[i].psz_action = libvlc_actions[i].name;
807             p_keys[i].i_key = config_GetInt( p_libvlc,
808                                              libvlc_actions[i].name );
809             p_keys[i].i_action = libvlc_actions[i].value;
810         }
811         p_keys[libvlc_actions_count].psz_action = NULL;
812         p_keys[libvlc_actions_count].i_key = 0;
813         p_keys[libvlc_actions_count].i_action = 0;
814         p_libvlc->p_hotkeys = p_keys;
815         var_AddCallback( p_libvlc, "key-pressed", vlc_key_to_action,
816                          p_keys );
817     }
818
819     /* Initialize playlist and get commandline files */
820     p_playlist = playlist_Create( VLC_OBJECT(p_libvlc) );
821     if( !p_playlist )
822     {
823         msg_Err( p_libvlc, "playlist initialization failed" );
824         if( priv->p_memcpy_module != NULL )
825         {
826             module_unneed( p_libvlc, priv->p_memcpy_module );
827         }
828         module_EndBank( p_libvlc, true );
829         return VLC_EGENERIC;
830     }
831     playlist_Activate( p_playlist );
832     vlc_object_attach( p_playlist, p_libvlc );
833
834     /* Add service discovery modules */
835     psz_modules = config_GetPsz( p_playlist, "services-discovery" );
836     if( psz_modules && *psz_modules )
837     {
838         char *p = psz_modules, *m;
839         while( ( m = strsep( &p, " :," ) ) != NULL )
840             playlist_ServicesDiscoveryAdd( p_playlist, m );
841     }
842     free( psz_modules );
843
844 #ifdef ENABLE_VLM
845     /* Initialize VLM if vlm-conf is specified */
846     psz_parser = config_GetPsz( p_libvlc, "vlm-conf" );
847     if( psz_parser && *psz_parser )
848     {
849         priv->p_vlm = vlm_New( p_libvlc );
850         if( !priv->p_vlm )
851             msg_Err( p_libvlc, "VLM initialization failed" );
852     }
853     free( psz_parser );
854 #endif
855
856     /*
857      * Load background interfaces
858      */
859     psz_modules = config_GetPsz( p_libvlc, "extraintf" );
860     psz_control = config_GetPsz( p_libvlc, "control" );
861
862     if( psz_modules && *psz_modules && psz_control && *psz_control )
863     {
864         char* psz_tmp;
865         if( asprintf( &psz_tmp, "%s:%s", psz_modules, psz_control ) != -1 )
866         {
867             free( psz_modules );
868             psz_modules = psz_tmp;
869         }
870     }
871     else if( psz_control && *psz_control )
872     {
873         free( psz_modules );
874         psz_modules = strdup( psz_control );
875     }
876
877     psz_parser = psz_modules;
878     while ( psz_parser && *psz_parser )
879     {
880         char *psz_module, *psz_temp;
881         psz_module = psz_parser;
882         psz_parser = strchr( psz_module, ':' );
883         if ( psz_parser )
884         {
885             *psz_parser = '\0';
886             psz_parser++;
887         }
888         if( asprintf( &psz_temp, "%s,none", psz_module ) != -1)
889         {
890             intf_Create( p_libvlc, psz_temp );
891             free( psz_temp );
892         }
893     }
894     free( psz_modules );
895     free( psz_control );
896
897     /*
898      * Always load the hotkeys interface if it exists
899      */
900     intf_Create( p_libvlc, "hotkeys,none" );
901
902 #ifdef HAVE_DBUS
903     /* loads dbus control interface if in one-instance mode
904      * we do it only when playlist exists, because dbus module needs it */
905     if( config_GetInt( p_libvlc, "one-instance" ) > 0
906         || ( config_GetInt( p_libvlc, "one-instance-when-started-from-file" )
907              && config_GetInt( p_libvlc, "started-from-file" ) ) )
908         intf_Create( p_libvlc, "dbus,none" );
909
910     /* Prevents the power management daemon from suspending the system
911      * when VLC is active */
912     if( config_GetInt( p_libvlc, "inhibit" ) > 0 )
913         intf_Create( p_libvlc, "inhibit,none" );
914 #endif
915
916     /*
917      * If needed, load the Xscreensaver interface
918      * Currently, only for X
919      */
920 #ifdef HAVE_X11_XLIB_H
921     if( config_GetInt( p_libvlc, "disable-screensaver" ) )
922     {
923         intf_Create( p_libvlc, "screensaver,none" );
924     }
925 #endif
926
927     if( (config_GetInt( p_libvlc, "file-logging" ) > 0) &&
928         !config_GetInt( p_libvlc, "syslog" ) )
929     {
930         intf_Create( p_libvlc, "logger,none" );
931     }
932 #ifdef HAVE_SYSLOG_H
933     if( config_GetInt( p_libvlc, "syslog" ) > 0 )
934     {
935         char *logmode = var_CreateGetString( p_libvlc, "logmode" );
936         var_SetString( p_libvlc, "logmode", "syslog" );
937         intf_Create( p_libvlc, "logger,none" );
938
939         if( logmode )
940         {
941             var_SetString( p_libvlc, "logmode", logmode );
942             free( logmode );
943         }
944         else
945             var_Destroy( p_libvlc, "logmode" );
946     }
947 #endif
948
949     if( config_GetInt( p_libvlc, "network-synchronisation") > 0 )
950     {
951         intf_Create( p_libvlc, "netsync,none" );
952     }
953
954 #ifdef WIN32
955     if( config_GetInt( p_libvlc, "prefer-system-codecs") > 0 )
956     {
957         char *psz_codecs = config_GetPsz( p_playlist, "codec" );
958         if( psz_codecs )
959         {
960             char *psz_morecodecs;
961             if( asprintf(&psz_morecodecs, "%s,dmo,quicktime", psz_codecs) != -1 )
962             {
963                 config_PutPsz( p_libvlc, "codec", psz_morecodecs);
964                 free( psz_morecodecs );
965             }
966         }
967         else
968             config_PutPsz( p_libvlc, "codec", "dmo,quicktime");
969         free( psz_codecs );
970     }
971 #endif
972
973     var_Create( p_libvlc, "drawable-view-top", VLC_VAR_INTEGER );
974     var_Create( p_libvlc, "drawable-view-left", VLC_VAR_INTEGER );
975     var_Create( p_libvlc, "drawable-view-bottom", VLC_VAR_INTEGER );
976     var_Create( p_libvlc, "drawable-view-right", VLC_VAR_INTEGER );
977     var_Create( p_libvlc, "drawable-clip-top", VLC_VAR_INTEGER );
978     var_Create( p_libvlc, "drawable-clip-left", VLC_VAR_INTEGER );
979     var_Create( p_libvlc, "drawable-clip-bottom", VLC_VAR_INTEGER );
980     var_Create( p_libvlc, "drawable-clip-right", VLC_VAR_INTEGER );
981
982     /* Create volume callback system. */
983     var_Create( p_libvlc, "volume-change", VLC_VAR_BOOL );
984
985     /* Create a variable for showing the fullscreen interface from hotkeys */
986     var_Create( p_libvlc, "intf-show", VLC_VAR_BOOL );
987     var_SetBool( p_libvlc, "intf-show", true );
988
989     /* Create a variable for showing the right click menu */
990     var_Create( p_libvlc, "intf-popupmenu", VLC_VAR_BOOL );
991
992     /*
993      * Get input filenames given as commandline arguments
994      */
995     GetFilenames( p_libvlc, i_argc, ppsz_argv );
996
997     /*
998      * Get --open argument
999      */
1000     var_Create( p_libvlc, "open", VLC_VAR_STRING | VLC_VAR_DOINHERIT );
1001     var_Get( p_libvlc, "open", &val );
1002     if ( val.psz_string != NULL && *val.psz_string )
1003     {
1004         playlist_t *p_playlist = pl_Hold( p_libvlc );
1005         playlist_AddExt( p_playlist, val.psz_string, NULL, PLAYLIST_INSERT, 0,
1006                          -1, 0, NULL, 0, true, pl_Unlocked );
1007         pl_Release( p_libvlc );
1008     }
1009     free( val.psz_string );
1010
1011     return VLC_SUCCESS;
1012 }
1013
1014 /**
1015  * Cleanup a libvlc instance. The instance is not completely deallocated
1016  * \param p_libvlc the instance to clean
1017  */
1018 void libvlc_InternalCleanup( libvlc_int_t *p_libvlc )
1019 {
1020     libvlc_priv_t *priv = libvlc_priv (p_libvlc);
1021     playlist_t    *p_playlist = priv->p_playlist;
1022
1023     /* Deactivate the playlist */
1024     msg_Dbg( p_libvlc, "deactivating the playlist" );
1025     playlist_Deactivate( p_playlist );
1026
1027     /* Remove all services discovery */
1028     msg_Dbg( p_libvlc, "removing all services discovery tasks" );
1029     playlist_ServicesDiscoveryKillAll( p_playlist );
1030
1031     /* Ask the interfaces to stop and destroy them */
1032     msg_Dbg( p_libvlc, "removing all interfaces" );
1033     libvlc_Quit( p_libvlc );
1034     intf_DestroyAll( p_libvlc );
1035
1036 #ifdef ENABLE_VLM
1037     /* Destroy VLM if created in libvlc_InternalInit */
1038     if( priv->p_vlm )
1039     {
1040         vlm_Delete( priv->p_vlm );
1041     }
1042 #endif
1043
1044     /* Free playlist */
1045     /* Any thread still running must not assume pl_Hold() succeeds. */
1046     msg_Dbg( p_libvlc, "removing playlist" );
1047
1048     libvlc_priv(p_playlist->p_libvlc)->p_playlist = NULL;
1049     barrier();  /* FIXME is that correct ? */
1050
1051     vlc_object_release( p_playlist );
1052
1053     stats_TimersDumpAll( p_libvlc );
1054     stats_TimersCleanAll( p_libvlc );
1055
1056     msg_Dbg( p_libvlc, "removing stats" );
1057
1058 #ifndef WIN32
1059     char* psz_pidfile = NULL;
1060
1061     if( b_daemon )
1062     {
1063         psz_pidfile = config_GetPsz( p_libvlc, "pidfile" );
1064         if( psz_pidfile != NULL )
1065         {
1066             msg_Dbg( p_libvlc, "removing pid file %s", psz_pidfile );
1067             if( unlink( psz_pidfile ) == -1 )
1068             {
1069                 msg_Dbg( p_libvlc, "removing pid file %s: %m",
1070                         psz_pidfile );
1071             }
1072         }
1073         free( psz_pidfile );
1074     }
1075 #endif
1076
1077     if( priv->p_memcpy_module )
1078     {
1079         module_unneed( p_libvlc, priv->p_memcpy_module );
1080         priv->p_memcpy_module = NULL;
1081     }
1082
1083     /* Free module bank. It is refcounted, so we call this each time  */
1084     module_EndBank( p_libvlc, true );
1085
1086     var_DelCallback( p_libvlc, "key-pressed", vlc_key_to_action,
1087                      (void *)p_libvlc->p_hotkeys );
1088     free( (void *)p_libvlc->p_hotkeys );
1089 }
1090
1091 /**
1092  * Destroy everything.
1093  * This function requests the running threads to finish, waits for their
1094  * termination, and destroys their structure.
1095  * It stops the thread systems: no instance can run after this has run
1096  * \param p_libvlc the instance to destroy
1097  */
1098 void libvlc_InternalDestroy( libvlc_int_t *p_libvlc )
1099 {
1100     libvlc_priv_t *priv = libvlc_priv( p_libvlc );
1101
1102     vlc_mutex_lock( &global_lock );
1103     i_instances--;
1104
1105     if( i_instances == 0 )
1106     {
1107         /* System specific cleaning code */
1108         system_End( p_libvlc );
1109     }
1110     vlc_mutex_unlock( &global_lock );
1111
1112     msg_Destroy( p_libvlc );
1113
1114     /* Destroy mutexes */
1115     vlc_cond_destroy( &priv->exiting );
1116     vlc_mutex_destroy( &priv->timer_lock );
1117
1118 #ifndef NDEBUG /* Hack to dump leaked objects tree */
1119     if( vlc_internals( p_libvlc )->i_refcount > 1 )
1120         while( vlc_internals( p_libvlc )->i_refcount > 0 )
1121             vlc_object_release( p_libvlc );
1122 #endif
1123
1124     assert( vlc_internals( p_libvlc )->i_refcount == 1 );
1125     vlc_object_release( p_libvlc );
1126 }
1127
1128 /**
1129  * Add an interface plugin and run it
1130  */
1131 int libvlc_InternalAddIntf( libvlc_int_t *p_libvlc, char const *psz_module )
1132 {
1133     if( !p_libvlc )
1134         return VLC_EGENERIC;
1135
1136     if( !psz_module ) /* requesting the default interface */
1137     {
1138         char *psz_interface = config_GetPsz( p_libvlc, "intf" );
1139         if( !psz_interface || !*psz_interface ) /* "intf" has not been set */
1140         {
1141 #ifndef WIN32
1142             if( b_daemon )
1143                  /* Daemon mode hack.
1144                   * We prefer the dummy interface if none is specified. */
1145                 psz_module = "dummy";
1146             else
1147 #endif
1148                 msg_Info( p_libvlc, "%s",
1149                           _("Running vlc with the default interface. "
1150                             "Use 'cvlc' to use vlc without interface.") );
1151         }
1152         free( psz_interface );
1153     }
1154
1155     /* Try to create the interface */
1156     if( intf_Create( p_libvlc, psz_module ? psz_module : "$intf" ) )
1157     {
1158         msg_Err( p_libvlc, "interface \"%s\" initialization failed",
1159                  psz_module ? psz_module : "default" );
1160         return VLC_EGENERIC;
1161     }
1162     return VLC_SUCCESS;
1163 }
1164
1165 static vlc_mutex_t exit_lock = VLC_STATIC_MUTEX;
1166
1167 /**
1168  * Waits until the LibVLC instance gets an exit signal. Normally, this happens
1169  * when the user "exits" an interface plugin.
1170  */
1171 void libvlc_InternalWait( libvlc_int_t *p_libvlc )
1172 {
1173     libvlc_priv_t *priv = libvlc_priv( p_libvlc );
1174
1175     vlc_mutex_lock( &exit_lock );
1176     while( vlc_object_alive( p_libvlc ) )
1177         vlc_cond_wait( &priv->exiting, &exit_lock );
1178     vlc_mutex_unlock( &exit_lock );
1179 }
1180
1181 /**
1182  * Posts an exit signal to LibVLC instance. This will normally initiate the
1183  * cleanup and destroy process. It should only be called on behalf of the user.
1184  */
1185 void libvlc_Quit( libvlc_int_t *p_libvlc )
1186 {
1187     libvlc_priv_t *priv = libvlc_priv( p_libvlc );
1188
1189     vlc_mutex_lock( &exit_lock );
1190     vlc_object_kill( p_libvlc );
1191     vlc_cond_signal( &priv->exiting );
1192     vlc_mutex_unlock( &exit_lock );
1193 }
1194
1195 #if defined( ENABLE_NLS ) && (defined (__APPLE__) || defined (WIN32)) && \
1196     ( defined( HAVE_GETTEXT ) || defined( HAVE_INCLUDED_GETTEXT ) )
1197 /*****************************************************************************
1198  * SetLanguage: set the interface language.
1199  *****************************************************************************
1200  * We set the LC_MESSAGES locale category for interface messages and buttons,
1201  * as well as the LC_CTYPE category for string sorting and possible wide
1202  * character support.
1203  *****************************************************************************/
1204 static void SetLanguage ( const char *psz_lang )
1205 {
1206 #ifdef __APPLE__
1207     /* I need that under Darwin, please check it doesn't disturb
1208      * other platforms. --Meuuh */
1209     setenv( "LANG", psz_lang, 1 );
1210
1211 #else
1212     /* We set LC_ALL manually because it is the only way to set
1213      * the language at runtime under eg. Windows. Beware that this
1214      * makes the environment unconsistent when libvlc is unloaded and
1215      * should probably be moved to a safer place like vlc.c. */
1216     static char psz_lcall[20];
1217     snprintf( psz_lcall, 19, "LC_ALL=%s", psz_lang );
1218     psz_lcall[19] = '\0';
1219     putenv( psz_lcall );
1220 #endif
1221
1222     setlocale( LC_ALL, psz_lang );
1223 }
1224 #endif
1225
1226
1227 static inline int LoadMessages (void)
1228 {
1229 #if defined( ENABLE_NLS ) \
1230      && ( defined( HAVE_GETTEXT ) || defined( HAVE_INCLUDED_GETTEXT ) )
1231     /* Specify where to find the locales for current domain */
1232 #if !defined( __APPLE__ ) && !defined( WIN32 ) && !defined( SYS_BEOS )
1233     static const char psz_path[] = LOCALEDIR;
1234 #else
1235     char psz_path[1024];
1236     if (snprintf (psz_path, sizeof (psz_path), "%s" DIR_SEP "%s",
1237                   config_GetDataDir(), "locale")
1238                      >= (int)sizeof (psz_path))
1239         return -1;
1240
1241 #endif
1242     if (bindtextdomain (PACKAGE_NAME, psz_path) == NULL)
1243     {
1244         fprintf (stderr, "Warning: cannot bind text domain "PACKAGE_NAME
1245                          " to directory %s\n", psz_path);
1246         return -1;
1247     }
1248
1249     /* LibVLC wants all messages in UTF-8.
1250      * Unfortunately, we cannot ask UTF-8 for strerror_r(), strsignal_r()
1251      * and other functions that are not part of our text domain.
1252      */
1253     if (bind_textdomain_codeset (PACKAGE_NAME, "UTF-8") == NULL)
1254     {
1255         fprintf (stderr, "Error: cannot set Unicode encoding for text domain "
1256                          PACKAGE_NAME"\n");
1257         // Unbinds the text domain to avoid broken encoding
1258         bindtextdomain (PACKAGE_NAME, "DOES_NOT_EXIST");
1259         return -1;
1260     }
1261
1262     /* LibVLC does NOT set the default textdomain, since it is a library.
1263      * This could otherwise break programs using LibVLC (other than VLC).
1264      * textdomain (PACKAGE_NAME);
1265      */
1266 #endif
1267     return 0;
1268 }
1269
1270 /*****************************************************************************
1271  * GetFilenames: parse command line options which are not flags
1272  *****************************************************************************
1273  * Parse command line for input files as well as their associated options.
1274  * An option always follows its associated input and begins with a ":".
1275  *****************************************************************************/
1276 static int GetFilenames( libvlc_int_t *p_vlc, int i_argc, const char *ppsz_argv[] )
1277 {
1278     int i_opt, i_options;
1279
1280     /* We assume that the remaining parameters are filenames
1281      * and their input options */
1282     for( i_opt = i_argc - 1; i_opt >= optind; i_opt-- )
1283     {
1284         i_options = 0;
1285
1286         /* Count the input options */
1287         while( *ppsz_argv[ i_opt ] == ':' && i_opt > optind )
1288         {
1289             i_options++;
1290             i_opt--;
1291         }
1292
1293         /* TODO: write an internal function of this one, to avoid
1294          *       unnecessary lookups. */
1295
1296         playlist_t *p_playlist = pl_Hold( p_vlc );
1297         playlist_AddExt( p_playlist, ppsz_argv[i_opt], NULL, PLAYLIST_INSERT,
1298                          0, -1,
1299                          i_options, ( i_options ? &ppsz_argv[i_opt + 1] : NULL ), VLC_INPUT_OPTION_TRUSTED,
1300                          true, pl_Unlocked );
1301         pl_Release( p_vlc );
1302     }
1303
1304     return VLC_SUCCESS;
1305 }
1306
1307 /*****************************************************************************
1308  * Help: print program help
1309  *****************************************************************************
1310  * Print a short inline help. Message interface is initialized at this stage.
1311  *****************************************************************************/
1312 static inline void print_help_on_full_help( void )
1313 {
1314     utf8_fprintf( stdout, "\n" );
1315     utf8_fprintf( stdout, "%s\n", _("To get exhaustive help, use '-H'.") );
1316 }
1317
1318 static const char vlc_usage[] = N_(
1319                             "Usage: %s [options] [stream] ..."
1320                             "\nYou can specify multiple streams on the commandline. They will be enqueued in the playlist."
1321                             "\nThe first item specified will be played first."
1322                             "\n"
1323                             "\nOptions-styles:"
1324                             "\n  --option  A global option that is set for the duration of the program."
1325                             "\n   -option  A single letter version of a global --option."
1326                             "\n   :option  An option that only applies to the stream directly before it"
1327                             "\n            and that overrides previous settings."
1328                             "\n"
1329                             "\nStream MRL syntax:"
1330                             "\n  [[access][/demux]://]URL[@[title][:chapter][-[title][:chapter]]] [:option=value ...]"
1331                             "\n"
1332                             "\n  Many of the global --options can also be used as MRL specific :options."
1333                             "\n  Multiple :option=value pairs can be specified."
1334                             "\n"
1335                             "\nURL syntax:"
1336                             "\n  [file://]filename              Plain media file"
1337                             "\n  http://ip:port/file            HTTP URL"
1338                             "\n  ftp://ip:port/file             FTP URL"
1339                             "\n  mms://ip:port/file             MMS URL"
1340                             "\n  screen://                      Screen capture"
1341                             "\n  [dvd://][device][@raw_device]  DVD device"
1342                             "\n  [vcd://][device]               VCD device"
1343                             "\n  [cdda://][device]              Audio CD device"
1344                             "\n  udp://[[<source address>]@[<bind address>][:<bind port>]]"
1345                             "\n                                 UDP stream sent by a streaming server"
1346                             "\n  vlc://pause:<seconds>          Special item to pause the playlist for a certain time"
1347                             "\n  vlc://quit                     Special item to quit VLC"
1348                             "\n");
1349
1350 static void Help( libvlc_int_t *p_this, char const *psz_help_name )
1351 {
1352 #ifdef WIN32
1353     ShowConsole( true );
1354 #endif
1355
1356     if( psz_help_name && !strcmp( psz_help_name, "help" ) )
1357     {
1358         utf8_fprintf( stdout, vlc_usage, "vlc" );
1359         Usage( p_this, "=help" );
1360         Usage( p_this, "=main" );
1361         print_help_on_full_help();
1362     }
1363     else if( psz_help_name && !strcmp( psz_help_name, "longhelp" ) )
1364     {
1365         utf8_fprintf( stdout, vlc_usage, "vlc" );
1366         Usage( p_this, NULL );
1367         print_help_on_full_help();
1368     }
1369     else if( psz_help_name && !strcmp( psz_help_name, "full-help" ) )
1370     {
1371         utf8_fprintf( stdout, vlc_usage, "vlc" );
1372         Usage( p_this, NULL );
1373     }
1374     else if( psz_help_name )
1375     {
1376         Usage( p_this, psz_help_name );
1377     }
1378
1379 #ifdef WIN32        /* Pause the console because it's destroyed when we exit */
1380     PauseConsole();
1381 #endif
1382 }
1383
1384 /*****************************************************************************
1385  * Usage: print module usage
1386  *****************************************************************************
1387  * Print a short inline help. Message interface is initialized at this stage.
1388  *****************************************************************************/
1389 #   define COL(x)  "\033[" #x ";1m"
1390 #   define RED     COL(31)
1391 #   define GREEN   COL(32)
1392 #   define YELLOW  COL(33)
1393 #   define BLUE    COL(34)
1394 #   define MAGENTA COL(35)
1395 #   define CYAN    COL(36)
1396 #   define WHITE   COL(0)
1397 #   define GRAY    "\033[0m"
1398 static void print_help_section( module_config_t *p_item, bool b_color, bool b_description )
1399 {
1400     if( !p_item ) return;
1401     if( b_color )
1402     {
1403         utf8_fprintf( stdout, RED"   %s:\n"GRAY,
1404                       p_item->psz_text );
1405         if( b_description && p_item->psz_longtext )
1406             utf8_fprintf( stdout, MAGENTA"   %s\n"GRAY,
1407                           p_item->psz_longtext );
1408     }
1409     else
1410     {
1411         utf8_fprintf( stdout, "   %s:\n", p_item->psz_text );
1412         if( b_description && p_item->psz_longtext )
1413             utf8_fprintf( stdout, "   %s\n", p_item->psz_longtext );
1414     }
1415 }
1416
1417 static void Usage( libvlc_int_t *p_this, char const *psz_search )
1418 {
1419 #define FORMAT_STRING "  %s --%s%s%s%s%s%s%s "
1420     /* short option ------'    | | | | | | |
1421      * option name ------------' | | | | | |
1422      * <bra ---------------------' | | | | |
1423      * option type or "" ----------' | | | |
1424      * ket> -------------------------' | | |
1425      * padding spaces -----------------' | |
1426      * comment --------------------------' |
1427      * comment suffix ---------------------'
1428      *
1429      * The purpose of having bra and ket is that we might i18n them as well.
1430      */
1431
1432 #define COLOR_FORMAT_STRING (WHITE"  %s --%s"YELLOW"%s%s%s%s%s%s "GRAY)
1433 #define COLOR_FORMAT_STRING_BOOL (WHITE"  %s --%s%s%s%s%s%s%s "GRAY)
1434
1435 #define LINE_START 8
1436 #define PADDING_SPACES 25
1437 #ifdef WIN32
1438 #   define OPTION_VALUE_SEP "="
1439 #else
1440 #   define OPTION_VALUE_SEP " "
1441 #endif
1442     char psz_spaces_text[PADDING_SPACES+LINE_START+1];
1443     char psz_spaces_longtext[LINE_START+3];
1444     char psz_format[sizeof(COLOR_FORMAT_STRING)];
1445     char psz_format_bool[sizeof(COLOR_FORMAT_STRING_BOOL)];
1446     char psz_buffer[10000];
1447     char psz_short[4];
1448     int i_width = ConsoleWidth() - (PADDING_SPACES+LINE_START+1);
1449     int i_width_description = i_width + PADDING_SPACES - 1;
1450     bool b_advanced    = config_GetInt( p_this, "advanced" ) > 0;
1451     bool b_description = config_GetInt( p_this, "help-verbose" ) > 0;
1452     bool b_description_hack;
1453     bool b_color       = config_GetInt( p_this, "color" ) > 0;
1454     bool b_has_advanced = false;
1455     bool b_found       = false;
1456     int  i_only_advanced = 0; /* Number of modules ignored because they
1457                                * only have advanced options */
1458     bool b_strict = psz_search && *psz_search == '=';
1459     if( b_strict ) psz_search++;
1460
1461     memset( psz_spaces_text, ' ', PADDING_SPACES+LINE_START );
1462     psz_spaces_text[PADDING_SPACES+LINE_START] = '\0';
1463     memset( psz_spaces_longtext, ' ', LINE_START+2 );
1464     psz_spaces_longtext[LINE_START+2] = '\0';
1465 #ifndef WIN32
1466     if( !isatty( 1 ) )
1467 #endif
1468         b_color = false; // don't put color control codes in a .txt file
1469
1470     if( b_color )
1471     {
1472         strcpy( psz_format, COLOR_FORMAT_STRING );
1473         strcpy( psz_format_bool, COLOR_FORMAT_STRING_BOOL );
1474     }
1475     else
1476     {
1477         strcpy( psz_format, FORMAT_STRING );
1478         strcpy( psz_format_bool, FORMAT_STRING );
1479     }
1480
1481     /* List all modules */
1482     module_t **list = module_list_get (NULL);
1483     if (!list)
1484         return;
1485
1486     /* Ugly hack to make sure that the help options always come first
1487      * (part 1) */
1488     if( !psz_search )
1489         Usage( p_this, "help" );
1490
1491     /* Enumerate the config for each module */
1492     for (size_t i = 0; list[i]; i++)
1493     {
1494         bool b_help_module;
1495         module_t *p_parser = list[i];
1496         module_config_t *p_item = NULL;
1497         module_config_t *p_section = NULL;
1498         module_config_t *p_end = p_parser->p_config + p_parser->confsize;
1499
1500         if( psz_search &&
1501             ( b_strict ? strcmp( psz_search, p_parser->psz_object_name )
1502                        : !strstr( p_parser->psz_object_name, psz_search ) ) )
1503         {
1504             char *const *pp_shortcut = p_parser->pp_shortcuts;
1505             while( *pp_shortcut )
1506             {
1507                 if( b_strict ? !strcmp( psz_search, *pp_shortcut )
1508                              : !!strstr( *pp_shortcut, psz_search ) )
1509                     break;
1510                 pp_shortcut ++;
1511             }
1512             if( !*pp_shortcut )
1513                 continue;
1514         }
1515
1516         /* Ignore modules without config options */
1517         if( !p_parser->i_config_items )
1518         {
1519             continue;
1520         }
1521
1522         b_help_module = !strcmp( "help", p_parser->psz_object_name );
1523         /* Ugly hack to make sure that the help options always come first
1524          * (part 2) */
1525         if( !psz_search && b_help_module )
1526             continue;
1527
1528         /* Ignore modules with only advanced config options if requested */
1529         if( !b_advanced )
1530         {
1531             for( p_item = p_parser->p_config;
1532                  p_item < p_end;
1533                  p_item++ )
1534             {
1535                 if( (p_item->i_type & CONFIG_ITEM) &&
1536                     !p_item->b_advanced && !p_item->b_removed ) break;
1537             }
1538
1539             if( p_item == p_end )
1540             {
1541                 i_only_advanced++;
1542                 continue;
1543             }
1544         }
1545
1546         b_found = true;
1547
1548         /* Print name of module */
1549         if( strcmp( "main", p_parser->psz_object_name ) )
1550         {
1551             if( b_color )
1552                 utf8_fprintf( stdout, "\n " GREEN "%s" GRAY " (%s)\n",
1553                               p_parser->psz_longname,
1554                                p_parser->psz_object_name );
1555             else
1556                 utf8_fprintf( stdout, "\n %s\n", p_parser->psz_longname );
1557         }
1558         if( p_parser->psz_help )
1559         {
1560             if( b_color )
1561                 utf8_fprintf( stdout, CYAN" %s\n"GRAY, p_parser->psz_help );
1562             else
1563                 utf8_fprintf( stdout, " %s\n", p_parser->psz_help );
1564         }
1565
1566         /* Print module options */
1567         for( p_item = p_parser->p_config;
1568              p_item < p_end;
1569              p_item++ )
1570         {
1571             char *psz_text, *psz_spaces = psz_spaces_text;
1572             const char *psz_bra = NULL, *psz_type = NULL, *psz_ket = NULL;
1573             const char *psz_suf = "", *psz_prefix = NULL;
1574             signed int i;
1575             size_t i_cur_width;
1576
1577             /* Skip removed options */
1578             if( p_item->b_removed )
1579             {
1580                 continue;
1581             }
1582             /* Skip advanced options if requested */
1583             if( p_item->b_advanced && !b_advanced )
1584             {
1585                 b_has_advanced = true;
1586                 continue;
1587             }
1588
1589             switch( p_item->i_type )
1590             {
1591             case CONFIG_HINT_CATEGORY:
1592             case CONFIG_HINT_USAGE:
1593                 if( !strcmp( "main", p_parser->psz_object_name ) )
1594                 {
1595                     if( b_color )
1596                         utf8_fprintf( stdout, GREEN "\n %s\n" GRAY,
1597                                       p_item->psz_text );
1598                     else
1599                         utf8_fprintf( stdout, "\n %s\n", p_item->psz_text );
1600                 }
1601                 if( b_description && p_item->psz_longtext )
1602                 {
1603                     if( b_color )
1604                         utf8_fprintf( stdout, CYAN " %s\n" GRAY,
1605                                       p_item->psz_longtext );
1606                     else
1607                         utf8_fprintf( stdout, " %s\n", p_item->psz_longtext );
1608                 }
1609                 break;
1610
1611             case CONFIG_HINT_SUBCATEGORY:
1612                 if( strcmp( "main", p_parser->psz_object_name ) )
1613                     break;
1614             case CONFIG_SECTION:
1615                 p_section = p_item;
1616                 break;
1617
1618             case CONFIG_ITEM_STRING:
1619             case CONFIG_ITEM_FILE:
1620             case CONFIG_ITEM_DIRECTORY:
1621             case CONFIG_ITEM_MODULE: /* We could also have "=<" here */
1622             case CONFIG_ITEM_MODULE_CAT:
1623             case CONFIG_ITEM_MODULE_LIST:
1624             case CONFIG_ITEM_MODULE_LIST_CAT:
1625             case CONFIG_ITEM_FONT:
1626             case CONFIG_ITEM_PASSWORD:
1627                 print_help_section( p_section, b_color, b_description );
1628                 p_section = NULL;
1629                 psz_bra = OPTION_VALUE_SEP "<";
1630                 psz_type = _("string");
1631                 psz_ket = ">";
1632
1633                 if( p_item->ppsz_list )
1634                 {
1635                     psz_bra = OPTION_VALUE_SEP "{";
1636                     psz_type = psz_buffer;
1637                     psz_buffer[0] = '\0';
1638                     for( i = 0; p_item->ppsz_list[i]; i++ )
1639                     {
1640                         if( i ) strcat( psz_buffer, "," );
1641                         strcat( psz_buffer, p_item->ppsz_list[i] );
1642                     }
1643                     psz_ket = "}";
1644                 }
1645                 break;
1646             case CONFIG_ITEM_INTEGER:
1647             case CONFIG_ITEM_KEY: /* FIXME: do something a bit more clever */
1648                 print_help_section( p_section, b_color, b_description );
1649                 p_section = NULL;
1650                 psz_bra = OPTION_VALUE_SEP "<";
1651                 psz_type = _("integer");
1652                 psz_ket = ">";
1653
1654                 if( p_item->min.i || p_item->max.i )
1655                 {
1656                     sprintf( psz_buffer, "%s [%i .. %i]", psz_type,
1657                              p_item->min.i, p_item->max.i );
1658                     psz_type = psz_buffer;
1659                 }
1660
1661                 if( p_item->i_list )
1662                 {
1663                     psz_bra = OPTION_VALUE_SEP "{";
1664                     psz_type = psz_buffer;
1665                     psz_buffer[0] = '\0';
1666                     for( i = 0; p_item->ppsz_list_text[i]; i++ )
1667                     {
1668                         if( i ) strcat( psz_buffer, ", " );
1669                         sprintf( psz_buffer + strlen(psz_buffer), "%i (%s)",
1670                                  p_item->pi_list[i],
1671                                  p_item->ppsz_list_text[i] );
1672                     }
1673                     psz_ket = "}";
1674                 }
1675                 break;
1676             case CONFIG_ITEM_FLOAT:
1677                 print_help_section( p_section, b_color, b_description );
1678                 p_section = NULL;
1679                 psz_bra = OPTION_VALUE_SEP "<";
1680                 psz_type = _("float");
1681                 psz_ket = ">";
1682                 if( p_item->min.f || p_item->max.f )
1683                 {
1684                     sprintf( psz_buffer, "%s [%f .. %f]", psz_type,
1685                              p_item->min.f, p_item->max.f );
1686                     psz_type = psz_buffer;
1687                 }
1688                 break;
1689             case CONFIG_ITEM_BOOL:
1690                 print_help_section( p_section, b_color, b_description );
1691                 p_section = NULL;
1692                 psz_bra = ""; psz_type = ""; psz_ket = "";
1693                 if( !b_help_module )
1694                 {
1695                     psz_suf = p_item->value.i ? _(" (default enabled)") :
1696                                                 _(" (default disabled)");
1697                 }
1698                 break;
1699             }
1700
1701             if( !psz_type )
1702             {
1703                 continue;
1704             }
1705
1706             /* Add short option if any */
1707             if( p_item->i_short )
1708             {
1709                 sprintf( psz_short, "-%c,", p_item->i_short );
1710             }
1711             else
1712             {
1713                 strcpy( psz_short, "   " );
1714             }
1715
1716             i = PADDING_SPACES - strlen( p_item->psz_name )
1717                  - strlen( psz_bra ) - strlen( psz_type )
1718                  - strlen( psz_ket ) - 1;
1719
1720             if( p_item->i_type == CONFIG_ITEM_BOOL && !b_help_module )
1721             {
1722                 psz_prefix =  ", --no-";
1723                 i -= strlen( p_item->psz_name ) + strlen( psz_prefix );
1724             }
1725
1726             if( i < 0 )
1727             {
1728                 psz_spaces[0] = '\n';
1729                 i = 0;
1730             }
1731             else
1732             {
1733                 psz_spaces[i] = '\0';
1734             }
1735
1736             if( p_item->i_type == CONFIG_ITEM_BOOL && !b_help_module )
1737             {
1738                 utf8_fprintf( stdout, psz_format_bool, psz_short,
1739                               p_item->psz_name, psz_prefix, p_item->psz_name,
1740                               psz_bra, psz_type, psz_ket, psz_spaces );
1741             }
1742             else
1743             {
1744                 utf8_fprintf( stdout, psz_format, psz_short, p_item->psz_name,
1745                          "", "", psz_bra, psz_type, psz_ket, psz_spaces );
1746             }
1747
1748             psz_spaces[i] = ' ';
1749
1750             /* We wrap the rest of the output */
1751             sprintf( psz_buffer, "%s%s", p_item->psz_text, psz_suf );
1752             b_description_hack = b_description;
1753
1754  description:
1755             psz_text = psz_buffer;
1756             i_cur_width = b_description && !b_description_hack
1757                           ? i_width_description
1758                           : i_width;
1759             while( *psz_text )
1760             {
1761                 char *psz_parser, *psz_word;
1762                 size_t i_end = strlen( psz_text );
1763
1764                 /* If the remaining text fits in a line, print it. */
1765                 if( i_end <= i_cur_width )
1766                 {
1767                     if( b_color )
1768                     {
1769                         if( !b_description || b_description_hack )
1770                             utf8_fprintf( stdout, BLUE"%s\n"GRAY, psz_text );
1771                         else
1772                             utf8_fprintf( stdout, "%s\n", psz_text );
1773                     }
1774                     else
1775                     {
1776                         utf8_fprintf( stdout, "%s\n", psz_text );
1777                     }
1778                     break;
1779                 }
1780
1781                 /* Otherwise, eat as many words as possible */
1782                 psz_parser = psz_text;
1783                 do
1784                 {
1785                     psz_word = psz_parser;
1786                     psz_parser = strchr( psz_word, ' ' );
1787                     /* If no space was found, we reached the end of the text
1788                      * block; otherwise, we skip the space we just found. */
1789                     psz_parser = psz_parser ? psz_parser + 1
1790                                             : psz_text + i_end;
1791
1792                 } while( (size_t)(psz_parser - psz_text) <= i_cur_width );
1793
1794                 /* We cut a word in one of these cases:
1795                  *  - it's the only word in the line and it's too long.
1796                  *  - we used less than 80% of the width and the word we are
1797                  *    going to wrap is longer than 40% of the width, and even
1798                  *    if the word would have fit in the next line. */
1799                 if( psz_word == psz_text
1800              || ( (size_t)(psz_word - psz_text) < 80 * i_cur_width / 100
1801              && (size_t)(psz_parser - psz_word) > 40 * i_cur_width / 100 ) )
1802                 {
1803                     char c = psz_text[i_cur_width];
1804                     psz_text[i_cur_width] = '\0';
1805                     if( b_color )
1806                     {
1807                         if( !b_description || b_description_hack )
1808                             utf8_fprintf( stdout, BLUE"%s\n%s"GRAY,
1809                                           psz_text, psz_spaces );
1810                         else
1811                             utf8_fprintf( stdout, "%s\n%s",
1812                                           psz_text, psz_spaces );
1813                     }
1814                     else
1815                     {
1816                         utf8_fprintf( stdout, "%s\n%s", psz_text, psz_spaces );
1817                     }
1818                     psz_text += i_cur_width;
1819                     psz_text[0] = c;
1820                 }
1821                 else
1822                 {
1823                     psz_word[-1] = '\0';
1824                     if( b_color )
1825                     {
1826                         if( !b_description || b_description_hack )
1827                             utf8_fprintf( stdout, BLUE"%s\n%s"GRAY,
1828                                           psz_text, psz_spaces );
1829                         else
1830                             utf8_fprintf( stdout, "%s\n%s",
1831                                           psz_text, psz_spaces );
1832                     }
1833                     else
1834                     {
1835                         utf8_fprintf( stdout, "%s\n%s", psz_text, psz_spaces );
1836                     }
1837                     psz_text = psz_word;
1838                 }
1839             }
1840
1841             if( b_description_hack && p_item->psz_longtext )
1842             {
1843                 sprintf( psz_buffer, "%s%s", p_item->psz_longtext, psz_suf );
1844                 b_description_hack = false;
1845                 psz_spaces = psz_spaces_longtext;
1846                 utf8_fprintf( stdout, "%s", psz_spaces );
1847                 goto description;
1848             }
1849         }
1850     }
1851
1852     if( b_has_advanced )
1853     {
1854         if( b_color )
1855             utf8_fprintf( stdout, "\n" WHITE "%s" GRAY " %s\n", _( "Note:" ),
1856            _( "add --advanced to your command line to see advanced options."));
1857         else
1858             utf8_fprintf( stdout, "\n%s %s\n", _( "Note:" ),
1859            _( "add --advanced to your command line to see advanced options."));
1860     }
1861
1862     if( i_only_advanced > 0 )
1863     {
1864         if( b_color )
1865         {
1866             utf8_fprintf( stdout, "\n" WHITE "%s" GRAY " ", _( "Note:" ) );
1867             utf8_fprintf( stdout, _( "%d module(s) were not displayed because they only have advanced options.\n" ), i_only_advanced );
1868         }
1869         else
1870         {
1871             utf8_fprintf( stdout, "\n%s ", _( "Note:" ) );
1872             utf8_fprintf( stdout, _( "%d module(s) were not displayed because they only have advanced options.\n" ), i_only_advanced );
1873         }
1874     }
1875     else if( !b_found )
1876     {
1877         if( b_color )
1878             utf8_fprintf( stdout, "\n" WHITE "%s" GRAY "\n",
1879                        _( "No matching module found. Use --list or " \
1880                           "--list-verbose to list available modules." ) );
1881         else
1882             utf8_fprintf( stdout, "\n%s\n",
1883                        _( "No matching module found. Use --list or " \
1884                           "--list-verbose to list available modules." ) );
1885     }
1886
1887     /* Release the module list */
1888     module_list_free (list);
1889 }
1890
1891 /*****************************************************************************
1892  * ListModules: list the available modules with their description
1893  *****************************************************************************
1894  * Print a list of all available modules (builtins and plugins) and a short
1895  * description for each one.
1896  *****************************************************************************/
1897 static void ListModules( libvlc_int_t *p_this, bool b_verbose )
1898 {
1899     module_t *p_parser;
1900     char psz_spaces[22];
1901
1902     bool b_color = config_GetInt( p_this, "color" ) > 0;
1903
1904     memset( psz_spaces, ' ', 22 );
1905
1906 #ifdef WIN32
1907     ShowConsole( true );
1908 #endif
1909
1910     /* List all modules */
1911     module_t **list = module_list_get (NULL);
1912
1913     /* Enumerate each module */
1914     for (size_t j = 0; (p_parser = list[j]) != NULL; j++)
1915     {
1916         int i;
1917
1918         /* Nasty hack, but right now I'm too tired to think about a nice
1919          * solution */
1920         i = 22 - strlen( p_parser->psz_object_name ) - 1;
1921         if( i < 0 ) i = 0;
1922         psz_spaces[i] = 0;
1923
1924         if( b_color )
1925             utf8_fprintf( stdout, GREEN"  %s%s "WHITE"%s\n"GRAY,
1926                           p_parser->psz_object_name,
1927                           psz_spaces,
1928                           p_parser->psz_longname );
1929         else
1930             utf8_fprintf( stdout, "  %s%s %s\n",
1931                           p_parser->psz_object_name,
1932                           psz_spaces, p_parser->psz_longname );
1933
1934         if( b_verbose )
1935         {
1936             char *const *pp_shortcut = p_parser->pp_shortcuts;
1937             while( *pp_shortcut )
1938             {
1939                 if( strcmp( *pp_shortcut, p_parser->psz_object_name ) )
1940                 {
1941                     if( b_color )
1942                         utf8_fprintf( stdout, CYAN"   s %s\n"GRAY,
1943                                       *pp_shortcut );
1944                     else
1945                         utf8_fprintf( stdout, "   s %s\n",
1946                                       *pp_shortcut );
1947                 }
1948                 pp_shortcut++;
1949             }
1950             if( p_parser->psz_capability )
1951             {
1952                 if( b_color )
1953                     utf8_fprintf( stdout, MAGENTA"   c %s (%d)\n"GRAY,
1954                                   p_parser->psz_capability,
1955                                   p_parser->i_score );
1956                 else
1957                     utf8_fprintf( stdout, "   c %s (%d)\n",
1958                                   p_parser->psz_capability,
1959                                   p_parser->i_score );
1960             }
1961         }
1962
1963         psz_spaces[i] = ' ';
1964     }
1965     module_list_free (list);
1966
1967 #ifdef WIN32        /* Pause the console because it's destroyed when we exit */
1968     PauseConsole();
1969 #endif
1970 }
1971
1972 /*****************************************************************************
1973  * Version: print complete program version
1974  *****************************************************************************
1975  * Print complete program version and build number.
1976  *****************************************************************************/
1977 static void Version( void )
1978 {
1979     extern const char psz_vlc_changeset[];
1980 #ifdef WIN32
1981     ShowConsole( true );
1982 #endif
1983
1984     utf8_fprintf( stdout, _("VLC version %s (%s)\n"), VLC_Version(),
1985                   psz_vlc_changeset );
1986     utf8_fprintf( stdout, _("Compiled by %s@%s.%s\n"),
1987              VLC_CompileBy(), VLC_CompileHost(), VLC_CompileDomain() );
1988     utf8_fprintf( stdout, _("Compiler: %s\n"), VLC_Compiler() );
1989     utf8_fprintf( stdout, "%s", LICENSE_MSG );
1990
1991 #ifdef WIN32        /* Pause the console because it's destroyed when we exit */
1992     PauseConsole();
1993 #endif
1994 }
1995
1996 /*****************************************************************************
1997  * ShowConsole: On Win32, create an output console for debug messages
1998  *****************************************************************************
1999  * This function is useful only on Win32.
2000  *****************************************************************************/
2001 #ifdef WIN32 /*  */
2002 static void ShowConsole( bool b_dofile )
2003 {
2004 #   ifndef UNDER_CE
2005     FILE *f_help = NULL;
2006
2007     if( getenv( "PWD" ) && getenv( "PS1" ) ) return; /* cygwin shell */
2008
2009     AllocConsole();
2010     /* Use the ANSI code page (e.g. Windows-1252) as expected by the LibVLC
2011      * Unicode/locale subsystem. By default, we have the obsolecent OEM code
2012      * page (e.g. CP437 or CP850). */
2013     SetConsoleOutputCP (GetACP ());
2014     SetConsoleTitle ("VLC media player version "PACKAGE_VERSION);
2015
2016     freopen( "CONOUT$", "w", stderr );
2017     freopen( "CONIN$", "r", stdin );
2018
2019     if( b_dofile && (f_help = fopen( "vlc-help.txt", "wt" )) )
2020     {
2021         fclose( f_help );
2022         freopen( "vlc-help.txt", "wt", stdout );
2023         utf8_fprintf( stderr, _("\nDumped content to vlc-help.txt file.\n") );
2024     }
2025     else freopen( "CONOUT$", "w", stdout );
2026
2027 #   endif
2028 }
2029 #endif
2030
2031 /*****************************************************************************
2032  * PauseConsole: On Win32, wait for a key press before closing the console
2033  *****************************************************************************
2034  * This function is useful only on Win32.
2035  *****************************************************************************/
2036 #ifdef WIN32 /*  */
2037 static void PauseConsole( void )
2038 {
2039 #   ifndef UNDER_CE
2040
2041     if( getenv( "PWD" ) && getenv( "PS1" ) ) return; /* cygwin shell */
2042
2043     utf8_fprintf( stderr, _("\nPress the RETURN key to continue...\n") );
2044     getchar();
2045     fclose( stdout );
2046
2047 #   endif
2048 }
2049 #endif
2050
2051 /*****************************************************************************
2052  * ConsoleWidth: Return the console width in characters
2053  *****************************************************************************
2054  * We use the stty shell command to get the console width; if this fails or
2055  * if the width is less than 80, we default to 80.
2056  *****************************************************************************/
2057 static int ConsoleWidth( void )
2058 {
2059     unsigned i_width = 80;
2060
2061 #ifndef WIN32
2062     FILE *file = popen( "stty size 2>/dev/null", "r" );
2063     if (file != NULL)
2064     {
2065         if (fscanf (file, "%*u %u", &i_width) <= 0)
2066             i_width = 80;
2067         pclose( file );
2068     }
2069 #elif !defined (UNDER_CE)
2070     CONSOLE_SCREEN_BUFFER_INFO buf;
2071
2072     if (GetConsoleScreenBufferInfo (GetStdHandle (STD_OUTPUT_HANDLE), &buf))
2073         i_width = buf.dwSize.X;
2074 #endif
2075
2076     return i_width;
2077 }
2078
2079 /*****************************************************************************
2080  * InitDeviceValues: initialize device values
2081  *****************************************************************************
2082  * This function inits the dvd, vcd and cd-audio values
2083  *****************************************************************************/
2084 static void InitDeviceValues( libvlc_int_t *p_vlc )
2085 {
2086 #ifdef HAVE_HAL
2087     LibHalContext * ctx = NULL;
2088     int i, i_devices;
2089     char **devices = NULL;
2090     char *block_dev = NULL;
2091     dbus_bool_t b_dvd;
2092
2093     DBusConnection *p_connection = NULL;
2094     DBusError       error;
2095
2096     ctx = libhal_ctx_new();
2097     if( !ctx ) return;
2098     dbus_error_init( &error );
2099     p_connection = dbus_bus_get ( DBUS_BUS_SYSTEM, &error );
2100     if( dbus_error_is_set( &error ) || !p_connection )
2101     {
2102         libhal_ctx_free( ctx );
2103         dbus_error_free( &error );
2104         return;
2105     }
2106     libhal_ctx_set_dbus_connection( ctx, p_connection );
2107     if( libhal_ctx_init( ctx, &error ) )
2108     {
2109         if( ( devices = libhal_get_all_devices( ctx, &i_devices, NULL ) ) )
2110         {
2111             for( i = 0; i < i_devices; i++ )
2112             {
2113                 if( !libhal_device_property_exists( ctx, devices[i],
2114                                                 "storage.cdrom.dvd", NULL ) )
2115                 {
2116                     continue;
2117                 }
2118                 b_dvd = libhal_device_get_property_bool( ctx, devices[ i ],
2119                                                  "storage.cdrom.dvd", NULL  );
2120                 block_dev = libhal_device_get_property_string( ctx,
2121                                 devices[ i ], "block.device" , NULL );
2122                 if( b_dvd )
2123                 {
2124                     config_PutPsz( p_vlc, "dvd", block_dev );
2125                 }
2126
2127                 config_PutPsz( p_vlc, "vcd", block_dev );
2128                 config_PutPsz( p_vlc, "cd-audio", block_dev );
2129                 libhal_free_string( block_dev );
2130             }
2131             libhal_free_string_array( devices );
2132         }
2133         libhal_ctx_shutdown( ctx, NULL );
2134         dbus_connection_unref( p_connection );
2135         libhal_ctx_free( ctx );
2136     }
2137     else
2138     {
2139         msg_Warn( p_vlc, "Unable to get HAL device properties" );
2140     }
2141 #else
2142     (void)p_vlc;
2143 #endif /* HAVE_HAL */
2144 }
2145
2146 #include <vlc_avcodec.h>
2147
2148 void vlc_avcodec_mutex (bool acquire)
2149 {
2150     static vlc_mutex_t lock = VLC_STATIC_MUTEX;
2151
2152     if (acquire)
2153         vlc_mutex_lock (&lock);
2154     else
2155         vlc_mutex_unlock (&lock);
2156 }