Changeset 802898f in mainline for uspace/lib/c/generic/async.c

Timestamp:

2013-09-02T20:14:11Z (11 years ago)

Author:

Dominik Taborsky (AT DOT) <brembyseznamcz>

Branches:

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

Children:

8c95dff

Parents:

0435fe41 (diff), 61ab4a9 (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:

mainline update

File:

• uspace/lib/c/generic/async.c (modified) (2 diffs)

uspace/lib/c/generic/async.c

@@ -2281 +2281 @@
 bool async_data_read_receive(ipc_callid_t *callid, size_t *size)
 {
+        ipc_call_t data;
+        return async_data_read_receive_call(callid, &data, size);
+}
+
+/** Wrapper for receiving the IPC_M_DATA_READ calls using the async framework.
+ *
+ * This wrapper only makes it more comfortable to receive IPC_M_DATA_READ
+ * calls so that the user doesn't have to remember the meaning of each IPC
+ * argument.
+ *
+ * So far, this wrapper is to be used from within a connection fibril.
+ *
+ * @param callid Storage for the hash of the IPC_M_DATA_READ.
+ * @param size   Storage for the maximum size. Can be NULL.
+ *
+ * @return True on success, false on failure.
+ *
+ */
+bool async_data_read_receive_call(ipc_callid_t *callid, ipc_call_t *data,
+    size_t *size)
+{
         assert(callid);
-        
-        ipc_call_t data;
-        *callid = async_get_call(&data);
-        
-        if (IPC_GET_IMETHOD(data) != IPC_M_DATA_READ)
+        assert(data);
+        
+        *callid = async_get_call(data);
+        
+        if (IPC_GET_IMETHOD(*data) != IPC_M_DATA_READ)
                 return false;
         
         if (size)
-                *size = (size_t) IPC_GET_ARG2(data);
+                *size = (size_t) IPC_GET_ARG2(*data);
         
         return true;
@@ -2385 +2406 @@
 bool async_data_write_receive(ipc_callid_t *callid, size_t *size)
 {
+        ipc_call_t data;
+        return async_data_write_receive_call(callid, &data, size);
+}
+
+/** Wrapper for receiving the IPC_M_DATA_WRITE calls using the async framework.
+ *
+ * This wrapper only makes it more comfortable to receive IPC_M_DATA_WRITE
+ * calls so that the user doesn't have to remember the meaning of each IPC
+ * argument.
+ *
+ * So far, this wrapper is to be used from within a connection fibril.
+ *
+ * @param callid Storage for the hash of the IPC_M_DATA_WRITE.
+ * @param data   Storage for the ipc call data.
+ * @param size   Storage for the suggested size. May be NULL.
+ *
+ * @return True on success, false on failure.
+ *
+ */
+bool async_data_write_receive_call(ipc_callid_t *callid, ipc_call_t *data,
+    size_t *size)
+{
         assert(callid);
-        
-        ipc_call_t data;
-        *callid = async_get_call(&data);
-        
-        if (IPC_GET_IMETHOD(data) != IPC_M_DATA_WRITE)
+        assert(data);
+        
+        *callid = async_get_call(data);
+        
+        if (IPC_GET_IMETHOD(*data) != IPC_M_DATA_WRITE)
                 return false;
         
         if (size)
-                *size = (size_t) IPC_GET_ARG2(data);
+                *size = (size_t) IPC_GET_ARG2(*data);
         
         return true;