Changeset ad7a6c9 in mainline for uspace/lib/c/generic/device/char_dev.c

Timestamp:

2011-03-30T13:10:24Z (14 years ago)

Author:

Vojtech Horky <vojtechhorky@…>

Branches:

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

Children:

4ae90f9

Parents:

6e50466 (diff), d6b81941 (diff)
Note: this is a merge changeset, the changes displayed below correspond to the merge itself.
Use the (diff) links above to see all the changes relative to each parent.

Message:

Merge mainline changes

File:

• uspace/lib/c/generic/device/char_dev.c (moved) (moved from uspace/lib/c/generic/device/char.c ) (5 diffs)

uspace/lib/c/generic/device/char_dev.c

@@ -34 +34 @@
 
 #include <ipc/dev_iface.h>
-#include <device/char.h>
+#include <device/char_dev.h>
 #include <errno.h>
 #include <async.h>
@@ -45 +45 @@
  * using its character interface.
  *
- * @param dev_phone Phone to the device.
- * @param buf       Buffer for the data read
- *                  from or written to the device.
- * @param len       Maximum length of the data to be
- *                  read or written.
- * @param read      Read from the device if true,
- *                  write to it otherwise.
+ * @param dev_phone     Phone to the device.
+ * @param buf           Buffer for the data read from or written to the device.
+ * @param size          Maximum size of data (in bytes) to be read or written.
+ * @param read          Read from the device if true, write to it otherwise.
  *
- * @return Non-negative number of bytes actually read
- *         from or written to the device on success,
- *         negative error number otherwise.
- *
+ * @return              Non-negative number of bytes actually read from or
+ *                      written to the device on success, negative error number
+ *                      otherwise.
  */
-static ssize_t rw_dev(int dev_phone, void *buf, size_t len, bool read)
+static ssize_t char_dev_rw(int dev_phone, void *buf, size_t size, bool read)
 {
         async_serialize_start();
@@ -68 +64 @@
         if (read) {
                 req = async_send_1(dev_phone, DEV_IFACE_ID(CHAR_DEV_IFACE),
-                    CHAR_READ_DEV, &answer);
-                ret = async_data_read_start(dev_phone, buf, len);
+                    CHAR_DEV_READ, &answer);
+                ret = async_data_read_start(dev_phone, buf, size);
         } else {
                 req = async_send_1(dev_phone, DEV_IFACE_ID(CHAR_DEV_IFACE),
-                    CHAR_WRITE_DEV, &answer);
-                ret = async_data_write_start(dev_phone, buf, len);
+                    CHAR_DEV_WRITE, &answer);
+                ret = async_data_write_start(dev_phone, buf, size);
         }
         
@@ -82 +78 @@
                 if (rc == EOK)
                         return (ssize_t) ret;
-                        
+                
                 return (ssize_t) rc;
         }
@@ -96 +92 @@
 }
 
-/** Read from device using its character interface.
+/** Read from character device.
  *
- * @param dev_phone Phone to the device.
- * @param buf       Output buffer for the data
- *                  read from the device.
- * @param len       Maximum length of the data to be read.
+ * @param dev_phone     Phone to the device.
+ * @param buf           Output buffer for the data read from the device.
+ * @param size          Maximum size (in bytes) of the data to be read.
  *
- * @return Non-negative number of bytes actually read
- *         from the device on success, negative error
- *         number otherwise.
- *
+ * @return              Non-negative number of bytes actually read from the
+ *                      device on success, negative error number otherwise.
  */
-ssize_t read_dev(int dev_phone, void *buf, size_t len)
+ssize_t char_dev_read(int dev_phone, void *buf, size_t size)
 {
-        return rw_dev(dev_phone, buf, len, true);
+        return char_dev_rw(dev_phone, buf, size, true);
 }
 
-/** Write to device using its character interface.
+/** Write to character device.
  *
- * @param dev_phone Phone to the device.
- * @param buf       Input buffer containg the data
- *                  to be written to the device.
- * @param len       Maximum length of the data to be written.
+ * @param dev_phone     Phone to the device.
+ * @param buf           Input buffer containg the data to be written to the
+ *                      device.
+ * @param size          Maximum size (in bytes) of the data to be written.
  *
- * @return Non-negative number of bytes actually written
- *         to the device on success, negative error number
- *         otherwise.
- *
+ * @return              Non-negative number of bytes actually written to the
+ *                      device on success, negative error number otherwise.
  */
-ssize_t write_dev(int dev_phone, void *buf, size_t len)
+ssize_t char_dev_write(int dev_phone, void *buf, size_t size)
 {
-        return rw_dev(dev_phone, buf, len, false);
+        return char_dev_rw(dev_phone, buf, size, false);
 }