Getting and Setting File Information: GnomeVFS - Filesystem Abstraction library

Getting and Setting File Information

Getting and Setting File Information — Convenient high-level abstraction for obtaining and setting file information, including ACLs.

Functions

GnomeVFSResult	gnome_vfs_get_file_info ()
GnomeVFSResult	gnome_vfs_get_file_info_uri ()
GnomeVFSResult	gnome_vfs_get_file_info_from_handle ()
GnomeVFSResult	gnome_vfs_set_file_info_uri ()
GnomeVFSResult	gnome_vfs_set_file_info ()

Description

Applications can use the gnome_vfs_get_file_info() family of operations to retrieve file information, as this operation can be quite costly in terms of time (specilly when sniffing the MIME type) applications can specify which information need at any time, reducing the performance impact.

All of these operations use a GnomeVFSFileInfo data structure that holds the file information, there are several methods that can be used to manipulate this information. See GnomeVFSFileInfo for more information.

Functions

gnome_vfs_get_file_info ()

GnomeVFSResult
gnome_vfs_get_file_info (const gchar *text_uri,
                         GnomeVFSFileInfo *info,
                         GnomeVFSFileInfoOptions options);

Retrieve information about text_uri . The information will be stored in info .

Parameters

text_uri	uri of the file for which information will be retrieved.
info	pointer to a GnomeVFSFileInfo object that will hold the information for the file on return.
options	options for retrieving file information.

Returns

an integer representing the result of the operation.

gnome_vfs_get_file_info_uri ()

GnomeVFSResult
gnome_vfs_get_file_info_uri (GnomeVFSURI *uri,
                             GnomeVFSFileInfo *info,
                             GnomeVFSFileInfoOptions options);

Retrieve information about text_uri . The information will be stored in info .

Parameters

uri	uri of the file for which information will be retrieved.
info	pointer to a GnomeVFSFileInfo object that will hold the information for the file on return.
options	options for retrieving file information.

Returns

an integer representing the result of the operation.

gnome_vfs_get_file_info_from_handle ()

GnomeVFSResult
gnome_vfs_get_file_info_from_handle (GnomeVFSHandle *handle,
                                     GnomeVFSFileInfo *info,
                                     GnomeVFSFileInfoOptions options);

Retrieve information about an open file. The information will be stored in info .

Parameters

handle	handle of the file for which information must be retrieved.
info	pointer to a GnomeVFSFileInfo object that will hold the information for the file on return.
options	options for retrieving file information.

Returns

an integer representing the result of the operation.

gnome_vfs_set_file_info_uri ()

GnomeVFSResult
gnome_vfs_set_file_info_uri (GnomeVFSURI *uri,
                             GnomeVFSFileInfo *info,
                             GnomeVFSSetFileInfoMask mask);

Set file information for uri ; only the information for which the corresponding bit in mask is set is actually modified.

info's valid_fields is not required to contain the GnomeVFSFileInfoFields corresponding to the specified GnomeVFSSetFileInfoMask fields of mask. It is assumed that the info fields referenced by mask are valid.

Parameters

uri	a uri.
info	information that must be set for the file.
mask	bit mask representing which fields of `info` need to be set.

Returns

an integer representing the result of the operation.

gnome_vfs_set_file_info ()

GnomeVFSResult
gnome_vfs_set_file_info (const gchar *text_uri,
                         GnomeVFSFileInfo *info,
                         GnomeVFSSetFileInfoMask mask);

Set file information for uri ; only the information for which the corresponding bit in mask is set is actually modified.

Parameters

text_uri	string representing the file location.
info	information that must be set for the file.
mask	bit mask representing which fields of `info` need to be set.

Returns

an integer representing the result of the operation.