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