Fix gio docs
[platform/upstream/glib.git] / gio / gdesktopappinfo.c
1 /* GIO - GLib Input, Output and Streaming Library
2  *
3  * Copyright (C) 2006-2007 Red Hat, Inc.
4  * Copyright © 2007 Ryan Lortie
5  *
6  * This library is free software; you can redistribute it and/or
7  * modify it under the terms of the GNU Lesser General Public
8  * License as published by the Free Software Foundation; either
9  * version 2 of the License, or (at your option) any later version.
10  *
11  * This library is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
14  * Lesser General Public License for more details.
15  *
16  * You should have received a copy of the GNU Lesser General
17  * Public License along with this library; if not, write to the
18  * Free Software Foundation, Inc., 59 Temple Place, Suite 330,
19  * Boston, MA 02111-1307, USA.
20  *
21  * Author: Alexander Larsson <alexl@redhat.com>
22  */
23
24 #include "config.h"
25
26 #include <errno.h>
27 #include <string.h>
28 #include <unistd.h>
29
30 #ifdef HAVE_CRT_EXTERNS_H
31 #include <crt_externs.h>
32 #endif
33
34 #include "gcontenttypeprivate.h"
35 #include "gdesktopappinfo.h"
36 #include "gfile.h"
37 #include "gioerror.h"
38 #include "gthemedicon.h"
39 #include "gfileicon.h"
40 #include <glib/gstdio.h>
41 #include "glibintl.h"
42 #include "giomodule-priv.h"
43 #include "gappinfo.h"
44
45
46 /**
47  * SECTION:gdesktopappinfo
48  * @title: GDesktopAppInfo
49  * @short_description: Application information from desktop files
50  * @include: gio/gdesktopappinfo.h
51  *
52  * #GDesktopAppInfo is an implementation of #GAppInfo based on
53  * desktop files.
54  *
55  * Note that <filename>&lt;gio/gdesktopappinfo.h&gt;</filename> belongs to
56  * the UNIX-specific GIO interfaces, thus you have to use the
57  * <filename>gio-unix-2.0.pc</filename> pkg-config file when using it.
58  */
59
60 #define DEFAULT_APPLICATIONS_GROUP  "Default Applications"
61 #define ADDED_ASSOCIATIONS_GROUP    "Added Associations"
62 #define REMOVED_ASSOCIATIONS_GROUP  "Removed Associations"
63 #define MIME_CACHE_GROUP            "MIME Cache"
64 #define GENERIC_NAME_KEY            "GenericName"
65 #define FULL_NAME_KEY               "X-GNOME-FullName"
66 #define KEYWORDS_KEY                "Keywords"
67 #define STARTUP_WM_CLASS_KEY        "StartupWMClass"
68
69 enum {
70   PROP_0,
71   PROP_FILENAME
72 };
73
74 static void     g_desktop_app_info_iface_init         (GAppInfoIface    *iface);
75 static GList *  get_all_desktop_entries_for_mime_type (const char       *base_mime_type,
76                                                        const char      **except,
77                                                        gboolean          include_fallback,
78                                                        char            **explicit_default);
79 static void     mime_info_cache_reload                (const char       *dir);
80 static gboolean g_desktop_app_info_ensure_saved       (GDesktopAppInfo  *info,
81                                                        GError          **error);
82
83 /**
84  * GDesktopAppInfo:
85  * 
86  * Information about an installed application from a desktop file.
87  */
88 struct _GDesktopAppInfo
89 {
90   GObject parent_instance;
91
92   char *desktop_id;
93   char *filename;
94
95   char *name;
96   char *generic_name;
97   char *fullname;
98   char *comment;
99   char *icon_name;
100   GIcon *icon;
101   char **keywords;
102   char **only_show_in;
103   char **not_show_in;
104   char *try_exec;
105   char *exec;
106   char *binary;
107   char *path;
108   char *categories;
109   char *startup_wm_class;
110   char **mime_types;
111
112   guint nodisplay       : 1;
113   guint hidden          : 1;
114   guint terminal        : 1;
115   guint startup_notify  : 1;
116   guint no_fuse         : 1;
117 };
118
119 typedef enum {
120   UPDATE_MIME_NONE = 1 << 0,
121   UPDATE_MIME_SET_DEFAULT = 1 << 1,
122   UPDATE_MIME_SET_NON_DEFAULT = 1 << 2,
123   UPDATE_MIME_REMOVE = 1 << 3,
124   UPDATE_MIME_SET_LAST_USED = 1 << 4,
125 } UpdateMimeFlags;
126
127 G_DEFINE_TYPE_WITH_CODE (GDesktopAppInfo, g_desktop_app_info, G_TYPE_OBJECT,
128                          G_IMPLEMENT_INTERFACE (G_TYPE_APP_INFO,
129                                                 g_desktop_app_info_iface_init))
130
131 G_LOCK_DEFINE_STATIC (g_desktop_env);
132 static gchar *g_desktop_env = NULL;
133
134 static gpointer
135 search_path_init (gpointer data)
136 {
137   char **args = NULL;
138   const char * const *data_dirs;
139   const char *user_data_dir;
140   int i, length, j;
141
142   data_dirs = g_get_system_data_dirs ();
143   length = g_strv_length ((char **) data_dirs);
144   
145   args = g_new (char *, length + 2);
146   
147   j = 0;
148   user_data_dir = g_get_user_data_dir ();
149   args[j++] = g_build_filename (user_data_dir, "applications", NULL);
150   for (i = 0; i < length; i++)
151     args[j++] = g_build_filename (data_dirs[i],
152                                   "applications", NULL);
153   args[j++] = NULL;
154   
155   return args;
156 }
157   
158 static const char * const *
159 get_applications_search_path (void)
160 {
161   static GOnce once_init = G_ONCE_INIT;
162   return g_once (&once_init, search_path_init, NULL);
163 }
164
165 static void
166 g_desktop_app_info_finalize (GObject *object)
167 {
168   GDesktopAppInfo *info;
169
170   info = G_DESKTOP_APP_INFO (object);
171
172   g_free (info->desktop_id);
173   g_free (info->filename);
174   g_free (info->name);
175   g_free (info->generic_name);
176   g_free (info->fullname);
177   g_free (info->comment);
178   g_free (info->icon_name);
179   if (info->icon)
180     g_object_unref (info->icon);
181   g_strfreev (info->keywords);
182   g_strfreev (info->only_show_in);
183   g_strfreev (info->not_show_in);
184   g_free (info->try_exec);
185   g_free (info->exec);
186   g_free (info->binary);
187   g_free (info->path);
188   g_free (info->categories);
189   g_free (info->startup_wm_class);
190   g_strfreev (info->mime_types);
191   
192   G_OBJECT_CLASS (g_desktop_app_info_parent_class)->finalize (object);
193 }
194
195 static void
196 g_desktop_app_info_set_property(GObject         *object,
197                                 guint            prop_id,
198                                 const GValue    *value,
199                                 GParamSpec      *pspec)
200 {
201   GDesktopAppInfo *self = G_DESKTOP_APP_INFO (object);
202
203   switch (prop_id)
204     {
205     case PROP_FILENAME:
206       self->filename = g_value_dup_string (value);
207       break;
208
209     default:
210       G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
211       break;
212     }
213 }
214
215 static void
216 g_desktop_app_info_get_property(GObject         *object,
217                                 guint            prop_id,
218                                 GValue          *value,
219                                 GParamSpec      *pspec)
220 {
221   GDesktopAppInfo *self = G_DESKTOP_APP_INFO (object);
222
223   switch (prop_id)
224     {
225     case PROP_FILENAME:
226       g_value_set_string (value, self->filename);
227       break;
228     default:
229       G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
230       break;
231     }
232 }
233
234 static void
235 g_desktop_app_info_class_init (GDesktopAppInfoClass *klass)
236 {
237   GObjectClass *gobject_class = G_OBJECT_CLASS (klass);
238   
239   gobject_class->get_property = g_desktop_app_info_get_property;
240   gobject_class->set_property = g_desktop_app_info_set_property;
241   gobject_class->finalize = g_desktop_app_info_finalize;
242
243   /**
244    * GDesktopAppInfo:filename:
245    *
246    * The origin filename of this #GDesktopAppInfo
247    */
248   g_object_class_install_property (gobject_class,
249                                    PROP_FILENAME,
250                                    g_param_spec_string ("filename", "Filename", "",
251                                                         NULL,
252                                                         G_PARAM_READWRITE | G_PARAM_CONSTRUCT_ONLY));
253 }
254
255 static void
256 g_desktop_app_info_init (GDesktopAppInfo *local)
257 {
258 }
259
260 static char *
261 binary_from_exec (const char *exec)
262 {
263   const char *p, *start;
264   
265   p = exec;
266   while (*p == ' ')
267     p++;
268   start = p;
269   while (*p != ' ' && *p != 0)
270     p++;
271   
272   return g_strndup (start, p - start);
273   
274 }
275
276 static gboolean
277 g_desktop_app_info_load_from_keyfile (GDesktopAppInfo *info, 
278                                       GKeyFile        *key_file)
279 {
280   char *start_group;
281   char *type;
282   char *try_exec;
283
284   start_group = g_key_file_get_start_group (key_file);
285   if (start_group == NULL || strcmp (start_group, G_KEY_FILE_DESKTOP_GROUP) != 0)
286     {
287       g_free (start_group);
288       return FALSE;
289     }
290   g_free (start_group);
291
292   type = g_key_file_get_string (key_file,
293                                 G_KEY_FILE_DESKTOP_GROUP,
294                                 G_KEY_FILE_DESKTOP_KEY_TYPE,
295                                 NULL);
296   if (type == NULL || strcmp (type, G_KEY_FILE_DESKTOP_TYPE_APPLICATION) != 0)
297     {
298       g_free (type);
299       return FALSE;
300     }
301   g_free (type);
302
303   try_exec = g_key_file_get_string (key_file,
304                                     G_KEY_FILE_DESKTOP_GROUP,
305                                     G_KEY_FILE_DESKTOP_KEY_TRY_EXEC,
306                                     NULL);
307   if (try_exec && try_exec[0] != '\0')
308     {
309       char *t;
310       t = g_find_program_in_path (try_exec);
311       if (t == NULL)
312         {
313           g_free (try_exec);
314           return FALSE;
315         }
316       g_free (t);
317     }
318
319   info->name = g_key_file_get_locale_string (key_file, G_KEY_FILE_DESKTOP_GROUP, G_KEY_FILE_DESKTOP_KEY_NAME, NULL, NULL);
320   info->generic_name = g_key_file_get_locale_string (key_file, G_KEY_FILE_DESKTOP_GROUP, GENERIC_NAME_KEY, NULL, NULL);
321   info->fullname = g_key_file_get_locale_string (key_file, G_KEY_FILE_DESKTOP_GROUP, FULL_NAME_KEY, NULL, NULL);
322   info->keywords = g_key_file_get_locale_string_list (key_file, G_KEY_FILE_DESKTOP_GROUP, KEYWORDS_KEY, NULL, NULL, NULL);
323   info->comment = g_key_file_get_locale_string (key_file, G_KEY_FILE_DESKTOP_GROUP, G_KEY_FILE_DESKTOP_KEY_COMMENT, NULL, NULL);
324   info->nodisplay = g_key_file_get_boolean (key_file, G_KEY_FILE_DESKTOP_GROUP, G_KEY_FILE_DESKTOP_KEY_NO_DISPLAY, NULL) != FALSE;
325   info->icon_name =  g_key_file_get_locale_string (key_file, G_KEY_FILE_DESKTOP_GROUP, G_KEY_FILE_DESKTOP_KEY_ICON, NULL, NULL);
326   info->only_show_in = g_key_file_get_string_list (key_file, G_KEY_FILE_DESKTOP_GROUP, G_KEY_FILE_DESKTOP_KEY_ONLY_SHOW_IN, NULL, NULL);
327   info->not_show_in = g_key_file_get_string_list (key_file, G_KEY_FILE_DESKTOP_GROUP, G_KEY_FILE_DESKTOP_KEY_NOT_SHOW_IN, NULL, NULL);
328   info->try_exec = try_exec;
329   info->exec = g_key_file_get_string (key_file, G_KEY_FILE_DESKTOP_GROUP, G_KEY_FILE_DESKTOP_KEY_EXEC, NULL);
330   info->path = g_key_file_get_string (key_file, G_KEY_FILE_DESKTOP_GROUP, G_KEY_FILE_DESKTOP_KEY_PATH, NULL);
331   info->terminal = g_key_file_get_boolean (key_file, G_KEY_FILE_DESKTOP_GROUP, G_KEY_FILE_DESKTOP_KEY_TERMINAL, NULL) != FALSE;
332   info->startup_notify = g_key_file_get_boolean (key_file, G_KEY_FILE_DESKTOP_GROUP, G_KEY_FILE_DESKTOP_KEY_STARTUP_NOTIFY, NULL) != FALSE;
333   info->no_fuse = g_key_file_get_boolean (key_file, G_KEY_FILE_DESKTOP_GROUP, "X-GIO-NoFuse", NULL) != FALSE;
334   info->hidden = g_key_file_get_boolean (key_file, G_KEY_FILE_DESKTOP_GROUP, G_KEY_FILE_DESKTOP_KEY_HIDDEN, NULL) != FALSE;
335   info->categories = g_key_file_get_string (key_file, G_KEY_FILE_DESKTOP_GROUP, G_KEY_FILE_DESKTOP_KEY_CATEGORIES, NULL);
336   info->startup_wm_class = g_key_file_get_string (key_file, G_KEY_FILE_DESKTOP_GROUP, STARTUP_WM_CLASS_KEY, NULL);
337   info->mime_types = g_key_file_get_string_list (key_file, G_KEY_FILE_DESKTOP_GROUP, G_KEY_FILE_DESKTOP_KEY_MIME_TYPE, NULL, NULL);
338   
339   info->icon = NULL;
340   if (info->icon_name)
341     {
342       if (g_path_is_absolute (info->icon_name))
343         {
344           GFile *file;
345           
346           file = g_file_new_for_path (info->icon_name);
347           info->icon = g_file_icon_new (file);
348           g_object_unref (file);
349         }
350       else
351         {
352           char *p;
353
354           /* Work around a common mistake in desktop files */    
355           if ((p = strrchr (info->icon_name, '.')) != NULL &&
356               (strcmp (p, ".png") == 0 ||
357                strcmp (p, ".xpm") == 0 ||
358                strcmp (p, ".svg") == 0)) 
359             *p = 0;
360
361           info->icon = g_themed_icon_new (info->icon_name);
362         }
363     }
364   
365   if (info->exec)
366     info->binary = binary_from_exec (info->exec);
367   
368   if (info->path && info->path[0] == '\0')
369     {
370       g_free (info->path);
371       info->path = NULL;
372     }
373
374   return TRUE;
375 }
376
377 static gboolean
378 g_desktop_app_info_load_file (GDesktopAppInfo *self)
379 {
380   GKeyFile *key_file;
381   gboolean retval = FALSE;
382   
383   g_return_val_if_fail (self->filename != NULL, FALSE);
384
385   key_file = g_key_file_new ();
386   
387   if (g_key_file_load_from_file (key_file,
388                                  self->filename,
389                                  G_KEY_FILE_NONE,
390                                  NULL))
391     {
392       retval = g_desktop_app_info_load_from_keyfile (self, key_file);
393     }
394
395   g_key_file_free (key_file);
396   return retval;
397 }
398
399 /**
400  * g_desktop_app_info_new_from_keyfile:
401  * @key_file: an opened #GKeyFile
402  * 
403  * Creates a new #GDesktopAppInfo.
404  *
405  * Returns: a new #GDesktopAppInfo or %NULL on error.
406  *
407  * Since: 2.18
408  **/
409 GDesktopAppInfo *
410 g_desktop_app_info_new_from_keyfile (GKeyFile *key_file)
411 {
412   GDesktopAppInfo *info;
413
414   info = g_object_new (G_TYPE_DESKTOP_APP_INFO, NULL);
415   info->filename = NULL;
416   if (!g_desktop_app_info_load_from_keyfile (info, key_file))
417     {
418       g_object_unref (info);
419       return NULL;
420     }
421   return info;
422 }
423
424 /**
425  * g_desktop_app_info_new_from_filename:
426  * @filename: the path of a desktop file, in the GLib filename encoding
427  * 
428  * Creates a new #GDesktopAppInfo.
429  *
430  * Returns: a new #GDesktopAppInfo or %NULL on error.
431  **/
432 GDesktopAppInfo *
433 g_desktop_app_info_new_from_filename (const char *filename)
434 {
435   GDesktopAppInfo *info = NULL;
436
437   info = g_object_new (G_TYPE_DESKTOP_APP_INFO, "filename", filename, NULL);
438   if (!g_desktop_app_info_load_file (info))
439     {
440       g_object_unref (info);
441       return NULL;
442     }
443   return info;
444 }
445
446 /**
447  * g_desktop_app_info_new:
448  * @desktop_id: the desktop file id
449  * 
450  * Creates a new #GDesktopAppInfo based on a desktop file id. 
451  *
452  * A desktop file id is the basename of the desktop file, including the 
453  * .desktop extension. GIO is looking for a desktop file with this name 
454  * in the <filename>applications</filename> subdirectories of the XDG data
455  * directories (i.e. the directories specified in the 
456  * <envar>XDG_DATA_HOME</envar> and <envar>XDG_DATA_DIRS</envar> environment 
457  * variables). GIO also supports the prefix-to-subdirectory mapping that is
458  * described in the <ulink url="http://standards.freedesktop.org/menu-spec/latest/">Menu Spec</ulink> 
459  * (i.e. a desktop id of kde-foo.desktop will match
460  * <filename>/usr/share/applications/kde/foo.desktop</filename>).
461  * 
462  * Returns: a new #GDesktopAppInfo, or %NULL if no desktop file with that id
463  */
464 GDesktopAppInfo *
465 g_desktop_app_info_new (const char *desktop_id)
466 {
467   GDesktopAppInfo *appinfo;
468   const char * const *dirs;
469   char *basename;
470   int i;
471
472   dirs = get_applications_search_path ();
473
474   basename = g_strdup (desktop_id);
475   
476   for (i = 0; dirs[i] != NULL; i++)
477     {
478       char *filename;
479       char *p;
480
481       filename = g_build_filename (dirs[i], desktop_id, NULL);
482       appinfo = g_desktop_app_info_new_from_filename (filename);
483       g_free (filename);
484       if (appinfo != NULL)
485         goto found;
486
487       p = basename;
488       while ((p = strchr (p, '-')) != NULL)
489         {
490           *p = '/';
491           
492           filename = g_build_filename (dirs[i], basename, NULL);
493           appinfo = g_desktop_app_info_new_from_filename (filename);
494           g_free (filename);
495           if (appinfo != NULL)
496             goto found;
497           *p = '-';
498           p++;
499         }
500     }
501   
502   g_free (basename);
503   return NULL;
504
505  found:
506   g_free (basename);
507   
508   appinfo->desktop_id = g_strdup (desktop_id);
509
510   if (g_desktop_app_info_get_is_hidden (appinfo))
511     {
512       g_object_unref (appinfo);
513       appinfo = NULL;
514     }
515   
516   return appinfo;
517 }
518
519 static GAppInfo *
520 g_desktop_app_info_dup (GAppInfo *appinfo)
521 {
522   GDesktopAppInfo *info = G_DESKTOP_APP_INFO (appinfo);
523   GDesktopAppInfo *new_info;
524   
525   new_info = g_object_new (G_TYPE_DESKTOP_APP_INFO, NULL);
526
527   new_info->filename = g_strdup (info->filename);
528   new_info->desktop_id = g_strdup (info->desktop_id);
529   
530   new_info->name = g_strdup (info->name);
531   new_info->generic_name = g_strdup (info->generic_name);
532   new_info->fullname = g_strdup (info->fullname);
533   new_info->keywords = g_strdupv (info->keywords);
534   new_info->comment = g_strdup (info->comment);
535   new_info->nodisplay = info->nodisplay;
536   new_info->icon_name = g_strdup (info->icon_name);
537   if (info->icon)
538     new_info->icon = g_object_ref (info->icon);
539   new_info->only_show_in = g_strdupv (info->only_show_in);
540   new_info->not_show_in = g_strdupv (info->not_show_in);
541   new_info->try_exec = g_strdup (info->try_exec);
542   new_info->exec = g_strdup (info->exec);
543   new_info->binary = g_strdup (info->binary);
544   new_info->path = g_strdup (info->path);
545   new_info->hidden = info->hidden;
546   new_info->terminal = info->terminal;
547   new_info->startup_notify = info->startup_notify;
548   
549   return G_APP_INFO (new_info);
550 }
551
552 static gboolean
553 g_desktop_app_info_equal (GAppInfo *appinfo1,
554                           GAppInfo *appinfo2)
555 {
556   GDesktopAppInfo *info1 = G_DESKTOP_APP_INFO (appinfo1);
557   GDesktopAppInfo *info2 = G_DESKTOP_APP_INFO (appinfo2);
558
559   if (info1->desktop_id == NULL ||
560       info2->desktop_id == NULL)
561     return info1 == info2;
562
563   return strcmp (info1->desktop_id, info2->desktop_id) == 0;
564 }
565
566 static const char *
567 g_desktop_app_info_get_id (GAppInfo *appinfo)
568 {
569   GDesktopAppInfo *info = G_DESKTOP_APP_INFO (appinfo);
570
571   return info->desktop_id;
572 }
573
574 static const char *
575 g_desktop_app_info_get_name (GAppInfo *appinfo)
576 {
577   GDesktopAppInfo *info = G_DESKTOP_APP_INFO (appinfo);
578
579   if (info->name == NULL)
580     return _("Unnamed");
581   return info->name;
582 }
583
584 static const char *
585 g_desktop_app_info_get_display_name (GAppInfo *appinfo)
586 {
587   GDesktopAppInfo *info = G_DESKTOP_APP_INFO (appinfo);
588
589   if (info->fullname == NULL)
590     return g_desktop_app_info_get_name (appinfo);
591   return info->fullname;
592 }
593
594 /**
595  * g_desktop_app_info_get_is_hidden:
596  * @info: a #GDesktopAppInfo.
597  *
598  * A desktop file is hidden if the Hidden key in it is
599  * set to True.
600  *
601  * Returns: %TRUE if hidden, %FALSE otherwise. 
602  **/
603 gboolean
604 g_desktop_app_info_get_is_hidden (GDesktopAppInfo *info)
605 {
606   return info->hidden;
607 }
608
609 /**
610  * g_desktop_app_info_get_filename:
611  * @info: a #GDesktopAppInfo
612  *
613  * When @info was created from a known filename, return it.  In some
614  * situations such as the #GDesktopAppInfo returned from
615  * g_desktop_app_info_new_from_keyfile(), this function will return %NULL.
616  *
617  * Returns: The full path to the file for @info, or %NULL if not known.
618  * Since: 2.24
619  */
620 const char *
621 g_desktop_app_info_get_filename (GDesktopAppInfo *info)
622 {
623   return info->filename;
624 }
625
626 static const char *
627 g_desktop_app_info_get_description (GAppInfo *appinfo)
628 {
629   GDesktopAppInfo *info = G_DESKTOP_APP_INFO (appinfo);
630   
631   return info->comment;
632 }
633
634 static const char *
635 g_desktop_app_info_get_executable (GAppInfo *appinfo)
636 {
637   GDesktopAppInfo *info = G_DESKTOP_APP_INFO (appinfo);
638   
639   return info->binary;
640 }
641
642 static const char *
643 g_desktop_app_info_get_commandline (GAppInfo *appinfo)
644 {
645   GDesktopAppInfo *info = G_DESKTOP_APP_INFO (appinfo);
646   
647   return info->exec;
648 }
649
650 static GIcon *
651 g_desktop_app_info_get_icon (GAppInfo *appinfo)
652 {
653   GDesktopAppInfo *info = G_DESKTOP_APP_INFO (appinfo);
654
655   return info->icon;
656 }
657
658 /**
659  * g_desktop_app_info_get_categories:
660  * @info: a #GDesktopAppInfo
661  *
662  * Gets the categories from the desktop file.
663  *
664  * Returns: The unparsed Categories key from the desktop file;
665  *     i.e. no attempt is made to split it by ';' or validate it.
666  */
667 const char *
668 g_desktop_app_info_get_categories (GDesktopAppInfo *info)
669 {
670   return info->categories;
671 }
672
673 /**
674  * g_desktop_app_info_get_keywords:
675  * @info: a #GDesktopAppInfo
676  *
677  * Gets the keywords from the desktop file.
678  *
679  * Returns: (transfer none): The value of the Keywords key
680  *
681  * Since: 2.32
682  */
683 const char * const *
684 g_desktop_app_info_get_keywords (GDesktopAppInfo *info)
685 {
686   return (const char * const *)info->keywords;
687 }
688
689 /**
690  * g_desktop_app_info_get_generic_name:
691  * @info: a #GDesktopAppInfo
692  *
693  * Gets the generic name from the destkop file.
694  *
695  * Returns: The value of the GenericName key
696  */
697 const char *
698 g_desktop_app_info_get_generic_name (GDesktopAppInfo *info)
699 {
700   return info->generic_name;
701 }
702
703 /**
704  * g_desktop_app_info_get_nodisplay:
705  * @info: a #GDesktopAppInfo
706  *
707  * Gets the value of the NoDisplay key, which helps determine if the
708  * application info should be shown in menus. See
709  * #G_KEY_FILE_DESKTOP_KEY_NO_DISPLAY and g_app_info_should_show().
710  *
711  * Returns: The value of the NoDisplay key
712  *
713  * Since: 2.30
714  */
715 gboolean
716 g_desktop_app_info_get_nodisplay (GDesktopAppInfo *info)
717 {
718   return info->nodisplay;
719 }
720
721 /**
722  * g_desktop_app_info_get_show_in:
723  * @info: a #GDesktopAppInfo
724  * @desktop_env: a string specifying a desktop name
725  *
726  * Checks if the application info should be shown in menus that list available
727  * applications for a specific name of the desktop, based on the
728  * <literal>OnlyShowIn</literal> and <literal>NotShowIn</literal> keys.
729  *
730  * If @desktop_env is %NULL, then the name of the desktop set with
731  * g_desktop_app_info_set_desktop_env() is used.
732  *
733  * Note that g_app_info_should_show() for @info will include this check (with
734  * %NULL for @desktop_env) as well as additional checks.
735  *
736  * Returns: %TRUE if the @info should be shown in @desktop_env according to the
737  * <literal>OnlyShowIn</literal> and <literal>NotShowIn</literal> keys, %FALSE
738  * otherwise.
739  *
740  * Since: 2.30
741  */
742 gboolean
743 g_desktop_app_info_get_show_in (GDesktopAppInfo *info,
744                                 const gchar     *desktop_env)
745 {
746   gboolean found;
747   int i;
748
749   g_return_val_if_fail (G_IS_DESKTOP_APP_INFO (info), FALSE);
750
751   if (!desktop_env) {
752     G_LOCK (g_desktop_env);
753     desktop_env = g_desktop_env;
754     G_UNLOCK (g_desktop_env);
755   }
756
757   if (info->only_show_in)
758     {
759       if (desktop_env == NULL)
760         return FALSE;
761
762       found = FALSE;
763       for (i = 0; info->only_show_in[i] != NULL; i++)
764         {
765           if (strcmp (info->only_show_in[i], desktop_env) == 0)
766             {
767               found = TRUE;
768               break;
769             }
770         }
771       if (!found)
772         return FALSE;
773     }
774
775   if (info->not_show_in && desktop_env)
776     {
777       for (i = 0; info->not_show_in[i] != NULL; i++)
778         {
779           if (strcmp (info->not_show_in[i], desktop_env) == 0)
780             return FALSE;
781         }
782     }
783
784   return TRUE;
785 }
786
787 static char *
788 expand_macro_single (char macro, char *uri)
789 {
790   GFile *file;
791   char *result = NULL;
792   char *path, *name;
793
794   file = g_file_new_for_uri (uri);
795   path = g_file_get_path (file);
796   g_object_unref (file);
797   
798   switch (macro)
799     {
800     case 'u':
801     case 'U':   
802       result = g_shell_quote (uri);
803       break;
804     case 'f':
805     case 'F':
806       if (path)
807         result = g_shell_quote (path);
808       break;
809     case 'd':
810     case 'D':
811       if (path)
812         {
813           name = g_path_get_dirname (path);
814           result = g_shell_quote (name);
815           g_free (name);
816         }
817       break;
818     case 'n':
819     case 'N':
820       if (path)
821         {
822           name = g_path_get_basename (path);
823           result = g_shell_quote (name);
824           g_free (name);
825         }
826       break;
827     }
828
829   g_free (path);
830   
831   return result;
832 }
833
834 static void
835 expand_macro (char              macro, 
836               GString          *exec, 
837               GDesktopAppInfo  *info, 
838               GList           **uri_list)
839 {
840   GList *uris = *uri_list;
841   char *expanded;
842   gboolean force_file_uri;
843   char force_file_uri_macro;
844   char *uri;
845
846   g_return_if_fail (exec != NULL);
847
848   /* On %u and %U, pass POSIX file path pointing to the URI via
849    * the FUSE mount in ~/.gvfs. Note that if the FUSE daemon isn't
850    * running or the URI doesn't have a POSIX file path via FUSE
851    * we'll just pass the URI.
852    */
853   force_file_uri_macro = macro;
854   force_file_uri = FALSE;
855   if (!info->no_fuse)
856     {
857       switch (macro)
858         {
859         case 'u':
860           force_file_uri_macro = 'f';
861           force_file_uri = TRUE;
862           break;
863         case 'U':
864           force_file_uri_macro = 'F';
865           force_file_uri = TRUE;
866           break;
867         default:
868           break;
869         }
870     }
871
872   switch (macro)
873     {
874     case 'u':
875     case 'f':
876     case 'd':
877     case 'n':
878       if (uris)
879         {
880           uri = uris->data;
881           if (!force_file_uri ||
882               /* Pass URI if it contains an anchor */
883               strchr (uri, '#') != NULL)
884             {
885               expanded = expand_macro_single (macro, uri);
886             }
887           else
888             {
889               expanded = expand_macro_single (force_file_uri_macro, uri);
890               if (expanded == NULL)
891                 expanded = expand_macro_single (macro, uri);
892             }
893
894           if (expanded)
895             {
896               g_string_append (exec, expanded);
897               g_free (expanded);
898             }
899           uris = uris->next;
900         }
901
902       break;
903
904     case 'U':   
905     case 'F':
906     case 'D':
907     case 'N':
908       while (uris)
909         {
910           uri = uris->data;
911           
912           if (!force_file_uri ||
913               /* Pass URI if it contains an anchor */
914               strchr (uri, '#') != NULL)
915             {
916               expanded = expand_macro_single (macro, uri);
917             }
918           else
919             {
920               expanded = expand_macro_single (force_file_uri_macro, uri);
921               if (expanded == NULL)
922                 expanded = expand_macro_single (macro, uri);
923             }
924
925           if (expanded)
926             {
927               g_string_append (exec, expanded);
928               g_free (expanded);
929             }
930           
931           uris = uris->next;
932           
933           if (uris != NULL && expanded)
934             g_string_append_c (exec, ' ');
935         }
936
937       break;
938
939     case 'i':
940       if (info->icon_name)
941         {
942           g_string_append (exec, "--icon ");
943           expanded = g_shell_quote (info->icon_name);
944           g_string_append (exec, expanded);
945           g_free (expanded);
946         }
947       break;
948
949     case 'c':
950       if (info->name) 
951         {
952           expanded = g_shell_quote (info->name);
953           g_string_append (exec, expanded);
954           g_free (expanded);
955         }
956       break;
957
958     case 'k':
959       if (info->filename) 
960         {
961           expanded = g_shell_quote (info->filename);
962           g_string_append (exec, expanded);
963           g_free (expanded);
964         }
965       break;
966
967     case 'm': /* deprecated */
968       break;
969
970     case '%':
971       g_string_append_c (exec, '%');
972       break;
973     }
974   
975   *uri_list = uris;
976 }
977
978 static gboolean
979 expand_application_parameters (GDesktopAppInfo   *info,
980                                GList            **uris,
981                                int               *argc,
982                                char            ***argv,
983                                GError           **error)
984 {
985   GList *uri_list = *uris;
986   const char *p = info->exec;
987   GString *expanded_exec;
988   gboolean res;
989
990   if (info->exec == NULL)
991     {
992       g_set_error_literal (error, G_IO_ERROR, G_IO_ERROR_FAILED,
993                            _("Desktop file didn't specify Exec field"));
994       return FALSE;
995     }
996
997   expanded_exec = g_string_new (NULL);
998
999   while (*p)
1000     {
1001       if (p[0] == '%' && p[1] != '\0')
1002         {
1003           expand_macro (p[1], expanded_exec, info, uris);
1004           p++;
1005         }
1006       else
1007         g_string_append_c (expanded_exec, *p);
1008
1009       p++;
1010     }
1011
1012   /* No file substitutions */
1013   if (uri_list == *uris && uri_list != NULL)
1014     {
1015       /* If there is no macro default to %f. This is also what KDE does */
1016       g_string_append_c (expanded_exec, ' ');
1017       expand_macro ('f', expanded_exec, info, uris);
1018     }
1019
1020   res = g_shell_parse_argv (expanded_exec->str, argc, argv, error);
1021   g_string_free (expanded_exec, TRUE);
1022   return res;
1023 }
1024
1025 static gboolean
1026 prepend_terminal_to_vector (int    *argc,
1027                             char ***argv)
1028 {
1029 #ifndef G_OS_WIN32
1030   char **real_argv;
1031   int real_argc;
1032   int i, j;
1033   char **term_argv = NULL;
1034   int term_argc = 0;
1035   char *check;
1036   char **the_argv;
1037   
1038   g_return_val_if_fail (argc != NULL, FALSE);
1039   g_return_val_if_fail (argv != NULL, FALSE);
1040         
1041   /* sanity */
1042   if(*argv == NULL)
1043     *argc = 0;
1044   
1045   the_argv = *argv;
1046
1047   /* compute size if not given */
1048   if (*argc < 0)
1049     {
1050       for (i = 0; the_argv[i] != NULL; i++)
1051         ;
1052       *argc = i;
1053     }
1054   
1055   term_argc = 2;
1056   term_argv = g_new0 (char *, 3);
1057
1058   check = g_find_program_in_path ("gnome-terminal");
1059   if (check != NULL)
1060     {
1061       term_argv[0] = check;
1062       /* Note that gnome-terminal takes -x and
1063        * as -e in gnome-terminal is broken we use that. */
1064       term_argv[1] = g_strdup ("-x");
1065     }
1066   else
1067     {
1068       if (check == NULL)
1069         check = g_find_program_in_path ("nxterm");
1070       if (check == NULL)
1071         check = g_find_program_in_path ("color-xterm");
1072       if (check == NULL)
1073         check = g_find_program_in_path ("rxvt");
1074       if (check == NULL)
1075         check = g_find_program_in_path ("xterm");
1076       if (check == NULL)
1077         check = g_find_program_in_path ("dtterm");
1078       if (check == NULL)
1079         {
1080           check = g_strdup ("xterm");
1081           g_warning ("couldn't find a terminal, falling back to xterm");
1082         }
1083       term_argv[0] = check;
1084       term_argv[1] = g_strdup ("-e");
1085     }
1086
1087   real_argc = term_argc + *argc;
1088   real_argv = g_new (char *, real_argc + 1);
1089   
1090   for (i = 0; i < term_argc; i++)
1091     real_argv[i] = term_argv[i];
1092   
1093   for (j = 0; j < *argc; j++, i++)
1094     real_argv[i] = (char *)the_argv[j];
1095   
1096   real_argv[i] = NULL;
1097   
1098   g_free (*argv);
1099   *argv = real_argv;
1100   *argc = real_argc;
1101   
1102   /* we use g_free here as we sucked all the inner strings
1103    * out from it into real_argv */
1104   g_free (term_argv);
1105   return TRUE;
1106 #else
1107   return FALSE;
1108 #endif /* G_OS_WIN32 */
1109 }
1110
1111 static GList *
1112 create_files_for_uris (GList *uris)
1113 {
1114   GList *res;
1115   GList *iter;
1116
1117   res = NULL;
1118
1119   for (iter = uris; iter; iter = iter->next)
1120     {
1121       GFile *file = g_file_new_for_uri ((char *)iter->data);
1122       res = g_list_prepend (res, file);
1123     }
1124
1125   return g_list_reverse (res);
1126 }
1127
1128 typedef struct
1129 {
1130   GSpawnChildSetupFunc user_setup;
1131   gpointer user_setup_data;
1132
1133   char *pid_envvar;
1134 } ChildSetupData;
1135
1136 static void
1137 child_setup (gpointer user_data)
1138 {
1139   ChildSetupData *data = user_data;
1140
1141   if (data->pid_envvar)
1142     {
1143       pid_t pid = getpid ();
1144       char buf[20];
1145       int i;
1146
1147       /* Write the pid into the space already reserved for it in the
1148        * environment array. We can't use sprintf because it might
1149        * malloc, so we do it by hand. It's simplest to write the pid
1150        * out backwards first, then copy it over.
1151        */
1152       for (i = 0; pid; i++, pid /= 10)
1153         buf[i] = (pid % 10) + '0';
1154       for (i--; i >= 0; i--)
1155         *(data->pid_envvar++) = buf[i];
1156       *data->pid_envvar = '\0';
1157     }
1158
1159   if (data->user_setup)
1160     data->user_setup (data->user_setup_data);
1161 }
1162
1163 static void
1164 notify_desktop_launch (GDBusConnection  *session_bus,
1165                        GDesktopAppInfo  *info,
1166                        long              pid,
1167                        const char       *display,
1168                        const char       *sn_id,
1169                        GList            *uris)
1170 {
1171   GDBusMessage *msg;
1172   GVariantBuilder uri_variant;
1173   GVariantBuilder extras_variant;
1174   GList *iter;
1175   const char *desktop_file_id;
1176   const char *gio_desktop_file;
1177
1178   if (session_bus == NULL)
1179     return;
1180
1181   g_variant_builder_init (&uri_variant, G_VARIANT_TYPE ("as"));
1182   for (iter = uris; iter; iter = iter->next)
1183     g_variant_builder_add (&uri_variant, "s", iter->data);
1184
1185   g_variant_builder_init (&extras_variant, G_VARIANT_TYPE ("a{sv}"));
1186   if (sn_id != NULL && g_utf8_validate (sn_id, -1, NULL))
1187     g_variant_builder_add (&extras_variant, "{sv}",
1188                            "startup-id",
1189                            g_variant_new ("s",
1190                                           sn_id));
1191   gio_desktop_file = g_getenv ("GIO_LAUNCHED_DESKTOP_FILE");
1192   if (gio_desktop_file != NULL)
1193     g_variant_builder_add (&extras_variant, "{sv}",
1194                            "origin-desktop-file",
1195                            g_variant_new_bytestring (gio_desktop_file));
1196   if (g_get_prgname () != NULL)
1197     g_variant_builder_add (&extras_variant, "{sv}",
1198                            "origin-prgname",
1199                            g_variant_new_bytestring (g_get_prgname ()));
1200   g_variant_builder_add (&extras_variant, "{sv}",
1201                          "origin-pid",
1202                          g_variant_new ("x",
1203                                         (gint64)getpid ()));
1204
1205   if (info->filename)
1206     desktop_file_id = info->filename;
1207   else if (info->desktop_id)
1208     desktop_file_id = info->desktop_id;
1209   else
1210     desktop_file_id = "";
1211   
1212   msg = g_dbus_message_new_signal ("/org/gtk/gio/DesktopAppInfo",
1213                                    "org.gtk.gio.DesktopAppInfo",
1214                                    "Launched");
1215   g_dbus_message_set_body (msg, g_variant_new ("(@aysxasa{sv})",
1216                                                g_variant_new_bytestring (desktop_file_id),
1217                                                display ? display : "",
1218                                                (gint64)pid,
1219                                                &uri_variant,
1220                                                &extras_variant));
1221   g_dbus_connection_send_message (session_bus,
1222                                   msg, 0,
1223                                   NULL,
1224                                   NULL);
1225   g_object_unref (msg);
1226 }
1227
1228 #define _SPAWN_FLAGS_DEFAULT (G_SPAWN_SEARCH_PATH)
1229
1230 static gboolean
1231 _g_desktop_app_info_launch_uris_internal (GAppInfo                   *appinfo,
1232                                           GList                      *uris,
1233                                           GAppLaunchContext          *launch_context,
1234                                           GSpawnFlags                 spawn_flags,
1235                                           GSpawnChildSetupFunc        user_setup,
1236                                           gpointer                    user_setup_data,
1237                                           GDesktopAppLaunchCallback   pid_callback,
1238                                           gpointer                    pid_callback_data,
1239                                           GError                     **error)
1240 {
1241   GDesktopAppInfo *info = G_DESKTOP_APP_INFO (appinfo);
1242   GDBusConnection *session_bus;
1243   gboolean completed = FALSE;
1244   GList *old_uris;
1245   char **argv, **envp;
1246   int argc;
1247   ChildSetupData data;
1248
1249   g_return_val_if_fail (appinfo != NULL, FALSE);
1250
1251   argv = NULL;
1252
1253   session_bus = g_bus_get_sync (G_BUS_TYPE_SESSION, NULL, NULL);
1254
1255   if (launch_context)
1256     envp = g_app_launch_context_get_environment (launch_context);
1257   else
1258     envp = g_get_environ ();
1259
1260   do
1261     {
1262       GPid pid;
1263       GList *launched_uris;
1264       GList *iter;
1265       char *display, *sn_id;
1266
1267       old_uris = uris;
1268       if (!expand_application_parameters (info, &uris,
1269                                           &argc, &argv, error))
1270         goto out;
1271
1272       /* Get the subset of URIs we're launching with this process */
1273       launched_uris = NULL;
1274       for (iter = old_uris; iter != NULL && iter != uris; iter = iter->next)
1275         launched_uris = g_list_prepend (launched_uris, iter->data);
1276       launched_uris = g_list_reverse (launched_uris);
1277
1278       if (info->terminal && !prepend_terminal_to_vector (&argc, &argv))
1279         {
1280           g_set_error_literal (error, G_IO_ERROR, G_IO_ERROR_FAILED,
1281                                _("Unable to find terminal required for application"));
1282           goto out;
1283         }
1284
1285       data.user_setup = user_setup;
1286       data.user_setup_data = user_setup_data;
1287
1288       if (info->filename)
1289         {
1290           envp = g_environ_setenv (envp,
1291                                    "GIO_LAUNCHED_DESKTOP_FILE",
1292                                    info->filename,
1293                                    TRUE);
1294           envp = g_environ_setenv (envp,
1295                                    "GIO_LAUNCHED_DESKTOP_FILE_PID",
1296                                    "XXXXXXXXXXXXXXXXXXXX", /* filled in child_setup */
1297                                    TRUE);
1298           data.pid_envvar = (char *)g_environ_getenv (envp, "GIO_LAUNCHED_DESKTOP_FILE_PID");
1299         }
1300       else
1301         {
1302           data.pid_envvar = NULL;
1303         }
1304
1305       display = NULL;
1306       sn_id = NULL;
1307       if (launch_context)
1308         {
1309           GList *launched_files = create_files_for_uris (launched_uris);
1310
1311           display = g_app_launch_context_get_display (launch_context,
1312                                                       appinfo,
1313                                                       launched_files);
1314           if (display)
1315             envp = g_environ_setenv (envp, "DISPLAY", display, TRUE);
1316
1317           if (info->startup_notify)
1318             {
1319               sn_id = g_app_launch_context_get_startup_notify_id (launch_context,
1320                                                                   appinfo,
1321                                                                   launched_files);
1322               envp = g_environ_setenv (envp, "DESKTOP_STARTUP_ID", sn_id, TRUE);
1323             }
1324
1325           g_list_free_full (launched_files, g_object_unref);
1326         }
1327
1328       if (!g_spawn_async (info->path,
1329                           argv,
1330                           envp,
1331                           spawn_flags,
1332                           child_setup,
1333                           &data,
1334                           &pid,
1335                           error))
1336         {
1337           if (sn_id)
1338             g_app_launch_context_launch_failed (launch_context, sn_id);
1339
1340           g_free (display);
1341           g_free (sn_id);
1342           g_list_free (launched_uris);
1343
1344           goto out;
1345         }
1346
1347       if (pid_callback != NULL)
1348         pid_callback (info, pid, pid_callback_data);
1349
1350       notify_desktop_launch (session_bus,
1351                              info,
1352                              pid,
1353                              display,
1354                              sn_id,
1355                              launched_uris);
1356
1357       g_free (display);
1358       g_free (sn_id);
1359       g_list_free (launched_uris);
1360
1361       g_strfreev (argv);
1362       argv = NULL;
1363     }
1364   while (uris != NULL);
1365
1366   /* TODO - need to handle the process exiting immediately
1367    * after launching an app.  See http://bugzilla.gnome.org/606960
1368    */
1369   if (session_bus != NULL)
1370     {
1371       /* This asynchronous flush holds a reference until it completes,
1372        * which ensures that the following unref won't immediately kill
1373        * the connection if we were the initial owner.
1374        */
1375       g_dbus_connection_flush (session_bus, NULL, NULL, NULL);
1376     }
1377
1378   completed = TRUE;
1379
1380  out:
1381   g_clear_object (&session_bus);
1382   g_strfreev (argv);
1383   g_strfreev (envp);
1384
1385   return completed;
1386 }
1387
1388 static gboolean
1389 g_desktop_app_info_launch_uris (GAppInfo           *appinfo,
1390                                 GList              *uris,
1391                                 GAppLaunchContext  *launch_context,
1392                                 GError            **error)
1393 {
1394   return _g_desktop_app_info_launch_uris_internal (appinfo, uris,
1395                                                    launch_context,
1396                                                    _SPAWN_FLAGS_DEFAULT,
1397                                                    NULL, NULL, NULL, NULL,
1398                                                    error);
1399 }
1400
1401 static gboolean
1402 g_desktop_app_info_supports_uris (GAppInfo *appinfo)
1403 {
1404   GDesktopAppInfo *info = G_DESKTOP_APP_INFO (appinfo);
1405  
1406   return info->exec && 
1407     ((strstr (info->exec, "%u") != NULL) ||
1408      (strstr (info->exec, "%U") != NULL));
1409 }
1410
1411 static gboolean
1412 g_desktop_app_info_supports_files (GAppInfo *appinfo)
1413 {
1414   GDesktopAppInfo *info = G_DESKTOP_APP_INFO (appinfo);
1415  
1416   return info->exec && 
1417     ((strstr (info->exec, "%f") != NULL) ||
1418      (strstr (info->exec, "%F") != NULL));
1419 }
1420
1421 static gboolean
1422 g_desktop_app_info_launch (GAppInfo           *appinfo,
1423                            GList              *files,
1424                            GAppLaunchContext  *launch_context,
1425                            GError            **error)
1426 {
1427   GList *uris;
1428   char *uri;
1429   gboolean res;
1430
1431   uris = NULL;
1432   while (files)
1433     {
1434       uri = g_file_get_uri (files->data);
1435       uris = g_list_prepend (uris, uri);
1436       files = files->next;
1437     }
1438   
1439   uris = g_list_reverse (uris);
1440   
1441   res = g_desktop_app_info_launch_uris (appinfo, uris, launch_context, error);
1442   
1443   g_list_free_full (uris, g_free);
1444   
1445   return res;
1446 }
1447
1448 /**
1449  * g_desktop_app_info_launch_uris_as_manager:
1450  * @appinfo: a #GDesktopAppInfo
1451  * @uris: (element-type utf8): List of URIs
1452  * @launch_context: a #GAppLaunchContext
1453  * @spawn_flags: #GSpawnFlags, used for each process
1454  * @user_setup: (scope call): a #GSpawnChildSetupFunc, used once for
1455  *     each process.
1456  * @user_setup_data: (closure user_setup): User data for @user_setup
1457  * @pid_callback: (scope call): Callback for child processes
1458  * @pid_callback_data: (closure pid_callback): User data for @callback
1459  * @error: return location for a #GError, or %NULL
1460  *
1461  * This function performs the equivalent of g_app_info_launch_uris(),
1462  * but is intended primarily for operating system components that
1463  * launch applications.  Ordinary applications should use
1464  * g_app_info_launch_uris().
1465  *
1466  * In contrast to g_app_info_launch_uris(), all processes created will
1467  * always be run directly as children as if by the UNIX fork()/exec()
1468  * calls.
1469  *
1470  * This guarantee allows additional control over the exact environment
1471  * of the child processes, which is provided via a setup function
1472  * @user_setup, as well as the process identifier of each child process
1473  * via @pid_callback. See g_spawn_async() for more information about the
1474  * semantics of the @user_setup function.
1475  *
1476  * Returns: %TRUE on successful launch, %FALSE otherwise.
1477  */
1478 gboolean
1479 g_desktop_app_info_launch_uris_as_manager (GDesktopAppInfo            *appinfo,
1480                                            GList                      *uris,
1481                                            GAppLaunchContext          *launch_context,
1482                                            GSpawnFlags                 spawn_flags,
1483                                            GSpawnChildSetupFunc        user_setup,
1484                                            gpointer                    user_setup_data,
1485                                            GDesktopAppLaunchCallback   pid_callback,
1486                                            gpointer                    pid_callback_data,
1487                                            GError                    **error)
1488 {
1489   return _g_desktop_app_info_launch_uris_internal ((GAppInfo*)appinfo,
1490                                                    uris,
1491                                                    launch_context,
1492                                                    spawn_flags,
1493                                                    user_setup,
1494                                                    user_setup_data,
1495                                                    pid_callback,
1496                                                    pid_callback_data,
1497                                                    error);
1498 }
1499
1500 /**
1501  * g_desktop_app_info_set_desktop_env:
1502  * @desktop_env: a string specifying what desktop this is
1503  *
1504  * Sets the name of the desktop that the application is running in.
1505  * This is used by g_app_info_should_show() and
1506  * g_desktop_app_info_get_show_in() to evaluate the
1507  * <literal>OnlyShowIn</literal> and <literal>NotShowIn</literal>
1508  * desktop entry fields.
1509  *
1510  * The <ulink url="http://standards.freedesktop.org/menu-spec/latest/">Desktop
1511  * Menu specification</ulink> recognizes the following:
1512  * <simplelist>
1513  *   <member>GNOME</member>
1514  *   <member>KDE</member>
1515  *   <member>ROX</member>
1516  *   <member>XFCE</member>
1517  *   <member>LXDE</member>
1518  *   <member>Unity</member>
1519  *   <member>Old</member>
1520  * </simplelist>
1521  *
1522  * Should be called only once; subsequent calls are ignored.
1523  */
1524 void
1525 g_desktop_app_info_set_desktop_env (const gchar *desktop_env)
1526 {
1527   G_LOCK (g_desktop_env);
1528   if (!g_desktop_env)
1529     g_desktop_env = g_strdup (desktop_env);
1530   G_UNLOCK (g_desktop_env);
1531 }
1532
1533 static gboolean
1534 g_desktop_app_info_should_show (GAppInfo *appinfo)
1535 {
1536   GDesktopAppInfo *info = G_DESKTOP_APP_INFO (appinfo);
1537
1538   if (info->nodisplay)
1539     return FALSE;
1540
1541   return g_desktop_app_info_get_show_in (info, NULL);
1542 }
1543
1544 typedef enum {
1545   APP_DIR,
1546   MIMETYPE_DIR
1547 } DirType;
1548
1549 static char *
1550 ensure_dir (DirType   type,
1551             GError  **error)
1552 {
1553   char *path, *display_name;
1554   int errsv;
1555
1556   if (type == APP_DIR)
1557     path = g_build_filename (g_get_user_data_dir (), "applications", NULL);
1558   else
1559     path = g_build_filename (g_get_user_data_dir (), "mime", "packages", NULL);
1560
1561   errno = 0;
1562   if (g_mkdir_with_parents (path, 0700) == 0)
1563     return path;
1564
1565   errsv = errno;
1566   display_name = g_filename_display_name (path);
1567   if (type == APP_DIR)
1568     g_set_error (error, G_IO_ERROR, g_io_error_from_errno (errsv),
1569                  _("Can't create user application configuration folder %s: %s"),
1570                  display_name, g_strerror (errsv));
1571   else
1572     g_set_error (error, G_IO_ERROR, g_io_error_from_errno (errsv),
1573                  _("Can't create user MIME configuration folder %s: %s"),
1574                  display_name, g_strerror (errsv));
1575
1576   g_free (display_name);
1577   g_free (path);
1578
1579   return NULL;
1580 }
1581
1582 static gboolean
1583 update_mimeapps_list (const char  *desktop_id, 
1584                       const char  *content_type,
1585                       UpdateMimeFlags flags,
1586                       GError     **error)
1587 {
1588   char *dirname, *filename, *string;
1589   GKeyFile *key_file;
1590   gboolean load_succeeded, res;
1591   char **old_list, **list;
1592   gsize length, data_size;
1593   char *data;
1594   int i, j, k;
1595   char **content_types;
1596
1597   /* Don't add both at start and end */
1598   g_assert (!((flags & UPDATE_MIME_SET_DEFAULT) &&
1599               (flags & UPDATE_MIME_SET_NON_DEFAULT)));
1600
1601   dirname = ensure_dir (APP_DIR, error);
1602   if (!dirname)
1603     return FALSE;
1604
1605   filename = g_build_filename (dirname, "mimeapps.list", NULL);
1606   g_free (dirname);
1607
1608   key_file = g_key_file_new ();
1609   load_succeeded = g_key_file_load_from_file (key_file, filename, G_KEY_FILE_NONE, NULL);
1610   if (!load_succeeded ||
1611       (!g_key_file_has_group (key_file, ADDED_ASSOCIATIONS_GROUP) &&
1612        !g_key_file_has_group (key_file, REMOVED_ASSOCIATIONS_GROUP) &&
1613        !g_key_file_has_group (key_file, DEFAULT_APPLICATIONS_GROUP)))
1614     {
1615       g_key_file_free (key_file);
1616       key_file = g_key_file_new ();
1617     }
1618
1619   if (content_type)
1620     {
1621       content_types = g_new (char *, 2);
1622       content_types[0] = g_strdup (content_type);
1623       content_types[1] = NULL;
1624     }
1625   else
1626     {
1627       content_types = g_key_file_get_keys (key_file, DEFAULT_APPLICATIONS_GROUP, NULL, NULL);
1628     }
1629
1630   for (k = 0; content_types && content_types[k]; k++)
1631     {
1632       /* set as default, if requested so */
1633       string = g_key_file_get_string (key_file,
1634                                       DEFAULT_APPLICATIONS_GROUP,
1635                                       content_types[k],
1636                                       NULL);
1637
1638       if (g_strcmp0 (string, desktop_id) != 0 &&
1639           (flags & UPDATE_MIME_SET_DEFAULT))
1640         {
1641           g_free (string);
1642           string = g_strdup (desktop_id);
1643
1644           /* add in the non-default list too, if it's not already there */
1645           flags |= UPDATE_MIME_SET_NON_DEFAULT;
1646         }
1647
1648       if (string == NULL || desktop_id == NULL)
1649         g_key_file_remove_key (key_file,
1650                                DEFAULT_APPLICATIONS_GROUP,
1651                                content_types[k],
1652                                NULL);
1653       else
1654         g_key_file_set_string (key_file,
1655                                DEFAULT_APPLICATIONS_GROUP,
1656                                content_types[k],
1657                                string);
1658
1659       g_free (string);
1660     }
1661
1662   if (content_type)
1663     {
1664       /* reuse the list from above */
1665     }
1666   else
1667     {
1668       g_strfreev (content_types);
1669       content_types = g_key_file_get_keys (key_file, ADDED_ASSOCIATIONS_GROUP, NULL, NULL);
1670     }
1671   
1672   for (k = 0; content_types && content_types[k]; k++)
1673     { 
1674       /* Add to the right place in the list */
1675   
1676       length = 0;
1677       old_list = g_key_file_get_string_list (key_file, ADDED_ASSOCIATIONS_GROUP,
1678                                              content_types[k], &length, NULL);
1679
1680       list = g_new (char *, 1 + length + 1);
1681
1682       i = 0;
1683
1684       /* if we're adding a last-used hint, just put the application in front of the list */
1685       if (flags & UPDATE_MIME_SET_LAST_USED)
1686         {
1687           /* avoid adding this again as non-default later */
1688           if (flags & UPDATE_MIME_SET_NON_DEFAULT)
1689             flags ^= UPDATE_MIME_SET_NON_DEFAULT;
1690
1691           list[i++] = g_strdup (desktop_id);
1692         }
1693
1694       if (old_list)
1695         {
1696           for (j = 0; old_list[j] != NULL; j++)
1697             {
1698               if (g_strcmp0 (old_list[j], desktop_id) != 0)
1699                 {
1700                   /* rewrite other entries if they're different from the new one */
1701                   list[i++] = g_strdup (old_list[j]);
1702                 }
1703               else if (flags & UPDATE_MIME_SET_NON_DEFAULT)
1704                 {
1705                   /* we encountered an old entry which is equal to the one we're adding as non-default,
1706                    * don't change its position in the list.
1707                    */
1708                   flags ^= UPDATE_MIME_SET_NON_DEFAULT;
1709                   list[i++] = g_strdup (old_list[j]);
1710                 }
1711             }
1712         }
1713
1714       /* add it at the end of the list */
1715       if (flags & UPDATE_MIME_SET_NON_DEFAULT)
1716         list[i++] = g_strdup (desktop_id);
1717
1718       list[i] = NULL;
1719   
1720       g_strfreev (old_list);
1721
1722       if (list[0] == NULL || desktop_id == NULL)
1723         g_key_file_remove_key (key_file,
1724                                ADDED_ASSOCIATIONS_GROUP,
1725                                content_types[k],
1726                                NULL);
1727       else
1728         g_key_file_set_string_list (key_file,
1729                                     ADDED_ASSOCIATIONS_GROUP,
1730                                     content_types[k],
1731                                     (const char * const *)list, i);
1732
1733       g_strfreev (list);
1734     }
1735   
1736   if (content_type)
1737     {
1738       /* reuse the list from above */
1739     }
1740   else
1741     {
1742       g_strfreev (content_types);
1743       content_types = g_key_file_get_keys (key_file, REMOVED_ASSOCIATIONS_GROUP, NULL, NULL);
1744     }
1745
1746   for (k = 0; content_types && content_types[k]; k++) 
1747     {
1748       /* Remove from removed associations group (unless remove) */
1749   
1750       length = 0;
1751       old_list = g_key_file_get_string_list (key_file, REMOVED_ASSOCIATIONS_GROUP,
1752                                              content_types[k], &length, NULL);
1753
1754       list = g_new (char *, 1 + length + 1);
1755
1756       i = 0;
1757       if (flags & UPDATE_MIME_REMOVE)
1758         list[i++] = g_strdup (desktop_id);
1759       if (old_list)
1760         {
1761           for (j = 0; old_list[j] != NULL; j++)
1762             {
1763               if (g_strcmp0 (old_list[j], desktop_id) != 0)
1764                 list[i++] = g_strdup (old_list[j]);
1765             }
1766         }
1767       list[i] = NULL;
1768   
1769       g_strfreev (old_list);
1770
1771       if (list[0] == NULL || desktop_id == NULL)
1772         g_key_file_remove_key (key_file,
1773                                REMOVED_ASSOCIATIONS_GROUP,
1774                                content_types[k],
1775                                NULL);
1776       else
1777         g_key_file_set_string_list (key_file,
1778                                     REMOVED_ASSOCIATIONS_GROUP,
1779                                     content_types[k],
1780                                     (const char * const *)list, i);
1781
1782       g_strfreev (list);
1783     }
1784
1785   g_strfreev (content_types);
1786
1787   data = g_key_file_to_data (key_file, &data_size, error);
1788   g_key_file_free (key_file);
1789
1790   res = g_file_set_contents (filename, data, data_size, error);
1791
1792   mime_info_cache_reload (NULL);
1793
1794   g_free (filename);
1795   g_free (data);
1796
1797   return res;
1798 }
1799
1800 static gboolean
1801 g_desktop_app_info_set_as_last_used_for_type (GAppInfo    *appinfo,
1802                                               const char  *content_type,
1803                                               GError     **error)
1804 {
1805   GDesktopAppInfo *info = G_DESKTOP_APP_INFO (appinfo);
1806
1807   if (!g_desktop_app_info_ensure_saved (info, error))
1808     return FALSE;
1809
1810   if (!info->desktop_id)
1811     {
1812       g_set_error_literal (error, G_IO_ERROR, G_IO_ERROR_FAILED,
1813                            _("Application information lacks an identifier"));
1814       return FALSE;
1815     }
1816
1817   /* both add support for the content type and set as last used */
1818   return update_mimeapps_list (info->desktop_id, content_type,
1819                                UPDATE_MIME_SET_NON_DEFAULT |
1820                                UPDATE_MIME_SET_LAST_USED,
1821                                error);
1822 }
1823
1824 static gboolean
1825 g_desktop_app_info_set_as_default_for_type (GAppInfo    *appinfo,
1826                                             const char  *content_type,
1827                                             GError     **error)
1828 {
1829   GDesktopAppInfo *info = G_DESKTOP_APP_INFO (appinfo);
1830
1831   if (!g_desktop_app_info_ensure_saved (info, error))
1832     return FALSE;
1833
1834   if (!info->desktop_id)
1835     {
1836       g_set_error_literal (error, G_IO_ERROR, G_IO_ERROR_FAILED,
1837                            _("Application information lacks an identifier"));
1838       return FALSE;
1839     }
1840
1841   return update_mimeapps_list (info->desktop_id, content_type,
1842                                UPDATE_MIME_SET_DEFAULT,
1843                                error);
1844 }
1845
1846 static void
1847 update_program_done (GPid     pid,
1848                      gint     status,
1849                      gpointer data)
1850 {
1851   /* Did the application exit correctly */
1852   if (g_spawn_check_exit_status (status, NULL))
1853     {
1854       /* Here we could clean out any caches in use */
1855     }
1856 }
1857
1858 static void
1859 run_update_command (char *command,
1860                     char *subdir)
1861 {
1862         char *argv[3] = {
1863                 NULL,
1864                 NULL,
1865                 NULL,
1866         };
1867         GPid pid = 0;
1868         GError *error = NULL;
1869
1870         argv[0] = command;
1871         argv[1] = g_build_filename (g_get_user_data_dir (), subdir, NULL);
1872
1873         if (g_spawn_async ("/", argv,
1874                            NULL,       /* envp */
1875                            G_SPAWN_SEARCH_PATH |
1876                            G_SPAWN_STDOUT_TO_DEV_NULL |
1877                            G_SPAWN_STDERR_TO_DEV_NULL |
1878                            G_SPAWN_DO_NOT_REAP_CHILD,
1879                            NULL, NULL, /* No setup function */
1880                            &pid,
1881                            &error)) 
1882           g_child_watch_add (pid, update_program_done, NULL);
1883         else
1884           {
1885             /* If we get an error at this point, it's quite likely the user doesn't
1886              * have an installed copy of either 'update-mime-database' or
1887              * 'update-desktop-database'.  I don't think we want to popup an error
1888              * dialog at this point, so we just do a g_warning to give the user a
1889              * chance of debugging it.
1890              */
1891             g_warning ("%s", error->message);
1892           }
1893         
1894         g_free (argv[1]);
1895 }
1896
1897 static gboolean
1898 g_desktop_app_info_set_as_default_for_extension (GAppInfo    *appinfo,
1899                                                  const char  *extension,
1900                                                  GError     **error)
1901 {
1902   char *filename, *basename, *mimetype;
1903   char *dirname;
1904   gboolean res;
1905
1906   if (!g_desktop_app_info_ensure_saved (G_DESKTOP_APP_INFO (appinfo), error))
1907     return FALSE;  
1908   
1909   dirname = ensure_dir (MIMETYPE_DIR, error);
1910   if (!dirname)
1911     return FALSE;
1912   
1913   basename = g_strdup_printf ("user-extension-%s.xml", extension);
1914   filename = g_build_filename (dirname, basename, NULL);
1915   g_free (basename);
1916   g_free (dirname);
1917
1918   mimetype = g_strdup_printf ("application/x-extension-%s", extension);
1919   
1920   if (!g_file_test (filename, G_FILE_TEST_EXISTS)) 
1921     {
1922       char *contents;
1923
1924       contents =
1925         g_strdup_printf ("<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n"
1926                          "<mime-info xmlns=\"http://www.freedesktop.org/standards/shared-mime-info\">\n"
1927                          " <mime-type type=\"%s\">\n"
1928                          "  <comment>%s document</comment>\n"
1929                          "  <glob pattern=\"*.%s\"/>\n"
1930                          " </mime-type>\n"
1931                          "</mime-info>\n", mimetype, extension, extension);
1932
1933       g_file_set_contents (filename, contents, -1, NULL);
1934       g_free (contents);
1935
1936       run_update_command ("update-mime-database", "mime");
1937     }
1938   g_free (filename);
1939   
1940   res = g_desktop_app_info_set_as_default_for_type (appinfo,
1941                                                     mimetype,
1942                                                     error);
1943
1944   g_free (mimetype);
1945   
1946   return res;
1947 }
1948
1949 static gboolean
1950 g_desktop_app_info_add_supports_type (GAppInfo    *appinfo,
1951                                       const char  *content_type,
1952                                       GError     **error)
1953 {
1954   GDesktopAppInfo *info = G_DESKTOP_APP_INFO (appinfo);
1955
1956   if (!g_desktop_app_info_ensure_saved (G_DESKTOP_APP_INFO (info), error))
1957     return FALSE;  
1958   
1959   return update_mimeapps_list (info->desktop_id, content_type,
1960                                UPDATE_MIME_SET_NON_DEFAULT,
1961                                error);
1962 }
1963
1964 static gboolean
1965 g_desktop_app_info_can_remove_supports_type (GAppInfo *appinfo)
1966 {
1967   return TRUE;
1968 }
1969
1970 static gboolean
1971 g_desktop_app_info_remove_supports_type (GAppInfo    *appinfo,
1972                                          const char  *content_type,
1973                                          GError     **error)
1974 {
1975   GDesktopAppInfo *info = G_DESKTOP_APP_INFO (appinfo);
1976
1977   if (!g_desktop_app_info_ensure_saved (G_DESKTOP_APP_INFO (info), error))
1978     return FALSE;
1979   
1980   return update_mimeapps_list (info->desktop_id, content_type,
1981                                UPDATE_MIME_REMOVE,
1982                                error);
1983 }
1984
1985 static const char **
1986 g_desktop_app_info_get_supported_types (GAppInfo *appinfo)
1987 {
1988   GDesktopAppInfo *info = G_DESKTOP_APP_INFO (appinfo);
1989
1990   return (const char**) info->mime_types;
1991 }
1992
1993
1994 static gboolean
1995 g_desktop_app_info_ensure_saved (GDesktopAppInfo  *info,
1996                                  GError          **error)
1997 {
1998   GKeyFile *key_file;
1999   char *dirname;
2000   char *filename;
2001   char *data, *desktop_id;
2002   gsize data_size;
2003   int fd;
2004   gboolean res;
2005   
2006   if (info->filename != NULL)
2007     return TRUE;
2008
2009   /* This is only used for object created with
2010    * g_app_info_create_from_commandline. All other
2011    * object should have a filename
2012    */
2013   
2014   dirname = ensure_dir (APP_DIR, error);
2015   if (!dirname)
2016     return FALSE;
2017   
2018   key_file = g_key_file_new ();
2019
2020   g_key_file_set_string (key_file, G_KEY_FILE_DESKTOP_GROUP,
2021                          "Encoding", "UTF-8");
2022   g_key_file_set_string (key_file, G_KEY_FILE_DESKTOP_GROUP,
2023                          G_KEY_FILE_DESKTOP_KEY_VERSION, "1.0");
2024   g_key_file_set_string (key_file, G_KEY_FILE_DESKTOP_GROUP,
2025                          G_KEY_FILE_DESKTOP_KEY_TYPE,
2026                          G_KEY_FILE_DESKTOP_TYPE_APPLICATION);
2027   if (info->terminal) 
2028     g_key_file_set_boolean (key_file, G_KEY_FILE_DESKTOP_GROUP,
2029                             G_KEY_FILE_DESKTOP_KEY_TERMINAL, TRUE);
2030   if (info->nodisplay)
2031     g_key_file_set_boolean (key_file, G_KEY_FILE_DESKTOP_GROUP,
2032                             G_KEY_FILE_DESKTOP_KEY_NO_DISPLAY, TRUE);
2033
2034   g_key_file_set_string (key_file, G_KEY_FILE_DESKTOP_GROUP,
2035                          G_KEY_FILE_DESKTOP_KEY_EXEC, info->exec);
2036
2037   g_key_file_set_string (key_file, G_KEY_FILE_DESKTOP_GROUP,
2038                          G_KEY_FILE_DESKTOP_KEY_NAME, info->name);
2039
2040   if (info->generic_name != NULL)
2041     g_key_file_set_string (key_file, G_KEY_FILE_DESKTOP_GROUP,
2042                            GENERIC_NAME_KEY, info->generic_name);
2043
2044   if (info->fullname != NULL)
2045     g_key_file_set_string (key_file, G_KEY_FILE_DESKTOP_GROUP,
2046                            FULL_NAME_KEY, info->fullname);
2047
2048   g_key_file_set_string (key_file, G_KEY_FILE_DESKTOP_GROUP,
2049                          G_KEY_FILE_DESKTOP_KEY_COMMENT, info->comment);
2050   
2051   g_key_file_set_boolean (key_file, G_KEY_FILE_DESKTOP_GROUP,
2052                           G_KEY_FILE_DESKTOP_KEY_NO_DISPLAY, TRUE);
2053
2054   data = g_key_file_to_data (key_file, &data_size, NULL);
2055   g_key_file_free (key_file);
2056
2057   desktop_id = g_strdup_printf ("userapp-%s-XXXXXX.desktop", info->name);
2058   filename = g_build_filename (dirname, desktop_id, NULL);
2059   g_free (desktop_id);
2060   g_free (dirname);
2061   
2062   fd = g_mkstemp (filename);
2063   if (fd == -1)
2064     {
2065       char *display_name;
2066
2067       display_name = g_filename_display_name (filename);
2068       g_set_error (error, G_IO_ERROR, G_IO_ERROR_FAILED,
2069                    _("Can't create user desktop file %s"), display_name);
2070       g_free (display_name);
2071       g_free (filename);
2072       g_free (data);
2073       return FALSE;
2074     }
2075
2076   desktop_id = g_path_get_basename (filename);
2077
2078   close (fd);
2079   
2080   res = g_file_set_contents (filename, data, data_size, error);
2081   g_free (data);
2082   if (!res)
2083     {
2084       g_free (desktop_id);
2085       g_free (filename);
2086       return FALSE;
2087     }
2088
2089   info->filename = filename;
2090   info->desktop_id = desktop_id;
2091   
2092   run_update_command ("update-desktop-database", "applications");
2093   
2094   return TRUE;
2095 }
2096
2097 static gboolean
2098 g_desktop_app_info_can_delete (GAppInfo *appinfo)
2099 {
2100   GDesktopAppInfo *info = G_DESKTOP_APP_INFO (appinfo);
2101
2102   if (info->filename)
2103     {
2104       if (strstr (info->filename, "/userapp-"))
2105         return g_access (info->filename, W_OK) == 0;
2106     }
2107
2108   return FALSE;
2109 }
2110
2111 static gboolean
2112 g_desktop_app_info_delete (GAppInfo *appinfo)
2113 {
2114   GDesktopAppInfo *info = G_DESKTOP_APP_INFO (appinfo);
2115   
2116   if (info->filename)
2117     { 
2118       if (g_remove (info->filename) == 0)
2119         {
2120           update_mimeapps_list (info->desktop_id, NULL,
2121                                 UPDATE_MIME_NONE,
2122                                 NULL);
2123
2124           g_free (info->filename);
2125           info->filename = NULL;
2126           g_free (info->desktop_id);
2127           info->desktop_id = NULL;
2128
2129           return TRUE;
2130         }
2131     }
2132
2133   return FALSE;
2134 }
2135
2136 /**
2137  * g_app_info_create_from_commandline:
2138  * @commandline: the commandline to use
2139  * @application_name: (allow-none): the application name, or %NULL to use @commandline
2140  * @flags: flags that can specify details of the created #GAppInfo
2141  * @error: a #GError location to store the error occurring, %NULL to ignore.
2142  *
2143  * Creates a new #GAppInfo from the given information.
2144  *
2145  * Note that for @commandline, the quoting rules of the Exec key of the
2146  * <ulink url="http://freedesktop.org/Standards/desktop-entry-spec">freedesktop.org Desktop
2147  * Entry Specification</ulink> are applied. For example, if the @commandline contains
2148  * percent-encoded URIs, the percent-character must be doubled in order to prevent it from
2149  * being swallowed by Exec key unquoting. See the specification for exact quoting rules.
2150  *
2151  * Returns: (transfer full): new #GAppInfo for given command.
2152  **/
2153 GAppInfo *
2154 g_app_info_create_from_commandline (const char           *commandline,
2155                                     const char           *application_name,
2156                                     GAppInfoCreateFlags   flags,
2157                                     GError              **error)
2158 {
2159   char **split;
2160   char *basename;
2161   GDesktopAppInfo *info;
2162
2163   g_return_val_if_fail (commandline, NULL);
2164
2165   info = g_object_new (G_TYPE_DESKTOP_APP_INFO, NULL);
2166
2167   info->filename = NULL;
2168   info->desktop_id = NULL;
2169   
2170   info->terminal = (flags & G_APP_INFO_CREATE_NEEDS_TERMINAL) != 0;
2171   info->startup_notify = (flags & G_APP_INFO_CREATE_SUPPORTS_STARTUP_NOTIFICATION) != 0;
2172   info->hidden = FALSE;
2173   if ((flags & G_APP_INFO_CREATE_SUPPORTS_URIS) != 0)
2174     info->exec = g_strconcat (commandline, " %u", NULL);
2175   else
2176     info->exec = g_strconcat (commandline, " %f", NULL);
2177   info->nodisplay = TRUE;
2178   info->binary = binary_from_exec (info->exec);
2179   
2180   if (application_name)
2181     info->name = g_strdup (application_name);
2182   else
2183     {
2184       /* FIXME: this should be more robust. Maybe g_shell_parse_argv and use argv[0] */
2185       split = g_strsplit (commandline, " ", 2);
2186       basename = split[0] ? g_path_get_basename (split[0]) : NULL;
2187       g_strfreev (split);
2188       info->name = basename;
2189       if (info->name == NULL)
2190         info->name = g_strdup ("custom");
2191     }
2192   info->comment = g_strdup_printf (_("Custom definition for %s"), info->name);
2193   
2194   return G_APP_INFO (info);
2195 }
2196
2197 static void
2198 g_desktop_app_info_iface_init (GAppInfoIface *iface)
2199 {
2200   iface->dup = g_desktop_app_info_dup;
2201   iface->equal = g_desktop_app_info_equal;
2202   iface->get_id = g_desktop_app_info_get_id;
2203   iface->get_name = g_desktop_app_info_get_name;
2204   iface->get_description = g_desktop_app_info_get_description;
2205   iface->get_executable = g_desktop_app_info_get_executable;
2206   iface->get_icon = g_desktop_app_info_get_icon;
2207   iface->launch = g_desktop_app_info_launch;
2208   iface->supports_uris = g_desktop_app_info_supports_uris;
2209   iface->supports_files = g_desktop_app_info_supports_files;
2210   iface->launch_uris = g_desktop_app_info_launch_uris;
2211   iface->should_show = g_desktop_app_info_should_show;
2212   iface->set_as_default_for_type = g_desktop_app_info_set_as_default_for_type;
2213   iface->set_as_default_for_extension = g_desktop_app_info_set_as_default_for_extension;
2214   iface->add_supports_type = g_desktop_app_info_add_supports_type;
2215   iface->can_remove_supports_type = g_desktop_app_info_can_remove_supports_type;
2216   iface->remove_supports_type = g_desktop_app_info_remove_supports_type;
2217   iface->can_delete = g_desktop_app_info_can_delete;
2218   iface->do_delete = g_desktop_app_info_delete;
2219   iface->get_commandline = g_desktop_app_info_get_commandline;
2220   iface->get_display_name = g_desktop_app_info_get_display_name;
2221   iface->set_as_last_used_for_type = g_desktop_app_info_set_as_last_used_for_type;
2222   iface->get_supported_types = g_desktop_app_info_get_supported_types;
2223 }
2224
2225 static gboolean
2226 app_info_in_list (GAppInfo *info, 
2227                   GList    *list)
2228 {
2229   while (list != NULL)
2230     {
2231       if (g_app_info_equal (info, list->data))
2232         return TRUE;
2233       list = list->next;
2234     }
2235   return FALSE;
2236 }
2237
2238 /**
2239  * g_app_info_get_recommended_for_type:
2240  * @content_type: the content type to find a #GAppInfo for
2241  * 
2242  * Gets a list of recommended #GAppInfos for a given content type, i.e.
2243  * those applications which claim to support the given content type exactly,
2244  * and not by MIME type subclassing.
2245  * Note that the first application of the list is the last used one, i.e.
2246  * the last one for which g_app_info_set_as_last_used_for_type() has been
2247  * called.
2248  *
2249  * Returns: (element-type GAppInfo) (transfer full): #GList of #GAppInfos
2250  *     for given @content_type or %NULL on error.
2251  *
2252  * Since: 2.28
2253  **/
2254 GList *
2255 g_app_info_get_recommended_for_type (const gchar *content_type)
2256 {
2257   GList *desktop_entries, *l;
2258   GList *infos;
2259   GDesktopAppInfo *info;
2260
2261   g_return_val_if_fail (content_type != NULL, NULL);
2262
2263   desktop_entries = get_all_desktop_entries_for_mime_type (content_type, NULL, FALSE, NULL);
2264
2265   infos = NULL;
2266   for (l = desktop_entries; l != NULL; l = l->next)
2267     {
2268       char *desktop_entry = l->data;
2269
2270       info = g_desktop_app_info_new (desktop_entry);
2271       if (info)
2272         {
2273           if (app_info_in_list (G_APP_INFO (info), infos))
2274             g_object_unref (info);
2275           else
2276             infos = g_list_prepend (infos, info);
2277         }
2278       g_free (desktop_entry);
2279     }
2280
2281   g_list_free (desktop_entries);
2282
2283   return g_list_reverse (infos);
2284 }
2285
2286 /**
2287  * g_app_info_get_fallback_for_type:
2288  * @content_type: the content type to find a #GAppInfo for
2289  * 
2290  * Gets a list of fallback #GAppInfos for a given content type, i.e.
2291  * those applications which claim to support the given content type
2292  * by MIME type subclassing and not directly.
2293  *
2294  * Returns: (element-type GAppInfo) (transfer full): #GList of #GAppInfos
2295  *     for given @content_type or %NULL on error.
2296  *
2297  * Since: 2.28
2298  **/
2299 GList *
2300 g_app_info_get_fallback_for_type (const gchar *content_type)
2301 {
2302   GList *desktop_entries, *l;
2303   GList *infos, *recommended_infos;
2304   GDesktopAppInfo *info;
2305
2306   g_return_val_if_fail (content_type != NULL, NULL);
2307
2308   desktop_entries = get_all_desktop_entries_for_mime_type (content_type, NULL, TRUE, NULL);
2309   recommended_infos = g_app_info_get_recommended_for_type (content_type);
2310
2311   infos = NULL;
2312   for (l = desktop_entries; l != NULL; l = l->next)
2313     {
2314       char *desktop_entry = l->data;
2315
2316       info = g_desktop_app_info_new (desktop_entry);
2317       if (info)
2318         {
2319           if (app_info_in_list (G_APP_INFO (info), infos) ||
2320               app_info_in_list (G_APP_INFO (info), recommended_infos))
2321             g_object_unref (info);
2322           else
2323             infos = g_list_prepend (infos, info);
2324         }
2325       g_free (desktop_entry);
2326     }
2327
2328   g_list_free (desktop_entries);
2329   g_list_free_full (recommended_infos, g_object_unref);
2330
2331   return g_list_reverse (infos);
2332 }
2333
2334 /**
2335  * g_app_info_get_all_for_type:
2336  * @content_type: the content type to find a #GAppInfo for
2337  *
2338  * Gets a list of all #GAppInfos for a given content type,
2339  * including the recommended and fallback #GAppInfos. See
2340  * g_app_info_get_recommended_for_type() and
2341  * g_app_info_get_fallback_for_type().
2342  *
2343  * Returns: (element-type GAppInfo) (transfer full): #GList of #GAppInfos
2344  *     for given @content_type or %NULL on error.
2345  **/
2346 GList *
2347 g_app_info_get_all_for_type (const char *content_type)
2348 {
2349   GList *desktop_entries, *l;
2350   GList *infos;
2351   char *user_default = NULL;
2352   GDesktopAppInfo *info;
2353
2354   g_return_val_if_fail (content_type != NULL, NULL);
2355   
2356   desktop_entries = get_all_desktop_entries_for_mime_type (content_type, NULL, TRUE, &user_default);
2357   infos = NULL;
2358
2359   /* put the user default in front of the list, for compatibility */
2360   if (user_default != NULL)
2361     {
2362       info = g_desktop_app_info_new (user_default);
2363
2364       if (info != NULL)
2365         infos = g_list_prepend (infos, info);
2366     }
2367
2368   g_free (user_default);
2369
2370   for (l = desktop_entries; l != NULL; l = l->next)
2371     {
2372       char *desktop_entry = l->data;
2373
2374       info = g_desktop_app_info_new (desktop_entry);
2375       if (info)
2376         {
2377           if (app_info_in_list (G_APP_INFO (info), infos))
2378             g_object_unref (info);
2379           else
2380             infos = g_list_prepend (infos, info);
2381         }
2382       g_free (desktop_entry);
2383     }
2384
2385   g_list_free (desktop_entries);
2386   
2387   return g_list_reverse (infos);
2388 }
2389
2390 /**
2391  * g_app_info_reset_type_associations:
2392  * @content_type: a content type
2393  *
2394  * Removes all changes to the type associations done by
2395  * g_app_info_set_as_default_for_type(),
2396  * g_app_info_set_as_default_for_extension(),
2397  * g_app_info_add_supports_type() or
2398  * g_app_info_remove_supports_type().
2399  *
2400  * Since: 2.20
2401  */
2402 void
2403 g_app_info_reset_type_associations (const char *content_type)
2404 {
2405   update_mimeapps_list (NULL, content_type,
2406                         UPDATE_MIME_NONE,
2407                         NULL);
2408 }
2409
2410 /**
2411  * g_app_info_get_default_for_type:
2412  * @content_type: the content type to find a #GAppInfo for
2413  * @must_support_uris: if %TRUE, the #GAppInfo is expected to
2414  *     support URIs
2415  *
2416  * Gets the default #GAppInfo for a given content type.
2417  *
2418  * Returns: (transfer full): #GAppInfo for given @content_type or
2419  *     %NULL on error.
2420  */
2421 GAppInfo *
2422 g_app_info_get_default_for_type (const char *content_type,
2423                                  gboolean    must_support_uris)
2424 {
2425   GList *desktop_entries, *l;
2426   char *user_default = NULL;
2427   GAppInfo *info;
2428
2429   g_return_val_if_fail (content_type != NULL, NULL);
2430   
2431   desktop_entries = get_all_desktop_entries_for_mime_type (content_type, NULL, TRUE, &user_default);
2432
2433   info = NULL;
2434
2435   if (user_default != NULL)
2436     {
2437       info = (GAppInfo *) g_desktop_app_info_new (user_default);
2438
2439       if (info)
2440         {
2441           if (must_support_uris && !g_app_info_supports_uris (info))
2442             {
2443               g_object_unref (info);
2444               info = NULL;
2445             }
2446         }
2447     }
2448
2449   g_free (user_default);
2450
2451   if (info != NULL)
2452     {
2453       g_list_free_full (desktop_entries, g_free);
2454       return info;
2455     }
2456
2457   /* pick the first from the other list that matches our URI
2458    * requirements.
2459    */
2460   for (l = desktop_entries; l != NULL; l = l->next)
2461     {
2462       char *desktop_entry = l->data;
2463
2464       info = (GAppInfo *)g_desktop_app_info_new (desktop_entry);
2465       if (info)
2466         {
2467           if (must_support_uris && !g_app_info_supports_uris (info))
2468             {
2469               g_object_unref (info);
2470               info = NULL;
2471             }
2472           else
2473             break;
2474         }
2475     }
2476   
2477   g_list_free_full (desktop_entries, g_free);
2478
2479   return info;
2480 }
2481
2482 /**
2483  * g_app_info_get_default_for_uri_scheme:
2484  * @uri_scheme: a string containing a URI scheme.
2485  *
2486  * Gets the default application for handling URIs with
2487  * the given URI scheme. A URI scheme is the initial part
2488  * of the URI, up to but not including the ':', e.g. "http",
2489  * "ftp" or "sip".
2490  *
2491  * Returns: (transfer full): #GAppInfo for given @uri_scheme or %NULL on error.
2492  */
2493 GAppInfo *
2494 g_app_info_get_default_for_uri_scheme (const char *uri_scheme)
2495 {
2496   GAppInfo *app_info;
2497   char *content_type, *scheme_down;
2498
2499   scheme_down = g_ascii_strdown (uri_scheme, -1);
2500   content_type = g_strdup_printf ("x-scheme-handler/%s", scheme_down);
2501   g_free (scheme_down);
2502   app_info = g_app_info_get_default_for_type (content_type, FALSE);
2503   g_free (content_type);
2504
2505   return app_info;
2506 }
2507
2508 static void
2509 get_apps_from_dir (GHashTable *apps, 
2510                    const char *dirname, 
2511                    const char *prefix)
2512 {
2513   GDir *dir;
2514   const char *basename;
2515   char *filename, *subprefix, *desktop_id;
2516   gboolean hidden;
2517   GDesktopAppInfo *appinfo;
2518   
2519   dir = g_dir_open (dirname, 0, NULL);
2520   if (dir)
2521     {
2522       while ((basename = g_dir_read_name (dir)) != NULL)
2523         {
2524           filename = g_build_filename (dirname, basename, NULL);
2525           if (g_str_has_suffix (basename, ".desktop"))
2526             {
2527               desktop_id = g_strconcat (prefix, basename, NULL);
2528
2529               /* Use _extended so we catch NULLs too (hidden) */
2530               if (!g_hash_table_lookup_extended (apps, desktop_id, NULL, NULL))
2531                 {
2532                   appinfo = g_desktop_app_info_new_from_filename (filename);
2533                   hidden = FALSE;
2534
2535                   if (appinfo && g_desktop_app_info_get_is_hidden (appinfo))
2536                     {
2537                       g_object_unref (appinfo);
2538                       appinfo = NULL;
2539                       hidden = TRUE;
2540                     }
2541                                       
2542                   if (appinfo || hidden)
2543                     {
2544                       g_hash_table_insert (apps, g_strdup (desktop_id), appinfo);
2545
2546                       if (appinfo)
2547                         {
2548                           /* Reuse instead of strdup here */
2549                           appinfo->desktop_id = desktop_id;
2550                           desktop_id = NULL;
2551                         }
2552                     }
2553                 }
2554               g_free (desktop_id);
2555             }
2556           else
2557             {
2558               if (g_file_test (filename, G_FILE_TEST_IS_DIR))
2559                 {
2560                   subprefix = g_strconcat (prefix, basename, "-", NULL);
2561                   get_apps_from_dir (apps, filename, subprefix);
2562                   g_free (subprefix);
2563                 }
2564             }
2565           g_free (filename);
2566         }
2567       g_dir_close (dir);
2568     }
2569 }
2570
2571
2572 /**
2573  * g_app_info_get_all:
2574  *
2575  * Gets a list of all of the applications currently registered 
2576  * on this system.
2577  * 
2578  * For desktop files, this includes applications that have 
2579  * <literal>NoDisplay=true</literal> set or are excluded from 
2580  * display by means of <literal>OnlyShowIn</literal> or
2581  * <literal>NotShowIn</literal>. See g_app_info_should_show().
2582  * The returned list does not include applications which have
2583  * the <literal>Hidden</literal> key set. 
2584  * 
2585  * Returns: (element-type GAppInfo) (transfer full): a newly allocated #GList of references to #GAppInfo<!---->s.
2586  **/
2587 GList *
2588 g_app_info_get_all (void)
2589 {
2590   const char * const *dirs;
2591   GHashTable *apps;
2592   GHashTableIter iter;
2593   gpointer value;
2594   int i;
2595   GList *infos;
2596
2597   dirs = get_applications_search_path ();
2598
2599   apps = g_hash_table_new_full (g_str_hash, g_str_equal,
2600                                 g_free, NULL);
2601
2602   
2603   for (i = 0; dirs[i] != NULL; i++)
2604     get_apps_from_dir (apps, dirs[i], "");
2605
2606
2607   infos = NULL;
2608   g_hash_table_iter_init (&iter, apps);
2609   while (g_hash_table_iter_next (&iter, NULL, &value))
2610     {
2611       if (value)
2612         infos = g_list_prepend (infos, value);
2613     }
2614
2615   g_hash_table_destroy (apps);
2616
2617   return g_list_reverse (infos);
2618 }
2619
2620 /* Cacheing of mimeinfo.cache and defaults.list files */
2621
2622 typedef struct {
2623   char *path;
2624   GHashTable *mime_info_cache_map;
2625   GHashTable *defaults_list_map;
2626   GHashTable *mimeapps_list_added_map;
2627   GHashTable *mimeapps_list_removed_map;
2628   GHashTable *mimeapps_list_defaults_map;
2629   time_t mime_info_cache_timestamp;
2630   time_t defaults_list_timestamp;
2631   time_t mimeapps_list_timestamp;
2632 } MimeInfoCacheDir;
2633
2634 typedef struct {
2635   GList *dirs;                       /* mimeinfo.cache and defaults.list */
2636   GHashTable *global_defaults_cache; /* global results of defaults.list lookup and validation */
2637   time_t last_stat_time;
2638   guint should_ping_mime_monitor : 1;
2639 } MimeInfoCache;
2640
2641 static MimeInfoCache *mime_info_cache = NULL;
2642 G_LOCK_DEFINE_STATIC (mime_info_cache);
2643
2644 static void mime_info_cache_dir_add_desktop_entries (MimeInfoCacheDir  *dir,
2645                                                      const char        *mime_type,
2646                                                      char             **new_desktop_file_ids);
2647
2648 static MimeInfoCache * mime_info_cache_new (void);
2649
2650 static void
2651 destroy_info_cache_value (gpointer  key, 
2652                           GList    *value, 
2653                           gpointer  data)
2654 {
2655   g_list_free_full (value, g_free);
2656 }
2657
2658 static void
2659 destroy_info_cache_map (GHashTable *info_cache_map)
2660 {
2661   g_hash_table_foreach (info_cache_map, (GHFunc)destroy_info_cache_value, NULL);
2662   g_hash_table_destroy (info_cache_map);
2663 }
2664
2665 static gboolean
2666 mime_info_cache_dir_out_of_date (MimeInfoCacheDir *dir,
2667                                  const char       *cache_file,
2668                                  time_t           *timestamp)
2669 {
2670   struct stat buf;
2671   char *filename;
2672   
2673   filename = g_build_filename (dir->path, cache_file, NULL);
2674   
2675   if (g_stat (filename, &buf) < 0)
2676     {
2677       g_free (filename);
2678       return TRUE;
2679     }
2680   g_free (filename);
2681
2682   if (buf.st_mtime != *timestamp) 
2683     return TRUE;
2684   
2685   return FALSE;
2686 }
2687
2688 /* Call with lock held */
2689 static gboolean
2690 remove_all (gpointer  key,
2691             gpointer  value,
2692             gpointer  user_data)
2693 {
2694   return TRUE;
2695 }
2696
2697
2698 static void
2699 mime_info_cache_blow_global_cache (void)
2700 {
2701   g_hash_table_foreach_remove (mime_info_cache->global_defaults_cache,
2702                                remove_all, NULL);
2703 }
2704
2705 static void
2706 mime_info_cache_dir_init (MimeInfoCacheDir *dir)
2707 {
2708   GError *load_error;
2709   GKeyFile *key_file;
2710   gchar *filename, **mime_types;
2711   int i;
2712   struct stat buf;
2713   
2714   load_error = NULL;
2715   mime_types = NULL;
2716   
2717   if (dir->mime_info_cache_map != NULL &&
2718       !mime_info_cache_dir_out_of_date (dir, "mimeinfo.cache",
2719                                         &dir->mime_info_cache_timestamp))
2720     return;
2721   
2722   if (dir->mime_info_cache_map != NULL)
2723     destroy_info_cache_map (dir->mime_info_cache_map);
2724   
2725   dir->mime_info_cache_map = g_hash_table_new_full (g_str_hash, g_str_equal,
2726                                                     (GDestroyNotify) g_free,
2727                                                     NULL);
2728   
2729   key_file = g_key_file_new ();
2730   
2731   filename = g_build_filename (dir->path, "mimeinfo.cache", NULL);
2732   
2733   if (g_stat (filename, &buf) < 0)
2734     goto error;
2735   
2736   if (dir->mime_info_cache_timestamp > 0) 
2737     mime_info_cache->should_ping_mime_monitor = TRUE;
2738   
2739   dir->mime_info_cache_timestamp = buf.st_mtime;
2740   
2741   g_key_file_load_from_file (key_file, filename, G_KEY_FILE_NONE, &load_error);
2742   
2743   g_free (filename);
2744   filename = NULL;
2745   
2746   if (load_error != NULL)
2747     goto error;
2748   
2749   mime_types = g_key_file_get_keys (key_file, MIME_CACHE_GROUP,
2750                                     NULL, &load_error);
2751   
2752   if (load_error != NULL)
2753     goto error;
2754   
2755   for (i = 0; mime_types[i] != NULL; i++)
2756     {
2757       gchar **desktop_file_ids;
2758       char *unaliased_type;
2759       desktop_file_ids = g_key_file_get_string_list (key_file,
2760                                                      MIME_CACHE_GROUP,
2761                                                      mime_types[i],
2762                                                      NULL,
2763                                                      NULL);
2764       
2765       if (desktop_file_ids == NULL)
2766         continue;
2767
2768       unaliased_type = _g_unix_content_type_unalias (mime_types[i]);
2769       mime_info_cache_dir_add_desktop_entries (dir,
2770                                                unaliased_type,
2771                                                desktop_file_ids);
2772       g_free (unaliased_type);
2773     
2774       g_strfreev (desktop_file_ids);
2775     }
2776   
2777   g_strfreev (mime_types);
2778   g_key_file_free (key_file);
2779   
2780   return;
2781  error:
2782   g_free (filename);
2783   g_key_file_free (key_file);
2784   
2785   if (mime_types != NULL)
2786     g_strfreev (mime_types);
2787   
2788   if (load_error)
2789     g_error_free (load_error);
2790 }
2791
2792 static void
2793 mime_info_cache_dir_init_defaults_list (MimeInfoCacheDir *dir)
2794 {
2795   GKeyFile *key_file;
2796   GError *load_error;
2797   gchar *filename, **mime_types;
2798   char *unaliased_type;
2799   char **desktop_file_ids;
2800   int i;
2801   struct stat buf;
2802
2803   load_error = NULL;
2804   mime_types = NULL;
2805
2806   if (dir->defaults_list_map != NULL &&
2807       !mime_info_cache_dir_out_of_date (dir, "defaults.list",
2808                                         &dir->defaults_list_timestamp))
2809     return;
2810   
2811   if (dir->defaults_list_map != NULL)
2812     g_hash_table_destroy (dir->defaults_list_map);
2813   dir->defaults_list_map = g_hash_table_new_full (g_str_hash, g_str_equal,
2814                                                   g_free, (GDestroyNotify)g_strfreev);
2815   
2816
2817   key_file = g_key_file_new ();
2818   
2819   filename = g_build_filename (dir->path, "defaults.list", NULL);
2820   if (g_stat (filename, &buf) < 0)
2821     goto error;
2822
2823   if (dir->defaults_list_timestamp > 0) 
2824     mime_info_cache->should_ping_mime_monitor = TRUE;
2825
2826   dir->defaults_list_timestamp = buf.st_mtime;
2827
2828   g_key_file_load_from_file (key_file, filename, G_KEY_FILE_NONE, &load_error);
2829   g_free (filename);
2830   filename = NULL;
2831
2832   if (load_error != NULL)
2833     goto error;
2834
2835   mime_types = g_key_file_get_keys (key_file, DEFAULT_APPLICATIONS_GROUP,
2836                                     NULL, NULL);
2837   if (mime_types != NULL)
2838     {
2839       for (i = 0; mime_types[i] != NULL; i++)
2840         {
2841           desktop_file_ids = g_key_file_get_string_list (key_file,
2842                                                          DEFAULT_APPLICATIONS_GROUP,
2843                                                          mime_types[i],
2844                                                          NULL,
2845                                                          NULL);
2846           if (desktop_file_ids == NULL)
2847             continue;
2848           
2849           unaliased_type = _g_unix_content_type_unalias (mime_types[i]);
2850           g_hash_table_replace (dir->defaults_list_map,
2851                                 unaliased_type,
2852                                 desktop_file_ids);
2853         }
2854       
2855       g_strfreev (mime_types);
2856     }
2857
2858   g_key_file_free (key_file);
2859   return;
2860   
2861  error:
2862   g_free (filename);
2863   g_key_file_free (key_file);
2864   
2865   if (mime_types != NULL)
2866     g_strfreev (mime_types);
2867   
2868   if (load_error)
2869     g_error_free (load_error);
2870 }
2871
2872 static void
2873 mime_info_cache_dir_init_mimeapps_list (MimeInfoCacheDir *dir)
2874 {
2875   GKeyFile *key_file;
2876   GError *load_error;
2877   gchar *filename, **mime_types;
2878   char *unaliased_type;
2879   char **desktop_file_ids;
2880   char *desktop_id;
2881   int i;
2882   struct stat buf;
2883
2884   load_error = NULL;
2885   mime_types = NULL;
2886
2887   if (dir->mimeapps_list_added_map != NULL &&
2888       !mime_info_cache_dir_out_of_date (dir, "mimeapps.list",
2889                                         &dir->mimeapps_list_timestamp))
2890     return;
2891   
2892   if (dir->mimeapps_list_added_map != NULL)
2893     g_hash_table_destroy (dir->mimeapps_list_added_map);
2894   dir->mimeapps_list_added_map = g_hash_table_new_full (g_str_hash, g_str_equal,
2895                                                         g_free, (GDestroyNotify)g_strfreev);
2896   
2897   if (dir->mimeapps_list_removed_map != NULL)
2898     g_hash_table_destroy (dir->mimeapps_list_removed_map);
2899   dir->mimeapps_list_removed_map = g_hash_table_new_full (g_str_hash, g_str_equal,
2900                                                           g_free, (GDestroyNotify)g_strfreev);
2901
2902   if (dir->mimeapps_list_defaults_map != NULL)
2903     g_hash_table_destroy (dir->mimeapps_list_defaults_map);
2904   dir->mimeapps_list_defaults_map = g_hash_table_new_full (g_str_hash, g_str_equal,
2905                                                            g_free, g_free);
2906
2907   key_file = g_key_file_new ();
2908   
2909   filename = g_build_filename (dir->path, "mimeapps.list", NULL);
2910   if (g_stat (filename, &buf) < 0)
2911     goto error;
2912
2913   if (dir->mimeapps_list_timestamp > 0) 
2914     mime_info_cache->should_ping_mime_monitor = TRUE;
2915
2916   dir->mimeapps_list_timestamp = buf.st_mtime;
2917
2918   g_key_file_load_from_file (key_file, filename, G_KEY_FILE_NONE, &load_error);
2919   g_free (filename);
2920   filename = NULL;
2921
2922   if (load_error != NULL)
2923     goto error;
2924
2925   mime_types = g_key_file_get_keys (key_file, ADDED_ASSOCIATIONS_GROUP,
2926                                     NULL, NULL);
2927   if (mime_types != NULL)
2928     {
2929       for (i = 0; mime_types[i] != NULL; i++)
2930         {
2931           desktop_file_ids = g_key_file_get_string_list (key_file,
2932                                                          ADDED_ASSOCIATIONS_GROUP,
2933                                                          mime_types[i],
2934                                                          NULL,
2935                                                          NULL);
2936           if (desktop_file_ids == NULL)
2937             continue;
2938           
2939           unaliased_type = _g_unix_content_type_unalias (mime_types[i]);
2940           g_hash_table_replace (dir->mimeapps_list_added_map,
2941                                 unaliased_type,
2942                                 desktop_file_ids);
2943         }
2944       
2945       g_strfreev (mime_types);
2946     }
2947
2948   mime_types = g_key_file_get_keys (key_file, REMOVED_ASSOCIATIONS_GROUP,
2949                                     NULL, NULL);
2950   if (mime_types != NULL)
2951     {
2952       for (i = 0; mime_types[i] != NULL; i++)
2953         {
2954           desktop_file_ids = g_key_file_get_string_list (key_file,
2955                                                          REMOVED_ASSOCIATIONS_GROUP,
2956                                                          mime_types[i],
2957                                                          NULL,
2958                                                          NULL);
2959           if (desktop_file_ids == NULL)
2960             continue;
2961           
2962           unaliased_type = _g_unix_content_type_unalias (mime_types[i]);
2963           g_hash_table_replace (dir->mimeapps_list_removed_map,
2964                                 unaliased_type,
2965                                 desktop_file_ids);
2966         }
2967       
2968       g_strfreev (mime_types);
2969     }
2970
2971   mime_types = g_key_file_get_keys (key_file, DEFAULT_APPLICATIONS_GROUP,
2972                                     NULL, NULL);
2973   if (mime_types != NULL)
2974     {
2975       for (i = 0; mime_types[i] != NULL; i++)
2976         {
2977           desktop_id = g_key_file_get_string (key_file,
2978                                               DEFAULT_APPLICATIONS_GROUP,
2979                                               mime_types[i],
2980                                               NULL);
2981           if (desktop_id == NULL)
2982             continue;
2983
2984           unaliased_type = _g_unix_content_type_unalias (mime_types[i]);
2985           g_hash_table_replace (dir->mimeapps_list_defaults_map,
2986                                 unaliased_type,
2987                                 desktop_id);
2988         }
2989
2990       g_strfreev (mime_types);
2991     }
2992
2993   g_key_file_free (key_file);
2994   return;
2995   
2996  error:
2997   g_free (filename);
2998   g_key_file_free (key_file);
2999   
3000   if (mime_types != NULL)
3001     g_strfreev (mime_types);
3002   
3003   if (load_error)
3004     g_error_free (load_error);
3005 }
3006
3007 static MimeInfoCacheDir *
3008 mime_info_cache_dir_new (const char *path)
3009 {
3010   MimeInfoCacheDir *dir;
3011
3012   dir = g_new0 (MimeInfoCacheDir, 1);
3013   dir->path = g_strdup (path);
3014   
3015   return dir;
3016 }
3017
3018 static void
3019 mime_info_cache_dir_free (MimeInfoCacheDir *dir)
3020 {
3021   if (dir == NULL)
3022     return;
3023   
3024   if (dir->mime_info_cache_map != NULL)
3025     {
3026       destroy_info_cache_map (dir->mime_info_cache_map);
3027       dir->mime_info_cache_map = NULL;
3028       
3029   }
3030   
3031   if (dir->defaults_list_map != NULL)
3032     {
3033       g_hash_table_destroy (dir->defaults_list_map);
3034       dir->defaults_list_map = NULL;
3035     }
3036   
3037   if (dir->mimeapps_list_added_map != NULL)
3038     {
3039       g_hash_table_destroy (dir->mimeapps_list_added_map);
3040       dir->mimeapps_list_added_map = NULL;
3041     }
3042   
3043   if (dir->mimeapps_list_removed_map != NULL)
3044     {
3045       g_hash_table_destroy (dir->mimeapps_list_removed_map);
3046       dir->mimeapps_list_removed_map = NULL;
3047     }
3048
3049   if (dir->mimeapps_list_defaults_map != NULL)
3050     {
3051       g_hash_table_destroy (dir->mimeapps_list_defaults_map);
3052       dir->mimeapps_list_defaults_map = NULL;
3053     }
3054
3055   g_free (dir);
3056 }
3057
3058 static void
3059 mime_info_cache_dir_add_desktop_entries (MimeInfoCacheDir  *dir,
3060                                          const char        *mime_type,
3061                                          char             **new_desktop_file_ids)
3062 {
3063   GList *desktop_file_ids;
3064   int i;
3065   
3066   desktop_file_ids = g_hash_table_lookup (dir->mime_info_cache_map,
3067                                           mime_type);
3068   
3069   for (i = 0; new_desktop_file_ids[i] != NULL; i++)
3070     {
3071       if (!g_list_find_custom (desktop_file_ids, new_desktop_file_ids[i], (GCompareFunc) strcmp))
3072         desktop_file_ids = g_list_append (desktop_file_ids,
3073                                           g_strdup (new_desktop_file_ids[i]));
3074     }
3075   
3076   g_hash_table_insert (dir->mime_info_cache_map, g_strdup (mime_type), desktop_file_ids);
3077 }
3078
3079 static void
3080 mime_info_cache_init_dir_lists (void)
3081 {
3082   const char * const *dirs;
3083   int i;
3084   
3085   mime_info_cache = mime_info_cache_new ();
3086   
3087   dirs = get_applications_search_path ();
3088   
3089   for (i = 0; dirs[i] != NULL; i++)
3090     {
3091       MimeInfoCacheDir *dir;
3092       
3093       dir = mime_info_cache_dir_new (dirs[i]);
3094       
3095       if (dir != NULL)
3096         {
3097           mime_info_cache_dir_init (dir);
3098           mime_info_cache_dir_init_defaults_list (dir);
3099           mime_info_cache_dir_init_mimeapps_list (dir);
3100           
3101           mime_info_cache->dirs = g_list_append (mime_info_cache->dirs, dir);
3102         }
3103     }
3104 }
3105
3106 static void
3107 mime_info_cache_update_dir_lists (void)
3108 {
3109   GList *tmp;
3110   
3111   tmp = mime_info_cache->dirs;
3112   
3113   while (tmp != NULL)
3114     {
3115       MimeInfoCacheDir *dir = (MimeInfoCacheDir *) tmp->data;
3116
3117       /* No need to do this if we had file monitors... */
3118       mime_info_cache_blow_global_cache ();
3119       mime_info_cache_dir_init (dir);
3120       mime_info_cache_dir_init_defaults_list (dir);
3121       mime_info_cache_dir_init_mimeapps_list (dir);
3122       
3123       tmp = tmp->next;
3124     }
3125 }
3126
3127 static void
3128 mime_info_cache_init (void)
3129 {
3130   G_LOCK (mime_info_cache);
3131   if (mime_info_cache == NULL)
3132     mime_info_cache_init_dir_lists ();
3133   else
3134     {
3135       time_t now;
3136       
3137       time (&now);
3138       if (now >= mime_info_cache->last_stat_time + 10)
3139         {
3140           mime_info_cache_update_dir_lists ();
3141           mime_info_cache->last_stat_time = now;
3142         }
3143     }
3144   
3145   if (mime_info_cache->should_ping_mime_monitor)
3146     {
3147       /* g_idle_add (emit_mime_changed, NULL); */
3148       mime_info_cache->should_ping_mime_monitor = FALSE;
3149     }
3150   
3151   G_UNLOCK (mime_info_cache);
3152 }
3153
3154 static MimeInfoCache *
3155 mime_info_cache_new (void)
3156 {
3157   MimeInfoCache *cache;
3158   
3159   cache = g_new0 (MimeInfoCache, 1);
3160   
3161   cache->global_defaults_cache = g_hash_table_new_full (g_str_hash, g_str_equal,
3162                                                         (GDestroyNotify) g_free,
3163                                                         (GDestroyNotify) g_free);
3164   return cache;
3165 }
3166
3167 static void
3168 mime_info_cache_free (MimeInfoCache *cache)
3169 {
3170   if (cache == NULL)
3171     return;
3172   
3173   g_list_free_full (cache->dirs, (GDestroyNotify) mime_info_cache_dir_free);
3174   g_hash_table_destroy (cache->global_defaults_cache);
3175   g_free (cache);
3176 }
3177
3178 /**
3179  * mime_info_cache_reload:
3180  * @dir: directory path which needs reloading.
3181  * 
3182  * Reload the mime information for the @dir.
3183  */
3184 static void
3185 mime_info_cache_reload (const char *dir)
3186 {
3187   /* FIXME: just reload the dir that needs reloading,
3188    * don't blow the whole cache
3189    */
3190   if (mime_info_cache != NULL)
3191     {
3192       G_LOCK (mime_info_cache);
3193       mime_info_cache_free (mime_info_cache);
3194       mime_info_cache = NULL;
3195       G_UNLOCK (mime_info_cache);
3196     }
3197 }
3198
3199 static GList *
3200 append_desktop_entry (GList      *list, 
3201                       const char *desktop_entry,
3202                       GList      *removed_entries)
3203 {
3204   /* Add if not already in list, and valid */
3205   if (!g_list_find_custom (list, desktop_entry, (GCompareFunc) strcmp) &&
3206       !g_list_find_custom (removed_entries, desktop_entry, (GCompareFunc) strcmp))
3207     list = g_list_prepend (list, g_strdup (desktop_entry));
3208   
3209   return list;
3210 }
3211
3212 /**
3213  * get_all_desktop_entries_for_mime_type:
3214  * @mime_type: a mime type.
3215  * @except: NULL or a strv list
3216  *
3217  * Returns all the desktop ids for @mime_type. The desktop files
3218  * are listed in an order so that default applications are listed before
3219  * non-default ones, and handlers for inherited mimetypes are listed
3220  * after the base ones.
3221  *
3222  * Optionally doesn't list the desktop ids given in the @except 
3223  *
3224  * Return value: a #GList containing the desktop ids which claim
3225  *    to handle @mime_type.
3226  */
3227 static GList *
3228 get_all_desktop_entries_for_mime_type (const char  *base_mime_type,
3229                                        const char **except,
3230                                        gboolean     include_fallback,
3231                                        char       **explicit_default)
3232 {
3233   GList *desktop_entries, *removed_entries, *list, *dir_list, *tmp;
3234   MimeInfoCacheDir *dir;
3235   char *mime_type, *default_entry = NULL;
3236   char *old_default_entry = NULL;
3237   const char *entry;
3238   char **mime_types;
3239   char **default_entries;
3240   char **removed_associations;
3241   gboolean already_found_handler;
3242   int i, j, k;
3243   GPtrArray *array;
3244   char **anc;
3245   
3246   mime_info_cache_init ();
3247
3248   if (include_fallback)
3249     {
3250       /* collect all ancestors */
3251       mime_types = _g_unix_content_type_get_parents (base_mime_type);
3252       array = g_ptr_array_new ();
3253       for (i = 0; mime_types[i]; i++)
3254         g_ptr_array_add (array, mime_types[i]);
3255       g_free (mime_types);
3256       for (i = 0; i < array->len; i++)
3257         {
3258           anc = _g_unix_content_type_get_parents (g_ptr_array_index (array, i));
3259           for (j = 0; anc[j]; j++)
3260             {
3261               for (k = 0; k < array->len; k++)
3262                 {
3263                   if (strcmp (anc[j], g_ptr_array_index (array, k)) == 0)
3264                     break;
3265                 }
3266               if (k == array->len) /* not found */
3267                 g_ptr_array_add (array, g_strdup (anc[j]));
3268             }
3269           g_strfreev (anc);
3270         }
3271       g_ptr_array_add (array, NULL);
3272       mime_types = (char **)g_ptr_array_free (array, FALSE);
3273     }
3274   else
3275     {
3276       mime_types = g_malloc0 (2 * sizeof (gchar *));
3277       mime_types[0] = g_strdup (base_mime_type);
3278       mime_types[1] = NULL;
3279     }
3280
3281   G_LOCK (mime_info_cache);
3282   
3283   removed_entries = NULL;
3284   desktop_entries = NULL;
3285
3286   for (i = 0; except != NULL && except[i] != NULL; i++)
3287     removed_entries = g_list_prepend (removed_entries, g_strdup (except[i]));
3288   
3289   for (i = 0; mime_types[i] != NULL; i++)
3290     {
3291       mime_type = mime_types[i];
3292
3293       /* This is true if we already found a handler for a more specific
3294          mimetype. If its set we ignore any defaults for the less specific
3295          mimetypes. */
3296       already_found_handler = (desktop_entries != NULL);
3297
3298       /* Go through all apps listed in user and system dirs */
3299       for (dir_list = mime_info_cache->dirs;
3300            dir_list != NULL;
3301            dir_list = dir_list->next)
3302         {
3303           dir = dir_list->data;
3304
3305           /* Pick the explicit default application if we got no result earlier
3306            * (ie, for more specific mime types)
3307            */
3308           if (!already_found_handler)
3309             {
3310               entry = g_hash_table_lookup (dir->mimeapps_list_defaults_map, mime_type);
3311
3312               if (entry != NULL)
3313                 {
3314                   /* Save the default entry if it's the first one we encounter */
3315                   if (default_entry == NULL)
3316                     default_entry = g_strdup (entry);
3317                 }
3318             }
3319
3320           /* Then added associations from mimeapps.list */
3321           default_entries = g_hash_table_lookup (dir->mimeapps_list_added_map, mime_type);
3322           for (j = 0; default_entries != NULL && default_entries[j] != NULL; j++)
3323             desktop_entries = append_desktop_entry (desktop_entries, default_entries[j], removed_entries);
3324
3325           /* Then removed associations from mimeapps.list */
3326           removed_associations = g_hash_table_lookup (dir->mimeapps_list_removed_map, mime_type);
3327           for (j = 0; removed_associations != NULL && removed_associations[j] != NULL; j++)
3328             removed_entries = append_desktop_entry (removed_entries, removed_associations[j], NULL);
3329
3330           /* Then system defaults (or old per-user config) (using removed associations from this dir or earlier) */
3331           default_entries = g_hash_table_lookup (dir->defaults_list_map, mime_type);
3332           for (j = 0; default_entries != NULL && default_entries[j] != NULL; j++)
3333             {
3334               if (default_entry == NULL && old_default_entry == NULL && !already_found_handler)
3335                 old_default_entry = g_strdup (default_entries[j]);
3336
3337               desktop_entries = append_desktop_entry (desktop_entries, default_entries[j], removed_entries);
3338             }
3339         }
3340
3341       /* Go through all entries that support the mimetype */
3342       for (dir_list = mime_info_cache->dirs;
3343            dir_list != NULL;
3344            dir_list = dir_list->next) 
3345         {
3346           dir = dir_list->data;
3347         
3348           list = g_hash_table_lookup (dir->mime_info_cache_map, mime_type);
3349           for (tmp = list; tmp != NULL; tmp = tmp->next)
3350             desktop_entries = append_desktop_entry (desktop_entries, tmp->data, removed_entries);
3351         }
3352     }
3353   
3354   G_UNLOCK (mime_info_cache);
3355
3356   g_strfreev (mime_types);
3357
3358   /* If we have no default from mimeapps.list, take it from
3359    * defaults.list intead.
3360    *
3361    * If we do have a default from mimeapps.list, free any one that came
3362    * from defaults.list.
3363    */
3364   if (default_entry == NULL)
3365     default_entry = old_default_entry;
3366   else
3367     g_free (old_default_entry);
3368
3369   if (explicit_default != NULL)
3370     *explicit_default = default_entry;
3371   else
3372     g_free (default_entry);
3373
3374   g_list_free_full (removed_entries, g_free);
3375
3376   desktop_entries = g_list_reverse (desktop_entries);
3377   
3378   return desktop_entries;
3379 }
3380
3381 /* GDesktopAppInfoLookup interface: */
3382
3383 G_GNUC_BEGIN_IGNORE_DEPRECATIONS
3384
3385 typedef GDesktopAppInfoLookupIface GDesktopAppInfoLookupInterface;
3386 G_DEFINE_INTERFACE (GDesktopAppInfoLookup, g_desktop_app_info_lookup, G_TYPE_OBJECT)
3387
3388 static void
3389 g_desktop_app_info_lookup_default_init (GDesktopAppInfoLookupInterface *iface)
3390 {
3391 }
3392
3393 /**
3394  * g_desktop_app_info_lookup_get_default_for_uri_scheme:
3395  * @lookup: a #GDesktopAppInfoLookup
3396  * @uri_scheme: a string containing a URI scheme.
3397  *
3398  * Gets the default application for launching applications 
3399  * using this URI scheme for a particular GDesktopAppInfoLookup
3400  * implementation.
3401  *
3402  * The GDesktopAppInfoLookup interface and this function is used
3403  * to implement g_app_info_get_default_for_uri_scheme() backends
3404  * in a GIO module. There is no reason for applications to use it
3405  * directly. Applications should use g_app_info_get_default_for_uri_scheme().
3406  * 
3407  * Returns: (transfer full): #GAppInfo for given @uri_scheme or %NULL on error.
3408  *
3409  * Deprecated: The #GDesktopAppInfoLookup interface is deprecated and unused by gio.
3410  */
3411 GAppInfo *
3412 g_desktop_app_info_lookup_get_default_for_uri_scheme (GDesktopAppInfoLookup *lookup,
3413                                                       const char            *uri_scheme)
3414 {
3415   GDesktopAppInfoLookupIface *iface;
3416
3417   g_return_val_if_fail (G_IS_DESKTOP_APP_INFO_LOOKUP (lookup), NULL);
3418
3419   iface = G_DESKTOP_APP_INFO_LOOKUP_GET_IFACE (lookup);
3420
3421   return (* iface->get_default_for_uri_scheme) (lookup, uri_scheme);
3422 }
3423
3424 G_GNUC_END_IGNORE_DEPRECATIONS
3425
3426 /**
3427  * g_desktop_app_info_get_startup_wm_class:
3428  * @info: a #GDesktopAppInfo that supports startup notify
3429  *
3430  * Retrieves the StartupWMClass field from @info. This represents the
3431  * WM_CLASS property of the main window of the application, if launched
3432  * through @info.
3433  *
3434  * Returns: (transfer none): the startup WM class, or %NULL if none is set
3435  * in the desktop file.
3436  *
3437  * Since: 2.34
3438  */
3439 const char *
3440 g_desktop_app_info_get_startup_wm_class (GDesktopAppInfo *info)
3441 {
3442   g_return_val_if_fail (G_IS_DESKTOP_APP_INFO (info), NULL);
3443
3444   return info->startup_wm_class;
3445 }