/* -*- Mode: C; tab-width: 8; indent-tabs-mode: t; c-basic-offset: 8 -*- */ /* * Copyright © 2002 Jorn Baayen * Copyright © 2003, 2004 Marco Pesenti Gritti * Copyright © 2004, 2005, 2006 Christian Persch * Copyright © 2012 Igalia S.L. * * This program is free software; you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation; either version 2, or (at your option) * any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this program; if not, write to the Free Software * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. * */ #include "config.h" #include "ephy-file-helpers.h" #include "ephy-debug.h" #include "ephy-prefs.h" #include "ephy-profile-utils.h" #include "ephy-settings.h" #include "ephy-string.h" #include #include #include #include #include #include #include #include #include #include #include /** * SECTION:ephy-file-helpers * @short_description: miscellaneous file related utility functions * * File related functions, including functions to launch, browse or move files * atomically. */ #define DELAY_MAX_TICKS 64 #define INITIAL_TICKS 2 static GHashTable *files = NULL; static GHashTable *mime_table = NULL; static gboolean keep_directory = FALSE; static char *dot_dir = NULL; static char *tmp_dir = NULL; static GList *del_on_exit = NULL; static gboolean is_default_dot_dir = FALSE; GQuark ephy_file_helpers_error_quark; /** * ephy_file_tmp_dir: * * Returns the name of the temp dir for the running Epiphany instance. * * Returns: the name of the temp dir, this string belongs to Epiphany. **/ const char * ephy_file_tmp_dir (void) { if (tmp_dir == NULL) { char *partial_name; char *full_name; partial_name = g_strconcat ("epiphany-", g_get_user_name (), "-XXXXXX", NULL); full_name = g_build_filename (g_get_tmp_dir (), partial_name, NULL); #ifdef HAVE_MKDTEMP tmp_dir = mkdtemp (full_name); #else #error no mkdtemp implementation #endif g_free (partial_name); if (tmp_dir == NULL) { g_free (full_name); } } return tmp_dir; } static char * ephy_file_download_dir (void) { const char *xdg_download_dir; xdg_download_dir = g_get_user_special_dir (G_USER_DIRECTORY_DOWNLOAD); if (xdg_download_dir != NULL) return g_strdup (xdg_download_dir); /* If we don't have XDG user dirs info, return an educated guess. */ return g_build_filename (g_get_home_dir (), _("Downloads"), NULL); } /** * ephy_file_get_downloads_dir: * * Returns a proper downloads destination by checking the * EPHY_PREFS_STATE_DOWNLOAD_DIR GSettings key and following this logic: * * - An absolute path: considered user-set, use this value directly. * * - "Desktop" keyword in GSettings: the directory returned by * ephy_file_desktop_dir(). * * - "Downloads" keyword in GSettings, or any other value: the XDG * downloads directory, or ~/Downloads. * * Returns: a newly-allocated string containing the path to the downloads dir. **/ char * ephy_file_get_downloads_dir (void) { char *download_dir; download_dir = g_settings_get_string (EPHY_SETTINGS_STATE, EPHY_PREFS_STATE_DOWNLOAD_DIR); if (g_str_equal (download_dir, "Desktop")) download_dir = ephy_file_desktop_dir (); if (g_str_equal (download_dir, "Downloads") || g_path_is_absolute (download_dir) != TRUE) download_dir = ephy_file_download_dir (); return download_dir; } /** * ephy_file_desktop_dir: * * Gets the XDG desktop dir path or a default homedir/Desktop alternative. * * Returns: a newly-allocated string containing the desktop dir path. **/ char * ephy_file_desktop_dir (void) { const char *xdg_desktop_dir; xdg_desktop_dir = g_get_user_special_dir (G_USER_DIRECTORY_DESKTOP); if (xdg_desktop_dir != NULL) return g_strdup (xdg_desktop_dir); /* If we don't have XDG user dirs info, return an educated guess. */ return g_build_filename (g_get_home_dir (), _("Desktop"), NULL); } /** * ephy_file_tmp_filename: * @base: the base name of the temp file to create, containing "XXXXXX" * @extension: an optional extension for @base or %NULL * * Gets a usable temp filename with g_mkstemp() using @base as the name * with an optional @extension. @base should contain "XXXXXX" in it. * * Notice that this does not create the file. It only gets a valid * filename. * * Returns: a newly-allocated string containing the name of the temp * file name or %NULL. **/ char * ephy_file_tmp_filename (const char *base, const char *extension) { int fd; char *name = g_strdup (base); fd = g_mkstemp (name); if (fd != -1) { unlink (name); close (fd); } else { g_free (name); return NULL; } if (extension) { char *tmp; tmp = g_strconcat (name, ".", extension, NULL); g_free (name); name = tmp; } return name; } /** * ephy_file: * @filename: the name of the Epiphany file requested * * Looks for @filename in Epiphany's directories and relevant paths. * * Returns: the full path to the requested file **/ const char * ephy_file (const char *filename) { char *ret; guint i; static const char * const paths[] = { #ifdef GNOME_ENABLE_DEBUG TOP_SRC_DATADIR "/", TOP_SRC_DATADIR "/icons/", TOP_SRC_DATADIR "/pages/", #endif SHARE_DIR "/", SHARE_DIR "/icons/", SHARE_DIR "/pages/" }; g_assert (files != NULL); ret = g_hash_table_lookup (files, filename); if (ret != NULL) return ret; for (i = 0; i < G_N_ELEMENTS (paths); i++) { ret = g_strconcat (paths[i], filename, NULL); if (g_file_test (ret, G_FILE_TEST_EXISTS) == TRUE) { g_hash_table_insert (files, g_strdup (filename), ret); return (const char *) ret; } g_free (ret); } g_warning ("Failed to find %s\n", filename); return NULL; } /** * ephy_dot_dir: * * Gets Epiphany's configuration directory, usually .config/epiphany * under user's homedir. * * Returns: the full path to Epiphany's configuration directory **/ const char * ephy_dot_dir (void) { return dot_dir; } /** * ephy_dot_dir_is_default: * * Returns whether the dot directory in use is the default one, found in * ~/.config * * Returns: %TRUE if it is the default dot dir, %FALSE for others **/ gboolean ephy_dot_dir_is_default (void) { return is_default_dot_dir; } /** * ephy_file_helpers_init: * @profile_dir: directory to use as Epiphany's profile * @flags: the %EphyFileHelpersFlags for this session * @error: an optional #GError * * Initializes Epiphany file helper functions, sets @profile_dir as Epiphany's * profile dir and whether the running session will be private. * * Returns: %FALSE if the profile dir couldn't be created or accessed **/ gboolean ephy_file_helpers_init (const char *profile_dir, EphyFileHelpersFlags flags, GError **error) { gboolean ret = TRUE; gboolean private_profile; gboolean steal_data_from_profile; ephy_file_helpers_error_quark = g_quark_from_static_string ("ephy-file-helpers-error"); files = g_hash_table_new_full (g_str_hash, g_str_equal, (GDestroyNotify) g_free, (GDestroyNotify) g_free); keep_directory = flags & EPHY_FILE_HELPERS_KEEP_DIR; private_profile = flags & EPHY_FILE_HELPERS_PRIVATE_PROFILE; steal_data_from_profile = flags & EPHY_FILE_HELPERS_STEAL_DATA; if (profile_dir != NULL && !steal_data_from_profile) { dot_dir = g_strdup (profile_dir); } else if (private_profile) { if (ephy_file_tmp_dir () == NULL) { g_set_error (error, EPHY_FILE_HELPERS_ERROR_QUARK, 0, _("Could not create a temporary directory in “%s”."), g_get_tmp_dir ()); return FALSE; } dot_dir = g_build_filename (ephy_file_tmp_dir (), "epiphany", NULL); } else { dot_dir = g_build_filename (g_get_user_config_dir (), "epiphany", NULL); is_default_dot_dir = TRUE; } if (flags & EPHY_FILE_HELPERS_ENSURE_EXISTS) ret = ephy_ensure_dir_exists (ephy_dot_dir (), error); if (steal_data_from_profile && profile_dir) { int i; char *files_to_copy[] = { EPHY_HISTORY_FILE, EPHY_BOOKMARKS_FILE }; for (i = 0; i < G_N_ELEMENTS (files_to_copy); i++) { char *filename; GError *error = NULL; GFile *source, *destination; filename = g_build_filename (profile_dir, files_to_copy[i], NULL); source = g_file_new_for_path (filename); g_free (filename); filename = g_build_filename (dot_dir, files_to_copy[i], NULL); destination = g_file_new_for_path (filename); g_free (filename); g_file_copy (source, destination, G_FILE_COPY_OVERWRITE, NULL, NULL, NULL, &error); if (error) { printf("Error stealing file %s from profile: %s\n", files_to_copy[i], error->message); g_error_free (error); } g_object_unref (source); g_object_unref (destination); } } return ret; } static void delete_files (GList *l) { for (; l != NULL; l = l->next) { unlink (l->data); } } /** * ephy_file_helpers_shutdown: * * Cleans file helpers information, corresponds to ephy_file_helpers_init(). **/ void ephy_file_helpers_shutdown (void) { g_hash_table_destroy (files); del_on_exit = g_list_reverse (del_on_exit); delete_files (del_on_exit); g_list_foreach (del_on_exit, (GFunc)g_free, NULL); g_list_free (del_on_exit); del_on_exit = NULL; if (mime_table != NULL) { LOG ("Destroying mime type hashtable"); g_hash_table_destroy (mime_table); mime_table = NULL; } g_free (dot_dir); dot_dir = NULL; if (tmp_dir != NULL) { if (!keep_directory) { GFile *tmp_dir_file; tmp_dir_file = g_file_new_for_path (tmp_dir); /* recursively delete the contents and the * directory */ LOG ("shutdown: delete tmp_dir %s", tmp_dir); ephy_file_delete_dir_recursively (tmp_dir_file, NULL); g_object_unref (tmp_dir_file); } g_free (tmp_dir); tmp_dir = NULL; } } /** * ephy_ensure_dir_exists: * @dir: path to a directory * @error: an optional GError to fill or %NULL * * Checks if @dir exists and is a directory, if it it exists and it's not a * directory %FALSE is returned. If @dir doesn't exist and can't be created * then %FALSE is returned. * * Returns: %TRUE if @dir exists and is a directory **/ gboolean ephy_ensure_dir_exists (const char *dir, GError **error) { if (g_file_test (dir, G_FILE_TEST_EXISTS) && !g_file_test (dir, G_FILE_TEST_IS_DIR)) { g_set_error (error, EPHY_FILE_HELPERS_ERROR_QUARK, 0, _("The file “%s” exists. Please move it out of the way."), dir); return FALSE; } if (!g_file_test (dir, G_FILE_TEST_EXISTS)) { if (g_mkdir_with_parents (dir, 488) == 0) { /* We need to set the .migrated file to the * current profile migration version, * otherwise the next time the browser runs * things might go awry. */ ephy_profile_utils_set_migration_version (EPHY_PROFILE_MIGRATION_VERSION); } else { g_set_error (error, EPHY_FILE_HELPERS_ERROR_QUARK, 0, _("Failed to create directory “%s”."), dir); return FALSE; } } return TRUE; } static void ephy_find_file_recursive (const char *path, const char *fname, GSList **list, gint depth, gint maxdepth) { GDir *dir; const gchar *file; dir = g_dir_open (path, 0, NULL); if (dir != NULL) { while ((file = g_dir_read_name (dir))) { if (depth < maxdepth) { char *new_path = g_build_filename (path, file, NULL); ephy_find_file_recursive (new_path, fname, list, depth + 1, maxdepth); g_free (new_path); } if (strcmp (file, fname) == 0) { char *new_path = g_build_filename (path, file, NULL); *list = g_slist_prepend (*list, new_path); } } g_dir_close (dir); } } /** * ephy_file_find: * @path: path to search for @fname * @fname: filename to search for * @maxdepth: maximum directory depth when searching @path * * Searchs for @fname in @path with a maximum depth of @maxdepth. * * Returns: a GSList of matches **/ GSList * ephy_file_find (const char *path, const char *fname, gint maxdepth) { GSList *ret = NULL; ephy_find_file_recursive (path, fname, &ret, 0, maxdepth); return ret; } /** * ephy_file_delete_on_exit: * @file: a #GFile * * Schedules @file to be deleted when Epiphany exits. This function currently * does nothing. **/ void ephy_file_delete_on_exit (GFile *file) { /* does nothing now */ } static void load_mime_from_xml (void) { xmlTextReaderPtr reader; const char *xml_file; int ret; EphyMimePermission permission = EPHY_MIME_PERMISSION_UNKNOWN; g_return_if_fail (mime_table == NULL); mime_table = g_hash_table_new_full (g_str_hash, g_str_equal, xmlFree, NULL); xml_file = ephy_file ("mime-types-permissions.xml"); if (xml_file == NULL) { g_warning ("MIME types permissions file not found!\n"); return; } reader = xmlNewTextReaderFilename (xml_file); if (reader == NULL) { g_warning ("Could not load MIME types permissions file!\n"); return; } ret = xmlTextReaderRead (reader); while (ret == 1) { const xmlChar *tag; xmlReaderTypes type; tag = xmlTextReaderConstName (reader); type = xmlTextReaderNodeType (reader); if (xmlStrEqual (tag, (const xmlChar *)"safe") && type == XML_READER_TYPE_ELEMENT) { permission = EPHY_MIME_PERMISSION_SAFE; } else if (xmlStrEqual (tag, (const xmlChar *)"unsafe") && type == XML_READER_TYPE_ELEMENT) { permission = EPHY_MIME_PERMISSION_UNSAFE; } else if (xmlStrEqual (tag, (const xmlChar *)"mime-type")) { xmlChar *type; type = xmlTextReaderGetAttribute (reader, (const xmlChar *)"type"); g_hash_table_insert (mime_table, type, GINT_TO_POINTER (permission)); } ret = xmlTextReaderRead (reader); } xmlFreeTextReader (reader); } /** * ephy_file_check_mime: * @mime_type: a mime type * * Checks @mime_type against our safe/unsafe database of types, returns an * #EphyMimePermission. * * Returns: an #EphyMimePermission **/ EphyMimePermission ephy_file_check_mime (const char *mime_type) { EphyMimePermission permission; gpointer tmp; g_return_val_if_fail (mime_type != NULL, EPHY_MIME_PERMISSION_UNKNOWN); if (mime_table == NULL) { load_mime_from_xml (); } tmp = g_hash_table_lookup (mime_table, mime_type); if (tmp == NULL) { permission = EPHY_MIME_PERMISSION_UNKNOWN; } else { permission = GPOINTER_TO_INT (tmp); } return permission; } /** * ephy_file_launch_application: * @app: the application to launch * @files: files to pass to @app * @user_time: user time to prevent focus stealing * @widget: a relevant widget from where to get the #GdkScreen and #GdkDisplay * * Launches @app to open @files. If @widget is set the screen and display from * it will be used to launch the application, otherwise the defaults will be * used. * * Returns: %TRUE if g_app_info_launch() succeeded **/ gboolean ephy_file_launch_application (GAppInfo *app, GList *files, guint32 user_time, GtkWidget *widget) { GdkAppLaunchContext *context; GdkDisplay *display; GdkScreen *screen; gboolean res; if (widget) { display = gtk_widget_get_display (widget); screen = gtk_widget_get_screen (widget); } else { display = gdk_display_get_default (); screen = gdk_screen_get_default (); } context = gdk_display_get_app_launch_context (display); gdk_app_launch_context_set_screen (context, screen); gdk_app_launch_context_set_timestamp (context, user_time); res = g_app_info_launch (app, files, G_APP_LAUNCH_CONTEXT (context), NULL); g_object_unref (context); return res; } /** * ephy_file_launch_desktop_file: * @filename: the path to the .desktop file * @parameter: path to an optional parameter file to pass to the application * @user_time: user time to prevent focus stealing * @widget: an optional widget for ephy_file_launch_application() * * Calls ephy_file_launch_application() for the application described by the * .desktop file @filename. Can pass @parameter as optional file arguments. * * Returns: %TRUE if the application launch was successful **/ gboolean ephy_file_launch_desktop_file (const char *filename, const char *parameter, guint32 user_time, GtkWidget *widget) { GDesktopAppInfo *app; GFile *file = NULL; GList *list = NULL; gboolean ret; app = g_desktop_app_info_new (filename); if (parameter) { file = g_file_new_for_path (parameter); list = g_list_append (list, file); } ret = ephy_file_launch_application (G_APP_INFO (app), list, user_time, widget); g_list_free (list); if (file) g_object_unref (file); return ret; } GAppInfo * ephy_file_launcher_get_app_info_for_file (GFile *file, const char *mime_type) { GAppInfo *app = NULL; g_return_val_if_fail (file || mime_type, FALSE); if (mime_type != NULL) { app = g_app_info_get_default_for_type (mime_type, FALSE); } else { GFileInfo *file_info; char *type; /* Sniff mime type and check if it's safe to open */ file_info = g_file_query_info (file, G_FILE_ATTRIBUTE_STANDARD_CONTENT_TYPE, 0, NULL, NULL); if (file_info == NULL) { return FALSE; } type = g_strdup (g_file_info_get_content_type (file_info)); g_object_unref (file_info); if (type != NULL && type[0] != '\0' && ephy_file_check_mime (type) == EPHY_MIME_PERMISSION_SAFE) { /* FIXME rename tmp file to right extension ? */ app = g_app_info_get_default_for_type (type, FALSE); } g_free (type); } return app; } /** * ephy_file_launch_handler: * @mime_type: the mime type of @file or %NULL * @file: a #GFile to pass as argument * @user_time: user time to prevent focus stealing * * Launches @file with its default handler application, if @mime_type is %NULL * then @file will be queried for its type. * * Returns: %TRUE on success **/ gboolean ephy_file_launch_handler (const char *mime_type, GFile *file, guint32 user_time) { GAppInfo *app = NULL; gboolean ret = FALSE; g_return_val_if_fail (file != NULL, FALSE); app = ephy_file_launcher_get_app_info_for_file (file, mime_type); if (app != NULL) { GList *list = NULL; list = g_list_append (list, file); ret = ephy_file_launch_application (app, list, user_time, NULL); g_list_free (list); } return ret; } /** * ephy_file_browse_to: * @file: a #GFile * @user_time: user_time to prevent focus stealing * * Launches the default application for browsing directories, with @file's * parent directory as its target. Passes @user_time to * ephy_file_launch_handler() to prevent focus stealing. * * Returns: %TRUE if the launch succeeded **/ gboolean ephy_file_browse_to (GFile *file, guint32 user_time) { return ephy_file_launch_handler ("inode/directory", file, user_time); } /** * ephy_file_delete_dir_recursively: * @directory: directory to remove * @error: location to set any #GError * * Remove @path and its contents. Like calling rm -rf @path. * * Returns: %TRUE if delete succeeded **/ gboolean ephy_file_delete_dir_recursively (GFile *directory, GError **error) { GFileEnumerator *children = NULL; GFileInfo *info; gboolean ret = FALSE; children = g_file_enumerate_children (directory, "standard::name,standard::type", 0, NULL, error); if (children == NULL || error) goto out; info = g_file_enumerator_next_file (children, NULL, error); while (info || error) { GFile *child; const char *name; GFileType type; if (error) goto out; name = g_file_info_get_name (info); child = g_file_get_child (directory, name); type = g_file_info_get_file_type (info); LOG ("ephy-file-delete-dir: delete child %s", name); if (type == G_FILE_TYPE_DIRECTORY) ret = ephy_file_delete_dir_recursively (child, error); else if (type == G_FILE_TYPE_REGULAR) ret = g_file_delete (child, NULL, error); g_object_unref (info); g_object_unref (child); if (!ret) goto out; info = g_file_enumerator_next_file (children, NULL, error); } ret = TRUE; LOG ("ephy-file-delete-dir: delete successful"); g_file_delete (directory, NULL, error); out: if (children) g_object_unref (children); return ret; } /** * ephy_file_delete_uri * @uri: URI of the file to be deleted * * Remove the given URI. */ void ephy_file_delete_uri (const char *uri) { GFile *file; gboolean ret; g_return_if_fail (uri); file = g_file_new_for_uri (uri); ret = g_file_delete (file, NULL, NULL); if (ret == TRUE) { LOG ("Deleted file at URI '%s'", uri); } else { LOG ("Couldn't file at URI '%s'", uri); } g_object_unref (file); } /** * ephy_file_create_data_uri_for_filename: * @filename: the filename of a local path * @mime_type: the MIME type of the filename, or %NULL * * Create a data uri using the contents of @filename. * If @mime_type is %NULL, the %G_FILE_ATTRIBUTE_STANDARD_CONTENT_TYPE * attribute of @filename will be used. * * Returns: a new allocated string containg the data uri, or %NULL if the * data uri could not be created */ char * ephy_file_create_data_uri_for_filename (const char *filename, const char *mime_type) { gchar *data; gsize data_length; gchar *base64; gchar *uri = NULL; GFileInfo *file_info = NULL; g_return_val_if_fail (filename != NULL, NULL); if (!g_file_get_contents (filename, &data, &data_length, NULL)) return NULL; base64 = g_base64_encode ((const guchar *)data, data_length); g_free (data); if (!mime_type) { GFile *file; file = g_file_new_for_path (filename); file_info = g_file_query_info (file, G_FILE_ATTRIBUTE_STANDARD_CONTENT_TYPE, G_FILE_QUERY_INFO_NONE, NULL, NULL); if (file_info) mime_type = g_file_info_get_content_type (file_info); g_object_unref (file); } if (mime_type) uri = g_strdup_printf ("data:%s;charset=utf8;base64,%s", mime_type, base64); g_free(base64); if (file_info) g_object_unref (file_info); return uri; } /** * ephy_sanitize_filename: * @filename: a filename * * Sanitize @filename to make sure it's a valid filename. If the * filename contains directory separators, they will be converted to * underscores, so that they are not interpreted as a path by the * filesystem. * * Note that it modifies string in place. The return value is to allow nesting. * * Returns: the sanitized filename */ char * ephy_sanitize_filename (char *filename) { g_return_val_if_fail (filename != NULL, NULL); return g_strdelimit (filename, G_DIR_SEPARATOR_S, '_'); }