Changeset 69977 in vbox for trunk/include/iprt/file.h

Timestamp:

Dec 7, 2017 1:02:36 PM (7 years ago)

Author:

vboxsync

Message:

IPRT/vfs: Implemented RTVFsFileSetSize, RTVfsFileGetMaxSize and RTvfsFileQueryMaxSize.

File:

• trunk/include/iprt/file.h (modified) (2 diffs)

trunk/include/iprt/file.h

@@ -1137 +1137 @@
 /** @} */
 
-/** @name RTFileSetAllocationSize flags
+/**
+ * Sets the current size of the file ensuring that all required blocks
+ * are allocated on the underlying medium.
+ *
+ * @returns IPRT status code.
+ * @retval  VERR_NOT_SUPPORTED if either this operation is not supported on the
+ *          current host in an efficient manner or the given combination of
+ *          flags is not supported.
+ * @param   hFile           The handle to the file.
+ * @param   cbSize          The new size of the file to allocate.
+ * @param   fFlags          Combination of RTFILE_ALLOC_SIZE_F_*
+ */
+RTDECL(int) RTFileSetAllocationSize(RTFILE hFile, uint64_t cbSize, uint32_t fFlags);
+
+/** @name RTFILE_ALLOC_SIZE_F_XXX - RTFileSetAllocationSize flags
  * @{ */
 /** Default flags. */
 #define RTFILE_ALLOC_SIZE_F_DEFAULT         0
-/** Do not change the size of the file if the given size is
- * bigger than the current file size. Useful to preallocate
- * blocks beyond the current size for appending data in an efficient
- * manner. Might not be supported on all hosts and will return
+/** Do not change the size of the file if the given size is bigger than the
+ * current file size.
+ *
+ * Useful to preallocate blocks beyond the current size for appending data in an
+ * efficient manner. Might not be supported on all hosts and will return
  * VERR_NOT_SUPPORTED in that case. */
 #define RTFILE_ALLOC_SIZE_F_KEEP_SIZE       RT_BIT(0)
@@ -1151 +1166 @@
 /** @} */
 
-/**
- * Sets the current size of the file ensuring that all required blocks
- * are allocated on the underlying medium.
- *
- * @returns IPRT status code.
- * @retval  VERR_NOT_SUPPORTED if either this operation is not supported on the current host
- *                             in an efficient manner or the given combination of flags is
- *                             not supported.
- * @param   hFile           The handle to the file.
- * @param   cbSize          The new size of the file to allocate.
- * @param   fFlags          Combination of RTFILE_ALLOC_SIZE_F_*
- */
-RTDECL(int) RTFileSetAllocationSize(RTFILE hFile, uint64_t cbSize, uint32_t fFlags);
 
 #ifdef IN_RING3