Package org.gnome.glib

Enum Class FileError

java.lang.Object

java.lang.Enum<FileError>

org.gnome.glib.FileError

All Implemented Interfaces:

Enumeration, Serializable, Comparable<FileError>, Constable

@Generated("io.github.jwharm.JavaGI")
public enum FileError
extends Enum<FileError>
implements Enumeration

Values corresponding to errno codes returned from file operations on UNIX. Unlike errno codes, GFileError values are available on all systems, even Windows. The exact meaning of each code depends on what sort of file operation you were performing; the UNIX documentation gives more details. The following error code descriptions come from the GNU C Library manual, and are under the copyright of that manual.

It's not very portable to make detailed assumptions about exactly which errors will be returned from a given operation. Some errors don't occur on some systems, etc., sometimes there are subtle differences in when a system will report a given error, etc.

Nested Class Summary

Nested classes/interfaces inherited from class java.lang.Enum

Enum.EnumDesc<E extends Enum<E>>

Enum Constant Summary

Enum Constants

Enum Constant	Description
ACCES	Permission denied; the file permissions do not allow the attempted operation.
AGAIN	Resource temporarily unavailable; the call might work if you try again later.
BADF	Bad file descriptor; for example, I/O on a descriptor that has been closed or reading from a descriptor open only for writing (or vice versa).
EXIST	Operation not permitted; only the owner of the file (or other resource) or processes with special privileges can perform the operation.
FAILED	Does not correspond to a UNIX error code; this is the standard "failed for unspecified reason" error code present in all GError error code enumerations.
FAULT	You passed in a pointer to bad memory.
INTR	Interrupted function call; an asynchronous signal occurred and prevented completion of the call.
INVAL	Invalid argument.
IO	Input/output error; usually used for physical read or write errors.
ISDIR	File is a directory; you cannot open a directory for writing, or create or remove hard links to it.
LOOP	Too many levels of symbolic links were encountered in looking up a file name.
MFILE	The current process has too many files open and can't open any more.
NAMETOOLONG	Filename too long.
NFILE	There are too many distinct file openings in the entire system.
NODEV	The underlying file system of the specified file does not support memory mapping.
NOENT	No such file or directory.
NOMEM	No memory available.
NOSPC	No space left on device; write operation on a file failed because the disk is full.
NOSYS	Function not implemented; this indicates that the system is missing some functionality.
NOTDIR	A file that isn't a directory was specified when a directory is required.
NXIO	No such device or address.
PERM	Operation not permitted; only the owner of the file (or other resource) or processes with special privileges can perform the operation.
PIPE	Broken pipe; there is no process reading from the other end of a pipe.
ROFS	The directory containing the new link can't be modified because it's on a read-only file system.
TXTBSY	Text file busy.

Method Summary

Modifier and Type	Method	Description
int	getValue()	Get the numeric value of this enum
static FileError	of(int value)	Create a new FileError for the provided value
static FileError	valueOf(String name)	Returns the enum constant of this class with the specified name.
static FileError[]	values()	Returns an array containing the constants of this enum class, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, describeConstable, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Details

EXIST

public static final FileError EXIST

Operation not permitted; only the owner of the file (or other resource) or processes with special privileges can perform the operation.

ISDIR

public static final FileError ISDIR

File is a directory; you cannot open a directory for writing, or create or remove hard links to it.

ACCES

public static final FileError ACCES

Permission denied; the file permissions do not allow the attempted operation.

NAMETOOLONG

public static final FileError NAMETOOLONG

Filename too long.

NOENT

public static final FileError NOENT

No such file or directory. This is a "file doesn't exist" error for ordinary files that are referenced in contexts where they are expected to already exist.

NOTDIR

public static final FileError NOTDIR

A file that isn't a directory was specified when a directory is required.

NXIO

public static final FileError NXIO

No such device or address. The system tried to use the device represented by a file you specified, and it couldn't find the device. This can mean that the device file was installed incorrectly, or that the physical device is missing or not correctly attached to the computer.

NODEV

public static final FileError NODEV

The underlying file system of the specified file does not support memory mapping.

ROFS

public static final FileError ROFS

The directory containing the new link can't be modified because it's on a read-only file system.

TXTBSY

public static final FileError TXTBSY

Text file busy.

FAULT

public static final FileError FAULT

You passed in a pointer to bad memory. (GLib won't reliably return this, don't pass in pointers to bad memory.)

LOOP

public static final FileError LOOP

Too many levels of symbolic links were encountered in looking up a file name. This often indicates a cycle of symbolic links.

NOSPC

public static final FileError NOSPC

No space left on device; write operation on a file failed because the disk is full.

NOMEM

public static final FileError NOMEM

No memory available. The system cannot allocate more virtual memory because its capacity is full.

MFILE

public static final FileError MFILE

The current process has too many files open and can't open any more. Duplicate descriptors do count toward this limit.

NFILE

public static final FileError NFILE

There are too many distinct file openings in the entire system.

BADF

public static final FileError BADF

Bad file descriptor; for example, I/O on a descriptor that has been closed or reading from a descriptor open only for writing (or vice versa).

INVAL

public static final FileError INVAL

Invalid argument. This is used to indicate various kinds of problems with passing the wrong argument to a library function.

PIPE

public static final FileError PIPE

Broken pipe; there is no process reading from the other end of a pipe. Every library function that returns this error code also generates a 'SIGPIPE' signal; this signal terminates the program if not handled or blocked. Thus, your program will never actually see this code unless it has handled or blocked 'SIGPIPE'.

AGAIN

public static final FileError AGAIN

Resource temporarily unavailable; the call might work if you try again later.

INTR

public static final FileError INTR

Interrupted function call; an asynchronous signal occurred and prevented completion of the call. When this happens, you should try the call again.

IO

public static final FileError IO

Input/output error; usually used for physical read or write errors. i.e. the disk or other physical device hardware is returning errors.

PERM

public static final FileError PERM

Operation not permitted; only the owner of the file (or other resource) or processes with special privileges can perform the operation.

NOSYS

public static final FileError NOSYS

Function not implemented; this indicates that the system is missing some functionality.

FAILED

public static final FileError FAILED

Does not correspond to a UNIX error code; this is the standard "failed for unspecified reason" error code present in all GError error code enumerations. Returned if no specific code applies.

Method Details

values

public static FileError[] values()

Returns an array containing the constants of this enum class, in the order they are declared.

Returns:

an array containing the constants of this enum class, in the order they are declared

valueOf

public static FileError valueOf(String name)

Returns the enum constant of this class with the specified name. The string must match exactly an identifier used to declare an enum constant in this class. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum class has no constant with the specified name

NullPointerException - if the argument is null

of

public static FileError of(int value)

Create a new FileError for the provided value

Parameters:

value - the enum value

Returns:

the enum for the provided value

getValue

public int getValue()

Get the numeric value of this enum

Specified by:

getValue in interface Enumeration

Returns:

the enum value