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