0a95e5bead4c728959145a2540fdd11b96c1ec3d
[platform/upstream/glib.git] / gio / gcontenttype.c
1 /* -*- mode: C; c-file-style: "gnu"; indent-tabs-mode: nil; -*- */
2
3 /* GIO - GLib Input, Output and Streaming Library
4  * 
5  * Copyright (C) 2006-2007 Red Hat, Inc.
6  *
7  * This library is free software; you can redistribute it and/or
8  * modify it under the terms of the GNU Lesser General Public
9  * License as published by the Free Software Foundation; either
10  * version 2 of the License, or (at your option) any later version.
11  *
12  * This library is distributed in the hope that it will be useful,
13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
15  * Lesser General Public License for more details.
16  *
17  * You should have received a copy of the GNU Lesser General
18  * Public License along with this library; if not, write to the
19  * Free Software Foundation, Inc., 59 Temple Place, Suite 330,
20  * Boston, MA 02111-1307, USA.
21  *
22  * Author: Alexander Larsson <alexl@redhat.com>
23  */
24
25 #include "config.h"
26 #include <sys/types.h>
27 #include <stdlib.h>
28 #include <string.h>
29 #include <stdio.h>
30 #include "gcontenttypeprivate.h"
31 #include "gthemedicon.h"
32 #include "gicon.h"
33 #include "gfile.h"
34 #include "gfileenumerator.h"
35 #include "gfileinfo.h"
36 #include "glibintl.h"
37
38 #include "gioalias.h"
39
40 /**
41  * SECTION:gcontenttype
42  * @short_description: Platform-specific content typing
43  * @include: gio/gio.h
44  *
45  * A content type is a platform specific string that defines the type
46  * of a file. On unix it is a mime type, on win32 it is an extension string
47  * like ".doc", ".txt" or a percieved string like "audio". Such strings
48  * can be looked up in the registry at HKEY_CLASSES_ROOT.
49  **/
50
51 #ifdef G_OS_WIN32
52
53 #include <windows.h>
54
55 static char *
56 get_registry_classes_key (const char    *subdir,
57                           const wchar_t *key_name)
58 {
59   wchar_t *wc_key;
60   HKEY reg_key = NULL;
61   DWORD key_type;
62   DWORD nbytes;
63   char *value_utf8;
64
65   value_utf8 = NULL;
66   
67   nbytes = 0;
68   wc_key = g_utf8_to_utf16 (subdir, -1, NULL, NULL, NULL);
69   if (RegOpenKeyExW (HKEY_CLASSES_ROOT, wc_key, 0,
70                      KEY_QUERY_VALUE, &reg_key) == ERROR_SUCCESS &&
71       RegQueryValueExW (reg_key, key_name, 0,
72                         &key_type, NULL, &nbytes) == ERROR_SUCCESS &&
73       (key_type == REG_SZ || key_type == REG_EXPAND_SZ))
74     {
75       wchar_t *wc_temp = g_new (wchar_t, (nbytes+1)/2 + 1);
76       RegQueryValueExW (reg_key, key_name, 0,
77                         &key_type, (LPBYTE) wc_temp, &nbytes);
78       wc_temp[nbytes/2] = '\0';
79       if (key_type == REG_EXPAND_SZ)
80         {
81           wchar_t dummy[1];
82           int len = ExpandEnvironmentStringsW (wc_temp, dummy, 1);
83           if (len > 0)
84             {
85               wchar_t *wc_temp_expanded = g_new (wchar_t, len);
86               if (ExpandEnvironmentStringsW (wc_temp, wc_temp_expanded, len) == len)
87                 value_utf8 = g_utf16_to_utf8 (wc_temp_expanded, -1, NULL, NULL, NULL);
88               g_free (wc_temp_expanded);
89             }
90         }
91       else
92         {
93           value_utf8 = g_utf16_to_utf8 (wc_temp, -1, NULL, NULL, NULL);
94         }
95       g_free (wc_temp);
96       
97     }
98   g_free (wc_key);
99   
100   if (reg_key != NULL)
101     RegCloseKey (reg_key);
102
103   return value_utf8;
104 }
105
106 gboolean
107 g_content_type_equals (const char *type1,
108                        const char *type2)
109 {
110   char *progid1, *progid2;
111   gboolean res;
112   
113   g_return_val_if_fail (type1 != NULL, FALSE);
114   g_return_val_if_fail (type2 != NULL, FALSE);
115
116   if (g_ascii_strcasecmp (type1, type2) == 0)
117     return TRUE;
118
119   res = FALSE;
120   progid1 = get_registry_classes_key (type1, NULL);
121   progid2 = get_registry_classes_key (type2, NULL);
122   if (progid1 != NULL && progid2 != NULL &&
123       strcmp (progid1, progid2) == 0)
124     res = TRUE;
125   g_free (progid1);
126   g_free (progid2);
127   
128   return res;
129 }
130
131 gboolean
132 g_content_type_is_a (const char *type,
133                      const char *supertype)
134 {
135   gboolean res;
136   char *value_utf8;
137
138   g_return_val_if_fail (type != NULL, FALSE);
139   g_return_val_if_fail (supertype != NULL, FALSE);
140
141   if (g_content_type_equals (type, supertype))
142     return TRUE;
143
144   res = FALSE;
145   value_utf8 = get_registry_classes_key (type, L"PerceivedType");
146   if (value_utf8 && strcmp (value_utf8, supertype) == 0)
147     res = TRUE;
148   g_free (value_utf8);
149   
150   return res;
151 }
152
153 gboolean
154 g_content_type_is_unknown (const char *type)
155 {
156   g_return_val_if_fail (type != NULL, FALSE);
157
158   return strcmp ("*", type) == 0;
159 }
160
161 char *
162 g_content_type_get_description (const char *type)
163 {
164   char *progid;
165   char *description;
166
167   g_return_val_if_fail (type != NULL, NULL);
168
169   progid = get_registry_classes_key (type, NULL);
170   if (progid)
171     {
172       description = get_registry_classes_key (progid, NULL);
173       g_free (progid);
174
175       if (description)
176         return description;
177     }
178
179   if (g_content_type_is_unknown (type))
180     return g_strdup (_("Unknown type"));
181   return g_strdup_printf (_("%s filetype"), type);
182 }
183
184 char *
185 g_content_type_get_mime_type (const char *type)
186 {
187   char *mime;
188
189   g_return_val_if_fail (type != NULL, NULL);
190
191   mime = get_registry_classes_key (type, L"Content Type");
192   if (mime)
193     return mime;
194   else if (g_content_type_is_unknown (type))
195     return g_strdup ("application/octet-stream");
196   else if (*type == '.')
197     return g_strdup_printf ("application/x-ext-%s", type+1);
198   /* TODO: Map "image" to "image/ *", etc? */
199
200   return g_strdup ("application/octet-stream");
201 }
202
203 G_LOCK_DEFINE_STATIC (_type_icons);
204 static GHashTable *_type_icons = NULL;
205
206 GIcon *
207 g_content_type_get_icon (const char *type)
208 {
209   GIcon *themed_icon;
210   char *name = NULL;
211
212   g_return_val_if_fail (type != NULL, NULL);
213
214   /* In the Registry icons are the default value of
215      HKEY_CLASSES_ROOT\<progid>\DefaultIcon with typical values like:
216      <type>: <value>
217      REG_EXPAND_SZ: %SystemRoot%\System32\Wscript.exe,3
218      REG_SZ: shimgvw.dll,3
219   */
220   G_LOCK (_type_icons);
221   if (!_type_icons)
222     _type_icons = g_hash_table_new (g_str_hash, g_str_equal);
223   name = g_hash_table_lookup (_type_icons, type);
224   if (!name && type[0] == '.')
225     {
226       /* double lookup by extension */
227       gchar *key = get_registry_classes_key (type, NULL);
228       if (!key)
229         key = g_strconcat (type+1, "file\\DefaultIcon", NULL);
230       else
231         {
232           gchar *key2 = g_strconcat (key, "\\DefaultIcon", NULL);
233           g_free (key);
234           key = key2;
235         }
236       name = get_registry_classes_key (key, NULL);
237       if (name && strcmp (name, "%1") == 0)
238         {
239           g_free (name);
240           name = NULL;
241         }
242       if (name)
243         g_hash_table_insert (_type_icons, g_strdup (type), g_strdup (name));
244       g_free (key);
245     }
246
247   /* icon-name similar to how it was with gtk-2-12 */
248   if (name)
249     {
250       themed_icon = g_themed_icon_new (name);
251     }
252   else
253     {
254       /* if not found an icon fall back to gtk-builtins */
255       name = strcmp (type, "inode/directory") == 0 ? "gtk-directory" : 
256                            g_content_type_can_be_executable (type) ? "gtk-execute" : "gtk-file";
257       g_hash_table_insert (_type_icons, g_strdup (type), g_strdup (name));
258       themed_icon = g_themed_icon_new_with_default_fallbacks (name);
259     }
260   G_UNLOCK (_type_icons);
261
262   return G_ICON (themed_icon);
263 }
264
265 gboolean
266 g_content_type_can_be_executable (const char *type)
267 {
268   g_return_val_if_fail (type != NULL, FALSE);
269
270   if (strcmp (type, ".exe") == 0 ||
271       strcmp (type, ".com") == 0 ||
272       strcmp (type, ".bat") == 0)
273     return TRUE;
274
275   /* TODO: Also look at PATHEXT, which lists the extensions for
276    * "scripts" in addition to those for true binary executables.
277    *
278    * (PATHEXT=.COM;.EXE;.BAT;.CMD;.VBS;.VBE;.JS;.JSE;.WSF;.WSH for me
279    * right now, for instance). And in a sense, all associated file
280    * types are "executable" on Windows... You can just type foo.jpg as
281    * a command name in cmd.exe, and it will run the application
282    * associated with .jpg. Hard to say what this API actually means
283    * with "executable".
284    */
285
286   return FALSE;
287 }
288
289 static gboolean
290 looks_like_text (const guchar *data, 
291                  gsize         data_size)
292 {
293   gsize i;
294   guchar c;
295   for (i = 0; i < data_size; i++)
296     {
297       c = data[i];
298       if (g_ascii_iscntrl (c) && !g_ascii_isspace (c) && c != '\b')
299         return FALSE;
300     }
301   return TRUE;
302 }
303
304 char *
305 g_content_type_from_mime_type (const char *mime_type)
306 {
307   char *key, *content_type;
308
309   g_return_val_if_fail (mime_type != NULL, NULL);
310
311   key = g_strconcat ("MIME\\DataBase\\Content Type\\", mime_type, NULL);
312   content_type = get_registry_classes_key (key, L"Extension");
313   g_free (key);
314
315   return content_type;
316 }
317
318 char *
319 g_content_type_guess (const char   *filename,
320                       const guchar *data,
321                       gsize         data_size,
322                       gboolean     *result_uncertain)
323 {
324   char *basename;
325   char *type;
326   char *dot;
327
328   type = NULL;
329
330   if (filename)
331     {
332       basename = g_path_get_basename (filename);
333       dot = strrchr (basename, '.');
334       if (dot)
335         type = g_strdup (dot);
336       g_free (basename);
337     }
338
339   if (type)
340     return type;
341
342   if (data && looks_like_text (data, data_size))
343     return g_strdup (".txt");
344
345   return g_strdup ("*");
346 }
347
348 GList *
349 g_content_types_get_registered (void)
350 {
351   DWORD index;
352   wchar_t keyname[256];
353   DWORD key_len;
354   char *key_utf8;
355   GList *types;
356
357   types = NULL;
358   index = 0;
359   key_len = 256;
360   while (RegEnumKeyExW(HKEY_CLASSES_ROOT,
361                        index,
362                        keyname,
363                        &key_len,
364                        NULL,
365                        NULL,
366                        NULL,
367                        NULL) == ERROR_SUCCESS)
368     {
369       key_utf8 = g_utf16_to_utf8 (keyname, -1, NULL, NULL, NULL);
370       if (key_utf8)
371         {
372           if (*key_utf8 == '.')
373             types = g_list_prepend (types, key_utf8);
374           else
375             g_free (key_utf8);
376         }
377       index++;
378       key_len = 256;
379     }
380   
381   return g_list_reverse (types);
382 }
383
384 char **
385 g_content_type_guess_for_tree (GFile *root)
386 {
387   /* FIXME: implement */
388   return NULL;
389 }
390
391 #else /* !G_OS_WIN32 - Unix specific version */
392
393 #include <dirent.h>
394
395 #define XDG_PREFIX _gio_xdg
396 #include "xdgmime/xdgmime.h"
397
398 /* We lock this mutex whenever we modify global state in this module.  */
399 G_LOCK_DEFINE_STATIC (gio_xdgmime);
400
401 gsize
402 _g_unix_content_type_get_sniff_len (void)
403 {
404   gsize size;
405
406   G_LOCK (gio_xdgmime);
407   size = xdg_mime_get_max_buffer_extents ();
408   G_UNLOCK (gio_xdgmime);
409
410   return size;
411 }
412
413 char *
414 _g_unix_content_type_unalias (const char *type)
415 {
416   char *res;
417   
418   G_LOCK (gio_xdgmime);
419   res = g_strdup (xdg_mime_unalias_mime_type (type));
420   G_UNLOCK (gio_xdgmime);
421   
422   return res;
423 }
424
425 char **
426 _g_unix_content_type_get_parents (const char *type)
427 {
428   const char *umime;
429   char **parents;
430   GPtrArray *array;
431   int i;
432
433   array = g_ptr_array_new ();
434   
435   G_LOCK (gio_xdgmime);
436   
437   umime = xdg_mime_unalias_mime_type (type);
438   
439   g_ptr_array_add (array, g_strdup (umime));
440   
441   parents = xdg_mime_list_mime_parents (umime);
442   for (i = 0; parents && parents[i] != NULL; i++)
443     g_ptr_array_add (array, g_strdup (parents[i]));
444   
445   free (parents);
446   
447   G_UNLOCK (gio_xdgmime);
448   
449   g_ptr_array_add (array, NULL);
450   
451   return (char **)g_ptr_array_free (array, FALSE);
452 }
453
454 /**
455  * g_content_type_equals:
456  * @type1: a content type string.
457  * @type2: a content type string.
458  *
459  * Compares two content types for equality.
460  *
461  * Returns: %TRUE if the two strings are identical or equivalent,
462  * %FALSE otherwise.
463  **/  
464 gboolean
465 g_content_type_equals (const char *type1,
466                        const char *type2)
467 {
468   gboolean res;
469   
470   g_return_val_if_fail (type1 != NULL, FALSE);
471   g_return_val_if_fail (type2 != NULL, FALSE);
472   
473   G_LOCK (gio_xdgmime);
474   res = xdg_mime_mime_type_equal (type1, type2);
475   G_UNLOCK (gio_xdgmime);
476         
477   return res;
478 }
479
480 /**
481  * g_content_type_is_a:
482  * @type: a content type string. 
483  * @supertype: a string.
484  *
485  * Determines if @type is a subset of @supertype.  
486  *
487  * Returns: %TRUE if @type is a kind of @supertype,
488  * %FALSE otherwise. 
489  **/  
490 gboolean
491 g_content_type_is_a (const char *type,
492                      const char *supertype)
493 {
494   gboolean res;
495     
496   g_return_val_if_fail (type != NULL, FALSE);
497   g_return_val_if_fail (supertype != NULL, FALSE);
498   
499   G_LOCK (gio_xdgmime);
500   res = xdg_mime_mime_type_subclass (type, supertype);
501   G_UNLOCK (gio_xdgmime);
502         
503   return res;
504 }
505
506 /**
507  * g_content_type_is_unknown:
508  * @type: a content type string. 
509  * 
510  * Checks if the content type is the generic "unknown" type.
511  * On unix this is the "application/octet-stream" mimetype,
512  * while on win32 it is "*".
513  * 
514  * Returns: %TRUE if the type is the unknown type.
515  **/  
516 gboolean
517 g_content_type_is_unknown (const char *type)
518 {
519   g_return_val_if_fail (type != NULL, FALSE);
520
521   return strcmp (XDG_MIME_TYPE_UNKNOWN, type) == 0;
522 }
523
524
525 typedef enum {
526   MIME_TAG_TYPE_OTHER,
527   MIME_TAG_TYPE_COMMENT
528 } MimeTagType;
529
530 typedef struct {
531   int current_type;
532   int current_lang_level;
533   int comment_lang_level;
534   char *comment;
535 } MimeParser;
536
537
538 static int
539 language_level (const char *lang)
540 {
541   const char * const *lang_list;
542   int i;
543   
544   /* The returned list is sorted from most desirable to least
545      desirable and always contains the default locale "C". */
546   lang_list = g_get_language_names ();
547   
548   for (i = 0; lang_list[i]; i++)
549     if (strcmp (lang_list[i], lang) == 0)
550       return 1000-i;
551   
552   return 0;
553 }
554
555 static void
556 mime_info_start_element (GMarkupParseContext  *context,
557                          const gchar          *element_name,
558                          const gchar         **attribute_names,
559                          const gchar         **attribute_values,
560                          gpointer              user_data,
561                          GError              **error)
562 {
563   int i;
564   const char *lang;
565   MimeParser *parser = user_data;
566   
567   if (strcmp (element_name, "comment") == 0)
568     {
569       lang = "C";
570       for (i = 0; attribute_names[i]; i++)
571         if (strcmp (attribute_names[i], "xml:lang") == 0)
572           {
573             lang = attribute_values[i];
574             break;
575           }
576       
577       parser->current_lang_level = language_level (lang);
578       parser->current_type = MIME_TAG_TYPE_COMMENT;
579     }
580   else
581     parser->current_type = MIME_TAG_TYPE_OTHER;
582   
583 }
584
585 static void
586 mime_info_end_element (GMarkupParseContext  *context,
587                        const gchar          *element_name,
588                        gpointer              user_data,
589                        GError              **error)
590 {
591   MimeParser *parser = user_data;
592   
593   parser->current_type = MIME_TAG_TYPE_OTHER;
594 }
595
596 static void
597 mime_info_text (GMarkupParseContext  *context,
598                 const gchar          *text,
599                 gsize                 text_len,  
600                 gpointer              user_data,
601                 GError              **error)
602 {
603   MimeParser *parser = user_data;
604
605   if (parser->current_type == MIME_TAG_TYPE_COMMENT &&
606       parser->current_lang_level > parser->comment_lang_level)
607     {
608       g_free (parser->comment);
609       parser->comment = g_strndup (text, text_len);
610       parser->comment_lang_level = parser->current_lang_level;
611     }
612 }
613
614 static char *
615 load_comment_for_mime_helper (const char *dir, 
616                               const char *basename)
617 {
618   GMarkupParseContext *context;
619   char *filename, *data;
620   gsize len;
621   gboolean res;
622   MimeParser parse_data = {0};
623   GMarkupParser parser = {
624     mime_info_start_element,
625     mime_info_end_element,
626     mime_info_text
627   };
628
629   filename = g_build_filename (dir, "mime", basename, NULL);
630   
631   res = g_file_get_contents (filename,  &data,  &len,  NULL);
632   g_free (filename);
633   if (!res)
634     return NULL;
635   
636   context = g_markup_parse_context_new   (&parser, 0, &parse_data, NULL);
637   res = g_markup_parse_context_parse (context, data, len, NULL);
638   g_free (data);
639   g_markup_parse_context_free (context);
640   
641   if (!res)
642     return NULL;
643
644   return parse_data.comment;
645 }
646
647
648 static char *
649 load_comment_for_mime (const char *mimetype)
650 {
651   const char * const* dirs;
652   char *basename;
653   char *comment;
654   int i;
655
656   basename = g_strdup_printf ("%s.xml", mimetype);
657
658   comment = load_comment_for_mime_helper (g_get_user_data_dir (), basename);
659   if (comment)
660     {
661       g_free (basename);
662       return comment;
663     }
664   
665   dirs = g_get_system_data_dirs ();
666
667   for (i = 0; dirs[i] != NULL; i++)
668     {
669       comment = load_comment_for_mime_helper (dirs[i], basename);
670       if (comment)
671         {
672           g_free (basename);
673           return comment;
674         }
675     }
676   g_free (basename);
677   
678   return g_strdup_printf (_("%s type"), mimetype);
679 }
680
681 /**
682  * g_content_type_get_description:
683  * @type: a content type string. 
684  * 
685  * Gets the human readable description of the content type.
686  * 
687  * Returns: a short description of the content type @type. 
688  **/  
689 char *
690 g_content_type_get_description (const char *type)
691 {
692   static GHashTable *type_comment_cache = NULL;
693   char *comment;
694
695   g_return_val_if_fail (type != NULL, NULL);
696   
697   G_LOCK (gio_xdgmime);
698   type = xdg_mime_unalias_mime_type (type);
699
700   if (type_comment_cache == NULL)
701     type_comment_cache = g_hash_table_new_full (g_str_hash, g_str_equal, g_free, g_free);
702
703   comment = g_hash_table_lookup (type_comment_cache, type);
704   comment = g_strdup (comment);
705   G_UNLOCK (gio_xdgmime);
706   
707   if (comment != NULL)
708     return comment;
709
710   comment = load_comment_for_mime (type);
711   
712   G_LOCK (gio_xdgmime);
713   g_hash_table_insert (type_comment_cache,
714                        g_strdup (type),
715                        g_strdup (comment));
716   G_UNLOCK (gio_xdgmime);
717
718   return comment;
719 }
720
721 /**
722  * g_content_type_get_mime_type:
723  * @type: a content type string. 
724  * 
725  * Gets the mime-type for the content type. If one is registered
726  * 
727  * Returns: the registered mime-type for the given @type, or NULL if unknown.
728  **/  
729 char *
730 g_content_type_get_mime_type (const char *type)
731 {
732   g_return_val_if_fail (type != NULL, NULL);
733
734   return g_strdup (type);
735 }
736
737 /**
738  * g_content_type_get_icon:
739  * @type: a content type string.
740  * 
741  * Gets the icon for a content type.
742  * 
743  * Returns: #GIcon corresponding to the content type.
744  **/  
745 GIcon *
746 g_content_type_get_icon (const char *type)
747 {
748   char *mimetype_icon, *generic_mimetype_icon, *q;
749   char *xdg_mimetype_icon, *legacy_mimetype_icon;
750   char *xdg_mimetype_generic_icon;
751   char *icon_names[4];
752   int n = 0;
753   const char *p;
754   GIcon *themed_icon;
755   
756   g_return_val_if_fail (type != NULL, NULL);
757   
758   G_LOCK (gio_xdgmime);
759   xdg_mimetype_icon = g_strdup (xdg_mime_get_icon (type));
760   xdg_mimetype_generic_icon = g_strdup (xdg_mime_get_generic_icon (type));
761   G_UNLOCK (gio_xdgmime);
762
763   mimetype_icon = g_strdup (type);
764   
765   while ((q = strchr (mimetype_icon, '/')) != NULL)
766     *q = '-';
767   
768   p = strchr (type, '/');
769   if (p == NULL)
770     p = type + strlen (type);
771
772   /* Not all icons have migrated to the new icon theme spec, look for old names too */
773   legacy_mimetype_icon = g_strconcat ("gnome-mime-", mimetype_icon, NULL);
774   
775   generic_mimetype_icon = g_malloc (p - type + strlen ("-x-generic") + 1);
776   memcpy (generic_mimetype_icon, type, p - type);
777   memcpy (generic_mimetype_icon + (p - type), "-x-generic", strlen ("-x-generic"));
778   generic_mimetype_icon[(p - type) + strlen ("-x-generic")] = 0;
779   
780   if (xdg_mimetype_icon)
781     icon_names[n++] = xdg_mimetype_icon;
782
783   icon_names[n++] = mimetype_icon;
784   icon_names[n++] = legacy_mimetype_icon;
785
786   if (xdg_mimetype_generic_icon)
787     icon_names[n++] = xdg_mimetype_generic_icon;
788
789   icon_names[n++] = generic_mimetype_icon;
790   
791   themed_icon = g_themed_icon_new_from_names (icon_names, n);
792   
793   g_free (xdg_mimetype_icon);
794   g_free (xdg_mimetype_generic_icon);
795   g_free (mimetype_icon);
796   g_free (legacy_mimetype_icon);
797   g_free (generic_mimetype_icon);
798   
799   return themed_icon;
800 }
801
802 /**
803  * g_content_type_can_be_executable:
804  * @type: a content type string.
805  * 
806  * Checks if a content type can be executable. Note that for instance
807  * things like text files can be executables (i.e. scripts and batch files).
808  * 
809  * Returns: %TRUE if the file type corresponds to a type that
810  * can be executable, %FALSE otherwise. 
811  **/  
812 gboolean
813 g_content_type_can_be_executable (const char *type)
814 {
815   g_return_val_if_fail (type != NULL, FALSE);
816
817   if (g_content_type_is_a (type, "application/x-executable")  ||
818       g_content_type_is_a (type, "text/plain"))
819     return TRUE;
820
821   return FALSE;
822 }
823
824 static gboolean
825 looks_like_text (const guchar *data, gsize data_size)
826 {
827   gsize i;
828   char c;
829   
830   for (i = 0; i < data_size; i++)
831     {
832       c = data[i];
833       
834       if (g_ascii_iscntrl (c) &&
835           !g_ascii_isspace (c) &&
836           c != '\b')
837         return FALSE;
838     }
839   return TRUE;
840 }
841
842 /**
843  * g_content_type_from_mime_type:
844  * @mime_type: a mime type string.
845  *
846  * Tries to find a content type based on the mime type name.
847  *
848  * Returns: Newly allocated string with content type or NULL when does not know.
849  *
850  * Since: 2.18
851  **/
852 char *
853 g_content_type_from_mime_type (const char *mime_type)
854 {
855   char *umime;
856
857   g_return_val_if_fail (mime_type != NULL, NULL);
858
859   G_LOCK (gio_xdgmime);
860   /* mime type and content type are same on unixes */
861   umime = g_strdup (xdg_mime_unalias_mime_type (mime_type));
862   G_UNLOCK (gio_xdgmime);
863
864   return umime;
865 }
866
867 /**
868  * g_content_type_guess:
869  * @filename: a string, or %NULL
870  * @data: a stream of data, or %NULL
871  * @data_size: the size of @data
872  * @result_uncertain: a flag indicating the certainty of the result
873  * 
874  * Guesses the content type based on example data. If the function is 
875  * uncertain, @result_uncertain will be set to %TRUE. Either @filename
876  * or @data may be %NULL, in which case the guess will be based solely
877  * on the other argument.
878  * 
879  * Returns: a string indicating a guessed content type for the 
880  * given data. 
881  **/  
882 char *
883 g_content_type_guess (const char   *filename,
884                       const guchar *data,
885                       gsize         data_size,
886                       gboolean     *result_uncertain)
887 {
888   char *basename;
889   const char *name_mimetypes[10], *sniffed_mimetype;
890   char *mimetype;
891   int i;
892   int n_name_mimetypes;
893   int sniffed_prio;
894
895   sniffed_prio = 0;
896   n_name_mimetypes = 0;
897   sniffed_mimetype = XDG_MIME_TYPE_UNKNOWN;
898
899   if (result_uncertain)
900     *result_uncertain = FALSE;
901   
902   G_LOCK (gio_xdgmime);
903   
904   if (filename)
905     {
906       i = strlen (filename);
907       if (filename[i - 1] == '/')
908         {
909           name_mimetypes[0] = "inode/directory";
910           name_mimetypes[1] = NULL;
911           n_name_mimetypes = 1;
912           if (result_uncertain)
913             *result_uncertain = TRUE;
914         }
915       else
916         {
917           basename = g_path_get_basename (filename);
918           n_name_mimetypes = xdg_mime_get_mime_types_from_file_name (basename, name_mimetypes, 10);
919           g_free (basename);
920         }
921     }
922
923   /* Got an extension match, and no conflicts. This is it. */
924   if (n_name_mimetypes == 1)
925     {
926       G_UNLOCK (gio_xdgmime);
927       return g_strdup (name_mimetypes[0]);
928     }
929   
930   if (data)
931     {
932       sniffed_mimetype = xdg_mime_get_mime_type_for_data (data, data_size, &sniffed_prio);
933       if (sniffed_mimetype == XDG_MIME_TYPE_UNKNOWN &&
934           data &&
935           looks_like_text (data, data_size))
936         sniffed_mimetype = "text/plain";
937
938       /* For security reasons we don't ever want to sniff desktop files
939        * where we know the filename and it doesn't have a .desktop extension.
940        * This is because desktop files allow executing any application and
941        * we don't want to make it possible to hide them looking like something
942        * else.
943        */
944       if (filename != NULL &&
945           strcmp (sniffed_mimetype, "application/x-desktop") == 0)
946         sniffed_mimetype = "text/plain";
947     }
948   
949   if (n_name_mimetypes == 0)
950     {
951       if (sniffed_mimetype == XDG_MIME_TYPE_UNKNOWN &&
952           result_uncertain)
953         *result_uncertain = TRUE;
954       
955       mimetype = g_strdup (sniffed_mimetype);
956     }
957   else
958     {
959       mimetype = NULL;
960       if (sniffed_mimetype != XDG_MIME_TYPE_UNKNOWN)
961         {
962           if (sniffed_prio >= 80) /* High priority sniffing match, use that */
963             mimetype = g_strdup (sniffed_mimetype);
964           else
965             {
966               /* There are conflicts between the name matches and we have a sniffed
967                  type, use that as a tie breaker. */
968               
969               for (i = 0; i < n_name_mimetypes; i++)
970                 {
971                   if ( xdg_mime_mime_type_subclass (name_mimetypes[i], sniffed_mimetype))
972                     {
973                       /* This nametype match is derived from (or the same as) the sniffed type).
974                          This is probably it. */
975                       mimetype = g_strdup (name_mimetypes[i]);
976                       break;
977                     }
978                 }
979             }
980         }
981       
982       if (mimetype == NULL)
983         {
984           /* Conflicts, and sniffed type was no help or not there. Guess on the first one */
985           mimetype = g_strdup (name_mimetypes[0]);
986           if (result_uncertain)
987             *result_uncertain = TRUE;
988         }
989     }
990   
991   G_UNLOCK (gio_xdgmime);
992
993   return mimetype;
994 }
995
996 static void
997 enumerate_mimetypes_subdir (const char *dir, 
998                             const char *prefix, 
999                             GHashTable *mimetypes)
1000 {
1001   DIR *d;
1002   struct dirent *ent;
1003   char *mimetype;
1004
1005   d = opendir (dir);
1006   if (d)
1007     {
1008       while ((ent = readdir (d)) != NULL)
1009         {
1010           if (g_str_has_suffix (ent->d_name, ".xml"))
1011             {
1012               mimetype = g_strdup_printf ("%s/%.*s", prefix, (int) strlen (ent->d_name) - 4, ent->d_name);
1013               g_hash_table_replace (mimetypes, mimetype, NULL);
1014             }
1015         }
1016       closedir (d);
1017     }
1018 }
1019
1020 static void
1021 enumerate_mimetypes_dir (const char *dir, 
1022                          GHashTable *mimetypes)
1023 {
1024   DIR *d;
1025   struct dirent *ent;
1026   char *mimedir;
1027   char *name;
1028
1029   mimedir = g_build_filename (dir, "mime", NULL);
1030   
1031   d = opendir (mimedir);
1032   if (d)
1033     {
1034       while ((ent = readdir (d)) != NULL)
1035         {
1036           if (strcmp (ent->d_name, "packages") != 0)
1037             {
1038               name = g_build_filename (mimedir, ent->d_name, NULL);
1039               if (g_file_test (name, G_FILE_TEST_IS_DIR))
1040                 enumerate_mimetypes_subdir (name, ent->d_name, mimetypes);
1041               g_free (name);
1042             }
1043         }
1044       closedir (d);
1045     }
1046   
1047   g_free (mimedir);
1048 }
1049
1050 /**
1051  * g_content_types_get_registered:
1052  * 
1053  * Gets a list of strings containing all the registered content types
1054  * known to the system. The list and its data should be freed using 
1055  * @g_list_foreach(list, g_free, NULL) and @g_list_free(list)
1056  * Returns: #GList of the registered content types.
1057  **/  
1058 GList *
1059 g_content_types_get_registered (void)
1060 {
1061   const char * const* dirs;
1062   GHashTable *mimetypes;
1063   GHashTableIter iter;
1064   gpointer key;
1065   int i;
1066   GList *l;
1067
1068   mimetypes = g_hash_table_new_full (g_str_hash, g_str_equal, g_free, NULL);
1069
1070   enumerate_mimetypes_dir (g_get_user_data_dir (), mimetypes);
1071   dirs = g_get_system_data_dirs ();
1072
1073   for (i = 0; dirs[i] != NULL; i++)
1074     enumerate_mimetypes_dir (dirs[i], mimetypes);
1075
1076   l = NULL;
1077   g_hash_table_iter_init (&iter, mimetypes);
1078   while (g_hash_table_iter_next (&iter, &key, NULL))
1079     {
1080       l = g_list_prepend (l, key);
1081       g_hash_table_iter_steal (&iter);
1082     }
1083
1084   g_hash_table_destroy (mimetypes);
1085
1086   return l;
1087 }
1088
1089
1090 /* tree magic data */
1091 static GList *tree_matches = NULL;
1092 static gboolean need_reload = FALSE;
1093
1094 G_LOCK_DEFINE_STATIC (gio_treemagic);
1095
1096 typedef struct 
1097 {
1098   gchar *path;
1099   GFileType type;
1100   guint match_case : 1;
1101   guint executable : 1;
1102   guint non_empty  : 1;
1103   guint on_disc    : 1;
1104   gchar *mimetype;
1105   GList *matches;
1106 } TreeMatchlet;
1107
1108 typedef struct
1109 {
1110   gchar *contenttype;
1111   gint priority;
1112   GList *matches;
1113 } TreeMatch;
1114
1115
1116 static void
1117 tree_matchlet_free (TreeMatchlet *matchlet)
1118 {
1119   g_list_foreach (matchlet->matches, (GFunc)tree_matchlet_free, NULL);
1120   g_list_free (matchlet->matches);
1121   g_free (matchlet->path);
1122   g_free (matchlet->mimetype);
1123   g_slice_free (TreeMatchlet, matchlet);
1124 }
1125
1126 static void
1127 tree_match_free (TreeMatch *match)
1128 {
1129   g_list_foreach (match->matches, (GFunc)tree_matchlet_free, NULL);
1130   g_list_free (match->matches);
1131   g_free (match->contenttype);
1132   g_slice_free (TreeMatch, match);
1133 }
1134
1135 static TreeMatch *
1136 parse_header (gchar *line)
1137 {
1138   gint len;
1139   gchar *s;
1140   TreeMatch *match;
1141
1142   len = strlen (line);
1143
1144   if (line[0] != '[' || line[len - 1] != ']')
1145     return NULL;
1146         
1147   line[len - 1] = 0;
1148   s = strchr (line, ':');
1149         
1150   match = g_slice_new0 (TreeMatch);
1151   match->priority = atoi (line + 1);
1152   match->contenttype = g_strdup (s + 1);
1153
1154   return match;
1155 }
1156
1157 static TreeMatchlet *
1158 parse_match_line (gchar *line, 
1159                   gint  *depth)
1160 {
1161   gchar *s, *p;
1162   TreeMatchlet *matchlet;
1163   gchar **parts;
1164   gint i;
1165
1166   matchlet = g_slice_new0 (TreeMatchlet);
1167
1168   if (line[0] == '>') 
1169     {
1170       *depth = 0;
1171       s = line;
1172     }
1173   else 
1174     {
1175       *depth = atoi (line);
1176       s = strchr (line, '>');
1177     }
1178   s += 2; 
1179   p = strchr (s, '"');
1180   *p = 0;
1181
1182   matchlet->path = g_strdup (s);
1183   s = p + 1;
1184   parts = g_strsplit (s, ",", 0);
1185   if (strcmp (parts[0], "=file") == 0)
1186     matchlet->type = G_FILE_TYPE_REGULAR;
1187   else if (strcmp (parts[0], "=directory") == 0)
1188     matchlet->type = G_FILE_TYPE_DIRECTORY;
1189   else if (strcmp (parts[0], "=link") == 0)
1190     matchlet->type = G_FILE_TYPE_SYMBOLIC_LINK;
1191   else
1192     matchlet->type = G_FILE_TYPE_UNKNOWN;
1193   for (i = 1; parts[i]; i++)
1194     {
1195       if (strcmp (parts[i], "executable") == 0)
1196         matchlet->executable = 1;
1197       else if (strcmp (parts[i], "match-case") == 0)
1198         matchlet->match_case = 1;
1199       else if (strcmp (parts[i], "non-empty") == 0)
1200         matchlet->non_empty = 1;
1201       else if (strcmp (parts[i], "on-disc") == 0)
1202         matchlet->on_disc = 1;
1203       else 
1204         matchlet->mimetype = g_strdup (parts[i]);
1205     }
1206
1207   g_strfreev (parts);
1208
1209   return matchlet;
1210 }
1211
1212 static gint
1213 cmp_match (gconstpointer a, gconstpointer b)
1214 {
1215   const TreeMatch *aa = (const TreeMatch *)a;
1216   const TreeMatch *bb = (const TreeMatch *)b;
1217
1218   return bb->priority - aa->priority;
1219 }
1220
1221 static void
1222 insert_match (TreeMatch *match)
1223 {
1224   tree_matches = g_list_insert_sorted (tree_matches, match, cmp_match);
1225 }
1226
1227 static void
1228 insert_matchlet (TreeMatch    *match, 
1229                  TreeMatchlet *matchlet, 
1230                  gint          depth)
1231 {
1232   if (depth == 0) 
1233     match->matches = g_list_append (match->matches, matchlet);
1234   else 
1235     {
1236       GList *last;
1237       TreeMatchlet *m;
1238
1239       last = g_list_last (match->matches);
1240       if (!last) 
1241         {
1242           tree_matchlet_free (matchlet);
1243           g_warning ("can't insert tree matchlet at depth %d", depth);
1244           return;
1245         }
1246
1247       m = (TreeMatchlet *) last->data;
1248       while (--depth > 0) 
1249         {
1250           last = g_list_last (m->matches);
1251           if (!last) 
1252             {
1253               tree_matchlet_free (matchlet);
1254               g_warning ("can't insert tree matchlet at depth %d", depth);
1255               return;
1256             }
1257                         
1258           m = (TreeMatchlet *) last->data;
1259         }
1260       m->matches = g_list_append (m->matches, matchlet);
1261     }
1262 }
1263
1264 static void
1265 read_tree_magic_from_directory (const gchar *prefix)
1266 {
1267   gchar *filename;
1268   gchar *text;
1269   gsize len;
1270   gchar **lines;
1271   gint i;
1272   TreeMatch *match;
1273   TreeMatchlet *matchlet;
1274   gint depth;
1275
1276   filename = g_build_filename (prefix, "mime", "treemagic", NULL);
1277
1278   if (g_file_get_contents (filename, &text, &len, NULL)) 
1279     {
1280       if (strcmp (text, "MIME-TreeMagic") == 0) 
1281         {
1282           lines = g_strsplit (text + strlen ("MIME-TreeMagic") + 2, "\n", 0);
1283           match = NULL;
1284           for (i = 0; lines[i] && lines[i][0]; i++) 
1285             {
1286               if (lines[i][0] == '[') 
1287                 {
1288                   match = parse_header (lines[i]);
1289                   insert_match (match);
1290                 }
1291               else 
1292                 {
1293                   matchlet = parse_match_line (lines[i], &depth);
1294                   insert_matchlet (match, matchlet, depth);
1295                 }
1296             }
1297       
1298           g_strfreev (lines);
1299         }
1300       else 
1301         g_warning ("%s: header not found, skipping\n", filename);
1302
1303       g_free (text);
1304     }
1305         
1306   g_free (filename);
1307 }
1308
1309
1310 static void
1311 xdg_mime_reload (void *user_data)
1312 {
1313   need_reload = TRUE;
1314 }
1315
1316 static void 
1317 tree_magic_shutdown (void)
1318 {
1319   g_list_foreach (tree_matches, (GFunc)tree_match_free, NULL);
1320   g_list_free (tree_matches);
1321   tree_matches = NULL;
1322 }
1323
1324 static void
1325 tree_magic_init (void)
1326 {
1327   static gboolean initialized = FALSE;
1328   const gchar *dir;
1329   const gchar * const * dirs;
1330   int i;
1331
1332   if (!initialized) 
1333     {
1334       initialized = TRUE;
1335
1336       xdg_mime_register_reload_callback (xdg_mime_reload, NULL, NULL);
1337       need_reload = TRUE;
1338     }
1339
1340   if (need_reload) 
1341     {
1342       need_reload = FALSE;
1343
1344       tree_magic_shutdown ();
1345
1346       dir = g_get_user_data_dir ();
1347       read_tree_magic_from_directory (dir);
1348       dirs = g_get_system_data_dirs ();
1349       for (i = 0; dirs[i]; i++)
1350         read_tree_magic_from_directory (dirs[i]);
1351     }
1352 }
1353
1354 /* a filtering enumerator */
1355
1356 typedef struct 
1357 {
1358   gchar *path;
1359   gint depth;
1360   gboolean ignore_case;
1361   gchar **components;
1362   gchar **case_components;
1363   GFileEnumerator **enumerators;
1364   GFile **children;
1365 } Enumerator;
1366
1367 static gboolean
1368 component_match (Enumerator  *e, 
1369                  gint         depth, 
1370                  const gchar *name)
1371 {
1372   gchar *case_folded, *key;
1373   gboolean found;
1374
1375   if (strcmp (name, e->components[depth]) == 0)
1376     return TRUE;
1377
1378   if (!e->ignore_case)
1379     return FALSE;
1380
1381   case_folded = g_utf8_casefold (name, -1);
1382   key = g_utf8_collate_key (case_folded, -1);
1383
1384   found = strcmp (key, e->case_components[depth]) == 0;
1385
1386   g_free (case_folded);
1387   g_free (key);
1388
1389   return found;
1390 }
1391
1392 static GFile *
1393 next_match_recurse (Enumerator *e, 
1394                     gint        depth)
1395 {
1396   GFile *file;
1397   GFileInfo *info;
1398   const gchar *name;
1399
1400   while (TRUE) 
1401     {
1402       if (e->enumerators[depth] == NULL) 
1403         {
1404           if (depth > 0) 
1405             {
1406               file = next_match_recurse (e, depth - 1);
1407               if (file)  
1408                 {
1409                   e->children[depth] = file;
1410                   e->enumerators[depth] = g_file_enumerate_children (file,
1411                                                                      G_FILE_ATTRIBUTE_STANDARD_NAME,
1412                                                                      G_FILE_QUERY_INFO_NONE,
1413                                                                      NULL,
1414                                                                      NULL);
1415                 }
1416             }
1417           if (e->enumerators[depth] == NULL)
1418             return NULL;
1419         }
1420
1421       while ((info = g_file_enumerator_next_file (e->enumerators[depth], NULL, NULL))) 
1422         {
1423           name = g_file_info_get_name (info);
1424           if (component_match (e, depth, name)) 
1425             {
1426               file = g_file_get_child (e->children[depth], name);
1427               g_object_unref (info);
1428               return file;
1429             }
1430           g_object_unref (info);
1431         }
1432
1433       g_object_unref (e->enumerators[depth]);
1434       e->enumerators[depth] = NULL;
1435       g_object_unref (e->children[depth]);
1436       e->children[depth] = NULL;
1437     }
1438 }
1439
1440 static GFile *
1441 enumerator_next (Enumerator *e)
1442 {
1443   return next_match_recurse (e, e->depth - 1);
1444 }
1445
1446 static Enumerator *
1447 enumerator_new (GFile      *root,
1448                 const char *path, 
1449                 gboolean    ignore_case)
1450 {
1451   Enumerator *e;
1452   gint i;
1453   gchar *case_folded;
1454
1455   e = g_new0 (Enumerator, 1);
1456   e->path = g_strdup (path);
1457   e->ignore_case = ignore_case;
1458
1459   e->components = g_strsplit (e->path, G_DIR_SEPARATOR_S, -1);
1460   e->depth = g_strv_length (e->components);
1461   if (e->ignore_case) 
1462     {
1463       e->case_components = g_new0 (char *, e->depth + 1);
1464       for (i = 0; e->components[i]; i++) 
1465         {
1466           case_folded = g_utf8_casefold (e->components[i], -1);
1467           e->case_components[i] = g_utf8_collate_key (case_folded, -1);
1468           g_free (case_folded);
1469         }       
1470     }
1471
1472   e->children = g_new0 (GFile *, e->depth);
1473   e->children[0] = g_object_ref (root);
1474   e->enumerators = g_new0 (GFileEnumerator *, e->depth);
1475   e->enumerators[0] = g_file_enumerate_children (root,
1476                                                  G_FILE_ATTRIBUTE_STANDARD_NAME,
1477                                                  G_FILE_QUERY_INFO_NONE,
1478                                                  NULL,
1479                                                  NULL);
1480
1481   return e;
1482 }
1483
1484 static void
1485 enumerator_free (Enumerator *e)
1486 {
1487   gint i;
1488
1489   for (i = 0; i < e->depth; i++) 
1490     { 
1491       if (e->enumerators[i]) 
1492         g_object_unref (e->enumerators[i]);
1493       if (e->children[i])
1494         g_object_unref (e->children[i]);
1495     }
1496
1497   g_free (e->enumerators);
1498   g_free (e->children);
1499   g_strfreev (e->components);
1500   if (e->case_components)
1501     g_strfreev (e->case_components);
1502   g_free (e->path);
1503   g_free (e);
1504 }
1505
1506 static gboolean
1507 matchlet_match (TreeMatchlet *matchlet,
1508                 GFile        *root)
1509 {
1510   GFile *file;
1511   GFileInfo *info;
1512   gboolean result;
1513   const gchar *attrs;
1514   Enumerator *e;
1515   GList *l;
1516
1517   e = enumerator_new (root, matchlet->path, !matchlet->match_case);
1518         
1519   do 
1520     {
1521       file = enumerator_next (e);
1522       if (!file) 
1523         {
1524           enumerator_free (e);  
1525           return FALSE;
1526         }
1527
1528       if (matchlet->mimetype)
1529         attrs = G_FILE_ATTRIBUTE_STANDARD_TYPE ","
1530                 G_FILE_ATTRIBUTE_ACCESS_CAN_EXECUTE ","
1531                 G_FILE_ATTRIBUTE_STANDARD_CONTENT_TYPE;
1532       else
1533         attrs = G_FILE_ATTRIBUTE_STANDARD_TYPE ","
1534                 G_FILE_ATTRIBUTE_ACCESS_CAN_EXECUTE;
1535       info = g_file_query_info (file, 
1536                                 attrs,
1537                                 G_FILE_QUERY_INFO_NONE,
1538                                 NULL,
1539                                 NULL);
1540       if (info) 
1541         {
1542           result = TRUE;
1543
1544           if (matchlet->type != G_FILE_TYPE_UNKNOWN &&
1545               g_file_info_get_file_type (info) != matchlet->type) 
1546             result = FALSE;
1547
1548           if (matchlet->executable &&
1549               !g_file_info_get_attribute_boolean (info, G_FILE_ATTRIBUTE_ACCESS_CAN_EXECUTE))
1550             result = FALSE;
1551         }       
1552       else 
1553         result = FALSE;
1554
1555       if (result && matchlet->non_empty) 
1556         {
1557           GFileEnumerator *child_enum;
1558           GFileInfo *child_info;
1559
1560           child_enum = g_file_enumerate_children (file, 
1561                                                   G_FILE_ATTRIBUTE_STANDARD_NAME,
1562                                                   G_FILE_QUERY_INFO_NONE,
1563                                                   NULL,
1564                                                   NULL);
1565         
1566           if (child_enum) 
1567             {
1568               child_info = g_file_enumerator_next_file (child_enum, NULL, NULL);
1569               if (child_info)
1570                 g_object_unref (child_info);
1571               else 
1572                 result = FALSE; 
1573               g_object_unref (child_enum);
1574             }
1575           else 
1576             result = FALSE;
1577         }
1578         
1579       if (result && matchlet->mimetype) 
1580         {
1581           if (strcmp (matchlet->mimetype, g_file_info_get_content_type (info)) != 0) 
1582             result = FALSE;
1583         }
1584         
1585       g_object_unref (info);
1586       g_object_unref (file);
1587     }
1588   while (!result);
1589
1590   enumerator_free (e);
1591         
1592   if (!matchlet->matches) 
1593     return TRUE;
1594
1595   for (l = matchlet->matches; l; l = l->next) 
1596     {
1597       TreeMatchlet *submatchlet;
1598
1599       submatchlet = l->data;
1600       if (matchlet_match (submatchlet, root))
1601         return TRUE;
1602     }
1603
1604   return FALSE;
1605 }
1606
1607 static void
1608 match_match (TreeMatch    *match,
1609              GFile        *root,
1610              GPtrArray    *types)
1611 {
1612   GList *l;
1613         
1614   for (l = match->matches; l; l = l->next) 
1615     {
1616       TreeMatchlet *matchlet = l->data;
1617       if (matchlet_match (matchlet, root)) 
1618         {
1619           g_ptr_array_add (types, g_strdup (match->contenttype));
1620           break;
1621         }
1622     }
1623 }
1624
1625 /**
1626  * g_content_type_guess_for_tree:
1627  * @root: the root of the tree to guess a type for
1628  *
1629  * Tries to guess the type of the tree with root @root, by
1630  * looking at the files it contains. The result is an array
1631  * of content types, with the best guess coming first.
1632  *
1633  * The types returned all have the form x-content/foo, e.g.
1634  * x-content/audio-cdda (for audio CDs) or x-content/image-dcf 
1635  * (for a camera memory card). See the <ulink url="http://www.freedesktop.org/wiki/Specifications/shared-mime-info-spec">shared-mime-info</ulink>
1636  * specification for more on x-content types.
1637  *
1638  * This function is useful in the implementation of g_mount_guess_content_type().
1639  *
1640  * Returns: an %NULL-terminated array of zero or more content types, or %NULL. 
1641  *    Free with g_strfreev()
1642  *
1643  * Since: 2.18
1644  */
1645 char **
1646 g_content_type_guess_for_tree (GFile *root)
1647 {
1648   GPtrArray *types;
1649   GList *l;
1650
1651   types = g_ptr_array_new ();
1652
1653   G_LOCK (gio_treemagic);
1654
1655   tree_magic_init ();
1656   for (l = tree_matches; l; l = l->next) 
1657     {
1658       TreeMatch *match = l->data;
1659       match_match (match, root, types);
1660     }
1661
1662   G_UNLOCK (gio_treemagic);
1663
1664   g_ptr_array_add (types, NULL);
1665
1666   return (char **)g_ptr_array_free (types, FALSE);
1667 }
1668
1669 #endif /* Unix version */
1670
1671 #define __G_CONTENT_TYPE_C__
1672 #include "gioaliasdef.c"