Changeset 15644 in vbox for trunk/include

Timestamp:

Dec 18, 2008 11:16:58 AM (16 years ago)

Author:

vboxsync

Message:

IPRT: sysfs review, fixes and cleanup.

File:

• trunk/include/iprt/linux/sysfs.h (modified) (4 diffs)

trunk/include/iprt/linux/sysfs.h

@@ -34 +34 @@
 #include <iprt/cdefs.h>
 #include <iprt/types.h>
+#include <iprt/stdarg.h>
 
-#include <stdarg.h>
 
 __BEGIN_DECLS
@@ -83 +83 @@
  * Closes a file opened with RTLinuxSysFsOpen or RTLinuxSysFsOpenV.
  *
- * @param   fd
+ * @param   fd          File descriptor returned by RTLinuxSysFsOpen or
+ *                      RTLinuxSysFsOpenV.
  */
 RTDECL(void) RTLinuxSysFsClose(int fd);
@@ -145 +146 @@
 /**
  * Reads the last element of the path of the file pointed to by the symbolic
- * link specified.  This is needed at least to get the name of the driver
- * associated with a device, where pszFormat should be the "driver" link in the
- * devices sysfs directory.
+ * link specified.
+ *
+ * This is needed at least to get the name of the driver associated with a
+ * device, where pszFormat should be the "driver" link in the devices sysfs
+ * directory.
+ *
+ * @returns The number of characters written on success, -1 and errno on failure.
+ * @param   pszBuf      Where to store the path element.  Must be at least two
+ *                      characters, but a longer buffer would be advisable.
+ * @param   cchBuf      The size of the buffer pointed to by @a pszBuf.
+ * @param   pszFormat   The filename format, either absolute or relative to "/sys/".
+ * @param   va           Format args.
+ */
+RTDECL(ssize_t) RTLinuxSysFsGetLinkDestV(char *pszBuf, size_t cchBuf, const char *pszFormat, va_list va);
+
+/**
+ * Reads the last element of the path of the file pointed to by the symbolic
+ * link specified.
+ *
+ * This is needed at least to get the name of the driver associated with a
+ * device, where pszFormat should be the "driver" link in the devices sysfs
+ * directory.
  *
  * @returns The number of characters written on success, -1 and errno on failure.
@@ -156 +176 @@
  * @param   ...         Format args.
  */
-RTDECL(int) RTLinuxSysFsGetLinkDest(char *pszBuf, size_t cchBuf, const char *pszFormat, ...);
+RTDECL(ssize_t) RTLinuxSysFsGetLinkDest(char *pszBuf, size_t cchBuf, const char *pszFormat, ...);
 
 /** @} */