git.sesse.net Git - vlc/blob - 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_GENERIC, "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     priv->i_last_input_id = 0; /* Not very safe, should be removed */
 823
 824     /*
 825      * Initialize hotkey handling
 826      */
 827     var_Create( p_libvlc, "key-pressed", VLC_VAR_INTEGER );
 828     var_Create( p_libvlc, "key-action", VLC_VAR_INTEGER );
 829     p_libvlc->p_hotkeys = malloc( libvlc_hotkeys_size );
 830     /* Do a copy (we don't need to modify the strings) */
 831     memcpy( p_libvlc->p_hotkeys, libvlc_hotkeys, libvlc_hotkeys_size );
 832     var_AddCallback( p_libvlc, "key-pressed", vlc_key_to_action,
 833                      p_libvlc->p_hotkeys );
 834
 835     /* Initialize interaction */
 836     priv->p_interaction = interaction_Init( p_libvlc );
 837
 838     /* Initialize playlist and get commandline files */
 839     playlist_ThreadCreate( p_libvlc );
 840     if( !priv->p_playlist )
 841     {
 842         msg_Err( p_libvlc, "playlist initialization failed" );
 843         if( priv->p_memcpy_module != NULL )
 844         {
 845             module_unneed( p_libvlc, priv->p_memcpy_module );
 846         }
 847         module_EndBank( p_libvlc );
 848         return VLC_EGENERIC;
 849     }
 850     p_playlist = priv->p_playlist;
 851
 852     psz_modules = config_GetPsz( p_playlist, "services-discovery" );
 853     if( psz_modules && *psz_modules )
 854     {
 855         /* Add service discovery modules */
 856         playlist_ServicesDiscoveryAdd( p_playlist, psz_modules );
 857     }
 858     free( psz_modules );
 859
 860 #ifdef ENABLE_VLM
 861     /* Initialize VLM if vlm-conf is specified */
 862     psz_parser = config_GetPsz( p_libvlc, "vlm-conf" );
 863     if( psz_parser && *psz_parser )
 864     {
 865         priv->p_vlm = vlm_New( p_libvlc );
 866         if( !priv->p_vlm )
 867             msg_Err( p_libvlc, "VLM initialization failed" );
 868     }
 869     free( psz_parser );
 870 #endif
 871
 872     /*
 873      * Load background interfaces
 874      */
 875     psz_modules = config_GetPsz( p_libvlc, "extraintf" );
 876     psz_control = config_GetPsz( p_libvlc, "control" );
 877
 878     if( psz_modules && *psz_modules && psz_control && *psz_control )
 879     {
 880         psz_modules = (char *)realloc( psz_modules, strlen( psz_modules ) +
 881                                                     strlen( psz_control ) + 1 );
 882         sprintf( psz_modules, "%s:%s", psz_modules, psz_control );
 883     }
 884     else if( psz_control && *psz_control )
 885     {
 886         free( psz_modules );
 887         psz_modules = strdup( psz_control );
 888     }
 889
 890     psz_parser = psz_modules;
 891     while ( psz_parser && *psz_parser )
 892     {
 893         char *psz_module, *psz_temp;
 894         psz_module = psz_parser;
 895         psz_parser = strchr( psz_module, ':' );
 896         if ( psz_parser )
 897         {
 898             *psz_parser = '\0';
 899             psz_parser++;
 900         }
 901         psz_temp = (char *)malloc( strlen(psz_module) + sizeof(",none") );
 902         if( psz_temp )
 903         {
 904             sprintf( psz_temp, "%s,none", psz_module );
 905             libvlc_InternalAddIntf( p_libvlc, psz_temp );
 906             free( psz_temp );
 907         }
 908     }
 909     free( psz_modules );
 910     free( psz_control );
 911
 912     /*
 913      * Always load the hotkeys interface if it exists
 914      */
 915     libvlc_InternalAddIntf( p_libvlc, "hotkeys,none" );
 916
 917 #ifdef HAVE_DBUS
 918     /* loads dbus control interface if in one-instance mode
 919      * we do it only when playlist exists, because dbus module needs it */
 920     if( config_GetInt( p_libvlc, "one-instance" ) > 0
 921         || ( config_GetInt( p_libvlc, "one-instance-when-started-from-file" )
 922              && config_GetInt( p_libvlc, "started-from-file" ) ) )
 923         libvlc_InternalAddIntf( p_libvlc, "dbus,none" );
 924
 925     /* Prevents the power management daemon from suspending the system
 926      * when VLC is active */
 927     if( config_GetInt( p_libvlc, "inhibit" ) > 0 )
 928         libvlc_InternalAddIntf( p_libvlc, "inhibit,none" );
 929 #endif
 930
 931     /*
 932      * If needed, load the Xscreensaver interface
 933      * Currently, only for X
 934      */
 935 #ifdef HAVE_X11_XLIB_H
 936     if( config_GetInt( p_libvlc, "disable-screensaver" ) )
 937     {
 938         libvlc_InternalAddIntf( p_libvlc, "screensaver,none" );
 939     }
 940 #endif
 941
 942     if( config_GetInt( p_libvlc, "file-logging" ) > 0 )
 943     {
 944         libvlc_InternalAddIntf( p_libvlc, "logger,none" );
 945     }
 946 #ifdef HAVE_SYSLOG_H
 947     if( config_GetInt( p_libvlc, "syslog" ) > 0 )
 948     {
 949         char *logmode = var_CreateGetString( p_libvlc, "logmode" );
 950         var_SetString( p_libvlc, "logmode", "syslog" );
 951         libvlc_InternalAddIntf( p_libvlc, "logger,none" );
 952
 953         if( logmode )
 954         {
 955             var_SetString( p_libvlc, "logmode", logmode );
 956             free( logmode );
 957         }
 958         else
 959             var_Destroy( p_libvlc, "logmode" );
 960     }
 961 #endif
 962
 963     if( config_GetInt( p_libvlc, "show-intf" ) > 0 )
 964     {
 965         libvlc_InternalAddIntf( p_libvlc, "showintf,none" );
 966     }
 967
 968     if( config_GetInt( p_libvlc, "network-synchronisation") > 0 )
 969     {
 970         libvlc_InternalAddIntf( p_libvlc, "netsync,none" );
 971     }
 972
 973 #ifdef WIN32
 974     if( config_GetInt( p_libvlc, "prefer-system-codecs") > 0 )
 975     {
 976         char *psz_codecs = config_GetPsz( p_playlist, "codec" );
 977         if( psz_codecs )
 978         {
 979             char *psz_morecodecs;
 980             if( asprintf(&psz_morecodecs, "%s,dmo,quicktime", psz_codecs) != -1 )
 981             {
 982                 config_PutPsz( p_libvlc, "codec", psz_morecodecs);
 983                 free( psz_morecodecs );
 984             }
 985         }
 986         else
 987             config_PutPsz( p_libvlc, "codec", "dmo,quicktime");
 988         free( psz_codecs );
 989     }
 990 #endif
 991
 992     /*
 993      * FIXME: kludge to use a p_libvlc-local variable for the Mozilla plugin
 994      */
 995     var_Create( p_libvlc, "drawable", VLC_VAR_INTEGER );
 996     var_Create( p_libvlc, "drawable-view-top", VLC_VAR_INTEGER );
 997     var_Create( p_libvlc, "drawable-view-left", VLC_VAR_INTEGER );
 998     var_Create( p_libvlc, "drawable-view-bottom", VLC_VAR_INTEGER );
 999     var_Create( p_libvlc, "drawable-view-right", VLC_VAR_INTEGER );
