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