diff options
author | Cosimo Cecchi <cosimo@endlessm.com> | 2016-06-20 11:42:56 -0700 |
---|---|---|
committer | Cosimo Cecchi <cosimoc@gnome.org> | 2016-06-25 06:58:19 +0800 |
commit | 375b4ca65cf09789aeeb4e15ac3b12211729aa31 (patch) | |
tree | 4fe5d6cdc2878ed7d169a9f7ab7e4e2bc5b9869d /gio/gvfs.h | |
parent | 4442bf2c95f68bbbf3dcc8e84b1775a90eb9927a (diff) | |
download | glib-375b4ca65cf09789aeeb4e15ac3b12211729aa31.tar.gz |
vfs: add g_vfs_register_uri_scheme()
Add a new API to allow clients to register a custom GFile implementation
handling a particular URI scheme.
This can be useful for tests, but also for cases where a different URI
scheme is desired to be used with another custom GFile backend.
As an additional cleanup, we can use this to register the "resource" URI
scheme too.
Based on a patch by Jasper St. Pierre <jstpierre@mecheye.net>.
https://bugzilla.gnome.org/show_bug.cgi?id=767887
Diffstat (limited to 'gio/gvfs.h')
-rw-r--r-- | gio/gvfs.h | 36 |
1 files changed, 36 insertions, 0 deletions
diff --git a/gio/gvfs.h b/gio/gvfs.h index e67e2d9a1..7b2969c9c 100644 --- a/gio/gvfs.h +++ b/gio/gvfs.h @@ -37,6 +37,28 @@ G_BEGIN_DECLS #define G_IS_VFS_CLASS(k) (G_TYPE_CHECK_CLASS_TYPE ((k), G_TYPE_VFS)) /** + * GVfsFileLookupFunc: + * @vfs: a #GVfs + * @identifier: the identifier to lookup a #GFile for. This can either + * be an URI or a parse name as returned by g_file_get_parse_name() + * @user_data: user data passed to the function + * + * This function type is used by g_vfs_register_uri_scheme() to make it + * possible for a client to associate an URI scheme to a different #GFile + * implementation. + * + * The client should return a reference to the new file that has been + * created for @uri, or %NULL to continue with the default implementation. + * + * Returns: (transfer full): a #GFile for @identifier. + * + * Since: 2.50 + */ +typedef GFile * (* GVfsFileLookupFunc) (GVfs *vfs, + const char *identifier, + gpointer user_data); + +/** * G_VFS_EXTENSION_POINT_NAME: * * Extension point for #GVfs functionality. @@ -127,6 +149,20 @@ GVfs * g_vfs_get_default (void); GLIB_AVAILABLE_IN_ALL GVfs * g_vfs_get_local (void); +GLIB_AVAILABLE_IN_2_50 +gboolean g_vfs_register_uri_scheme (GVfs *vfs, + const char *scheme, + GVfsFileLookupFunc uri_func, + gpointer uri_data, + GDestroyNotify uri_destroy, + GVfsFileLookupFunc parse_name_func, + gpointer parse_name_data, + GDestroyNotify parse_name_destroy); +GLIB_AVAILABLE_IN_2_50 +gboolean g_vfs_unregister_uri_scheme (GVfs *vfs, + const char *scheme); + + G_END_DECLS #endif /* __G_VFS_H__ */ |