GnomeVFSResult

GnomeVFSResult — Result of I/O operations, the equivalent of errno

Synopsis




enum        GnomeVFSResult;
const char* gnome_vfs_result_to_string      (GnomeVFSResult result);
GnomeVFSResult gnome_vfs_result_from_errno_code
                                            (int errno_code);
GnomeVFSResult gnome_vfs_result_from_errno  (void);
GnomeVFSResult gnome_vfs_result_from_h_errno
                                            (void);
GnomeVFSResult gnome_vfs_result_from_h_errno_val
                                            (int h_errno_code);

Description

Details

enum GnomeVFSResult

typedef enum {
	GNOME_VFS_OK,
	GNOME_VFS_ERROR_NOT_FOUND,
	GNOME_VFS_ERROR_GENERIC,
	GNOME_VFS_ERROR_INTERNAL,
	GNOME_VFS_ERROR_BAD_PARAMETERS,
	GNOME_VFS_ERROR_NOT_SUPPORTED,
	GNOME_VFS_ERROR_IO,
	GNOME_VFS_ERROR_CORRUPTED_DATA,
	GNOME_VFS_ERROR_WRONG_FORMAT,
	GNOME_VFS_ERROR_BAD_FILE,
	GNOME_VFS_ERROR_TOO_BIG,
	GNOME_VFS_ERROR_NO_SPACE,
	GNOME_VFS_ERROR_READ_ONLY,
	GNOME_VFS_ERROR_INVALID_URI,
	GNOME_VFS_ERROR_NOT_OPEN,
	GNOME_VFS_ERROR_INVALID_OPEN_MODE,
	GNOME_VFS_ERROR_ACCESS_DENIED,
	GNOME_VFS_ERROR_TOO_MANY_OPEN_FILES,
	GNOME_VFS_ERROR_EOF,
	GNOME_VFS_ERROR_NOT_A_DIRECTORY,
	GNOME_VFS_ERROR_IN_PROGRESS,
	GNOME_VFS_ERROR_INTERRUPTED,
	GNOME_VFS_ERROR_FILE_EXISTS,
	GNOME_VFS_ERROR_LOOP,
	GNOME_VFS_ERROR_NOT_PERMITTED,
	GNOME_VFS_ERROR_IS_DIRECTORY,
	GNOME_VFS_ERROR_NO_MEMORY,
	GNOME_VFS_ERROR_HOST_NOT_FOUND,
	GNOME_VFS_ERROR_INVALID_HOST_NAME,
	GNOME_VFS_ERROR_HOST_HAS_NO_ADDRESS,
	GNOME_VFS_ERROR_LOGIN_FAILED,
	GNOME_VFS_ERROR_CANCELLED,
	GNOME_VFS_ERROR_DIRECTORY_BUSY,
	GNOME_VFS_ERROR_DIRECTORY_NOT_EMPTY,
	GNOME_VFS_ERROR_TOO_MANY_LINKS,
	GNOME_VFS_ERROR_READ_ONLY_FILE_SYSTEM,
	GNOME_VFS_ERROR_NOT_SAME_FILE_SYSTEM,
	GNOME_VFS_ERROR_NAME_TOO_LONG,
	GNOME_VFS_ERROR_SERVICE_NOT_AVAILABLE,
	GNOME_VFS_ERROR_SERVICE_OBSOLETE,
	GNOME_VFS_ERROR_PROTOCOL_ERROR,
	GNOME_VFS_ERROR_NO_MASTER_BROWSER,
	GNOME_VFS_ERROR_NO_DEFAULT,
	GNOME_VFS_ERROR_NO_HANDLER,
	GNOME_VFS_ERROR_PARSE,
	GNOME_VFS_ERROR_LAUNCH,
	GNOME_VFS_ERROR_TIMEOUT,
	GNOME_VFS_ERROR_NAMESERVER,
	GNOME_VFS_ERROR_LOCKED,
	GNOME_VFS_ERROR_DEPRECATED_FUNCTION,
	GNOME_VFS_ERROR_INVALID_FILENAME,
	GNOME_VFS_ERROR_NOT_A_SYMBOLIC_LINK,
	GNOME_VFS_NUM_ERRORS
} GnomeVFSResult;

A GnomeVFSResult informs library clients about the result of a file operation. Unless it is GNOME_VFS_OK, it denotes that a problem occurred and the operation could not be executed successfully.

gnome_vfs_result_to_string() provides a textual representation of GnomeVFSResults.

