git.sesse.net Git - vlc/blob - src/libvlc-common.c

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