linux-support 0.0.25

// This file is part of file-descriptors. It is subject to the license terms in the COPYRIGHT file found in the top-level directory of this distribution and at https://raw.githubusercontent.com/lemonrock/file-descriptors/master/COPYRIGHT. No part of file-descriptors, including this file, may be copied, modified, propagated, or distributed except according to the terms contained in the COPYRIGHT file.
// Copyright © 2018-2019 The developers of file-descriptors. See the COPYRIGHT file in the top-level directory of this distribution and at https://raw.githubusercontent.com/lemonrock/file-descriptors/master/COPYRIGHT.


bitflags!
{
	/// Flags control the status of a newly opened file descriptor by fanotify.
	///
	/// Before Linux 3.18 the features these flags imply was very buggily implemented.
	pub struct FileStatusFlags: u32
	{
		/// Enable support for files exceeding 2 GB.
		///
		/// Failing to set this flag will result in an `EOVERFLOW` error when trying to open a large file which is monitored by an fanotify group on a 32-bit system.
		///
		/// Note that this value differs widely across architectures, and even is the same as `ReadOnly` on x86_64.
		const LargeFile = O_LARGEFILE as u32;

		/// Enable append.
		const Append = O_APPEND as u32;

		/// Every `write()` to the file returns only when the contents of the file have been written to disk.
		///
		/// This provides the guarantee that when the system call returns the file data is on disk.
		const DataSynchronize = O_DSYNC as u32;

		/// Do not adjust access time.
		const NoAccessTime = O_NOATIME as u32;

		/// Every `write()` to the file returns only when the contents of the file have been written to disk and also the file metadata has been written to disk.
		///
		/// This provides the guarantee that when the system call returns the file data is on disk.
		///
		/// It is a stronger guarantee than `DataSynchronize`.
		const Synchronize = O_SYNC as u32;
	}
}