GNOME_VFS_OK No error.
GNOME_VFS_ERROR_NOT_FOUND File not found.
GNOME_VFS_ERROR_GENERIC Generic error.
GNOME_VFS_ERROR_INTERNAL Internal error.
GNOME_VFS_ERROR_BAD_PARAMETERS Invalid parameters.
GNOME_VFS_ERROR_NOT_SUPPORTED Unsupported operation.
GNOME_VFS_ERROR_IO I/O error.
GNOME_VFS_ERROR_CORRUPTED_DATA Data corrupted.
GNOME_VFS_ERROR_WRONG_FORMAT Format not valid.
GNOME_VFS_ERROR_BAD_FILE Bad file handle.
GNOME_VFS_ERROR_TOO_BIG File too big.
GNOME_VFS_ERROR_NO_SPACE No space left on device.
GNOME_VFS_ERROR_READ_ONLY Read-only file system.
GNOME_VFS_ERROR_INVALID_URI Invalid URI.
GNOME_VFS_ERROR_NOT_OPEN File not open.
GNOME_VFS_ERROR_INVALID_OPEN_MODE Open mode not valid.
GNOME_VFS_ERROR_ACCESS_DENIED Access denied.
GNOME_VFS_ERROR_TOO_MANY_OPEN_FILES Too many open files.
GNOME_VFS_ERROR_EOF End of file.
GNOME_VFS_ERROR_NOT_A_DIRECTORY Not a directory.
GNOME_VFS_ERROR_IN_PROGRESS Operation in progress.
GNOME_VFS_ERROR_INTERRUPTED Operation interrupted.
GNOME_VFS_ERROR_FILE_EXISTS File exists.
GNOME_VFS_ERROR_LOOP Looping links encountered.
GNOME_VFS_ERROR_NOT_PERMITTED Operation not permitted.
GNOME_VFS_ERROR_IS_DIRECTORY Is a directory.
GNOME_VFS_ERROR_NO_MEMORY Not enough memory.
GNOME_VFS_ERROR_HOST_NOT_FOUND Host not found.
GNOME_VFS_ERROR_INVALID_HOST_NAME Host name not valid.
GNOME_VFS_ERROR_HOST_HAS_NO_ADDRESS Host has no address.
GNOME_VFS_ERROR_LOGIN_FAILED Login failed.
GNOME_VFS_ERROR_CANCELLED Operation cancelled.
GNOME_VFS_ERROR_DIRECTORY_BUSY Directory busy.
GNOME_VFS_ERROR_DIRECTORY_NOT_EMPTY Directory not empty.
GNOME_VFS_ERROR_TOO_MANY_LINKS Too many links.
GNOME_VFS_ERROR_READ_ONLY_FILE_SYSTEM Read only file system.
GNOME_VFS_ERROR_NOT_SAME_FILE_SYSTEM Not on the same file system.
GNOME_VFS_ERROR_NAME_TOO_LONG Name too long.
GNOME_VFS_ERROR_SERVICE_NOT_AVAILABLE Service not available.
GNOME_VFS_ERROR_SERVICE_OBSOLETE Request obsoletes service's data.
GNOME_VFS_ERROR_PROTOCOL_ERROR Protocol error.
GNOME_VFS_ERROR_NO_MASTER_BROWSER Could not find master browser.
GNOME_VFS_ERROR_NO_DEFAULT No default action associated.
GNOME_VFS_ERROR_NO_HANDLER No handler for URL scheme.
GNOME_VFS_ERROR_PARSE Error parsing command line.
GNOME_VFS_ERROR_LAUNCH Error launching command.
GNOME_VFS_ERROR_TIMEOUT Timeout reached.
GNOME_VFS_ERROR_NAMESERVER Nameserver error.
GNOME_VFS_ERROR_LOCKED The resource is locked.
GNOME_VFS_ERROR_DEPRECATED_FUNCTION Function call deprecated.
GNOME_VFS_ERROR_INVALID_FILENAME The specified filename is invalid.
GNOME_VFS_ERROR_NOT_A_SYMBOLIC_LINK Not a symbolic link.
GNOME_VFS_NUM_ERRORS

gnome_vfs_result_to_string ()

const char* gnome_vfs_result_to_string      (GnomeVFSResult result);

Returns a string representing result, useful for debugging purposes, but probably not appropriate for passing to the user.

result : a GnomeVFSResult to convert to a string.
Returns : a string representing result.

gnome_vfs_result_from_errno_code ()

GnomeVFSResult gnome_vfs_result_from_errno_code
                                            (int errno_code);

Converts a system errno value to a GnomeVFSResult.

errno_code : integer of the same type as the system "errno".
Returns : a GnomeVFSResult equivalent to errno_code.

gnome_vfs_result_from_errno ()

GnomeVFSResult gnome_vfs_result_from_errno  (void);

Converts the system errno to a GnomeVFSResult.

Returns : a GnomeVFSResult equivalent to the current system errno.

gnome_vfs_result_from_h_errno ()

GnomeVFSResult gnome_vfs_result_from_h_errno
                                            (void);

Converts the system "h_errno" to a GnomeVFSResult (h_errno represents errors accessing and finding internet hosts)

Returns : a GnomeVFSResult equivalent to the current system "h_errno".

gnome_vfs_result_from_h_errno_val ()

GnomeVFSResult gnome_vfs_result_from_h_errno_val
                                            (int h_errno_code);

Converts the error code h_errno_code into a GnomeVFSResult.

h_errno_code : an integer representing the same error code as the system h_errno.
Returns : The GnomeVFSResult equivalent to the h_errno_code.