Changeset 2a53f71 in mainline for uspace/lib/posix/unistd.c

Timestamp:

2011-07-31T04:59:20Z (13 years ago)

Author:

Petr Koupy <petr.koupy@…>

Branches:

lfn, master, serial, ticket/834-toolchain-update, topic/msim-upgrade, topic/simplify-dev-export

Children:

27a8d1d

Parents:

11544f4

Message:

Added missing comments to the newly implemented functions.

File:

• uspace/lib/posix/unistd.c (modified) (5 diffs)

uspace/lib/posix/unistd.c

@@ -186 +186 @@
  * Close a file.
  *
- * @param fildes
+ * @param fildes File descriptor of the opened file.
  * @return 0 on success, -1 on error.
  */
@@ -223 +223 @@
  * Requests outstanding data to be written to the underlying storage device.
  *
- * @param fildes
+ * @param fildes File descriptor of the opened file.
+ * @return Zero on success, -1 otherwise.
  */
 int posix_fsync(int fildes)
@@ -230 +231 @@
 }
 
+/**
+ * Truncate a file to a specified length.
+ *
+ * @param fildes File descriptor of the opened file.
+ * @param length New length of the file.
+ * @return Zero on success, -1 otherwise.
+ */
 int posix_ftruncate(int fildes, posix_off_t length)
 {
@@ -257 +265 @@
 }
 
+/**
+ * Duplicate an open file descriptor.
+ *
+ * @param fildes File descriptor to be duplicated.
+ * @return On success, new file descriptor for the same file, otherwise -1.
+ */
 int posix_dup(int fildes)
 {
@@ -262 +276 @@
 }
 
+/**
+ * Duplicate an open file descriptor.
+ * 
+ * @param fildes File descriptor to be duplicated.
+ * @param fildes2 File descriptor to be paired with the same file description
+ *     as is paired fildes.
+ * @return fildes2 on success, -1 otherwise.
+ */
 int posix_dup2(int fildes, int fildes2)
 {