GFileSetContentsFlags

Flags to pass to glib.global.fileSetContentsFull to affect its safety and performance.

Values

ValueMeaning
None0

No guarantees about file consistency or durability. The most dangerous setting, which is slightly faster than other settings.

Consistent1

Guarantee file consistency: after a crash, either the old version of the file or the new version of the file will be available, but not a mixture. On Unix systems this equates to an fsync() on the file and use of an atomic rename() of the new version of the file over the old.

Durable2

Guarantee file durability: after a crash, the new version of the file will be available. On Unix systems this equates to an fsync() on the file (if G_FILE_SET_CONTENTS_CONSISTENT is unset), or the effects of G_FILE_SET_CONTENTS_CONSISTENT plus an fsync() on the directory containing the file after calling rename().

OnlyExisting4

Only apply consistency and durability guarantees if the file already exists. This may speed up file operations if the file doesn’t currently exist, but may result in a corrupted version of the new file if the system crashes while writing it.