Changeset 34230 in vbox for trunk/include/iprt

Timestamp:

Nov 22, 2010 10:06:48 AM (14 years ago)

Author:

vboxsync

svn:sync-xref-src-repo-rev:

67976

Message:

iprt,VBoxServiceAutoMount.cpp: RTPathSetOwner[Ex] should take NIL_RTUID/GID not -1 / ~0, the only excuse is that NIL_RT[UG]ID probably didn't exist when it was written. Ditto for the RTFileSetOwner API (not realized yet).

Location:

trunk/include/iprt

Files:

• file.h (modified) (1 diff)
• path.h (modified) (2 diffs)

trunk/include/iprt/file.h ¶

@@ -763 +763 @@
  * @returns iprt status code.
  * @param   File        Handle to the file.
- * @param   uid         The new file owner user id. Use -1 (or ~0) to leave this unchanged.
- * @param   gid         The new group id. Use -1 (or ~0) to leave this unchanged.
+ * @param   uid         The new file owner user id.  Pass NIL_RTUID to leave
+ *                      this unchanged.
+ * @param   gid         The new group id.  Pass NIL_RTGID to leave this
+ *                      unchanged.
  */
 RTR3DECL(int) RTFileSetOwner(RTFILE File, uint32_t uid, uint32_t gid);

trunk/include/iprt/path.h ¶

@@ -811 +811 @@
  * @returns iprt status code.
  * @param   pszPath     Path to the file system object.
- * @param   uid         The new file owner user id. Use -1 (or ~0) to leave this unchanged.
- * @param   gid         The new group id. Use -1 (or ~0) to leave this unchanged.
+ * @param   uid         The new file owner user id.  Pass NIL_RTUID to leave
+ *                      this unchanged.
+ * @param   gid         The new group id.  Pass NIL_RTGUID to leave this
+ *                      unchanged.
  */
 RTR3DECL(int) RTPathSetOwner(const char *pszPath, uint32_t uid, uint32_t gid);
@@ -821 +823 @@
  * @returns iprt status code.
  * @param   pszPath     Path to the file system object.
- * @param   uid         The new file owner user id. Use -1 (or ~0) to leave this unchanged.
- * @param   gid         The new group id. Use -1 (or ~0) to leave this unchanged.
+ * @param   uid         The new file owner user id.  Pass NIL_RTUID to leave
+ *                      this unchanged.
+ * @param   gid         The new group id.  Pass NIL_RTGID to leave this
+ *                      unchanged.
  * @param   fFlags      RTPATH_F_ON_LINK or RTPATH_F_FOLLOW_LINK.
  */