1000     var_Create( p_libvlc, "drawable-clip-top", VLC_VAR_INTEGER );
1001     var_Create( p_libvlc, "drawable-clip-left", VLC_VAR_INTEGER );
1002     var_Create( p_libvlc, "drawable-clip-bottom", VLC_VAR_INTEGER );
1003     var_Create( p_libvlc, "drawable-clip-right", VLC_VAR_INTEGER );
1004
1005     /* Create volume callback system. */
1006     var_Create( p_libvlc, "volume-change", VLC_VAR_BOOL );
1007
1008     /* Create a variable for showing the interface (moved from playlist). */
1009     var_Create( p_libvlc, "intf-show", VLC_VAR_BOOL );
1010     var_SetBool( p_libvlc, "intf-show", true );
1011
1012     var_Create( p_libvlc, "intf-popupmenu", VLC_VAR_BOOL );
1013
1014     /*
1015      * Get input filenames given as commandline arguments
1016      */
1017     GetFilenames( p_libvlc, i_argc, ppsz_argv );
1018
1019     /*
1020      * Get --open argument
1021      */
1022     var_Create( p_libvlc, "open", VLC_VAR_STRING | VLC_VAR_DOINHERIT );
1023     var_Get( p_libvlc, "open", &val );
1024     if ( val.psz_string != NULL && *val.psz_string )
1025     {
1026         playlist_t *p_playlist = pl_Hold( p_libvlc );
1027         playlist_AddExt( p_playlist, val.psz_string, NULL, PLAYLIST_INSERT, 0,
1028                          -1, NULL, 0, true, pl_Unlocked );
1029         pl_Release( p_libvlc );
1030     }
1031     free( val.psz_string );
1032
1033     return VLC_SUCCESS;
1034 }
1035
1036 /**
1037  * Cleanup a libvlc instance. The instance is not completely deallocated
1038  * \param p_libvlc the instance to clean
1039  */
1040 int libvlc_InternalCleanup( libvlc_int_t *p_libvlc )
1041 {
1042     intf_thread_t      * p_intf = NULL;
1043     libvlc_priv_t      *priv = libvlc_priv (p_libvlc);
1044
1045     /* Ask the interfaces to stop and destroy them */
1046     msg_Dbg( p_libvlc, "removing all interfaces" );
1047     while( (p_intf = vlc_object_find( p_libvlc, VLC_OBJECT_INTF, FIND_CHILD )) )
1048     {
1049         intf_StopThread( p_intf );
1050         vlc_object_detach( p_intf );
1051         vlc_object_release( p_intf ); /* for intf_Create() */
1052         vlc_object_release( p_intf ); /* for vlc_object_find() */
1053     }
1054
1055 #ifdef ENABLE_VLM
1056     /* Destroy VLM if created in libvlc_InternalInit */
1057     if( priv->p_vlm )
1058     {
1059         vlm_Delete( priv->p_vlm );
1060     }
1061 #endif
1062
1063     playlist_t *p_playlist = priv->p_playlist;
1064     /* Remove all services discovery */
1065     msg_Dbg( p_libvlc, "removing all services discovery tasks" );
1066     playlist_ServicesDiscoveryKillAll( p_playlist );
1067
1068     /* Free playlist */
1069     /* Any thread still running must not assume pl_Hold() succeeds. */
1070     msg_Dbg( p_libvlc, "removing playlist" );
1071     priv->p_playlist = NULL;
1072     vlc_object_kill( p_playlist ); /* <-- memory barrier for pl_Hold() */
1073     vlc_thread_join( p_playlist );
1074     vlc_object_release( p_playlist );
1075
1076     /* Free interaction */
1077     msg_Dbg( p_libvlc, "removing interaction" );
1078     interaction_Destroy( priv->p_interaction );
1079
1080     /* Free video outputs */
1081     msg_Dbg( p_libvlc, "removing all video outputs" );
1082     vlc_list_t *list = vlc_list_find (p_libvlc, VLC_OBJECT_VOUT, FIND_CHILD);
1083     for (int i = 0; i < list->i_count; i++)
1084         vlc_object_release (list->p_values[i].p_object);
1085     vlc_list_release (list);
1086
1087     stats_TimersDumpAll( p_libvlc );
1088     stats_TimersCleanAll( p_libvlc );
1089
1090     msg_Dbg( p_libvlc, "removing stats" );
1091     vlc_mutex_destroy( &p_libvlc->p_stats->lock );
1092     FREENULL( p_libvlc->p_stats );
1093
1094     return VLC_SUCCESS;
1095 }
1096
1097 /**
1098  * Destroy everything.
1099  * This function requests the running threads to finish, waits for their
1100  * termination, and destroys their structure.
1101  * It stops the thread systems: no instance can run after this has run
1102  * \param p_libvlc the instance to destroy
1103  */
1104 int libvlc_InternalDestroy( libvlc_int_t *p_libvlc )
1105 {
1106     if( !p_libvlc )
1107         return VLC_EGENERIC;
1108
1109     libvlc_priv_t *priv = libvlc_priv (p_libvlc);
1110
1111 #ifndef WIN32
1112     char* psz_pidfile = NULL;
1113
1114     if( b_daemon )
1115     {
1116         psz_pidfile = config_GetPsz( p_libvlc, "pidfile" );
1117         if( psz_pidfile != NULL )
1118         {
1119             msg_Dbg( p_libvlc, "removing pid file %s", psz_pidfile );
1120             if( unlink( psz_pidfile ) == -1 )
1121             {
1122                 msg_Dbg( p_libvlc, "removing pid file %s: %m",
1123                         psz_pidfile );
1124             }
1125         }
1126         free( psz_pidfile );
1127     }
1128 #endif
1129
1130     if( priv->p_memcpy_module )
1131     {
1132         module_unneed( p_libvlc, priv->p_memcpy_module );
1133         priv->p_memcpy_module = NULL;
1134     }
1135
1136     /* Free module bank. It is refcounted, so we call this each time  */
1137     module_EndBank( p_libvlc );
1138
1139     FREENULL( priv->psz_configfile );
1140     var_DelCallback( p_libvlc, "key-pressed", vlc_key_to_action,
1141                      p_libvlc->p_hotkeys );
1142     FREENULL( p_libvlc->p_hotkeys );
1143
1144     vlc_mutex_t *lock = var_AcquireMutex( "libvlc" );
1145     i_instances--;
1146
1147     if( i_instances == 0 )
1148     {
1149         /* System specific cleaning code */
1150         system_End( p_libvlc );
1151     }
1152     vlc_mutex_unlock( lock );
1153
1154     msg_Flush( p_libvlc );
1155     msg_Destroy( p_libvlc );
1156
1157     /* Destroy mutexes */
1158     vlc_mutex_destroy( &priv->config_lock );
1159     vlc_mutex_destroy( &priv->timer_lock );
1160
1161     vlc_object_release( p_libvlc );
1162     p_libvlc = NULL;
1163
1164     /* Stop thread system: last one out please shut the door!
1165      * The number of initializations of the thread system is counted, we
1166      * can call this each time */
1167     vlc_threads_end ();
1168
1169     return VLC_SUCCESS;
1170 }
1171
1172 /**
1173  * Add an interface plugin and run it
1174  */
1175 int libvlc_InternalAddIntf( libvlc_int_t *p_libvlc, char const *psz_module )
1176 {
1177     int i_err;
1178     intf_thread_t *p_intf = NULL;
1179
1180     if( !p_libvlc )
1181         return VLC_EGENERIC;
1182
1183     if( !psz_module ) /* requesting the default interface */
1184     {
1185         char *psz_interface = config_GetPsz( p_libvlc, "intf" );
1186         if( !psz_interface || !*psz_interface ) /* "intf" has not been set */
1187         {
1188 #ifndef WIN32
1189             if( b_daemon )
1190                  /* Daemon mode hack.
1191                   * We prefer the dummy interface if none is specified. */
1192                 psz_module = "dummy";
1193             else
1194 #endif
1195                 msg_Info( p_libvlc, _("Running vlc with the default interface. Use 'cvlc' to use vlc without interface.") );
1196         }
1197         free( psz_interface );
1198     }
1199
1200     /* Try to create the interface */
1201     p_intf = intf_Create( p_libvlc, psz_module ? psz_module : "$intf" );
1202     if( p_intf == NULL )
1203     {
1204         msg_Err( p_libvlc, "interface \"%s\" initialization failed",
1205                  psz_module );
1206         return VLC_EGENERIC;
1207     }
1208
1209     /* Try to run the interface */
1210     i_err = intf_RunThread( p_intf );
1211     if( i_err )
1212     {
1213         vlc_object_detach( p_intf );
1214         vlc_object_release( p_intf );
1215         return i_err;
1216     }
1217
1218     return VLC_SUCCESS;
1219 };
1220
1221 #if defined( ENABLE_NLS ) && (defined (__APPLE__) || defined (WIN32)) && \
1222     ( defined( HAVE_GETTEXT ) || defined( HAVE_INCLUDED_GETTEXT ) )
1223 /*****************************************************************************
1224  * SetLanguage: set the interface language.
1225  *****************************************************************************
1226  * We set the LC_MESSAGES locale category for interface messages and buttons,
1227  * as well as the LC_CTYPE category for string sorting and possible wide
1228  * character support.
1229  *****************************************************************************/
1230 static void SetLanguage ( const char *psz_lang )
1231 {
1232 #ifdef __APPLE__
1233     /* I need that under Darwin, please check it doesn't disturb
1234      * other platforms. --Meuuh */
1235     setenv( "LANG", psz_lang, 1 );
1236
1237 #else
1238     /* We set LC_ALL manually because it is the only way to set
1239      * the language at runtime under eg. Windows. Beware that this
1240      * makes the environment unconsistent when libvlc is unloaded and
1241      * should probably be moved to a safer place like vlc.c. */
1242     static char psz_lcall[20];
1243     snprintf( psz_lcall, 19, "LC_ALL=%s", psz_lang );
1244     psz_lcall[19] = '\0';
1245     putenv( psz_lcall );
1246 #endif
1247
1248     setlocale( LC_ALL, psz_lang );
1249 }
1250 #endif
1251
1252
1253 static inline int LoadMessages (void)
1254 {
1255 #if defined( ENABLE_NLS ) \
1256      && ( defined( HAVE_GETTEXT ) || defined( HAVE_INCLUDED_GETTEXT ) )
1257     /* Specify where to find the locales for current domain */
1258 #if !defined( __APPLE__ ) && !defined( WIN32 ) && !defined( SYS_BEOS )
1259     static const char psz_path[] = LOCALEDIR;
1260 #else
1261     char psz_path[1024];
1262     if (snprintf (psz_path, sizeof (psz_path), "%s" DIR_SEP "%s",
1263                   config_GetDataDir(), "locale")
1264                      >= (int)sizeof (psz_path))
1265         return -1;
1266
1267 #endif
1268     if (bindtextdomain (PACKAGE_NAME, psz_path) == NULL)
1269     {
1270         fprintf (stderr, "Warning: cannot bind text domain "PACKAGE_NAME
1271                          " to directory %s\n", psz_path);
1272         return -1;
1273     }
1274
1275     /* LibVLC wants all messages in UTF-8.
1276      * Unfortunately, we cannot ask UTF-8 for strerror_r(), strsignal_r()
1277      * and other functions that are not part of our text domain.
1278      */
1279     if (bind_textdomain_codeset (PACKAGE_NAME, "UTF-8") == NULL)
1280     {
1281         fprintf (stderr, "Error: cannot set Unicode encoding for text domain "
1282                          PACKAGE_NAME"\n");
1283         // Unbinds the text domain to avoid broken encoding
1284         bindtextdomain (PACKAGE_NAME, "DOES_NOT_EXIST");
1285         return -1;
1286     }
1287
1288     /* LibVLC does NOT set the default textdomain, since it is a library.
1289      * This could otherwise break programs using LibVLC (other than VLC).
1290      * textdomain (PACKAGE_NAME);
1291      */
1292 #endif
1293     return 0;
1294 }
1295
1296 /*****************************************************************************
1297  * GetFilenames: parse command line options which are not flags
1298  *****************************************************************************
1299  * Parse command line for input files as well as their associated options.
1300  * An option always follows its associated input and begins with a ":".
1301  *****************************************************************************/
1302 static int GetFilenames( libvlc_int_t *p_vlc, int i_argc, const char *ppsz_argv[] )
1303 {
1304     int i_opt, i_options;
1305
1306     /* We assume that the remaining parameters are filenames
1307      * and their input options */
1308     for( i_opt = i_argc - 1; i_opt >= optind; i_opt-- )
1309     {
1310         i_options = 0;
1311
1312         /* Count the input options */
1313         while( *ppsz_argv[ i_opt ] == ':' && i_opt > optind )
1314         {
1315             i_options++;
1316             i_opt--;
1317         }
1318
1319         /* TODO: write an internal function of this one, to avoid
1320          *       unnecessary lookups. */
1321
1322         playlist_t *p_playlist = pl_Hold( p_vlc );
1323         playlist_AddExt( p_playlist, ppsz_argv[i_opt], NULL, PLAYLIST_INSERT,
1324                          0, -1, ( i_options ? &ppsz_argv[i_opt + 1] : NULL ),
1325                          i_options, true, pl_Unlocked );
1326         pl_Release( p_vlc );
1327     }
1328
1329     return VLC_SUCCESS;
1330 }
1331
1332 /*****************************************************************************
1333  * Help: print program help
1334  *****************************************************************************
1335  * Print a short inline help. Message interface is initialized at this stage.
1336  *****************************************************************************/
1337 static inline void print_help_on_full_help( void )
1338 {
1339     utf8_fprintf( stdout, "\n" );
1340     utf8_fprintf( stdout, "%s\n", _("To get exhaustive help, use '-H'.") );
1341 }
1342
1343 static void Help( libvlc_int_t *p_this, char const *psz_help_name )
1344 {
1345 #ifdef WIN32
1346     ShowConsole( true );
1347 #endif
1348
1349     if( psz_help_name && !strcmp( psz_help_name, "help" ) )
1350     {
1351         utf8_fprintf( stdout, vlc_usage, "vlc" );
1352         Usage( p_this, "=help" );
1353         Usage( p_this, "=main" );
1354         print_help_on_full_help();
1355     }
1356     else if( psz_help_name && !strcmp( psz_help_name, "longhelp" ) )
1357     {
1358         utf8_fprintf( stdout, vlc_usage, "vlc" );
1359         Usage( p_this, NULL );
1360         print_help_on_full_help();
1361     }
1362     else if( psz_help_name && !strcmp( psz_help_name, "full-help" ) )
1363     {
1364         utf8_fprintf( stdout, vlc_usage, "vlc" );
1365         Usage( p_this, NULL );
1366     }
1367     else if( psz_help_name )
1368     {
1369         Usage( p_this, psz_help_name );
1370     }
1371
1372 #ifdef WIN32        /* Pause the console because it's destroyed when we exit */
1373     PauseConsole();
1374 #endif
1375 }
1376
1377 /*****************************************************************************
1378  * Usage: print module usage
1379  *****************************************************************************
1380  * Print a short inline help. Message interface is initialized at this stage.
1381  *****************************************************************************/
1382 #   define COL(x)  "\033[" #x ";1m"
1383 #   define RED     COL(31)
1384 #   define GREEN   COL(32)
1385 #   define YELLOW  COL(33)
1386 #   define BLUE    COL(34)
1387 #   define MAGENTA COL(35)
1388 #   define CYAN    COL(36)
1389 #   define WHITE   COL(0)
1390 #   define GRAY    "\033[0m"
1391 static void print_help_section( module_config_t *p_item, bool b_color, bool b_description )
1392 {
1393     if( !p_item ) return;
1394     if( b_color )
1395     {
1396         utf8_fprintf( stdout, RED"   %s:\n"GRAY,
1397                       p_item->psz_text );
1398         if( b_description && p_item->psz_longtext )
1399             utf8_fprintf( stdout, MAGENTA"   %s\n"GRAY,
1400                           p_item->psz_longtext );
1401     }
1402     else
1403     {
1404         utf8_fprintf( stdout, "   %s:\n", p_item->psz_text );
1405         if( b_description && p_item->psz_longtext )
1406             utf8_fprintf( stdout, "   %s\n", p_item->psz_longtext );
1407     }
1408 }
1409
1410 static void Usage( libvlc_int_t *p_this, char const *psz_search )
1411 {
1412 #define FORMAT_STRING "  %s --%s%s%s%s%s%s%s "
1413     /* short option ------'    | | | | | | |
1414      * option name ------------' | | | | | |
1415      * <bra ---------------------' | | | | |
1416      * option type or "" ----------' | | | |
1417      * ket> -------------------------' | | |
1418      * padding spaces -----------------' | |
1419      * comment --------------------------' |
1420      * comment suffix ---------------------'
1421      *
1422      * The purpose of having bra and ket is that we might i18n them as well.
1423      */
1424
1425 #define COLOR_FORMAT_STRING (WHITE"  %s --%s"YELLOW"%s%s%s%s%s%s "GRAY)
1426 #define COLOR_FORMAT_STRING_BOOL (WHITE"  %s --%s%s%s%s%s%s%s "GRAY)
1427
1428 #define LINE_START 8
1429 #define PADDING_SPACES 25
1430 #ifdef WIN32
1431 #   define OPTION_VALUE_SEP "="
1432 #else
1433 #   define OPTION_VALUE_SEP " "
1434 #endif
1435     char psz_spaces_text[PADDING_SPACES+LINE_START+1];
1436     char psz_spaces_longtext[LINE_START+3];
1437     char psz_format[sizeof(COLOR_FORMAT_STRING)];
1438     char psz_format_bool[sizeof(COLOR_FORMAT_STRING_BOOL)];
1439     char psz_buffer[10000];
1440     char psz_short[4];
1441     int i_width = ConsoleWidth() - (PADDING_SPACES+LINE_START+1);
1442     int i_width_description = i_width + PADDING_SPACES - 1;
1443     bool b_advanced    = config_GetInt( p_this, "advanced" ) > 0;
1444     bool b_description = config_GetInt( p_this, "help-verbose" ) > 0;
1445     bool b_description_hack;
1446     bool b_color       = config_GetInt( p_this, "color" ) > 0;
1447     bool b_has_advanced = false;
1448     bool b_found       = false;
1449     int  i_only_advanced = 0; /* Number of modules ignored because they
1450                                * only have advanced options */
1451     bool b_strict = psz_search && *psz_search == '=';
1452     if( b_strict ) psz_search++;
1453
1454     memset( psz_spaces_text, ' ', PADDING_SPACES+LINE_START );
1455     psz_spaces_text[PADDING_SPACES+LINE_START] = '\0';
1456     memset( psz_spaces_longtext, ' ', LINE_START+2 );
1457     psz_spaces_longtext[LINE_START+2] = '\0';
1458 #ifndef WIN32
1459     if( !isatty( 1 ) )
1460 #endif
1461         b_color = false; // don't put color control codes in a .txt file
1462
1463     if( b_color )
1464     {
1465         strcpy( psz_format, COLOR_FORMAT_STRING );
1466         strcpy( psz_format_bool, COLOR_FORMAT_STRING_BOOL );
1467     }
1468     else
1469     {
1470         strcpy( psz_format, FORMAT_STRING );
1471         strcpy( psz_format_bool, FORMAT_STRING );
1472     }
1473
1474     /* List all modules */
1475     module_t **list = module_list_get (NULL);
1476     if (!list)
1477         return;
1478
1479     /* Ugly hack to make sure that the help options always come first
1480      * (part 1) */
1481     if( !psz_search )
1482         Usage( p_this, "help" );
1483
1484     /* Enumerate the config for each module */
1485     for (size_t i = 0; list[i]; i++)
1486     {
1487         bool b_help_module;
1488         module_t *p_parser = list[i];
1489         module_config_t *p_item = NULL;
1490         module_config_t *p_section = NULL;
1491         module_config_t *p_end = p_parser->p_config + p_parser->confsize;
1492
1493         if( psz_search &&
1494             ( b_strict ? strcmp( psz_search, p_parser->psz_object_name )
1495                        : !strstr( p_parser->psz_object_name, psz_search ) ) )
1496         {
1497             char *const *pp_shortcut = p_parser->pp_shortcuts;
1498             while( *pp_shortcut )
1499             {
1500                 if( b_strict ? !strcmp( psz_search, *pp_shortcut )
1501                              : !!strstr( *pp_shortcut, psz_search ) )
1502                     break;
1503                 pp_shortcut ++;
1504             }
1505             if( !*pp_shortcut )
1506                 continue;
1507         }
1508
1509         /* Ignore modules without config options */
1510         if( !p_parser->i_config_items )
1511         {
1512             continue;
1513         }
1514
1515         b_help_module = !strcmp( "help", p_parser->psz_object_name );
1516         /* Ugly hack to make sure that the help options always come first
1517          * (part 2) */
1518         if( !psz_search && b_help_module )
1519             continue;
1520
1521         /* Ignore modules with only advanced config options if requested */
1522         if( !b_advanced )
1523         {
1524             for( p_item = p_parser->p_config;
1525                  p_item < p_end;
1526                  p_item++ )
1527             {
1528                 if( (p_item->i_type & CONFIG_ITEM) &&
1529                     !p_item->b_advanced && !p_item->b_removed ) break;
1530             }
1531
1532             if( p_item == p_end )
1533             {
1534                 i_only_advanced++;
1535                 continue;
1536             }
1537         }
1538
1539         b_found = true;
1540
1541         /* Print name of module */
1542         if( strcmp( "main", p_parser->psz_object_name ) )
1543         {
1544             if( b_color )
1545                 utf8_fprintf( stdout, "\n " GREEN "%s" GRAY " (%s)\n",
1546                               p_parser->psz_longname,
1547                                p_parser->psz_object_name );
1548             else
1549                 utf8_fprintf( stdout, "\n %s\n", p_parser->psz_longname );
1550         }
1551         if( p_parser->psz_help )
1552         {
1553             if( b_color )
1554                 utf8_fprintf( stdout, CYAN" %s\n"GRAY, p_parser->psz_help );
1555             else
1556                 utf8_fprintf( stdout, " %s\n", p_parser->psz_help );
1557         }
1558
1559         /* Print module options */
1560         for( p_item = p_parser->p_config;
1561              p_item < p_end;
1562              p_item++ )
1563         {
1564             char *psz_text, *psz_spaces = psz_spaces_text;
1565             const char *psz_bra = NULL, *psz_type = NULL, *psz_ket = NULL;
1566             const char *psz_suf = "", *psz_prefix = NULL;
1567             signed int i;
1568             size_t i_cur_width;
1569
1570             /* Skip removed options */
1571             if( p_item->b_removed )
1572             {
1573                 continue;
1574             }
1575             /* Skip advanced options if requested */
1576             if( p_item->b_advanced && !b_advanced )
1577             {
1578                 b_has_advanced = true;
1579                 continue;
1580             }
1581
1582             switch( p_item->i_type )
1583             {
1584             case CONFIG_HINT_CATEGORY:
1585             case CONFIG_HINT_USAGE:
1586                 if( !strcmp( "main", p_parser->psz_object_name ) )
1587                 {
1588                     if( b_color )
1589                         utf8_fprintf( stdout, GREEN "\n %s\n" GRAY,
1590                                       p_item->psz_text );
1591                     else
1592                         utf8_fprintf( stdout, "\n %s\n", p_item->psz_text );
1593                 }
1594                 if( b_description && p_item->psz_longtext )
1595                 {
1596                     if( b_color )
1597                         utf8_fprintf( stdout, CYAN " %s\n" GRAY,
1598                                       p_item->psz_longtext );
1599                     else
1600                         utf8_fprintf( stdout, " %s\n", p_item->psz_longtext );
1601                 }
1602                 break;
1603
1604             case CONFIG_HINT_SUBCATEGORY:
1605                 if( strcmp( "main", p_parser->psz_object_name ) )
1606                     break;
1607             case CONFIG_SECTION:
1608                 p_section = p_item;
1609                 break;
1610
1611             case CONFIG_ITEM_STRING:
1612             case CONFIG_ITEM_FILE:
1613             case CONFIG_ITEM_DIRECTORY:
1614             case CONFIG_ITEM_MODULE: /* We could also have "=<" here */
1615             case CONFIG_ITEM_MODULE_CAT:
1616             case CONFIG_ITEM_MODULE_LIST:
1617             case CONFIG_ITEM_MODULE_LIST_CAT:
1618             case CONFIG_ITEM_FONT:
1619             case CONFIG_ITEM_PASSWORD:
1620                 print_help_section( p_section, b_color, b_description );
1621                 p_section = NULL;
1622                 psz_bra = OPTION_VALUE_SEP "<";
1623                 psz_type = _("string");
1624                 psz_ket = ">";
1625
1626                 if( p_item->ppsz_list )
1627                 {
1628                     psz_bra = OPTION_VALUE_SEP "{";
1629                     psz_type = psz_buffer;
1630                     psz_buffer[0] = '\0';
1631                     for( i = 0; p_item->ppsz_list[i]; i++ )
1632                     {
1633                         if( i ) strcat( psz_buffer, "," );
1634                         strcat( psz_buffer, p_item->ppsz_list[i] );
1635                     }
1636                     psz_ket = "}";
1637                 }
1638                 break;
1639             case CONFIG_ITEM_INTEGER:
1640             case CONFIG_ITEM_KEY: /* FIXME: do something a bit more clever */
1641                 print_help_section( p_section, b_color, b_description );
1642                 p_section = NULL;
1643                 psz_bra = OPTION_VALUE_SEP "<";
1644                 psz_type = _("integer");
1645                 psz_ket = ">";
1646
1647                 if( p_item->min.i || p_item->max.i )
1648                 {
1649                     sprintf( psz_buffer, "%s [%i .. %i]", psz_type,
1650                              p_item->min.i, p_item->max.i );
1651                     psz_type = psz_buffer;
1652                 }
1653
1654                 if( p_item->i_list )
1655                 {
1656                     psz_bra = OPTION_VALUE_SEP "{";
1657                     psz_type = psz_buffer;
1658                     psz_buffer[0] = '\0';
1659                     for( i = 0; p_item->ppsz_list_text[i]; i++ )
1660                     {
1661                         if( i ) strcat( psz_buffer, ", " );
1662                         sprintf( psz_buffer + strlen(psz_buffer), "%i (%s)",
1663                                  p_item->pi_list[i],
1664                                  p_item->ppsz_list_text[i] );
1665                     }
1666                     psz_ket = "}";
1667                 }
1668                 break;
1669             case CONFIG_ITEM_FLOAT:
1670                 print_help_section( p_section, b_color, b_description );
1671                 p_section = NULL;
1672                 psz_bra = OPTION_VALUE_SEP "<";
1673                 psz_type = _("float");
1674                 psz_ket = ">";
1675                 if( p_item->min.f || p_item->max.f )
1676                 {
1677                     sprintf( psz_buffer, "%s [%f .. %f]", psz_type,
1678                              p_item->min.f, p_item->max.f );
1679                     psz_type = psz_buffer;
1680                 }
1681                 break;
1682             case CONFIG_ITEM_BOOL:
1683                 print_help_section( p_section, b_color, b_description );
1684                 p_section = NULL;
1685                 psz_bra = ""; psz_type = ""; psz_ket = "";
1686                 if( !b_help_module )
1687                 {
1688                     psz_suf = p_item->value.i ? _(" (default enabled)") :
1689                                                 _(" (default disabled)");
1690                 }
1691                 break;
1692             }
1693
1694             if( !psz_type )
1695             {
1696                 continue;
1697             }
1698
1699             /* Add short option if any */
1700             if( p_item->i_short )
1701             {
1702                 sprintf( psz_short, "-%c,", p_item->i_short );
1703             }
1704             else
1705             {
1706                 strcpy( psz_short, "   " );
1707             }
1708
1709             i = PADDING_SPACES - strlen( p_item->psz_name )
1710                  - strlen( psz_bra ) - strlen( psz_type )
1711                  - strlen( psz_ket ) - 1;
1712
1713             if( p_item->i_type == CONFIG_ITEM_BOOL && !b_help_module )
1714             {
1715                 psz_prefix =  ", --no-";
1716                 i -= strlen( p_item->psz_name ) + strlen( psz_prefix );
1717             }
1718
1719             if( i < 0 )
1720             {
1721                 psz_spaces[0] = '\n';
1722                 i = 0;
1723             }
1724             else
1725             {
1726                 psz_spaces[i] = '\0';
1727             }
1728
1729             if( p_item->i_type == CONFIG_ITEM_BOOL && !b_help_module )
1730             {
1731                 utf8_fprintf( stdout, psz_format_bool, psz_short,
1732                               p_item->psz_name, psz_prefix, p_item->psz_name,
1733                               psz_bra, psz_type, psz_ket, psz_spaces );
1734             }
1735             else
1736             {
1737                 utf8_fprintf( stdout, psz_format, psz_short, p_item->psz_name,
1738                          "", "", psz_bra, psz_type, psz_ket, psz_spaces );
1739             }
1740
1741             psz_spaces[i] = ' ';
1742
1743             /* We wrap the rest of the output */
1744             sprintf( psz_buffer, "%s%s", p_item->psz_text, psz_suf );
1745             b_description_hack = b_description;
1746
1747  description:
1748             psz_text = psz_buffer;
1749             i_cur_width = b_description && !b_description_hack
1750                           ? i_width_description
1751                           : i_width;
1752             while( *psz_text )
1753             {
1754                 char *psz_parser, *psz_word;
1755                 size_t i_end = strlen( psz_text );
1756
1757                 /* If the remaining text fits in a line, print it. */
1758                 if( i_end <= i_cur_width )
1759                 {
1760                     if( b_color )
1761                     {
1762                         if( !b_description || b_description_hack )
1763                             utf8_fprintf( stdout, BLUE"%s\n"GRAY, psz_text );
1764                         else
1765                             utf8_fprintf( stdout, "%s\n", psz_text );
1766                     }
1767                     else
1768                     {
1769                         utf8_fprintf( stdout, "%s\n", psz_text );
1770                     }
1771                     break;
1772                 }
1773
1774                 /* Otherwise, eat as many words as possible */
1775                 psz_parser = psz_text;
1776                 do
1777                 {
1778                     psz_word = psz_parser;
1779                     psz_parser = strchr( psz_word, ' ' );
1780                     /* If no space was found, we reached the end of the text
1781                      * block; otherwise, we skip the space we just found. */
1782                     psz_parser = psz_parser ? psz_parser + 1
1783                                             : psz_text + i_end;
1784
1785                 } while( (size_t)(psz_parser - psz_text) <= i_cur_width );
1786
1787                 /* We cut a word in one of these cases:
1788                  *  - it's the only word in the line and it's too long.
1789                  *  - we used less than 80% of the width and the word we are
1790                  *    going to wrap is longer than 40% of the width, and even
1791                  *    if the word would have fit in the next line. */
1792                 if( psz_word == psz_text
1793              || ( (size_t)(psz_word - psz_text) < 80 * i_cur_width / 100
1794              && (size_t)(psz_parser - psz_word) > 40 * i_cur_width / 100 ) )
1795                 {
1796                     char c = psz_text[i_cur_width];
1797                     psz_text[i_cur_width] = '\0';
1798                     if( b_color )
1799                     {
1800                         if( !b_description || b_description_hack )
1801                             utf8_fprintf( stdout, BLUE"%s\n%s"GRAY,
1802                                           psz_text, psz_spaces );
1803                         else
1804                             utf8_fprintf( stdout, "%s\n%s",
1805                                           psz_text, psz_spaces );
1806                     }
1807                     else
1808                     {
1809                         utf8_fprintf( stdout, "%s\n%s", psz_text, psz_spaces );
1810                     }
1811                     psz_text += i_cur_width;
1812                     psz_text[0] = c;
1813                 }
1814                 else
1815                 {
1816                     psz_word[-1] = '\0';
1817                     if( b_color )
1818                     {
1819                         if( !b_description || b_description_hack )
1820                             utf8_fprintf( stdout, BLUE"%s\n%s"GRAY,
1821                                           psz_text, psz_spaces );
1822                         else
1823                             utf8_fprintf( stdout, "%s\n%s",
1824                                           psz_text, psz_spaces );
1825                     }
1826                     else
1827                     {
1828                         utf8_fprintf( stdout, "%s\n%s", psz_text, psz_spaces );
1829                     }
1830                     psz_text = psz_word;
1831                 }
1832             }
1833
1834             if( b_description_hack && p_item->psz_longtext )
1835             {
1836                 sprintf( psz_buffer, "%s%s", p_item->psz_longtext, psz_suf );
1837                 b_description_hack = false;
1838                 psz_spaces = psz_spaces_longtext;
1839                 utf8_fprintf( stdout, "%s", psz_spaces );
1840                 goto description;
1841             }
1842         }
1843     }
1844
1845     if( b_has_advanced )
1846     {
1847         if( b_color )
1848             utf8_fprintf( stdout, "\n" WHITE "%s" GRAY " %s\n", _( "Note:" ),
1849            _( "add --advanced to your command line to see advanced options."));
1850         else
1851             utf8_fprintf( stdout, "\n%s %s\n", _( "Note:" ),
1852            _( "add --advanced to your command line to see advanced options."));
1853     }
1854
1855     if( i_only_advanced > 0 )
1856     {
1857         if( b_color )
1858         {
1859             utf8_fprintf( stdout, "\n" WHITE "%s" GRAY " ", _( "Note:" ) );
1860             utf8_fprintf( stdout, _( "%d module(s) were not displayed because they only have advanced options.\n" ), i_only_advanced );
1861         }
1862         else
1863         {
1864             utf8_fprintf( stdout, "\n%s ", _( "Note:" ) );
1865             utf8_fprintf( stdout, _( "%d module(s) were not displayed because they only have advanced options.\n" ), i_only_advanced );
1866         }
1867     }
1868     else if( !b_found )
1869     {
1870         if( b_color )
1871             utf8_fprintf( stdout, "\n" WHITE "%s" GRAY "\n",
1872                        _( "No matching module found. Use --list or" \
1873                           "--list-verbose to list available modules." ) );
1874         else
1875             utf8_fprintf( stdout, "\n%s\n",
1876                        _( "No matching module found. Use --list or" \
1877                           "--list-verbose to list available modules." ) );
1878     }
1879
1880     /* Release the module list */
1881     module_list_free (list);
1882 }
1883
1884 /*****************************************************************************
1885  * ListModules: list the available modules with their description
1886  *****************************************************************************
1887  * Print a list of all available modules (builtins and plugins) and a short
1888  * description for each one.
1889  *****************************************************************************/
1890 static void ListModules( libvlc_int_t *p_this, bool b_verbose )
1891 {
1892     module_t *p_parser;
1893     char psz_spaces[22];
1894
1895     bool b_color = config_GetInt( p_this, "color" ) > 0;
1896
1897     memset( psz_spaces, ' ', 22 );
1898
1899 #ifdef WIN32
1900     ShowConsole( true );
1901 #endif
1902
1903     /* List all modules */
1904     module_t **list = module_list_get (NULL);
1905
1906     /* Enumerate each module */
1907     for (size_t j = 0; (p_parser = list[j]) != NULL; j++)
1908     {
1909         int i;
1910
1911         /* Nasty hack, but right now I'm too tired to think about a nice
1912          * solution */
1913         i = 22 - strlen( p_parser->psz_object_name ) - 1;
1914         if( i < 0 ) i = 0;
1915         psz_spaces[i] = 0;
1916
1917         if( b_color )
1918             utf8_fprintf( stdout, GREEN"  %s%s "WHITE"%s\n"GRAY,
1919                           p_parser->psz_object_name,
1920                           psz_spaces,
1921                           p_parser->psz_longname );
1922         else
1923             utf8_fprintf( stdout, "  %s%s %s\n",
1924                           p_parser->psz_object_name,
1925                           psz_spaces, p_parser->psz_longname );
1926
1927         if( b_verbose )
1928         {
1929             char *const *pp_shortcut = p_parser->pp_shortcuts;
1930             while( *pp_shortcut )
1931             {
1932                 if( strcmp( *pp_shortcut, p_parser->psz_object_name ) )
1933                 {
1934                     if( b_color )
1935                         utf8_fprintf( stdout, CYAN"   s %s\n"GRAY,
1936                                       *pp_shortcut );
1937                     else
1938                         utf8_fprintf( stdout, "   s %s\n",
1939                                       *pp_shortcut );
1940                 }
1941                 pp_shortcut++;
1942             }
1943             if( p_parser->psz_capability )
1944             {
1945                 if( b_color )
1946                     utf8_fprintf( stdout, MAGENTA"   c %s (%d)\n"GRAY,
1947                                   p_parser->psz_capability,
1948                                   p_parser->i_score );
1949                 else
1950                     utf8_fprintf( stdout, "   c %s (%d)\n",
1951                                   p_parser->psz_capability,
1952                                   p_parser->i_score );
1953             }
1954         }
1955
1956         psz_spaces[i] = ' ';
1957     }
1958     module_list_free (list);
1959
1960 #ifdef WIN32        /* Pause the console because it's destroyed when we exit */
1961     PauseConsole();
1962 #endif
1963 }
1964
1965 /*****************************************************************************
1966  * Version: print complete program version
1967  *****************************************************************************
1968  * Print complete program version and build number.
1969  *****************************************************************************/
1970 static void Version( void )
1971 {
1972 #ifdef WIN32
1973     ShowConsole( true );
1974 #endif
1975
1976     utf8_fprintf( stdout, _("VLC version %s\n"), VLC_Version() );
1977     utf8_fprintf( stdout, _("Compiled by %s@%s.%s\n"),
1978              VLC_CompileBy(), VLC_CompileHost(), VLC_CompileDomain() );
1979     utf8_fprintf( stdout, _("Compiler: %s\n"), VLC_Compiler() );
1980     if( strcmp( VLC_Changeset(), "exported" ) )
1981         utf8_fprintf( stdout, _("Based upon Git commit [%s]\n"),
1982                  VLC_Changeset() );
1983     utf8_fprintf( stdout, LICENSE_MSG );
1984
1985 #ifdef WIN32        /* Pause the console because it's destroyed when we exit */
1986     PauseConsole();
1987 #endif
1988 }
1989
1990 /*****************************************************************************
1991  * ShowConsole: On Win32, create an output console for debug messages
1992  *****************************************************************************
1993  * This function is useful only on Win32.
1994  *****************************************************************************/
1995 #ifdef WIN32 /*  */
1996 static void ShowConsole( bool b_dofile )
1997 {
1998 #   ifndef UNDER_CE
1999     FILE *f_help = NULL;
2000
2001     if( getenv( "PWD" ) && getenv( "PS1" ) ) return; /* cygwin shell */
2002
2003     AllocConsole();
2004     /* Use the ANSI code page (e.g. Windows-1252) as expected by the LibVLC
2005      * Unicode/locale subsystem. By default, we have the obsolecent OEM code
2006      * page (e.g. CP437 or CP850). */
2007     SetConsoleOutputCP (GetACP ());
2008     SetConsoleTitle ("VLC media player version "PACKAGE_VERSION);
2009
2010     freopen( "CONOUT$", "w", stderr );
2011     freopen( "CONIN$", "r", stdin );
2012
2013     if( b_dofile && (f_help = fopen( "vlc-help.txt", "wt" )) )
2014     {
2015         fclose( f_help );
2016         freopen( "vlc-help.txt", "wt", stdout );
2017         utf8_fprintf( stderr, _("\nDumped content to vlc-help.txt file.\n") );
2018     }
2019     else freopen( "CONOUT$", "w", stdout );
2020
2021 #   endif
2022 }
2023 #endif
2024
2025 /*****************************************************************************
2026  * PauseConsole: On Win32, wait for a key press before closing the console
2027  *****************************************************************************
2028  * This function is useful only on Win32.
2029  *****************************************************************************/
2030 #ifdef WIN32 /*  */
2031 static void PauseConsole( void )
2032 {
2033 #   ifndef UNDER_CE
2034
2035     if( getenv( "PWD" ) && getenv( "PS1" ) ) return; /* cygwin shell */
2036
2037     utf8_fprintf( stderr, _("\nPress the RETURN key to continue...\n") );
2038     getchar();
2039     fclose( stdout );
2040
2041 #   endif
2042 }
2043 #endif
2044
2045 /*****************************************************************************
2046  * ConsoleWidth: Return the console width in characters
2047  *****************************************************************************
2048  * We use the stty shell command to get the console width; if this fails or
2049  * if the width is less than 80, we default to 80.
2050  *****************************************************************************/
2051 static int ConsoleWidth( void )
2052 {
2053     unsigned i_width = 80;
2054
2055 #ifndef WIN32
2056     FILE *file = popen( "stty size 2>/dev/null", "r" );
2057     if (file != NULL)
2058     {
2059         if (fscanf (file, "%*u %u", &i_width) <= 0)
2060             i_width = 80;
2061         pclose( file );
2062     }
2063 #elif !defined (UNDER_CE)
2064     CONSOLE_SCREEN_BUFFER_INFO buf;
2065
2066     if (GetConsoleScreenBufferInfo (GetStdHandle (STD_OUTPUT_HANDLE), &buf))
2067         i_width = buf.dwSize.X;
2068 #endif
2069
2070     return i_width;
2071 }
2072
2073 static int VerboseCallback( vlc_object_t *p_this, const char *psz_variable,
2074                      vlc_value_t old_val, vlc_value_t new_val, void *param)
2075 {
2076     libvlc_int_t *p_libvlc = (libvlc_int_t *)p_this;
2077     (void)psz_variable;
2078     (void)old_val;
2079     (void)param;
2080
2081     if( new_val.i_int >= -1 )
2082     {
2083         libvlc_priv (p_libvlc)->i_verbose = __MIN( new_val.i_int, 2 );
2084     }
2085     return VLC_SUCCESS;
2086 }
2087
2088 /*****************************************************************************
2089  * InitDeviceValues: initialize device values
2090  *****************************************************************************
2091  * This function inits the dvd, vcd and cd-audio values
2092  *****************************************************************************/
2093 static void InitDeviceValues( libvlc_int_t *p_vlc )
2094 {
2095 #ifdef HAVE_HAL
2096     LibHalContext * ctx = NULL;
2097     int i, i_devices;
2098     char **devices = NULL;
2099     char *block_dev = NULL;
2100     dbus_bool_t b_dvd;
2101
2102     DBusConnection *p_connection = NULL;
2103     DBusError       error;
2104
2105     ctx = libhal_ctx_new();
2106     if( !ctx ) return;
2107     dbus_error_init( &error );
2108     p_connection = dbus_bus_get ( DBUS_BUS_SYSTEM, &error );
2109     if( dbus_error_is_set( &error ) || !p_connection )
2110     {
2111         libhal_ctx_free( ctx );
2112         dbus_error_free( &error );
2113         return;
2114     }
2115     libhal_ctx_set_dbus_connection( ctx, p_connection );
2116     if( libhal_ctx_init( ctx, &error ) )
2117     {
2118         if( ( devices = libhal_get_all_devices( ctx, &i_devices, NULL ) ) )
2119         {
2120             for( i = 0; i < i_devices; i++ )
2121             {
2122                 if( !libhal_device_property_exists( ctx, devices[i],
2123                                                 "storage.cdrom.dvd", NULL ) )
2124                 {
2125                     continue;
2126                 }
2127                 b_dvd = libhal_device_get_property_bool( ctx, devices[ i ],
2128                                                  "storage.cdrom.dvd", NULL  );
2129                 block_dev = libhal_device_get_property_string( ctx,
2130                                 devices[ i ], "block.device" , NULL );
2131                 if( b_dvd )
2132                 {
2133                     config_PutPsz( p_vlc, "dvd", block_dev );
2134                 }
2135
2136                 config_PutPsz( p_vlc, "vcd", block_dev );
2137                 config_PutPsz( p_vlc, "cd-audio", block_dev );
2138                 libhal_free_string( block_dev );
2139             }
2140             libhal_free_string_array( devices );
2141         }
2142         libhal_ctx_shutdown( ctx, NULL );
2143         dbus_connection_unref( p_connection );
2144         libhal_ctx_free( ctx );
2145     }
2146     else
2147     {
2148         msg_Warn( p_vlc, "Unable to get HAL device properties" );
2149     }
2150 #else
2151     (void)p_vlc;
2152 #endif /* HAVE_HAL */
2153 }