/* GIO - GLib Input, Output and Streaming Library
- *
+ *
* Copyright (C) 2006-2007 Red Hat, Inc.
*
* This library is free software; you can redistribute it and/or
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General
- * Public License along with this library; if not, write to the
- * Free Software Foundation, Inc., 59 Temple Place, Suite 330,
- * Boston, MA 02111-1307, USA.
+ * Public License along with this library; if not, see <http://www.gnu.org/licenses/>.
*
* Author: Alexander Larsson <alexl@redhat.com>
*/
#include "config.h"
#include <string.h>
#include "gvfs.h"
+#include "glib-private.h"
#include "glocalvfs.h"
+#include "gresourcefile.h"
#include "giomodule-priv.h"
#include "glibintl.h"
/**
* SECTION:gvfs
- * @short_description: Virtual File System
+ * @short_description: Virtual File System
* @include: gio/gio.h
- *
+ *
* Entry point for using GIO functionality.
*
- **/
+ */
G_DEFINE_TYPE (GVfs, g_vfs, G_TYPE_OBJECT);
/**
* g_vfs_is_active:
* @vfs: a #GVfs.
- *
+ *
* Checks if the VFS is active.
- *
- * Returns: %TRUE if construction of the @vfs was successful and it is now active.
- **/
+ *
+ * Returns: %TRUE if construction of the @vfs was successful
+ * and it is now active.
+ */
gboolean
g_vfs_is_active (GVfs *vfs)
{
* g_vfs_get_file_for_path:
* @vfs: a #GVfs.
* @path: a string containing a VFS path.
- *
+ *
* Gets a #GFile for @path.
- *
- * Returns: a #GFile.
+ *
+ * Returns: (transfer full): a #GFile.
* Free the returned object with g_object_unref().
- **/
+ */
GFile *
g_vfs_get_file_for_path (GVfs *vfs,
- const char *path)
+ const char *path)
{
GVfsClass *class;
-
+
g_return_val_if_fail (G_IS_VFS (vfs), NULL);
g_return_val_if_fail (path != NULL, NULL);
/**
* g_vfs_get_file_for_uri:
* @vfs: a#GVfs.
- * @uri: a string containing a URI
- *
+ * @uri: a string containing a URI
+ *
* Gets a #GFile for @uri.
- *
+ *
* This operation never fails, but the returned object
- * might not support any I/O operation if the URI
+ * might not support any I/O operation if the URI
* is malformed or if the URI scheme is not supported.
- *
- * Returns: a #GFile.
+ *
+ * Returns: (transfer full): a #GFile.
* Free the returned object with g_object_unref().
- **/
+ */
GFile *
g_vfs_get_file_for_uri (GVfs *vfs,
- const char *uri)
+ const char *uri)
{
GVfsClass *class;
-
+
g_return_val_if_fail (G_IS_VFS (vfs), NULL);
g_return_val_if_fail (uri != NULL, NULL);
class = G_VFS_GET_CLASS (vfs);
+ /* This is an unfortunate placement, but we really
+ * need to check this before chaining to the vfs,
+ * because we want to support resource uris for
+ * all vfs:es, even those that predate resources.
+ */
+ if (g_str_has_prefix (uri, "resource:"))
+ return _g_resource_file_new (uri);
+
return (* class->get_file_for_uri) (vfs, uri);
}
/**
* g_vfs_get_supported_uri_schemes:
* @vfs: a #GVfs.
- *
+ *
* Gets a list of URI schemes supported by @vfs.
- *
- * Returns: a %NULL-terminated array of strings.
- * The returned array belongs to GIO and must
+ *
+ * Returns: (transfer none): a %NULL-terminated array of strings.
+ * The returned array belongs to GIO and must
* not be freed or modified.
- **/
+ */
const gchar * const *
g_vfs_get_supported_uri_schemes (GVfs *vfs)
{
GVfsClass *class;
-
+
g_return_val_if_fail (G_IS_VFS (vfs), NULL);
class = G_VFS_GET_CLASS (vfs);
* g_vfs_parse_name:
* @vfs: a #GVfs.
* @parse_name: a string to be parsed by the VFS module.
- *
- * This operation never fails, but the returned object might
- * not support any I/O operations if the @parse_name cannot
+ *
+ * This operation never fails, but the returned object might
+ * not support any I/O operations if the @parse_name cannot
* be parsed by the #GVfs module.
- *
- * Returns: a #GFile for the given @parse_name.
+ *
+ * Returns: (transfer full): a #GFile for the given @parse_name.
* Free the returned object with g_object_unref().
- **/
+ */
GFile *
g_vfs_parse_name (GVfs *vfs,
- const char *parse_name)
+ const char *parse_name)
{
GVfsClass *class;
-
+
g_return_val_if_fail (G_IS_VFS (vfs), NULL);
g_return_val_if_fail (parse_name != NULL, NULL);
class = G_VFS_GET_CLASS (vfs);
- return (* class->parse_name) (vfs, parse_name);
-}
+ if (g_str_has_prefix (parse_name, "resource:"))
+ return _g_resource_file_new (parse_name);
-static gpointer
-get_default_vfs (gpointer arg)
-{
- const char *use_this;
- GVfs *vfs;
- GList *l;
- GIOExtensionPoint *ep;
- GIOExtension *extension;
-
-
- use_this = g_getenv ("GIO_USE_VFS");
-
- /* Ensure vfs in modules loaded */
- _g_io_modules_ensure_loaded ();
-
- ep = g_io_extension_point_lookup (G_VFS_EXTENSION_POINT_NAME);
-
- if (use_this)
- {
- extension = g_io_extension_point_get_extension_by_name (ep, use_this);
- if (extension)
- {
- vfs = g_object_new (g_io_extension_get_type (extension), NULL);
-
- if (g_vfs_is_active (vfs))
- return vfs;
-
- g_object_unref (vfs);
- }
- }
-
- for (l = g_io_extension_point_get_extensions (ep); l != NULL; l = l->next)
- {
- extension = l->data;
-
- vfs = g_object_new (g_io_extension_get_type (extension), NULL);
-
- if (g_vfs_is_active (vfs))
- return vfs;
-
- g_object_unref (vfs);
- }
-
-
- return NULL;
+ return (* class->parse_name) (vfs, parse_name);
}
/**
* g_vfs_get_default:
- *
+ *
* Gets the default #GVfs for the system.
- *
- * Returns: a #GVfs.
- **/
+ *
+ * Returns: (transfer none): a #GVfs.
+ */
GVfs *
g_vfs_get_default (void)
{
- static GOnce once_init = G_ONCE_INIT;
-
- return g_once (&once_init, get_default_vfs, NULL);
+ if (GLIB_PRIVATE_CALL (g_check_setuid) ())
+ return g_vfs_get_local ();
+ return _g_io_module_get_default (G_VFS_EXTENSION_POINT_NAME,
+ "GIO_USE_VFS",
+ (GIOModuleVerifyFunc)g_vfs_is_active);
}
/**
* g_vfs_get_local:
- *
+ *
* Gets the local #GVfs for the system.
- *
- * Returns: a #GVfs.
- **/
+ *
+ * Returns: (transfer none): a #GVfs.
+ */
GVfs *
g_vfs_get_local (void)
{