git.sesse.net Git - vlc/blob - src/config/file.c

   1 /*****************************************************************************
   2  * file.c: configuration file handling
   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 #ifdef HAVE_CONFIG_H
  25 # include "config.h"
  26 #endif
  27
  28 #include <vlc_common.h>
  29 #include "../libvlc.h"
  30 #include "vlc_charset.h"
  31 #include "vlc_keys.h"
  32
  33 #include <errno.h>                                                  /* errno */
  34 #include <assert.h>
  35 #include <limits.h>
  36 #ifdef __APPLE__
  37 #   include <xlocale.h>
  38 #else
  39 #include <locale.h>
  40 #endif
  41
  42 #include "configuration.h"
  43 #include "modules/modules.h"
  44
  45 static char *ConfigKeyToString( int );
  46
  47 static inline char *strdupnull (const char *src)
  48 {
  49     return src ? strdup (src) : NULL;
  50 }
  51
  52 /**
  53  * Get the user's configuration file
  54  */
  55 static char *config_GetConfigFile( vlc_object_t *obj )
  56 {
  57     char *psz_file = config_GetPsz( obj, "config" );
  58     if( psz_file == NULL )
  59     {
  60         char *psz_dir = config_GetUserConfDir();
  61
  62         if( asprintf( &psz_file, "%s" DIR_SEP CONFIG_FILE, psz_dir ) == -1 )
  63             psz_file = NULL;
  64         free( psz_dir );
  65     }
  66     return psz_file;
  67 }
  68
  69 static FILE *config_OpenConfigFile( vlc_object_t *p_obj, const char *mode )
  70 {
  71     char *psz_filename = config_GetConfigFile( p_obj );
  72     if( psz_filename == NULL )
  73         return NULL;
  74
  75     msg_Dbg( p_obj, "opening config file (%s)", psz_filename );
  76
  77     FILE *p_stream = utf8_fopen( psz_filename, mode );
  78     if( p_stream == NULL && errno != ENOENT )
  79     {
  80         msg_Err( p_obj, "cannot open config file (%s): %m",
  81                  psz_filename );
  82
  83     }
  84 #if !( defined(WIN32) || defined(__APPLE__) || defined(SYS_BEOS) )
  85     else if( p_stream == NULL && errno == ENOENT && mode[0] == 'r' )
  86     {
  87         /* This is the fallback for pre XDG Base Directory
  88          * Specification configs */
  89         char *psz_old;
  90         if( asprintf( &psz_old, "%s" DIR_SEP CONFIG_DIR DIR_SEP CONFIG_FILE,
  91                       config_GetHomeDir() ) != -1 )
  92         {
  93             p_stream = utf8_fopen( psz_old, mode );
  94             if( p_stream )
  95             {
  96                 /* Old config file found. We want to write it at the
  97                  * new location now. */
  98                 msg_Info( p_obj->p_libvlc, "Found old config file at %s. "
  99                           "VLC will now use %s.", psz_old, psz_filename );
 100                 char *psz_readme;
 101                 if( asprintf(&psz_readme,"%s"DIR_SEP CONFIG_DIR DIR_SEP"README",
 102                               config_GetHomeDir() ) != -1 )
 103                 {
 104                     FILE *p_readme = utf8_fopen( psz_readme, "wt" );
 105                     if( p_readme )
 106                     {
 107                         fprintf( p_readme, "The VLC media player "
 108                                  "configuration folder has moved to comply\n"
 109                                  "with the XDG Base Directory Specification "
 110                                  "version 0.6. Your\nconfiguration has been "
 111                                  "copied to the new location:\n%s\nYou can "
 112                                  "delete this directory and all its contents.",
 113                                   psz_filename);
 114                         fclose( p_readme );
 115                     }
 116                     free( psz_readme );
 117                 }
 118             }
 119             free( psz_old );
 120         }
 121     }
 122 #endif
 123     return p_stream;
 124 }
 125
 126
 127 static int strtoi (const char *str)
 128 {
 129     char *end;
 130     long l;
 131
 132     errno = 0;
 133     l = strtol (str, &end, 0);
 134
 135     if (!errno)
 136     {
 137         if ((l > INT_MAX) || (l < INT_MIN))
 138             errno = ERANGE;
 139         if (*end)
 140             errno = EINVAL;
 141     }
 142     return (int)l;
 143 }
 144
 145
 146 /*****************************************************************************
 147  * config_LoadConfigFile: loads the configuration file.
 148  *****************************************************************************
 149  * This function is called to load the config options stored in the config
 150  * file.
 151  *****************************************************************************/
 152 int __config_LoadConfigFile( vlc_object_t *p_this, const char *psz_module_name )
 153 {
 154     libvlc_priv_t *priv = libvlc_priv (p_this->p_libvlc);
 155     FILE *file;
 156
 157     file = config_OpenConfigFile (p_this, "rt");
 158     if (file == NULL)
 159         return VLC_EGENERIC;
 160
 161     /* Acquire config file lock */
 162     vlc_mutex_lock( &priv->config_lock );
 163
 164     /* Look for the selected module, if NULL then save everything */
 165     module_t **list = module_list_get (NULL);
 166
 167     /* Look for UTF-8 Byte Order Mark */
 168     char * (*convert) (const char *) = strdupnull;
 169     char bom[3];
 170
 171     if ((fread (bom, 1, 3, file) != 3)
 172      || memcmp (bom, "\xEF\xBB\xBF", 3))
 173     {
 174         convert = FromLocaleDup;
 175         rewind (file); /* no BOM, rewind */
 176     }
 177
 178     module_t *module = NULL;
 179     char line[1024], section[1022];
 180     section[0] = '\0';
 181
 182     /* Ensure consistent number formatting... */
 183     locale_t loc = newlocale (LC_NUMERIC_MASK, "C", NULL);
 184     locale_t baseloc = uselocale (loc);
 185
 186     while (fgets (line, 1024, file) != NULL)
 187     {
 188         /* Ignore comments and empty lines */
 189         switch (line[0])
 190         {
 191             case '#':
 192             case '\n':
 193             case '\0':
 194                 continue;
 195         }
 196
 197         if (line[0] == '[')
 198         {
 199             char *ptr = strchr (line, ']');
 200             if (ptr == NULL)
 201                 continue; /* syntax error; */
 202             *ptr = '\0';
 203
 204             /* New section ( = a given module) */
 205             strcpy (section, line + 1);
 206             module = NULL;
 207
 208             if ((psz_module_name == NULL)
 209              || (strcmp (psz_module_name, section) == 0))
 210             {
 211                 for (int i = 0; list[i]; i++)
 212                 {
 213                     module_t *m = list[i];
 214
 215                     if ((strcmp (section, m->psz_object_name) == 0)
 216                      && (m->i_config_items > 0)) /* ignore config-less modules */
 217                     {
 218                         module = m;
 219                         if (psz_module_name != NULL)
 220                             msg_Dbg (p_this,
 221                                      "loading config for module \"%s\"",
 222                                      section);
 223                         break;
 224                     }
 225                 }
 226             }
 227
 228             continue;
 229         }
 230
 231         if (module == NULL)
 232             continue; /* no need to parse if there is no matching module */
 233
 234         char *ptr = strchr (line, '\n');
 235         if (ptr != NULL)
 236             *ptr = '\0';
 237
 238         /* look for option name */
 239         const char *psz_option_name = line;
 240
 241         ptr = strchr (line, '=');
 242         if (ptr == NULL)
 243             continue; /* syntax error */
 244
 245         *ptr = '\0';
 246         const char *psz_option_value = ptr + 1;
 247
 248         /* try to match this option with one of the module's options */
 249         for (size_t i = 0; i < module->confsize; i++)
 250         {
 251             module_config_t *p_item = module->p_config + i;
 252
 253             if ((p_item->i_type & CONFIG_HINT)
 254              || strcmp (p_item->psz_name, psz_option_name))
 255                 continue;
 256
 257             /* We found it */
 258             errno = 0;
 259
 260             switch( p_item->i_type )
 261             {
 262                 case CONFIG_ITEM_BOOL:
 263                 case CONFIG_ITEM_INTEGER:
 264                 {
 265                     long l = strtoi (psz_option_value);
 266                     if (errno)
 267                         msg_Warn (p_this, "Integer value (%s) for %s: %m",
 268                                   psz_option_value, psz_option_name);
 269                     else
 270                         p_item->saved.i = p_item->value.i = (int)l;
 271                     break;
 272                 }
 273
 274                 case CONFIG_ITEM_FLOAT:
 275                     if( !*psz_option_value )
 276                         break;                    /* ignore empty option */
 277                     p_item->value.f = (float)atof (psz_option_value);
 278                     p_item->saved.f = p_item->value.f;
 279                     break;
 280
 281                 case CONFIG_ITEM_KEY:
 282                     if( !*psz_option_value )
 283                         break;                    /* ignore empty option */
 284                     p_item->value.i = ConfigStringToKey(psz_option_value);
 285                     p_item->saved.i = p_item->value.i;
 286                     break;
 287
 288                 default:
 289                     vlc_mutex_lock( p_item->p_lock );
 290
 291                     /* free old string */
 292                     free( (char*) p_item->value.psz );
 293                     free( (char*) p_item->saved.psz );
 294
 295                     p_item->value.psz = convert (psz_option_value);
 296                     p_item->saved.psz = strdupnull (p_item->value.psz);
 297
 298                     vlc_mutex_unlock( p_item->p_lock );
 299                     break;
 300             }
 301
 302             break;
 303         }
 304     }
 305
 306     if (ferror (file))
 307     {
 308         msg_Err (p_this, "error reading configuration: %m");
 309         clearerr (file);
 310     }
 311     fclose (file);
 312
 313     module_list_free (list);
 314     if (loc != (locale_t)0)
 315     {
 316         uselocale (baseloc);
 317         freelocale (loc);
 318     }
 319
 320     vlc_mutex_unlock( &priv->config_lock );
 321     return 0;
 322 }
 323
 324 /*****************************************************************************
 325  * config_CreateDir: Create configuration directory if it doesn't exist.
 326  *****************************************************************************/
 327 int config_CreateDir( vlc_object_t *p_this, const char *psz_dirname )
 328 {
 329     if( !psz_dirname || !*psz_dirname ) return -1;
 330
 331     if( utf8_mkdir( psz_dirname, 0700 ) == 0 )
 332         return 0;
 333
 334     switch( errno )
 335     {
 336         case EEXIST:
 337             return 0;
 338
 339         case ENOENT:
 340         {
 341             /* Let's try to create the parent directory */
 342             char psz_parent[strlen( psz_dirname ) + 1], *psz_end;
 343             strcpy( psz_parent, psz_dirname );
 344
 345             psz_end = strrchr( psz_parent, DIR_SEP_CHAR );
 346             if( psz_end && psz_end != psz_parent )
 347             {
 348                 *psz_end = '\0';
 349                 if( config_CreateDir( p_this, psz_parent ) == 0 )
 350                 {
 351                     if( !utf8_mkdir( psz_dirname, 0700 ) )
 352                         return 0;
 353                 }
 354             }
 355         }
 356     }
 357
 358     msg_Err( p_this, "could not create %s: %m", psz_dirname );
 359     return -1;
 360 }
 361
 362 static int
 363 config_Write (FILE *file, const char *type, const char *desc,
 364               bool comment, const char *name, const char *fmt, ...)
 365 {
 366     va_list ap;
 367     int ret;
 368
 369     if (desc == NULL)
 370         desc = "?";
 371
 372     if (fprintf (file, "# %s (%s)\n%s%s=", desc, vlc_gettext (type),
 373                  comment ? "#" : "", name) < 0)
 374         return -1;
 375
 376     va_start (ap, fmt);
 377     ret = vfprintf (file, fmt, ap);
 378     va_end (ap);
 379     if (ret < 0)
 380         return -1;
 381
 382     if (fputs ("\n\n", file) == EOF)
 383         return -1;
 384     return 0;
 385 }
 386
 387
 388 static int config_PrepareDir (vlc_object_t *obj)
 389 {
 390     char *psz_configdir = config_GetUserConfDir ();
 391     if (psz_configdir == NULL) /* XXX: This should never happen */
 392         return -1;
 393
 394     int ret = config_CreateDir (obj, psz_configdir);
 395     free (psz_configdir);
 396     return ret;
 397 }
 398
 399 /*****************************************************************************
 400  * config_SaveConfigFile: Save a module's config options.
 401  *****************************************************************************
 402  * This will save the specified module's config options to the config file.
 403  * If psz_module_name is NULL then we save all the modules config options.
 404  * It's no use to save the config options that kept their default values, so
 405  * we'll try to be a bit clever here.
 406  *
 407  * When we save we mustn't delete the config options of the modules that
 408  * haven't been loaded. So we cannot just create a new config file with the
 409  * config structures we've got in memory.
 410  * I don't really know how to deal with this nicely, so I will use a completly
 411  * dumb method ;-)
 412  * I will load the config file in memory, but skipping all the sections of the
 413  * modules we want to save. Then I will create a brand new file, dump the file
 414  * loaded in memory and then append the sections of the modules we want to
 415  * save.
 416  * Really stupid no ?
 417  *****************************************************************************/
 418 static int SaveConfigFile( vlc_object_t *p_this, const char *psz_module_name,
 419                            bool b_autosave )
 420 {
 421     libvlc_priv_t *priv = libvlc_priv (p_this->p_libvlc);
 422     module_t *p_parser;
 423     FILE *file;
 424     char p_line[1024], *p_index2;
 425     unsigned long i_sizebuf = 0;
 426     char *p_bigbuffer, *p_index;
 427     bool b_backup;
 428     int i_index;
 429
 430     /* Acquire config file lock */
 431     vlc_mutex_lock( &priv->config_lock );
 432
 433     if( config_PrepareDir( p_this ) )
 434     {
 435         msg_Err( p_this, "no configuration directory" );
 436         vlc_mutex_unlock( &priv->config_lock );
 437         return -1;
 438     }
 439
 440     file = config_OpenConfigFile( p_this, "rt" );
 441     if( file != NULL )
 442     {
 443         /* look for file size */
 444         fseek( file, 0L, SEEK_END );
 445         i_sizebuf = ftell( file );
 446         fseek( file, 0L, SEEK_SET );
 447         if( i_sizebuf >= LONG_MAX )
 448             i_sizebuf = 0;
 449     }
 450
 451     p_bigbuffer = p_index = malloc( i_sizebuf+1 );
 452     if( !p_bigbuffer )
 453     {
 454         if( file ) fclose( file );
 455         vlc_mutex_unlock( &priv->config_lock );
 456         return -1;
 457     }
 458     p_bigbuffer[0] = 0;
 459
 460     /* List all available modules */
 461     module_t **list = module_list_get (NULL);
 462
 463     /* backup file into memory, we only need to backup the sections we won't
 464      * save later on */
 465     b_backup = 0;
 466     while( file && fgets( p_line, 1024, file ) )
 467     {
 468         if( (p_line[0] == '[') && (p_index2 = strchr(p_line,']')))
 469         {
 470
 471             /* we found a section, check if we need to do a backup */
 472             for( i_index = 0; (p_parser = list[i_index]) != NULL; i_index++ )
 473             {
 474                 if( ((p_index2 - &p_line[1])
 475                        == (int)strlen(p_parser->psz_object_name) )
 476                     && !memcmp( &p_line[1], p_parser->psz_object_name,
 477                                 strlen(p_parser->psz_object_name) ) )
 478                 {
 479                     if( !psz_module_name )
 480                         break;
 481                     else if( !strcmp( psz_module_name,
 482                                       p_parser->psz_object_name ) )
 483                         break;
 484                 }
 485             }
 486
 487             if( list[i_index] == NULL )
 488             {
 489                 /* we don't have this section in our list so we need to back
 490                  * it up */
 491                 *p_index2 = 0;
 492 #if 0
 493                 msg_Dbg( p_this, "backing up config for unknown module \"%s\"",
 494                                  &p_line[1] );
 495 #endif
 496                 *p_index2 = ']';
 497
 498                 b_backup = 1;
 499             }
 500             else
 501             {
 502                 b_backup = 0;
 503             }
 504         }
 505
 506         /* save line if requested and line is valid (doesn't begin with a
 507          * space, tab, or eol) */
 508         if( b_backup && (p_line[0] != '\n') && (p_line[0] != ' ')
 509             && (p_line[0] != '\t') )
 510         {
 511             strcpy( p_index, p_line );
 512             p_index += strlen( p_line );
 513         }
 514     }
 515     if( file ) fclose( file );
 516
 517
 518     /*
 519      * Save module config in file
 520      */
 521
 522     file = config_OpenConfigFile (p_this, "wt");
 523     if( !file )
 524     {
 525         module_list_free (list);
 526         free( p_bigbuffer );
 527         vlc_mutex_unlock( &priv->config_lock );
 528         return -1;
 529     }
 530
 531     fprintf( file, "\xEF\xBB\xBF###\n###  " COPYRIGHT_MESSAGE "\n###\n\n"
 532        "###\n### lines beginning with a '#' character are comments\n###\n\n" );
 533
 534     /* Ensure consistent number formatting... */
 535     locale_t loc = newlocale (LC_NUMERIC_MASK, "C", NULL);
 536     locale_t baseloc = uselocale (loc);
 537
 538     /* Look for the selected module, if NULL then save everything */
 539     for( i_index = 0; (p_parser = list[i_index]) != NULL; i_index++ )
 540     {
 541         module_config_t *p_item, *p_end;
 542
 543         if( psz_module_name && strcmp( psz_module_name,
 544                                        p_parser->psz_object_name ) )
 545             continue;
 546
 547         if( !p_parser->i_config_items )
 548             continue;
 549
 550         if( psz_module_name )
 551             msg_Dbg( p_this, "saving config for module \"%s\"",
 552                      p_parser->psz_object_name );
 553
 554         fprintf( file, "[%s]", p_parser->psz_object_name );
 555         if( p_parser->psz_longname )
 556             fprintf( file, " # %s\n\n", p_parser->psz_longname );
 557         else
 558             fprintf( file, "\n\n" );
 559
 560         for( p_item = p_parser->p_config, p_end = p_item + p_parser->confsize;
 561              p_item < p_end;
 562              p_item++ )
 563         {
 564             /* Do not save the new value in the configuration file
 565              * if doing an autosave, and the item is not an "autosaved" one. */
 566             bool b_retain = b_autosave && !p_item->b_autosave;
 567
 568             if ((p_item->i_type & CONFIG_HINT) /* ignore hint */
 569              || p_item->b_removed              /* ignore deprecated option */
 570              || p_item->b_unsaveable)          /* ignore volatile option */
 571                 continue;
 572
 573             if (IsConfigIntegerType (p_item->i_type))
 574             {
 575                 int val = b_retain ? p_item->saved.i : p_item->value.i;
 576                 if (p_item->i_type == CONFIG_ITEM_KEY)
 577                 {
 578                     char *psz_key = ConfigKeyToString (val);
 579                     config_Write (file, p_item->psz_text, N_("key"),
 580                                   val == p_item->orig.i,
 581                                   p_item->psz_name, "%s",
 582                                   psz_key ? psz_key : "");
 583                     free (psz_key);
 584                 }
 585                 else
 586                     config_Write (file, p_item->psz_text,
 587                                   (p_item->i_type == CONFIG_ITEM_BOOL)
 588                                       ? N_("boolean") : N_("integer"),
 589                                   val == p_item->orig.i,
 590                                   p_item->psz_name, "%d", val);
 591                 p_item->saved.i = val;
 592             }
 593             else
 594             if (IsConfigFloatType (p_item->i_type))
 595             {
 596                 float val = b_retain ? p_item->saved.f : p_item->value.f;
 597                 config_Write (file, p_item->psz_text, N_("float"),
 598                               val == p_item->orig.f,
 599                               p_item->psz_name, "%f", val);
 600                 p_item->saved.f = val;
 601             }
 602             else
 603             {
 604                 const char *psz_value = b_retain ? p_item->saved.psz
 605                                                  : p_item->value.psz;
 606                 bool modified;
 607
 608                 assert (IsConfigStringType (p_item->i_type));
 609
 610                 if (b_retain && (psz_value == NULL)) /* FIXME: hack */
 611                     psz_value = p_item->orig.psz;
 612
 613                 modified =
 614                     (psz_value != NULL)
 615                         ? ((p_item->orig.psz != NULL)
 616                             ? (strcmp (psz_value, p_item->orig.psz) != 0)
 617                             : true)
 618                         : (p_item->orig.psz != NULL);
 619
 620                 config_Write (file, p_item->psz_text, N_("string"),
 621                               !modified, p_item->psz_name, "%s",
 622                               psz_value ? psz_value : "");
 623
 624                 if ( !b_retain )
 625                 {
 626
 627                     free ((char *)p_item->saved.psz);
 628                     if( (psz_value && p_item->orig.psz &&
 629                          strcmp( psz_value, p_item->orig.psz )) ||
 630                         !psz_value || !p_item->orig.psz)
 631                         p_item->saved.psz = strdupnull (psz_value);
 632                     else
 633                         p_item->saved.psz = NULL;
 634                 }
 635             }
 636
 637             if (!b_retain)
 638                 p_item->b_dirty = false;
 639         }
 640     }
 641
 642     module_list_free (list);
 643     if (loc != (locale_t)0)
 644     {
 645         uselocale (baseloc);
 646         freelocale (loc);
 647     }
 648
 649     /*
 650      * Restore old settings from the config in file
 651      */
 652     fputs( p_bigbuffer, file );
 653     free( p_bigbuffer );
 654
 655     fclose( file );
 656     vlc_mutex_unlock( &priv->config_lock );
 657
 658     return 0;
 659 }
 660
 661 int config_AutoSaveConfigFile( vlc_object_t *p_this )
 662 {
 663     libvlc_priv_t *priv = libvlc_priv (p_this->p_libvlc);
 664     size_t i_index;
 665     bool done;
 666
 667     assert( p_this );
 668
 669     /* Check if there's anything to save */
 670     vlc_mutex_lock( &priv->config_lock );
 671     module_t **list = module_list_get (NULL);
 672     for( i_index = 0; list[i_index]; i_index++ )
 673     {
 674         module_t *p_parser = list[i_index];
 675         module_config_t *p_item, *p_end;
 676
 677         if( !p_parser->i_config_items ) continue;
 678
 679         for( p_item = p_parser->p_config, p_end = p_item + p_parser->confsize;
 680              p_item < p_end;
 681              p_item++ )
 682         {
 683             if( p_item->b_autosave && p_item->b_dirty ) break;
 684         }
 685         if( p_item < p_end ) break;
 686     }
 687     done = list[i_index] == NULL;
 688     module_list_free (list);
 689     vlc_mutex_unlock( &priv->config_lock );
 690
 691     return done ? VLC_SUCCESS : SaveConfigFile( p_this, NULL, true );
 692 }
 693
 694 int __config_SaveConfigFile( vlc_object_t *p_this, const char *psz_module_name )
 695 {
 696     return SaveConfigFile( p_this, psz_module_name, false );
 697 }
 698
 699 int ConfigStringToKey( const char *psz_key )
 700 {
 701     int i_key = 0;
 702     unsigned int i;
 703     const char *psz_parser = strchr( psz_key, '-' );
 704     while( psz_parser && psz_parser != psz_key )
 705     {
 706         for( i = 0; i < sizeof(vlc_modifiers) / sizeof(key_descriptor_t); i++ )
 707         {
 708             if( !strncasecmp( vlc_modifiers[i].psz_key_string, psz_key,
 709                               strlen( vlc_modifiers[i].psz_key_string ) ) )
 710             {
 711                 i_key |= vlc_modifiers[i].i_key_code;
 712             }
 713         }
 714         psz_key = psz_parser + 1;
 715         psz_parser = strchr( psz_key, '-' );
 716     }
 717     for( i = 0; i < sizeof(vlc_keys) / sizeof( key_descriptor_t ); i++ )
 718     {
 719         if( !strcasecmp( vlc_keys[i].psz_key_string, psz_key ) )
 720         {
 721             i_key |= vlc_keys[i].i_key_code;
 722             break;
 723         }
 724     }
 725     return i_key;
 726 }
 727
 728 char *ConfigKeyToString( int i_key )
 729 {
 730     char *psz_key = malloc( 100 );
 731     char *p;
 732     size_t index;
 733
 734     if ( !psz_key )
 735     {
 736         return NULL;
 737     }
 738     *psz_key = '\0';
 739     p = psz_key;
 740
 741     for( index = 0; index < (sizeof(vlc_modifiers) / sizeof(key_descriptor_t));
 742          index++ )
 743     {
 744         if( i_key & vlc_modifiers[index].i_key_code )
 745         {
 746             p += sprintf( p, "%s-", vlc_modifiers[index].psz_key_string );
 747         }
 748     }
 749     for( index = 0; index < (sizeof(vlc_keys) / sizeof( key_descriptor_t));
 750          index++)
 751     {
 752         if( (int)( i_key & ~KEY_MODIFIER ) == vlc_keys[index].i_key_code )
 753         {
 754             p += sprintf( p, "%s", vlc_keys[index].psz_key_string );
 755             break;
 756         }
 757     }
 758     return psz_key;
 759 }
 760