From: Oliver Kurth <okurth@vmware.com>
Date: Fri, 15 Sep 2017 18:23:44 +0000 (-0700)
Subject: fileIO.h: Clean up some comments
X-Git-Tag: stable-10.2.0~168
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=8484528eef9106be5a58885b29083a8622bcdc76;p=thirdparty%2Fopen-vm-tools.git

fileIO.h: Clean up some comments

Make the comment style consistent
---

diff --git a/open-vm-tools/lib/include/fileIO.h b/open-vm-tools/lib/include/fileIO.h
index 91517872d..a57b94471 100644
--- a/open-vm-tools/lib/include/fileIO.h
+++ b/open-vm-tools/lib/include/fileIO.h
@@ -200,17 +200,19 @@ typedef enum {
  * called "optimistic" to speed up opens. Rule-of-thumb is to use it
  * only for read-only opens of small files (< 1KB).
  */
-#define FILEIO_OPEN_OPTIMISTIC_LOCK   (1 << 22)
+#define FILEIO_OPEN_OPTIMISTIC_LOCK   (1 << 22)  // 0x00400000
 
-// Flag passed to open() to enable use of oplocks on VMFS.  This definition
-// must match USEROBJ_OPEN_OPTIMISTIC_LOCK in user_vsiTypes.h.
+/*
+ * Flag passed to open() to enable use of oplocks on VMFS.  This definition
+ * must match USEROBJ_OPEN_OPTIMISTIC_LOCK in user_vsiTypes.h.
+ */
 #define O_OPTIMISTIC_LOCK             (1 << 22)  // 0x00400000
 
 /*
  * POSIX specific close the file descriptor when the program uses a variant
  * of the exec system call capability. This is useful in fork/exec scenarios.
  */
-#define FILEIO_OPEN_CLOSE_ON_EXEC     (1 << 23)
+#define FILEIO_OPEN_CLOSE_ON_EXEC     (1 << 23)  // 0x00800000
 
 /*
  * Flag passed to open() to not attempt to get the LUN attributes as part of
@@ -219,11 +221,19 @@ typedef enum {
  * user_vsiTypes.h and FS_OPEN_NOATTR in fs_public.h
  */
 #define O_NOATTR                      (1 << 26)  // 0x04000000
-// Flag passed to open() to get multiwriter VMFS lock.  This definition must
-// match USEROBJ_OPEN_MULTIWRITER_LOCK in user_vsiTypes.h.
-#define O_MULTIWRITER_LOCK            (1 << 27)  //0x08000000
-// Flag passed to open() to get exclusive VMFS lock.  This definition must
-// match USEROBJ_OPEN_EXCLUSIVE_LOCK in user_vsiTypes.h.
+
+/*
+ * Flag passed to open() to get multiwriter VMFS lock.  This definition must
+ * match USEROBJ_OPEN_MULTIWRITER_LOCK in user_vsiTypes.h.
+ */
+
+#define O_MULTIWRITER_LOCK            (1 << 27)  // 0x08000000
+
+/*
+ * Flag passed to open() to get exclusive VMFS lock.  This definition must
+ * match USEROBJ_OPEN_EXCLUSIVE_LOCK in user_vsiTypes.h.
+ */
+
 #define O_EXCLUSIVE_LOCK              (1 << 28)  // 0x10000000
 
 /* File Access check args */