![]() |
![]() |
![]() |
GnomeVFS - Filesystem Abstraction library | ![]() |
---|
Advanced File OperationsAdvanced File Operations — |
GnomeVFSResult gnome_vfs_file_control (GnomeVFSHandle *handle, const char *operation, gpointer operation_data); GnomeVFSResult gnome_vfs_forget_cache (GnomeVFSHandle *handle, GnomeVFSFileOffset offset, GnomeVFSFileSize size);
GnomeVFSResult gnome_vfs_file_control (GnomeVFSHandle *handle, const char *operation, gpointer operation_data);
Execute a backend dependent operation specified by the string operation
.
This is typically used for specialized vfs backends that need additional
operations that gnome-vfs doesn't have. Compare it to the unix call ioctl()
.
The format of operation_data
depends on the operation. Operation that are
backend specific are normally namespaced by their module name.
handle : |
Handle of the file to affect |
operation : |
The operation to execute |
operation_data : |
The data needed to execute the operation |
Returns : | an integer representing the success of the operation |
GnomeVFSResult gnome_vfs_forget_cache (GnomeVFSHandle *handle, GnomeVFSFileOffset offset, GnomeVFSFileSize size);
With this call you can announce to gnome-vfs that you will no longer
use the region of data starting at offset
with the size of size
. Any
cached data for this region might then be freed.
This might be useful if you stream large files, for example.
handle : |
Handle of the file to affect |
offset : |
Start point of the region to be freed |
size : |
Length of the region to be freed (or until the end of the file if 0 is specified) |
Returns : | An integer representing the result of the operation. |
Since 2.12
<< Truncating Files | Asynchronous File Operations >> |