git.sesse.net Git - vlc/blob - src/modules/configuration.c

   1 /*****************************************************************************
   2  * configuration.c management of the modules configuration
   3  *****************************************************************************
   4  * Copyright (C) 2001-2007 the VideoLAN team
   5  * $Id$
   6  *
   7  * Authors: Gildas Bazin <gbazin@videolan.org>
   8  *
   9  * This program is free software; you can redistribute it and/or modify
  10  * it under the terms of the GNU General Public License as published by
  11  * the Free Software Foundation; either version 2 of the License, or
  12  * (at your option) any later version.
  13  *
  14  * This program is distributed in the hope that it will be useful,
  15  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  16  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  17  * GNU General Public License for more details.
  18  *
  19  * You should have received a copy of the GNU General Public License
  20  * along with this program; if not, write to the Free Software
  21  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
  22  *****************************************************************************/
  23
  24 #include <vlc/vlc.h>
  25 #include "../libvlc.h"
  26 #include "vlc_keys.h"
  27 #include "vlc_charset.h"
  28
  29 #include <errno.h>                                                  /* errno */
  30
  31 #ifdef HAVE_LIMITS_H
  32 #   include <limits.h>
  33 #endif
  34
  35 #ifdef HAVE_UNISTD_H
  36 #    include <unistd.h>                                          /* getuid() */
  37 #endif
  38
  39 #ifdef HAVE_GETOPT_LONG
  40 #   ifdef HAVE_GETOPT_H
  41 #       include <getopt.h>                                       /* getopt() */
  42 #   endif
  43 #else
  44 #   include "../extras/getopt.h"
  45 #endif
  46
  47 #if defined(HAVE_GETPWUID)
  48 #   include <pwd.h>                                            /* getpwuid() */
  49 #endif
  50
  51 #if defined( HAVE_SYS_STAT_H )
  52 #   include <sys/stat.h>
  53 #endif
  54 #if defined( HAVE_SYS_TYPES_H )
  55 #   include <sys/types.h>
  56 #endif
  57 #if defined( WIN32 )
  58 #   if !defined( UNDER_CE )
  59 #       include <direct.h>
  60 #   endif
  61 #include <tchar.h>
  62 #endif
  63
  64 #include "configuration.h"
  65 #include "modules/modules.h"
  66
  67 static int ConfigStringToKey( const char * );
  68 static char *ConfigKeyToString( int );
  69
  70 static inline char *strdupnull (const char *src)
  71 {
  72     if (src == NULL)
  73         return NULL;
  74     return strdup (src);
  75 }
  76
  77 static inline char *_strdupnull (const char *src)
  78 {
  79     if (src == NULL)
  80         return NULL;
  81     return strdup (_(src));
  82 }
  83
  84 /* Item types that use a string value (i.e. serialized in the module cache) */
  85 int IsConfigStringType (int type)
  86 {
  87     static const unsigned char config_types[] =
  88     {
  89         CONFIG_ITEM_STRING, CONFIG_ITEM_FILE, CONFIG_ITEM_MODULE,
  90         CONFIG_ITEM_DIRECTORY, CONFIG_ITEM_MODULE_CAT, CONFIG_ITEM_PASSWORD,
  91         CONFIG_ITEM_MODULE_LIST, CONFIG_ITEM_MODULE_LIST_CAT
  92     };
  93
  94     /* NOTE: this needs to be changed if we ever get more than 255 types */
  95     return memchr (config_types, type, sizeof (config_types)) != NULL;
  96 }
  97
  98
  99 static int IsConfigIntegerType (int type)
 100 {
 101     static const unsigned char config_types[] =
 102     {
 103         CONFIG_ITEM_INTEGER, CONFIG_ITEM_KEY, CONFIG_ITEM_BOOL,
 104         CONFIG_CATEGORY, CONFIG_SUBCATEGORY
 105     };
 106
 107     return memchr (config_types, type, sizeof (config_types)) != NULL;
 108 }
 109
 110
 111 static inline int IsConfigFloatType (int type)
 112 {
 113     return type == CONFIG_ITEM_FLOAT;
 114 }
 115
 116
 117 /*****************************************************************************
 118  * config_GetType: get the type of a variable (bool, int, float, string)
 119  *****************************************************************************
 120  * This function is used to get the type of a variable from its name.
 121  * Beware, this is quite slow.
 122  *****************************************************************************/
 123 int __config_GetType( vlc_object_t *p_this, const char *psz_name )
 124 {
 125     module_config_t *p_config;
 126     int i_type;
 127
 128     p_config = config_FindConfig( p_this, psz_name );
 129
 130     /* sanity checks */
 131     if( !p_config )
 132     {
 133         return 0;
 134     }
 135
 136     switch( p_config->i_type )
 137     {
 138     case CONFIG_ITEM_BOOL:
 139         i_type = VLC_VAR_BOOL;
 140         break;
 141
 142     case CONFIG_ITEM_INTEGER:
 143         i_type = VLC_VAR_INTEGER;
 144         break;
 145
 146     case CONFIG_ITEM_FLOAT:
 147         i_type = VLC_VAR_FLOAT;
 148         break;
 149
 150     case CONFIG_ITEM_MODULE:
 151     case CONFIG_ITEM_MODULE_CAT:
 152     case CONFIG_ITEM_MODULE_LIST:
 153     case CONFIG_ITEM_MODULE_LIST_CAT:
 154         i_type = VLC_VAR_MODULE;
 155         break;
 156
 157     case CONFIG_ITEM_STRING:
 158         i_type = VLC_VAR_STRING;
 159         break;
 160
 161     case CONFIG_ITEM_PASSWORD:
 162         i_type = VLC_VAR_STRING;
 163         break;
 164
 165     case CONFIG_ITEM_FILE:
 166         i_type = VLC_VAR_FILE;
 167         break;
 168
 169     case CONFIG_ITEM_DIRECTORY:
 170         i_type = VLC_VAR_DIRECTORY;
 171         break;
 172
 173     default:
 174         i_type = 0;
 175         break;
 176     }
 177
 178     return i_type;
 179 }
 180
 181 /*****************************************************************************
 182  * config_GetInt: get the value of an int variable
 183  *****************************************************************************
 184  * This function is used to get the value of variables which are internally
 185  * represented by an integer (CONFIG_ITEM_INTEGER and
 186  * CONFIG_ITEM_BOOL).
 187  *****************************************************************************/
 188 int __config_GetInt( vlc_object_t *p_this, const char *psz_name )
 189 {
 190     module_config_t *p_config;
 191
 192     p_config = config_FindConfig( p_this, psz_name );
 193
 194     /* sanity checks */
 195     if( !p_config )
 196     {
 197         msg_Err( p_this, "option %s does not exist", psz_name );
 198         return -1;
 199     }
 200
 201     if (!IsConfigIntegerType (p_config->i_type))
 202     {
 203         msg_Err( p_this, "option %s does not refer to an int", psz_name );
 204         return -1;
 205     }
 206
 207     return p_config->value.i;
 208 }
 209
 210 /*****************************************************************************
 211  * config_GetFloat: get the value of a float variable
 212  *****************************************************************************
 213  * This function is used to get the value of variables which are internally
 214  * represented by a float (CONFIG_ITEM_FLOAT).
 215  *****************************************************************************/
 216 float __config_GetFloat( vlc_object_t *p_this, const char *psz_name )
 217 {
 218     module_config_t *p_config;
 219
 220     p_config = config_FindConfig( p_this, psz_name );
 221
 222     /* sanity checks */
 223     if( !p_config )
 224     {
 225         msg_Err( p_this, "option %s does not exist", psz_name );
 226         return -1;
 227     }
 228
 229     if (!IsConfigFloatType (p_config->i_type))
 230     {
 231         msg_Err( p_this, "option %s does not refer to a float", psz_name );
 232         return -1;
 233     }
 234
 235     return p_config->value.f;
 236 }
 237
 238 /*****************************************************************************
 239  * config_GetPsz: get the string value of a string variable
 240  *****************************************************************************
 241  * This function is used to get the value of variables which are internally
 242  * represented by a string (CONFIG_ITEM_STRING, CONFIG_ITEM_FILE,
 243  * CONFIG_ITEM_DIRECTORY, CONFIG_ITEM_PASSWORD, and CONFIG_ITEM_MODULE).
 244  *
 245  * Important note: remember to free() the returned char* because it's a
 246  *   duplicate of the actual value. It isn't safe to return a pointer to the
 247  *   actual value as it can be modified at any time.
 248  *****************************************************************************/
 249 char * __config_GetPsz( vlc_object_t *p_this, const char *psz_name )
 250 {
 251     module_config_t *p_config;
 252
 253     p_config = config_FindConfig( p_this, psz_name );
 254
 255     /* sanity checks */
 256     if( !p_config )
 257     {
 258         msg_Err( p_this, "option %s does not exist", psz_name );
 259         return NULL;
 260     }
 261
 262     if (!IsConfigStringType (p_config->i_type))
 263     {
 264         msg_Err( p_this, "option %s does not refer to a string", psz_name );
 265         return NULL;
 266     }
 267
 268     /* return a copy of the string */
 269     vlc_mutex_lock( p_config->p_lock );
 270     char *psz_value = strdupnull (p_config->value.psz);
 271     vlc_mutex_unlock( p_config->p_lock );
 272
 273     return psz_value;
 274 }
 275
 276 /*****************************************************************************
 277  * config_PutPsz: set the string value of a string variable
 278  *****************************************************************************
 279  * This function is used to set the value of variables which are internally
 280  * represented by a string (CONFIG_ITEM_STRING, CONFIG_ITEM_FILE,
 281  * CONFIG_ITEM_DIRECTORY, CONFIG_ITEM_PASSWORD, and CONFIG_ITEM_MODULE).
 282  *****************************************************************************/
 283 void __config_PutPsz( vlc_object_t *p_this,
 284                       const char *psz_name, const char *psz_value )
 285 {
 286     module_config_t *p_config;
 287     vlc_value_t oldval, val;
 288
 289     p_config = config_FindConfig( p_this, psz_name );
 290
 291
 292     /* sanity checks */
 293     if( !p_config )
 294     {
 295         msg_Warn( p_this, "option %s does not exist", psz_name );
 296         return;
 297     }
 298
 299     if (!IsConfigStringType (p_config->i_type))
 300     {
 301         msg_Err( p_this, "option %s does not refer to a string", psz_name );
 302         return;
 303     }
 304
 305     vlc_mutex_lock( p_config->p_lock );
 306
 307     /* backup old value */
 308     oldval.psz_string = (char *)p_config->value.psz;
 309
 310     if ((psz_value != NULL) && *psz_value)
 311         p_config->value.psz = strdup (psz_value);
 312     else
 313         p_config->value.psz = NULL;
 314
 315     p_config->b_dirty = VLC_TRUE;
 316
 317     val.psz_string = (char *)p_config->value.psz;
 318
 319     vlc_mutex_unlock( p_config->p_lock );
 320
 321     if( p_config->pf_callback )
 322     {
 323         p_config->pf_callback( p_this, psz_name, oldval, val,
 324                                p_config->p_callback_data );
 325     }
 326
 327     /* free old string */
 328     if( oldval.psz_string ) free( oldval.psz_string );
 329 }
 330
 331 /*****************************************************************************
 332  * config_PutInt: set the integer value of an int variable
 333  *****************************************************************************
 334  * This function is used to set the value of variables which are internally
 335  * represented by an integer (CONFIG_ITEM_INTEGER and
 336  * CONFIG_ITEM_BOOL).
 337  *****************************************************************************/
 338 void __config_PutInt( vlc_object_t *p_this, const char *psz_name, int i_value )
 339 {
 340     module_config_t *p_config;
 341     vlc_value_t oldval, val;
 342
 343     p_config = config_FindConfig( p_this, psz_name );
 344
 345     /* sanity checks */
 346     if( !p_config )
 347     {
 348         msg_Warn( p_this, "option %s does not exist", psz_name );
 349         return;
 350     }
 351
 352     if (!IsConfigIntegerType (p_config->i_type))
 353     {
 354         msg_Err( p_this, "option %s does not refer to an int", psz_name );
 355         return;
 356     }
 357
 358     /* backup old value */
 359     oldval.i_int = p_config->value.i;
 360
 361     /* if i_min == i_max == 0, then do not use them */
 362     if ((p_config->min.i == 0) && (p_config->max.i == 0))
 363     {
 364         p_config->value.i = i_value;
 365     }
 366     else if (i_value < p_config->min.i)
 367     {
 368         p_config->value.i = p_config->min.i;
 369     }
 370     else if (i_value > p_config->max.i)
 371     {
 372         p_config->value.i = p_config->max.i;
 373     }
 374     else
 375     {
 376         p_config->value.i = i_value;
 377     }
 378
 379     p_config->b_dirty = VLC_TRUE;
 380
 381     val.i_int = p_config->value.i;
 382
 383     if( p_config->pf_callback )
 384     {
 385         p_config->pf_callback( p_this, psz_name, oldval, val,
 386                                p_config->p_callback_data );
 387     }
 388 }
 389
 390 /*****************************************************************************
 391  * config_PutFloat: set the value of a float variable
 392  *****************************************************************************
 393  * This function is used to set the value of variables which are internally
 394  * represented by a float (CONFIG_ITEM_FLOAT).
 395  *****************************************************************************/
 396 void __config_PutFloat( vlc_object_t *p_this,
 397                         const char *psz_name, float f_value )
 398 {
 399     module_config_t *p_config;
 400     vlc_value_t oldval, val;
 401
 402     p_config = config_FindConfig( p_this, psz_name );
 403
 404     /* sanity checks */
 405     if( !p_config )
 406     {
 407         msg_Warn( p_this, "option %s does not exist", psz_name );
 408         return;
 409     }
 410
 411     if (!IsConfigFloatType (p_config->i_type))
 412     {
 413         msg_Err( p_this, "option %s does not refer to a float", psz_name );
 414         return;
 415     }
 416
 417     /* backup old value */
 418     oldval.f_float = p_config->value.f;
 419
 420     /* if f_min == f_max == 0, then do not use them */
 421     if ((p_config->min.f == 0) && (p_config->max.f == 0))
 422     {
 423         p_config->value.f = f_value;
 424     }
 425     else if (f_value < p_config->min.f)
 426     {
 427         p_config->value.f = p_config->min.f;
 428     }
 429     else if (f_value > p_config->max.f)
 430     {
 431         p_config->value.f = p_config->max.f;
 432     }
 433     else
 434     {
 435         p_config->value.f = f_value;
 436     }
 437
 438     p_config->b_dirty = VLC_TRUE;
 439
 440     val.f_float = p_config->value.f;
 441
 442     if( p_config->pf_callback )
 443     {
 444         p_config->pf_callback( p_this, psz_name, oldval, val,
 445                                p_config->p_callback_data );
 446     }
 447 }
 448
 449 /*****************************************************************************
 450  * config_FindConfig: find the config structure associated with an option.
 451  *****************************************************************************
 452  * FIXME: This function really needs to be optimized.
 453  * FIXME: And now even more.
 454  *****************************************************************************/
 455 module_config_t *config_FindConfig( vlc_object_t *p_this, const char *psz_name )
 456 {
 457     vlc_list_t *p_list;
 458     int i_index;
 459
 460     if( !psz_name ) return NULL;
 461
 462     p_list = vlc_list_find( p_this, VLC_OBJECT_MODULE, FIND_ANYWHERE );
 463
 464     for( i_index = 0; i_index < p_list->i_count; i_index++ )
 465     {
 466         module_config_t *p_item, *p_end;
 467         module_t *p_parser = (module_t *)p_list->p_values[i_index].p_object;
 468
 469         if( !p_parser->i_config_items )
 470             continue;
 471
 472         for( p_item = p_parser->p_config, p_end = p_item + p_parser->confsize;
 473              p_item < p_end;
 474              p_item++ )
 475         {
 476             if( p_item->i_type & CONFIG_HINT )
 477                 /* ignore hints */
 478                 continue;
 479             if( !strcmp( psz_name, p_item->psz_name ) )
 480             {
 481                 vlc_list_release( p_list );
 482                 return p_item;
 483             }
 484         }
 485     }
 486
 487     vlc_list_release( p_list );
 488
 489     return NULL;
 490 }
 491
 492 /*****************************************************************************
 493  * config_FindModule: find a specific module structure.
 494  *****************************************************************************/
 495 module_t *config_FindModule( vlc_object_t *p_this, const char *psz_name )
 496 {
 497     vlc_list_t *p_list;
 498     module_t *p_module, *p_result = NULL;
 499     int i_index;
 500
 501     if( !psz_name ) return NULL;
 502
 503     p_list = vlc_list_find( p_this, VLC_OBJECT_MODULE, FIND_ANYWHERE );
 504
 505     for( i_index = 0; i_index < p_list->i_count; i_index++ )
 506     {
 507         p_module = (module_t *)p_list->p_values[i_index].p_object;
 508         if( !strcmp( p_module->psz_object_name, psz_name ) )
 509         {
 510              p_result = p_module;
 511              break;
 512         }
 513     }
 514
 515     vlc_list_release( p_list );
 516
 517     return p_result;
 518 }
 519
 520 /*****************************************************************************
 521  * config_Duplicate: creates a duplicate of a module's configuration data.
 522  *****************************************************************************
 523  * Unfortunatly we cannot work directly with the module's config data as
 524  * this module might be unloaded from memory at any time (remember HideModule).
 525  * This is why we need to create an exact copy of the config data.
 526  *****************************************************************************/
 527 int config_Duplicate( module_t *p_module, const module_config_t *p_orig,
 528                       size_t n )
 529 {
 530     int j;
 531     const module_config_t *p_item, *p_end = p_orig + n;
 532
 533     /* Calculate the structure length */
 534     p_module->i_config_items = 0;
 535     p_module->i_bool_items = 0;
 536
 537     for( p_item = p_orig; p_item < p_end; p_item++ )
 538     {
 539         if( p_item->i_type & CONFIG_ITEM )
 540         {
 541             p_module->i_config_items++;
 542         }
 543
 544         if( p_item->i_type == CONFIG_ITEM_BOOL )
 545         {
 546             p_module->i_bool_items++;
 547         }
 548     }
 549
 550     /* Allocate memory */
 551     p_module->p_config = (module_config_t *)calloc( n, sizeof(*p_orig) );
 552     if( p_module->p_config == NULL )
 553     {
 554         msg_Err( p_module, "config error: can't duplicate p_config" );
 555         return VLC_ENOMEM;
 556     }
 557     p_module->confsize = n;
 558
 559     /* Do the duplication job */
 560     for( size_t i = 0; i < n ; i++ )
 561     {
 562         p_module->p_config[i] = p_orig[i];
 563
 564         if (IsConfigIntegerType (p_module->p_config[i].i_type))
 565         {
 566             p_module->p_config[i].orig.i = p_orig[i].value.i;
 567             p_module->p_config[i].saved.i = p_orig[i].value.i;
 568         }
 569         else
 570         if (IsConfigFloatType (p_module->p_config[i].i_type))
 571         {
 572             p_module->p_config[i].orig.f = p_orig[i].value.f;
 573             p_module->p_config[i].saved.f = p_orig[i].value.f;
 574         }
 575         else
 576         if (IsConfigStringType (p_module->p_config[i].i_type))
 577         {
 578             p_module->p_config[i].value.psz = strdupnull (p_orig[i].value.psz);
 579             p_module->p_config[i].orig.psz = strdupnull (p_orig[i].value.psz);
 580             p_module->p_config[i].saved.psz = NULL;
 581         }
 582
 583         p_module->p_config[i].psz_type = strdupnull (p_orig[i].psz_type);
 584         p_module->p_config[i].psz_name = strdupnull (p_orig[i].psz_name);
 585         p_module->p_config[i].psz_current = strdupnull (p_orig[i].psz_current);
 586         p_module->p_config[i].psz_text = _strdupnull (p_orig[i].psz_text);
 587         p_module->p_config[i].psz_longtext = _strdupnull (p_orig[i].psz_longtext);
 588
 589         p_module->p_config[i].p_lock = &p_module->object_lock;
 590
 591         /* duplicate the string list */
 592         if( p_orig[i].i_list )
 593         {
 594             if( p_orig[i].ppsz_list )
 595             {
 596                 p_module->p_config[i].ppsz_list =
 597                     malloc( (p_orig[i].i_list + 1) * sizeof(char *) );
 598                 if( p_module->p_config[i].ppsz_list )
 599                 {
 600                     for( j = 0; j < p_orig[i].i_list; j++ )
 601                         p_module->p_config[i].ppsz_list[j] =
 602                                 strdupnull (p_orig[i].ppsz_list[j]);
 603                     p_module->p_config[i].ppsz_list[j] = NULL;
 604                 }
 605             }
 606             if( p_orig[i].ppsz_list_text )
 607             {
 608                 p_module->p_config[i].ppsz_list_text =
 609                     calloc( (p_orig[i].i_list + 1), sizeof(char *) );
 610                 if( p_module->p_config[i].ppsz_list_text )
 611                 {
 612                     for( j = 0; j < p_orig[i].i_list; j++ )
 613                         p_module->p_config[i].ppsz_list_text[j] =
 614                                 strdupnull (_(p_orig[i].ppsz_list_text[j]));
 615                     p_module->p_config[i].ppsz_list_text[j] = NULL;
 616                 }
 617             }
 618             if( p_orig[i].pi_list )
 619             {
 620                 p_module->p_config[i].pi_list =
 621                     malloc( (p_orig[i].i_list + 1) * sizeof(int) );
 622                 if( p_module->p_config[i].pi_list )
 623                 {
 624                     for( j = 0; j < p_orig[i].i_list; j++ )
 625                         p_module->p_config[i].pi_list[j] =
 626                             p_orig[i].pi_list[j];
 627                 }
 628             }
 629         }
 630
 631         /* duplicate the actions list */
 632         if( p_orig[i].i_action )
 633         {
 634             int j;
 635
 636             p_module->p_config[i].ppf_action =
 637                 malloc( p_orig[i].i_action * sizeof(void *) );
 638             p_module->p_config[i].ppsz_action_text =
 639                 malloc( p_orig[i].i_action * sizeof(char *) );
 640
 641             for( j = 0; j < p_orig[i].i_action; j++ )
 642             {
 643                 p_module->p_config[i].ppf_action[j] =
 644                     p_orig[i].ppf_action[j];
 645                 p_module->p_config[i].ppsz_action_text[j] =
 646                     strdupnull (p_orig[i].ppsz_action_text[j]);
 647             }
 648         }
 649
 650         p_module->p_config[i].pf_callback = p_orig[i].pf_callback;
 651     }
 652     return VLC_SUCCESS;
 653 }
 654
 655
 656 /*****************************************************************************
 657  * config_Free: frees a duplicated module's configuration data.
 658  *****************************************************************************
 659  * This function frees all the data duplicated by config_Duplicate.
 660  *****************************************************************************/
 661 void config_Free( module_t *p_module )
 662 {
 663     int i;
 664
 665     for (size_t j = 0; j < p_module->confsize; j++)
 666     {
 667         module_config_t *p_item = p_module->p_config + j;
 668
 669         free( (char*) p_item->psz_type );
 670         free( (char*) p_item->psz_name );
 671         free( (char*) p_item->psz_current );
 672         free( (char*) p_item->psz_text );
 673         free( (char*) p_item->psz_longtext );
 674
 675         if (IsConfigStringType (p_item->i_type))
 676         {
 677             free ((char *)p_item->value.psz);
 678             free ((char *)p_item->orig.psz);
 679             free ((char *)p_item->saved.psz);
 680         }
 681
 682         if( p_item->i_list )
 683         {
 684             for( i = 0; i < p_item->i_list; i++ )
 685             {
 686                 if( p_item->ppsz_list && p_item->ppsz_list[i] )
 687                     free( (char*) p_item->ppsz_list[i] );
 688                 if( p_item->ppsz_list_text && p_item->ppsz_list_text[i] )
 689                     free( (char*) p_item->ppsz_list_text[i] );
 690             }
 691             if( p_item->ppsz_list ) free( p_item->ppsz_list );
 692             if( p_item->ppsz_list_text ) free( p_item->ppsz_list_text );
 693             if( p_item->pi_list ) free( p_item->pi_list );
 694         }
 695
 696         if( p_item->i_action )
 697         {
 698             for( i = 0; i < p_item->i_action; i++ )
 699             {
 700                 free( (char*) p_item->ppsz_action_text[i] );
 701             }
 702             if( p_item->ppf_action ) free( p_item->ppf_action );
 703             if( p_item->ppsz_action_text ) free( p_item->ppsz_action_text );
 704         }
 705     }
 706
 707     if (p_module->p_config != NULL)
 708     {
 709         free (p_module->p_config);
 710         p_module->p_config = NULL;
 711     }
 712 }
 713
 714 /*****************************************************************************
 715  * config_SetCallbacks: sets callback functions in the duplicate p_config.
 716  *****************************************************************************
 717  * Unfortunatly we cannot work directly with the module's config data as
 718  * this module might be unloaded from memory at any time (remember HideModule).
 719  * This is why we need to duplicate callbacks each time we reload the module.
 720  *****************************************************************************/
 721 void config_SetCallbacks( module_config_t *p_new, module_config_t *p_orig,
 722                           size_t n )
 723 {
 724     for (size_t i = 0; i < n; i++)
 725     {
 726         p_new->pf_callback = p_orig->pf_callback;
 727         p_new++;
 728         p_orig++;
 729     }
 730 }
 731
 732 /*****************************************************************************
 733  * config_UnsetCallbacks: unsets callback functions in the duplicate p_config.
 734  *****************************************************************************
 735  * We simply undo what we did in config_SetCallbacks.
 736  *****************************************************************************/
 737 void config_UnsetCallbacks( module_config_t *p_new, size_t n )
 738 {
 739     for (size_t i = 0; i < n; i++)
 740     {
 741         p_new->pf_callback = NULL;
 742         p_new++;
 743     }
 744 }
 745
 746 /*****************************************************************************
 747  * config_ResetAll: reset the configuration data for all the modules.
 748  *****************************************************************************/
 749 void __config_ResetAll( vlc_object_t *p_this )
 750 {
 751     int i_index;
 752     vlc_list_t *p_list;
 753     module_t *p_module;
 754
 755     /* Acquire config file lock */
 756     vlc_mutex_lock( &p_this->p_libvlc->config_lock );
 757
 758     p_list = vlc_list_find( p_this, VLC_OBJECT_MODULE, FIND_ANYWHERE );
 759
 760     for( i_index = 0; i_index < p_list->i_count; i_index++ )
 761     {
 762         p_module = (module_t *)p_list->p_values[i_index].p_object ;
 763         if( p_module->b_submodule ) continue;
 764
 765         for (size_t i = 0; i < p_module->confsize; i++ )
 766         {
 767             if (IsConfigIntegerType (p_module->p_config[i].i_type))
 768                 p_module->p_config[i].value.i = p_module->p_config[i].orig.i;
 769             else
 770             if (IsConfigFloatType (p_module->p_config[i].i_type))
 771                 p_module->p_config[i].value.f = p_module->p_config[i].orig.f;
 772             else
 773             if (IsConfigStringType (p_module->p_config[i].i_type))
 774             {
 775                 free ((char *)p_module->p_config[i].value.psz);
 776                 p_module->p_config[i].value.psz =
 777                         strdupnull (p_module->p_config[i].orig.psz);
 778             }
 779         }
 780     }
 781
 782     vlc_list_release( p_list );
 783     vlc_mutex_unlock( &p_this->p_libvlc->config_lock );
 784 }
 785
 786
 787 static FILE *config_OpenConfigFile( vlc_object_t *p_obj, const char *mode )
 788 {
 789     char *psz_filename = p_obj->p_libvlc->psz_configfile;
 790     FILE *p_stream;
 791
 792     if( !psz_filename )
 793     {
 794         psz_filename = config_GetConfigFile( p_obj->p_libvlc );
 795     }
 796
 797     msg_Dbg( p_obj, "opening config file (%s)", psz_filename );
 798
 799     p_stream = utf8_fopen( psz_filename, mode );
 800     if( p_stream == NULL && errno != ENOENT )
 801     {
 802         msg_Err( p_obj, "cannot open config file (%s): %m",
 803                  psz_filename );
 804
 805     }
 806 #if !( defined(WIN32) || defined(__APPLE__) || defined(SYS_BEOS) )
 807     else if( p_stream == NULL && errno == ENOENT && mode[0] == 'r' )
 808     {
 809         /* This is the fallback for pre XDG Base Directory
 810          * Specification configs */
 811         char *psz_old;
 812         if( asprintf( &psz_old, "%s" DIR_SEP CONFIG_DIR DIR_SEP CONFIG_FILE,
 813                   p_obj->p_libvlc->psz_homedir ) != -1 )
 814         {
 815             p_stream = utf8_fopen( psz_old, mode );
 816             if( p_stream )
 817             {
 818                 /* Old config file found. We want to write it at the
 819                  * new location now. */
 820                 msg_Info( p_obj->p_libvlc, "Found old config file at %s. "
 821                           "VLC will now use %s.", psz_old, psz_filename );
 822                 char *psz_readme;
 823                 if( asprintf(&psz_readme,"%s"DIR_SEP CONFIG_DIR DIR_SEP"README",
 824                               p_obj->p_libvlc->psz_homedir ) != -1 )
 825                 {
 826                     FILE *p_readme = utf8_fopen( psz_readme, "wt" );
 827                     if( p_readme )
 828                     {
 829                         fputs( "The VLC media player configuration folder has "
 830                                "moved to comply with the XDG Base "
 831                                "Directory Specification version 0.6. Your "
 832                                "configuration has been copied to the new "
 833                                "location (", p_readme );
 834                         fputs( p_obj->p_libvlc->psz_configdir, p_readme );
 835                         fputs( "). You can delete this directory and "
 836                                "all its contents.", p_readme );
 837                         fclose( p_readme );
 838                     }
 839                     free( psz_readme );
 840                 }
 841             }
 842             free( psz_old );
 843         }
 844     }
 845 #endif
 846     else if( p_stream != NULL )
 847     {
 848         p_obj->p_libvlc->psz_configfile = psz_filename;
 849     }
 850
 851     return p_stream;
 852 }
 853
 854
 855 static int strtoi (const char *str)
 856 {
 857     char *end;
 858     long l;
 859
 860     errno = 0;
 861     l = strtol (str, &end, 0);
 862
 863     if (!errno)
 864     {
 865         if ((l > INT_MAX) || (l < INT_MIN))
 866             errno = ERANGE;
 867         if (*end)
 868             errno = EINVAL;
 869     }
 870     return (int)l;
 871 }
 872
 873
 874 /*****************************************************************************
 875  * config_LoadConfigFile: loads the configuration file.
 876  *****************************************************************************
 877  * This function is called to load the config options stored in the config
 878  * file.
 879  *****************************************************************************/
 880 int __config_LoadConfigFile( vlc_object_t *p_this, const char *psz_module_name )
 881 {
 882     vlc_list_t *p_list;
 883     FILE *file;
 884
 885     file = config_OpenConfigFile (p_this, "rt");
 886     if (file == NULL)
 887         return VLC_EGENERIC;
 888
 889     /* Acquire config file lock */
 890     vlc_mutex_lock( &p_this->p_libvlc->config_lock );
 891
 892     /* Look for the selected module, if NULL then save everything */
 893     p_list = vlc_list_find( p_this, VLC_OBJECT_MODULE, FIND_ANYWHERE );
 894
 895     /* Look for UTF-8 Byte Order Mark */
 896     char * (*convert) (const char *) = strdupnull;
 897     char bom[3];
 898
 899     if ((fread (bom, 1, 3, file) != 3)
 900      || memcmp (bom, "\xEF\xBB\xBF", 3))
 901     {
 902         convert = FromLocaleDup;
 903         rewind (file); /* no BOM, rewind */
 904     }
 905
 906     module_t *module = NULL;
 907     char line[1024], section[1022];
 908     section[0] = '\0';
 909
 910     while (fgets (line, 1024, file) != NULL)
 911     {
 912         /* Ignore comments and empty lines */
 913         switch (line[0])
 914         {
 915             case '#':
 916             case '\n':
 917             case '\0':
 918                 continue;
 919         }
 920
 921         if (line[0] == '[')
 922         {
 923             char *ptr = strchr (line, ']');
 924             if (ptr == NULL)
 925                 continue; /* syntax error; */
 926             *ptr = '\0';
 927
 928             /* New section ( = a given module) */
 929             strcpy (section, line + 1);
 930             module = NULL;
 931
 932             if ((psz_module_name == NULL)
 933              || (strcmp (psz_module_name, section) == 0))
 934             {
 935                 for (int i = 0; i < p_list->i_count; i++)
 936                 {
 937                     module_t *m = (module_t *)p_list->p_values[i].p_object;
 938
 939                     if ((strcmp (section, m->psz_object_name) == 0)
 940                      && (m->i_config_items > 0)) /* ignore config-less modules */
 941                     {
 942                         module = m;
 943                         if (psz_module_name != NULL)
 944                             msg_Dbg (p_this,
 945                                      "loading config for module \"%s\"",
 946                                      section);
 947                         break;
 948                     }
 949                 }
 950             }
 951
 952             continue;
 953         }
 954
 955         if (module == NULL)
 956             continue; /* no need to parse if there is no matching module */
 957
 958         char *ptr = strchr (line, '\n');
 959         if (ptr != NULL)
 960             *ptr = '\0';
 961
 962         /* look for option name */
 963         const char *psz_option_name = line;
 964
 965         ptr = strchr (line, '=');
 966         if (ptr == NULL)
 967             continue; /* syntax error */
 968
 969         *ptr = '\0';
 970         const char *psz_option_value = ptr + 1;
 971
 972         /* try to match this option with one of the module's options */
 973         for (size_t i = 0; i < module->confsize; i++)
 974         {
 975             module_config_t *p_item = module->p_config + i;
 976
 977             if ((p_item->i_type & CONFIG_HINT)
 978              || strcmp (p_item->psz_name, psz_option_name))
 979                 continue;
 980
 981             /* We found it */
 982             errno = 0;
 983
 984             switch( p_item->i_type )
 985             {
 986                 case CONFIG_ITEM_BOOL:
 987                 case CONFIG_ITEM_INTEGER:
 988                 {
 989                     long l = strtoi (psz_option_value);
 990                     if (errno)
 991                         msg_Warn (p_this, "Integer value (%s) for %s: %m",
 992                                   psz_option_value, psz_option_name);
 993                     else
 994                         p_item->saved.i = p_item->value.i = (int)l;
 995                     break;
 996                 }
 997
 998                 case CONFIG_ITEM_FLOAT:
 999                     if( !*psz_option_value )
1000                         break;                    /* ignore empty option */
1001                     p_item->value.f = (float)i18n_atof( psz_option_value);
1002                     p_item->saved.f = p_item->value.f;
1003                     break;
1004
1005                 case CONFIG_ITEM_KEY:
1006                     if( !*psz_option_value )
1007                         break;                    /* ignore empty option */
1008                     p_item->value.i = ConfigStringToKey(psz_option_value);
1009                     p_item->saved.i = p_item->value.i;
1010                     break;
1011
1012                 default:
1013                     vlc_mutex_lock( p_item->p_lock );
1014
1015                     /* free old string */
1016                     free( (char*) p_item->value.psz );
1017                     free( (char*) p_item->saved.psz );
1018
1019                     p_item->value.psz = convert (psz_option_value);
1020                     p_item->saved.psz = strdupnull (p_item->value.psz);
1021
1022                     vlc_mutex_unlock( p_item->p_lock );
1023                     break;
1024             }
1025
1026             break;
1027         }
1028     }
1029
1030     if (ferror (file))
1031     {
1032         msg_Err (p_this, "error reading configuration: %m");
1033         clearerr (file);
1034     }
1035     fclose (file);
1036
1037     vlc_list_release( p_list );
1038
1039     vlc_mutex_unlock( &p_this->p_libvlc->config_lock );
1040     return 0;
1041 }
1042
1043 /*****************************************************************************
1044  * config_CreateDir: Create configuration directory if it doesn't exist.
1045  *****************************************************************************/
1046 int config_CreateDir( vlc_object_t *p_this, const char *psz_dirname )
1047 {
1048     if( !psz_dirname && !*psz_dirname ) return -1;
1049
1050     if( utf8_mkdir( psz_dirname, 0700 ) == 0 )
1051         return 0;
1052
1053     switch( errno )
1054     {
1055         case EEXIST:
1056             return 0;
1057
1058         case ENOENT:
1059         {
1060             /* Let's try to create the parent directory */
1061             char psz_parent[strlen( psz_dirname ) + 1], *psz_end;
1062             strcpy( psz_parent, psz_dirname );
1063
1064             psz_end = strrchr( psz_parent, DIR_SEP_CHAR );
1065             if( psz_end && psz_end != psz_parent )
1066             {
1067                 *psz_end = '\0';
1068                 if( config_CreateDir( p_this, psz_parent ) == 0 )
1069                 {
1070                     if( !utf8_mkdir( psz_dirname, 0700 ) )
1071                         return 0;
1072                 }
1073             }
1074         }
1075     }
1076
1077     msg_Err( p_this, "could not create %s: %m", psz_dirname );
1078     return -1;
1079 }
1080
1081 /*****************************************************************************
1082  * config_SaveConfigFile: Save a module's config options.
1083  *****************************************************************************
1084  * This will save the specified module's config options to the config file.
1085  * If psz_module_name is NULL then we save all the modules config options.
1086  * It's no use to save the config options that kept their default values, so
1087  * we'll try to be a bit clever here.
1088  *
1089  * When we save we mustn't delete the config options of the modules that
1090  * haven't been loaded. So we cannot just create a new config file with the
1091  * config structures we've got in memory.
1092  * I don't really know how to deal with this nicely, so I will use a completly
1093  * dumb method ;-)
1094  * I will load the config file in memory, but skipping all the sections of the
1095  * modules we want to save. Then I will create a brand new file, dump the file
1096  * loaded in memory and then append the sections of the modules we want to
1097  * save.
1098  * Really stupid no ?
1099  *****************************************************************************/
1100 static int SaveConfigFile( vlc_object_t *p_this, const char *psz_module_name,
1101                            vlc_bool_t b_autosave )
1102 {
1103     module_t *p_parser;
1104     vlc_list_t *p_list;
1105     FILE *file;
1106     char p_line[1024], *p_index2;
1107     int i_sizebuf = 0;
1108     char *p_bigbuffer, *p_index;
1109     vlc_bool_t b_backup;
1110     int i_index;
1111
1112     /* Acquire config file lock */
1113     vlc_mutex_lock( &p_this->p_libvlc->config_lock );
1114
1115     if( p_this->p_libvlc->psz_configfile == NULL )
1116     {
1117         const char *psz_configdir = p_this->p_libvlc->psz_configdir;
1118         if( !psz_configdir ) /* XXX: This should never happen */
1119         {
1120             msg_Err( p_this, "no configuration directory defined" );
1121             vlc_mutex_unlock( &p_this->p_libvlc->config_lock );
1122             return -1;
1123         }
1124
1125         config_CreateDir( p_this, psz_configdir );
1126     }
1127
1128     file = config_OpenConfigFile( p_this, "rt" );
1129     if( file != NULL )
1130     {
1131         /* look for file size */
1132         fseek( file, 0L, SEEK_END );
1133         i_sizebuf = ftell( file );
1134         fseek( file, 0L, SEEK_SET );
1135     }
1136
1137     p_bigbuffer = p_index = malloc( i_sizebuf+1 );
1138     if( !p_bigbuffer )
1139     {
1140         msg_Err( p_this, "out of memory" );
1141         if( file ) fclose( file );
1142         vlc_mutex_unlock( &p_this->p_libvlc->config_lock );
1143         return -1;
1144     }
1145     p_bigbuffer[0] = 0;
1146
1147     /* List all available modules */
1148     p_list = vlc_list_find( p_this, VLC_OBJECT_MODULE, FIND_ANYWHERE );
1149
1150     /* backup file into memory, we only need to backup the sections we won't
1151      * save later on */
1152     b_backup = 0;
1153     while( file && fgets( p_line, 1024, file ) )
1154     {
1155         if( (p_line[0] == '[') && (p_index2 = strchr(p_line,']')))
1156         {
1157
1158             /* we found a section, check if we need to do a backup */
1159             for( i_index = 0; i_index < p_list->i_count; i_index++ )
1160             {
1161                 p_parser = (module_t *)p_list->p_values[i_index].p_object ;
1162
1163                 if( ((p_index2 - &p_line[1])
1164                        == (int)strlen(p_parser->psz_object_name) )
1165                     && !memcmp( &p_line[1], p_parser->psz_object_name,
1166                                 strlen(p_parser->psz_object_name) ) )
1167                 {
1168                     if( !psz_module_name )
1169                         break;
1170                     else if( !strcmp( psz_module_name,
1171                                       p_parser->psz_object_name ) )
1172                         break;
1173                 }
1174             }
1175
1176             if( i_index == p_list->i_count )
1177             {
1178                 /* we don't have this section in our list so we need to back
1179                  * it up */
1180                 *p_index2 = 0;
1181 #if 0
1182                 msg_Dbg( p_this, "backing up config for unknown module \"%s\"",
1183                                  &p_line[1] );
1184 #endif
1185                 *p_index2 = ']';
1186
1187                 b_backup = 1;
1188             }
1189             else
1190             {
1191                 b_backup = 0;
1192             }
1193         }
1194
1195         /* save line if requested and line is valid (doesn't begin with a
1196          * space, tab, or eol) */
1197         if( b_backup && (p_line[0] != '\n') && (p_line[0] != ' ')
1198             && (p_line[0] != '\t') )
1199         {
1200             strcpy( p_index, p_line );
1201             p_index += strlen( p_line );
1202         }
1203     }
1204     if( file ) fclose( file );
1205
1206
1207     /*
1208      * Save module config in file
1209      */
1210
1211     file = config_OpenConfigFile (p_this, "wt");
1212     if( !file )
1213     {
1214         vlc_list_release( p_list );
1215         free( p_bigbuffer );
1216         vlc_mutex_unlock( &p_this->p_libvlc->config_lock );
1217         return -1;
1218     }
1219
1220     fprintf( file, "\xEF\xBB\xBF###\n###  " COPYRIGHT_MESSAGE "\n###\n\n"
1221        "###\n### lines begining with a '#' character are comments\n###\n\n" );
1222
1223     /* Look for the selected module, if NULL then save everything */
1224     for( i_index = 0; i_index < p_list->i_count; i_index++ )
1225     {
1226         module_config_t *p_item, *p_end;
1227         p_parser = (module_t *)p_list->p_values[i_index].p_object ;
1228
1229         if( psz_module_name && strcmp( psz_module_name,
1230                                        p_parser->psz_object_name ) )
1231             continue;
1232
1233         if( !p_parser->i_config_items )
1234             continue;
1235
1236         if( psz_module_name )
1237             msg_Dbg( p_this, "saving config for module \"%s\"",
1238                      p_parser->psz_object_name );
1239
1240         fprintf( file, "[%s]", p_parser->psz_object_name );
1241         if( p_parser->psz_longname )
1242             fprintf( file, " # %s\n\n", p_parser->psz_longname );
1243         else
1244             fprintf( file, "\n\n" );
1245
1246         for( p_item = p_parser->p_config, p_end = p_item + p_parser->confsize;
1247              p_item < p_end;
1248              p_item++ )
1249         {
1250             char  *psz_key;
1251             int   i_value = p_item->value.i;
1252             float f_value = p_item->value.f;
1253             const char  *psz_value = p_item->value.psz;
1254
1255             if( p_item->i_type & CONFIG_HINT )
1256                 /* ignore hints */
1257                 continue;
1258             /* Ignore deprecated options */
1259             if( p_item->psz_current )
1260                 continue;
1261             if( p_item->b_unsaveable )
1262                 /*obvious*/
1263                 continue;
1264
1265             if( b_autosave && !p_item->b_autosave )
1266             {
1267                 i_value = p_item->saved.i;
1268                 f_value = p_item->saved.f;
1269                 psz_value = p_item->saved.psz;
1270                 if( !psz_value ) psz_value = p_item->orig.psz;
1271             }
1272             else
1273             {
1274                 p_item->b_dirty = VLC_FALSE;
1275             }
1276
1277             switch( p_item->i_type )
1278             {
1279             case CONFIG_ITEM_BOOL:
1280             case CONFIG_ITEM_INTEGER:
1281                 if( p_item->psz_text )
1282                     fprintf( file, "# %s (%s)\n", p_item->psz_text,
1283                              (p_item->i_type == CONFIG_ITEM_BOOL) ?
1284                              _("boolean") : _("integer") );
1285                 if( i_value == p_item->orig.i )
1286                     fputc ('#', file);
1287                 fprintf( file, "%s=%i\n", p_item->psz_name, i_value );
1288
1289                 p_item->saved.i = i_value;
1290                 break;
1291
1292             case CONFIG_ITEM_KEY:
1293                 if( p_item->psz_text )
1294                     fprintf( file, "# %s (%s)\n", p_item->psz_text,
1295                              _("key") );
1296                 if( i_value == p_item->orig.i )
1297                     fputc ('#', file);
1298                 psz_key = ConfigKeyToString( i_value );
1299                 fprintf( file, "%s=%s\n", p_item->psz_name,
1300                          psz_key ? psz_key : "" );
1301                 free (psz_key);
1302
1303                 p_item->saved.i = i_value;
1304                 break;
1305
1306             case CONFIG_ITEM_FLOAT:
1307                 if( p_item->psz_text )
1308                     fprintf( file, "# %s (%s)\n", p_item->psz_text,
1309                              _("float") );
1310                 if( f_value == p_item->orig.f )
1311                     fputc ('#', file);
1312                 fprintf( file, "%s=%f\n", p_item->psz_name, (double)f_value );
1313
1314                 p_item->saved.f = f_value;
1315                 break;
1316
1317             default:
1318                 if( p_item->psz_text )
1319                     fprintf( file, "# %s (%s)\n", p_item->psz_text,
1320                              _("string") );
1321                 if( (!psz_value && !p_item->orig.psz) ||
1322                     (psz_value && p_item->orig.psz &&
1323                      !strcmp( psz_value, p_item->orig.psz )) )
1324                     fputc ('#', file);
1325                 fprintf( file, "%s=%s\n", p_item->psz_name,
1326                          psz_value ?: "" );
1327
1328                 if( b_autosave && !p_item->b_autosave ) break;
1329
1330                 free ((char *)p_item->saved.psz);
1331                 if( (psz_value && p_item->orig.psz &&
1332                      strcmp( psz_value, p_item->orig.psz )) ||
1333                     !psz_value || !p_item->orig.psz)
1334                     p_item->saved.psz = strdupnull (psz_value);
1335                 else
1336                     p_item->saved.psz = NULL;
1337             }
1338         }
1339
1340         fputc ('\n', file);
1341     }
1342
1343     vlc_list_release( p_list );
1344
1345     /*
1346      * Restore old settings from the config in file
1347      */
1348     fputs( p_bigbuffer, file );
1349     free( p_bigbuffer );
1350
1351     fclose( file );
1352     vlc_mutex_unlock( &p_this->p_libvlc->config_lock );
1353
1354     return 0;
1355 }
1356
1357 int config_AutoSaveConfigFile( vlc_object_t *p_this )
1358 {
1359     vlc_list_t *p_list;
1360     int i_index, i_count;
1361
1362     if( !p_this ) return -1;
1363
1364     /* Check if there's anything to save */
1365     vlc_mutex_lock( &p_this->p_libvlc->config_lock );
1366     p_list = vlc_list_find( p_this, VLC_OBJECT_MODULE, FIND_ANYWHERE );
1367     i_count = p_list->i_count;
1368     for( i_index = 0; i_index < i_count; i_index++ )
1369     {
1370         module_t *p_parser = (module_t *)p_list->p_values[i_index].p_object ;
1371         module_config_t *p_item, *p_end;
1372
1373         if( !p_parser->i_config_items ) continue;
1374
1375         for( p_item = p_parser->p_config, p_end = p_item + p_parser->confsize;
1376              p_item < p_end;
1377              p_item++ )
1378         {
1379             if( p_item->b_autosave && p_item->b_dirty ) break;
1380         }
1381         break;
1382     }
1383     vlc_list_release( p_list );
1384     vlc_mutex_unlock( &p_this->p_libvlc->config_lock );
1385
1386     if( i_index == i_count ) return VLC_SUCCESS;
1387     return SaveConfigFile( p_this, 0, VLC_TRUE );
1388 }
1389
1390 int __config_SaveConfigFile( vlc_object_t *p_this, const char *psz_module_name )
1391 {
1392     return SaveConfigFile( p_this, psz_module_name, VLC_FALSE );
1393 }
1394
1395 /*****************************************************************************
1396  * config_LoadCmdLine: parse command line
1397  *****************************************************************************
1398  * Parse command line for configuration options.
1399  * Now that the module_bank has been initialized, we can dynamically
1400  * generate the longopts structure used by getops. We have to do it this way
1401  * because we don't know (and don't want to know) in advance the configuration
1402  * options used (ie. exported) by each module.
1403  *****************************************************************************/
1404 int __config_LoadCmdLine( vlc_object_t *p_this, int *pi_argc, char *ppsz_argv[],
1405                           vlc_bool_t b_ignore_errors )
1406 {
1407     int i_cmd, i_index, i_opts, i_shortopts, flag, i_verbose = 0;
1408     module_t *p_parser;
1409     vlc_list_t *p_list;
1410     struct option *p_longopts;
1411     int i_modules_index;
1412
1413     /* Short options */
1414     module_config_t *pp_shortopts[256];
1415     char *psz_shortopts;
1416
1417     /* Set default configuration and copy arguments */
1418     p_this->p_libvlc->i_argc    = *pi_argc;
1419     p_this->p_libvlc->ppsz_argv = ppsz_argv;
1420
1421 #ifdef __APPLE__
1422     /* When VLC.app is run by double clicking in Mac OS X, the 2nd arg
1423      * is the PSN - process serial number (a unique PID-ish thingie)
1424      * still ok for real Darwin & when run from command line */
1425     if ( (*pi_argc > 1) && (strncmp( ppsz_argv[ 1 ] , "-psn" , 4 ) == 0) )
1426                                         /* for example -psn_0_9306113 */
1427     {
1428         /* GDMF!... I can't do this or else the MacOSX window server will
1429          * not pick up the PSN and not register the app and we crash...
1430          * hence the following kludge otherwise we'll get confused w/ argv[1]
1431          * being an input file name */
1432 #if 0
1433         ppsz_argv[ 1 ] = NULL;
1434 #endif
1435         *pi_argc = *pi_argc - 1;
1436         pi_argc--;
1437         return 0;
1438     }
1439 #endif
1440
1441     /* List all modules */
1442     p_list = vlc_list_find( p_this, VLC_OBJECT_MODULE, FIND_ANYWHERE );
1443
1444     /*
1445      * Generate the longopts and shortopts structures used by getopt_long
1446      */
1447
1448     i_opts = 0;
1449     for( i_modules_index = 0; i_modules_index < p_list->i_count;
1450          i_modules_index++ )
1451     {
1452         p_parser = (module_t *)p_list->p_values[i_modules_index].p_object ;
1453
1454         /* count the number of exported configuration options (to allocate
1455          * longopts). We also need to allocate space for two options when
1456          * dealing with boolean to allow for --foo and --no-foo */
1457         i_opts += p_parser->i_config_items
1458                      + 2 * p_parser->i_bool_items;
1459     }
1460
1461     p_longopts = malloc( sizeof(struct option) * (i_opts + 1) );
1462     if( p_longopts == NULL )
1463     {
1464         msg_Err( p_this, "out of memory" );
1465         vlc_list_release( p_list );
1466         return -1;
1467     }
1468
1469     psz_shortopts = malloc( sizeof( char ) * (2 * i_opts + 1) );
1470     if( psz_shortopts == NULL )
1471     {
1472         msg_Err( p_this, "out of memory" );
1473         free( p_longopts );
1474         vlc_list_release( p_list );
1475         return -1;
1476     }
1477
1478     /* If we are requested to ignore errors, then we must work on a copy
1479      * of the ppsz_argv array, otherwise getopt_long will reorder it for
1480      * us, ignoring the arity of the options */
1481     if( b_ignore_errors )
1482     {
1483         ppsz_argv = (char**)malloc( *pi_argc * sizeof(char *) );
1484         if( ppsz_argv == NULL )
1485         {
1486             msg_Err( p_this, "out of memory" );
1487             free( psz_shortopts );
1488             free( p_longopts );
1489             vlc_list_release( p_list );
1490             return -1;
1491         }
1492         memcpy( ppsz_argv, p_this->p_libvlc->ppsz_argv,
1493                 *pi_argc * sizeof(char *) );
1494     }
1495
1496     i_shortopts = 0;
1497     for( i_index = 0; i_index < 256; i_index++ )
1498     {
1499         pp_shortopts[i_index] = NULL;
1500     }
1501
1502     /* Fill the p_longopts and psz_shortopts structures */
1503     i_index = 0;
1504     for( i_modules_index = 0; i_modules_index < p_list->i_count;
1505          i_modules_index++ )
1506     {
1507         module_config_t *p_item, *p_end;
1508         p_parser = (module_t *)p_list->p_values[i_modules_index].p_object ;
1509
1510         if( !p_parser->i_config_items )
1511             continue;
1512
1513         for( p_item = p_parser->p_config, p_end = p_item + p_parser->confsize;
1514              p_item < p_end;
1515              p_item++ )
1516         {
1517             /* Ignore hints */
1518             if( p_item->i_type & CONFIG_HINT )
1519                 continue;
1520
1521             /* Add item to long options */
1522             p_longopts[i_index].name = strdup( p_item->psz_name );
1523             if( p_longopts[i_index].name == NULL ) continue;
1524             p_longopts[i_index].has_arg =
1525                 (p_item->i_type == CONFIG_ITEM_BOOL)?
1526                                                no_argument : required_argument;
1527             p_longopts[i_index].flag = &flag;
1528             p_longopts[i_index].val = 0;
1529             i_index++;
1530
1531             /* When dealing with bools we also need to add the --no-foo
1532              * option */
1533             if( p_item->i_type == CONFIG_ITEM_BOOL )
1534             {
1535                 char *psz_name = malloc( strlen(p_item->psz_name) + 3 );
1536                 if( psz_name == NULL ) continue;
1537                 strcpy( psz_name, "no" );
1538                 strcat( psz_name, p_item->psz_name );
1539
1540                 p_longopts[i_index].name = psz_name;
1541                 p_longopts[i_index].has_arg = no_argument;
1542                 p_longopts[i_index].flag = &flag;
1543                 p_longopts[i_index].val = 1;
1544                 i_index++;
1545
1546                 psz_name = malloc( strlen(p_item->psz_name) + 4 );
1547                 if( psz_name == NULL ) continue;
1548                 strcpy( psz_name, "no-" );
1549                 strcat( psz_name, p_item->psz_name );
1550
1551                 p_longopts[i_index].name = psz_name;
1552                 p_longopts[i_index].has_arg = no_argument;
1553                 p_longopts[i_index].flag = &flag;
1554                 p_longopts[i_index].val = 1;
1555                 i_index++;
1556             }
1557
1558             /* If item also has a short option, add it */
1559             if( p_item->i_short )
1560             {
1561                 pp_shortopts[(int)p_item->i_short] = p_item;
1562                 psz_shortopts[i_shortopts] = p_item->i_short;
1563                 i_shortopts++;
1564                 if( p_item->i_type != CONFIG_ITEM_BOOL )
1565                 {
1566                     psz_shortopts[i_shortopts] = ':';
1567                     i_shortopts++;
1568
1569                     if( p_item->i_short == 'v' )
1570                     {
1571                         psz_shortopts[i_shortopts] = ':';
1572                         i_shortopts++;
1573                     }
1574                 }
1575             }
1576         }
1577     }
1578
1579     /* We don't need the module list anymore */
1580     vlc_list_release( p_list );
1581
1582     /* Close the longopts and shortopts structures */
1583     memset( &p_longopts[i_index], 0, sizeof(struct option) );
1584     psz_shortopts[i_shortopts] = '\0';
1585
1586     /*
1587      * Parse the command line options
1588      */
1589     opterr = 0;
1590     optind = 0; /* set to 0 to tell GNU getopt to reinitialize */
1591     while( ( i_cmd = getopt_long( *pi_argc, ppsz_argv, psz_shortopts,
1592                                   p_longopts, &i_index ) ) != -1 )
1593     {
1594         /* A long option has been recognized */
1595         if( i_cmd == 0 )
1596         {
1597             module_config_t *p_conf;
1598             char *psz_name = (char *)p_longopts[i_index].name;
1599
1600             /* Check if we deal with a --nofoo or --no-foo long option */
1601             if( flag ) psz_name += psz_name[2] == '-' ? 3 : 2;
1602
1603             /* Store the configuration option */
1604             p_conf = config_FindConfig( p_this, psz_name );
1605             if( p_conf )
1606             {
1607                 /* Check if the option is deprecated */
1608                 if( p_conf->psz_current )
1609                 {
1610                     if( p_conf->b_strict )
1611                     {
1612                         fprintf(stderr,
1613                                 "Warning: option --%s no longer exists.\n",
1614                                 p_conf->psz_name);
1615                        continue;
1616                     }
1617
1618                     fprintf( stderr,
1619                              "%s: option --%s is deprecated. Use --%s instead.\n",
1620                              b_ignore_errors ? "Warning" : "Error",
1621                              p_conf->psz_name, p_conf->psz_current);
1622                     if( !b_ignore_errors )
1623                     {
1624                         /*free */
1625                         for( i_index = 0; p_longopts[i_index].name; i_index++ )
1626                              free( (char *)p_longopts[i_index].name );
1627
1628                         free( p_longopts );
1629                         free( psz_shortopts );
1630                         return -1;
1631                     }
1632
1633                     psz_name = (char *)p_conf->psz_current;
1634                     p_conf = config_FindConfig( p_this, psz_name );
1635                 }
1636
1637                 switch( p_conf->i_type )
1638                 {
1639                     case CONFIG_ITEM_STRING:
1640                     case CONFIG_ITEM_PASSWORD:
1641                     case CONFIG_ITEM_FILE:
1642                     case CONFIG_ITEM_DIRECTORY:
1643                     case CONFIG_ITEM_MODULE:
1644                     case CONFIG_ITEM_MODULE_LIST:
1645                     case CONFIG_ITEM_MODULE_LIST_CAT:
1646                     case CONFIG_ITEM_MODULE_CAT:
1647                         config_PutPsz( p_this, psz_name, optarg );
1648                         break;
1649                     case CONFIG_ITEM_INTEGER:
1650                         config_PutInt( p_this, psz_name, strtol(optarg, 0, 0));
1651                         break;
1652                     case CONFIG_ITEM_FLOAT:
1653                         config_PutFloat( p_this, psz_name, (float)atof(optarg) );
1654                         break;
1655                     case CONFIG_ITEM_KEY:
1656                         config_PutInt( p_this, psz_name, ConfigStringToKey( optarg ) );
1657                         break;
1658                     case CONFIG_ITEM_BOOL:
1659                         config_PutInt( p_this, psz_name, !flag );
1660                         break;
1661                 }
1662                 continue;
1663             }
1664         }
1665
1666         /* A short option has been recognized */
1667         if( pp_shortopts[i_cmd] != NULL )
1668         {
1669             switch( pp_shortopts[i_cmd]->i_type )
1670             {
1671                 case CONFIG_ITEM_STRING:
1672                 case CONFIG_ITEM_PASSWORD:
1673                 case CONFIG_ITEM_FILE:
1674                 case CONFIG_ITEM_DIRECTORY:
1675                 case CONFIG_ITEM_MODULE:
1676                 case CONFIG_ITEM_MODULE_CAT:
1677                 case CONFIG_ITEM_MODULE_LIST:
1678                 case CONFIG_ITEM_MODULE_LIST_CAT:
1679                     config_PutPsz( p_this, pp_shortopts[i_cmd]->psz_name, optarg );
1680                     break;
1681                 case CONFIG_ITEM_INTEGER:
1682                     if( i_cmd == 'v' )
1683                     {
1684                         if( optarg )
1685                         {
1686                             if( *optarg == 'v' ) /* eg. -vvv */
1687                             {
1688                                 i_verbose++;
1689                                 while( *optarg == 'v' )
1690                                 {
1691                                     i_verbose++;
1692                                     optarg++;
1693                                 }
1694                             }
1695                             else
1696                             {
1697                                 i_verbose += atoi( optarg ); /* eg. -v2 */
1698                             }
1699                         }
1700                         else
1701                         {
1702                             i_verbose++; /* -v */
1703                         }
1704                         config_PutInt( p_this, pp_shortopts[i_cmd]->psz_name,
1705                                                i_verbose );
1706                     }
1707                     else
1708                     {
1709                         config_PutInt( p_this, pp_shortopts[i_cmd]->psz_name,
1710                                                strtol(optarg, 0, 0) );
1711                     }
1712                     break;
1713                 case CONFIG_ITEM_BOOL:
1714                     config_PutInt( p_this, pp_shortopts[i_cmd]->psz_name, 1 );
1715                     break;
1716             }
1717
1718             continue;
1719         }
1720
1721         /* Internal error: unknown option */
1722         if( !b_ignore_errors )
1723         {
1724             fprintf( stderr, "%s: unknown option"
1725                      " or missing mandatory argument ",
1726                      p_this->p_libvlc->psz_object_name );
1727             if( optopt )
1728             {
1729                 fprintf( stderr, "`-%c'\n", optopt );
1730             }
1731             else
1732             {
1733                 fprintf( stderr, "`%s'\n", ppsz_argv[optind-1] );
1734             }
1735             fprintf( stderr, "Try `%s --help' for more information.\n",
1736                              p_this->p_libvlc->psz_object_name );
1737
1738             for( i_index = 0; p_longopts[i_index].name; i_index++ )
1739                 free( (char *)p_longopts[i_index].name );
1740             free( p_longopts );
1741             free( psz_shortopts );
1742             return -1;
1743         }
1744     }
1745
1746     /* Free allocated resources */
1747     for( i_index = 0; p_longopts[i_index].name; i_index++ )
1748         free( (char *)p_longopts[i_index].name );
1749     free( p_longopts );
1750     free( psz_shortopts );
1751     if( b_ignore_errors ) free( ppsz_argv );
1752
1753     return 0;
1754 }
1755
1756 /**
1757  * config_GetDataDir: find directory where shared data is installed
1758  *
1759  * @return a string (always succeeds).
1760  */
1761 const char *config_GetDataDir( void )
1762 {
1763 #if defined (WIN32) || defined (UNDER_CE)
1764     return vlc_global()->psz_vlcpath;
1765 #elif defined(__APPLE__) || defined (SYS_BEOS)
1766     static char path[PATH_MAX] = "";
1767
1768     if( *path == '\0' )
1769     {
1770         snprintf( path, sizeof( path ), "%s/share",
1771                   vlc_global()->psz_vlcpath );
1772         path[sizeof( path ) - 1] = '\0';
1773     }
1774     return path;
1775 #else
1776     return DATA_PATH;
1777 #endif
1778 }
1779
1780 /*****************************************************************************
1781  * config_GetHomeDir, config_GetUserDir: find the user's home directory.
1782  *****************************************************************************
1783  * This function will try by different ways to find the user's home path.
1784  * Note that this function is not reentrant, it should be called only once
1785  * at the beginning of main where the result will be stored for later use.
1786  *****************************************************************************/
1787 static char *GetDir( vlc_bool_t b_appdata )
1788 {
1789     const char *psz_localhome = NULL;
1790
1791 #if defined(WIN32) && !defined(UNDER_CE)
1792     typedef HRESULT (WINAPI *SHGETFOLDERPATH)( HWND, int, HANDLE, DWORD,
1793                                                LPWSTR );
1794 #ifndef CSIDL_FLAG_CREATE
1795 #   define CSIDL_FLAG_CREATE 0x8000
1796 #endif
1797 #ifndef CSIDL_APPDATA
1798 #   define CSIDL_APPDATA 0x1A
1799 #endif
1800 #ifndef CSIDL_PROFILE
1801 #   define CSIDL_PROFILE 0x28
1802 #endif
1803 #ifndef SHGFP_TYPE_CURRENT
1804 #   define SHGFP_TYPE_CURRENT 0
1805 #endif
1806
1807     HINSTANCE shfolder_dll;
1808     SHGETFOLDERPATH SHGetFolderPath ;
1809
1810     /* load the shfolder dll to retrieve SHGetFolderPath */
1811     if( ( shfolder_dll = LoadLibrary( _T("SHFolder.dll") ) ) != NULL )
1812     {
1813         SHGetFolderPath = (void *)GetProcAddress( shfolder_dll,
1814                                                   _T("SHGetFolderPathW") );
1815         if ( SHGetFolderPath != NULL )
1816         {
1817             wchar_t whomedir[MAX_PATH];
1818
1819             /* get the "Application Data" folder for the current user */
1820             if( S_OK == SHGetFolderPath( NULL,
1821                                          (b_appdata ? CSIDL_APPDATA :
1822                                            CSIDL_PROFILE) | CSIDL_FLAG_CREATE,
1823                                          NULL, SHGFP_TYPE_CURRENT,
1824                                          whomedir ) )
1825             {
1826                 FreeLibrary( shfolder_dll );
1827                 return FromWide( whomedir );
1828             }
1829         }
1830         FreeLibrary( shfolder_dll );
1831     }
1832
1833 #elif defined(UNDER_CE)
1834
1835 #ifndef CSIDL_APPDATA
1836 #   define CSIDL_APPDATA 0x1A
1837 #endif
1838
1839     wchar_t whomedir[MAX_PATH];
1840
1841     /* get the "Application Data" folder for the current user */
1842     if( SHGetSpecialFolderPath( NULL, whomedir, CSIDL_APPDATA, 1 ) )
1843         return FromWide( whomedir );
1844 #endif
1845
1846     psz_localhome = getenv( "HOME" );
1847     if( psz_localhome == NULL )
1848     {
1849 #if defined(HAVE_GETPWUID)
1850         struct passwd *p_pw;
1851         (void)b_appdata;
1852
1853         if( ( p_pw = getpwuid( getuid() ) ) != NULL )
1854             psz_localhome = p_pw->pw_dir;
1855         else
1856 #endif
1857         {
1858             psz_localhome = getenv( "TMP" );
1859             if( psz_localhome == NULL )
1860                 psz_localhome = "/tmp";
1861         }
1862     }
1863
1864     return FromLocaleDup( psz_localhome );
1865 }
1866
1867 /**
1868  * Get the user's home directory
1869  */
1870 char *config_GetHomeDir( void )
1871 {
1872     return GetDir( VLC_FALSE );
1873 }
1874
1875 /**
1876  * Get the user's main data and config directory:
1877  *   - on windows that's the App Data directory;
1878  *   - on other OSes it's the same as the home directory.
1879  */
1880 char *config_GetUserDir( void );
1881 char *config_GetUserDir( void )
1882 {
1883     return GetDir( VLC_TRUE );
1884 }
1885
1886 /**
1887  * Get the user's VLC configuration directory
1888  */
1889 char *config_GetConfigDir( libvlc_int_t *p_libvlc )
1890 {
1891     char *psz_dir;
1892 #if defined(WIN32) || defined(__APPLE__) || defined(SYS_BEOS)
1893     char *psz_parent = config_GetUserDir();
1894     if( !psz_parent ) psz_parent = p_libvlc->psz_homedir;
1895     if( asprintf( &psz_dir, "%s" DIR_SEP CONFIG_DIR, psz_parent ) == -1 )
1896         return NULL;
1897     return psz_dir;
1898 #else
1899     /* XDG Base Directory Specification - Version 0.6 */
1900     char *psz_env = getenv( "XDG_CONFIG_HOME" );
1901     if( psz_env )
1902     {
1903         if( asprintf( &psz_dir, "%s/vlc", psz_env ) == -1 )
1904             return NULL;
1905         return psz_dir;
1906     }
1907     psz_env = getenv( "HOME" );
1908     if( !psz_env ) psz_env = p_libvlc->psz_homedir; /* not part of XDG spec but we want a sensible fallback */
1909     if( asprintf( &psz_dir, "%s/.config/vlc", psz_env ) == -1 )
1910         return NULL;
1911     return psz_dir;
1912 #endif
1913 }
1914
1915 /**
1916  * Get the user's VLC data directory
1917  * (used for stuff like the skins, custom lua modules, ...)
1918  */
1919 char *config_GetUserDataDir( libvlc_int_t *p_libvlc )
1920 {
1921     char *psz_dir;
1922 #if defined(WIN32) || defined(__APPLE__) || defined(SYS_BEOS)
1923     char *psz_parent = config_GetUserDir();
1924     if( !psz_parent ) psz_parent = p_libvlc->psz_homedir;
1925     if( asprintf( &psz_dir, "%s" DIR_SEP CONFIG_DIR, psz_parent ) == -1 )
1926         return NULL;
1927     return psz_dir;
1928 #else
1929     /* XDG Base Directory Specification - Version 0.6 */
1930     char *psz_env = getenv( "XDG_DATA_HOME" );
1931     if( psz_env )
1932     {
1933         if( asprintf( &psz_dir, "%s/vlc", psz_env ) == -1 )
1934             return NULL;
1935         return psz_dir;
1936     }
1937     psz_env = getenv( "HOME" );
1938     if( !psz_env ) psz_env = p_libvlc->psz_homedir; /* not part of XDG spec but we want a sensible fallback */
1939     if( asprintf( &psz_dir, "%s/.local/share/vlc", psz_env ) == -1 )
1940         return NULL;
1941     return psz_dir;
1942 #endif
1943 }
1944
1945 /**
1946  * Get the user's VLC cache directory
1947  * (used for stuff like the modules cache, the album art cache, ...)
1948  */
1949 char *config_GetCacheDir( libvlc_int_t *p_libvlc )
1950 {
1951     char *psz_dir;
1952 #if defined(WIN32) || defined(__APPLE__) || defined(SYS_BEOS)
1953     char *psz_parent = config_GetUserDir();
1954     if( !psz_parent ) psz_parent = p_libvlc->psz_homedir;
1955     if( asprintf( &psz_dir, "%s" DIR_SEP CONFIG_DIR, psz_parent ) == -1 )
1956         return NULL;
1957     return psz_dir;
1958 #else
1959     /* XDG Base Directory Specification - Version 0.6 */
1960     char *psz_env = getenv( "XDG_CACHE_HOME" );
1961     if( psz_env )
1962     {
1963         if( asprintf( &psz_dir, "%s/vlc", psz_env ) == -1 )
1964             return NULL;
1965         return psz_dir;
1966     }
1967     psz_env = getenv( "HOME" );
1968     if( !psz_env ) psz_env = p_libvlc->psz_homedir; /* not part of XDG spec but we want a sensible fallback */
1969     if( asprintf( &psz_dir, "%s/.cache/vlc", psz_env ) == -1 )
1970         return NULL;
1971     return psz_dir;
1972 #endif
1973 }
1974
1975 /**
1976  * Get the user's configuration file
1977  */
1978 char *config_GetConfigFile( libvlc_int_t *p_libvlc )
1979 {
1980     char *psz_configfile;
1981     if( asprintf( &psz_configfile, "%s" DIR_SEP CONFIG_FILE,
1982                   p_libvlc->psz_configdir ) == -1 )
1983         return NULL;
1984     return psz_configfile;
1985 }
1986
1987 /**
1988  * Get the user's configuration file when given with the --config option
1989  */
1990 char *config_GetCustomConfigFile( libvlc_int_t *p_libvlc )
1991 {
1992     char *psz_configfile = config_GetPsz( p_libvlc, "config" );
1993     if( psz_configfile != NULL )
1994     {
1995         if( psz_configfile[0] == '~' && psz_configfile[1] == '/' )
1996         {
1997             /* This is incomplete: we should also support the ~cmassiot/ syntax */
1998             char *psz_buf;
1999             if( asprintf( &psz_buf, "%s/%s", p_libvlc->psz_homedir,
2000                           psz_configfile + 2 ) == -1 )
2001             {
2002                 free( psz_configfile );
2003                 return NULL;
2004             }
2005             free( psz_configfile );
2006             psz_configfile = psz_buf;
2007         }
2008     }
2009     return psz_configfile;
2010 }
2011
2012 static int ConfigStringToKey( const char *psz_key )
2013 {
2014     int i_key = 0;
2015     unsigned int i;
2016     const char *psz_parser = strchr( psz_key, '-' );
2017     while( psz_parser && psz_parser != psz_key )
2018     {
2019         for( i = 0; i < sizeof(vlc_modifiers) / sizeof(key_descriptor_t); i++ )
2020         {
2021             if( !strncasecmp( vlc_modifiers[i].psz_key_string, psz_key,
2022                               strlen( vlc_modifiers[i].psz_key_string ) ) )
2023             {
2024                 i_key |= vlc_modifiers[i].i_key_code;
2025             }
2026         }
2027         psz_key = psz_parser + 1;
2028         psz_parser = strchr( psz_key, '-' );
2029     }
2030     for( i = 0; i < sizeof(vlc_keys) / sizeof( key_descriptor_t ); i++ )
2031     {
2032         if( !strcasecmp( vlc_keys[i].psz_key_string, psz_key ) )
2033         {
2034             i_key |= vlc_keys[i].i_key_code;
2035             break;
2036         }
2037     }
2038     return i_key;
2039 }
2040
2041 static char *ConfigKeyToString( int i_key )
2042 {
2043     char *psz_key = malloc( 100 );
2044     char *p;
2045     size_t index;
2046
2047     if ( !psz_key )
2048     {
2049         return NULL;
2050     }
2051     *psz_key = '\0';
2052     p = psz_key;
2053     for( index = 0; index < (sizeof(vlc_modifiers) / sizeof(key_descriptor_t));
2054          index++ )
2055     {
2056         if( i_key & vlc_modifiers[index].i_key_code )
2057         {
2058             p += sprintf( p, "%s-", vlc_modifiers[index].psz_key_string );
2059         }
2060     }
2061     for( index = 0; index < (sizeof(vlc_keys) / sizeof( key_descriptor_t));
2062          index++)
2063     {
2064         if( (int)( i_key & ~KEY_MODIFIER ) == vlc_keys[index].i_key_code )
2065         {
2066             p += sprintf( p, "%s", vlc_keys[index].psz_key_string );
2067             break;
2068         }
2069     }
2070     return psz_key;
2071 }