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