[PATCH 2/2] documnt FMODE_ constants

Make sure all FMODE_ constants are documents, and ensure a coherent
style for the already existing comments.

Signed-off-by: Christoph Hellwig <hch@lst.de>
Signed-off-by: Al Viro <viro@zeniv.linux.org.uk>

authored by Christoph Hellwig and committed by Al Viro fc9161e5 fd4ce1ac

+17 -15
+17 -15
include/linux/fs.h
··· 63 63 #define MAY_ACCESS 16 64 64 #define MAY_OPEN 32 65 65 66 - #define FMODE_READ ((__force fmode_t)1) 67 - #define FMODE_WRITE ((__force fmode_t)2) 68 - 69 - /* Internal kernel extensions */ 70 - #define FMODE_LSEEK ((__force fmode_t)4) 71 - #define FMODE_PREAD ((__force fmode_t)8) 72 - #define FMODE_PWRITE FMODE_PREAD /* These go hand in hand */ 73 - 74 - /* File is being opened for execution. Primary users of this flag are 75 - distributed filesystems that can use it to achieve correct ETXTBUSY 76 - behavior for cross-node execution/opening_for_writing of files */ 77 - #define FMODE_EXEC ((__force fmode_t)16) 78 - 79 - #define FMODE_NDELAY ((__force fmode_t)32) 80 - #define FMODE_EXCL ((__force fmode_t)64) 66 + /* file is open for reading */ 67 + #define FMODE_READ ((__force fmode_t)1) 68 + /* file is open for writing */ 69 + #define FMODE_WRITE ((__force fmode_t)2) 70 + /* file is seekable */ 71 + #define FMODE_LSEEK ((__force fmode_t)4) 72 + /* file can be accessed using pread/pwrite */ 73 + #define FMODE_PREAD ((__force fmode_t)8) 74 + #define FMODE_PWRITE FMODE_PREAD /* These go hand in hand */ 75 + /* File is opened for execution with sys_execve / sys_uselib */ 76 + #define FMODE_EXEC ((__force fmode_t)16) 77 + /* File is opened with O_NDELAY (only set for block devices) */ 78 + #define FMODE_NDELAY ((__force fmode_t)32) 79 + /* File is opened with O_EXCL (only set for block devices) */ 80 + #define FMODE_EXCL ((__force fmode_t)64) 81 + /* File is opened using open(.., 3, ..) and is writeable only for ioctls 82 + (specialy hack for floppy.c) */ 81 83 #define FMODE_WRITE_IOCTL ((__force fmode_t)128) 82 84 83 85 #define RW_MASK 1