Changes in uspace/lib/libc/generic/async.c [f74392f:8aa42e3] in mainline

File:

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

uspace/lib/libc/generic/async.c

@@ -1101 +1101 @@
 }
 
-/** Wrapper for making IPC_M_CONNECT_ME_TO calls using the async framework.
- * 
- * Ask through phone for a new connection to some service.
- *
- * @param phoneid       Phone handle used for contacting the other side.
- * @param arg1          User defined argument.
- * @param arg2          User defined argument.
- * @param arg3          User defined argument.
- *
- * @return              New phone handle on success or a negative error code.
- */
-int
-async_connect_me_to(int phoneid, ipcarg_t arg1, ipcarg_t arg2, ipcarg_t arg3)
-{
-        int rc;
-        ipcarg_t newphid;
-
-        rc = async_req_3_5(phoneid, IPC_M_CONNECT_ME_TO, arg1, arg2, arg3, NULL,
-            NULL, NULL, NULL, &newphid);
-        
-        if (rc != EOK)  
-                return rc;
-
-        return newphid;
-}
-
-/** Wrapper for making IPC_M_CONNECT_ME_TO calls using the async framework.
- * 
- * Ask through phone for a new connection to some service and block until
- * success.
- *
- * @param phoneid       Phone handle used for contacting the other side.
- * @param arg1          User defined argument.
- * @param arg2          User defined argument.
- * @param arg3          User defined argument.
- *
- * @return              New phone handle on success or a negative error code.
- */
-int
-async_connect_me_to_blocking(int phoneid, ipcarg_t arg1, ipcarg_t arg2,
-    ipcarg_t arg3)
-{
-        int rc;
-        ipcarg_t newphid;
-
-        rc = async_req_4_5(phoneid, IPC_M_CONNECT_ME_TO, arg1, arg2, arg3,
-            IPC_FLAG_BLOCKING, NULL, NULL, NULL, NULL, &newphid);
-        
-        if (rc != EOK)  
-                return rc;
-
-        return newphid;
-}
-
 /** Wrapper for making IPC_M_SHARE_IN calls using the async framework.
  *
@@ -1341 +1287 @@
 }
 
-/** Wrapper for forwarding any read request
- *
- *
- */
-int async_data_read_forward_fast(int phoneid, ipcarg_t method, ipcarg_t arg1,
-    ipcarg_t arg2, ipcarg_t arg3, ipcarg_t arg4, ipc_call_t *dataptr)
-{
-        ipc_callid_t callid;
-        if (!async_data_read_receive(&callid, NULL)) {
-                ipc_answer_0(callid, EINVAL);
-                return EINVAL;
-        }
-        
-        aid_t msg = async_send_fast(phoneid, method, arg1, arg2, arg3, arg4,
-            dataptr);
-        if (msg == 0) {
-                ipc_answer_0(callid, EINVAL);
-                return EINVAL;
-        }
-        
-        int retval = ipc_forward_fast(callid, phoneid, 0, 0, 0,
-            IPC_FF_ROUTE_FROM_ME);
-        if (retval != EOK) {
-                async_wait_for(msg, NULL);
-                ipc_answer_0(callid, retval);
-                return retval;
-        }
-        
-        ipcarg_t rc;
-        async_wait_for(msg, &rc);
-        
-        return (int) rc;
-}
-
 /** Wrapper for making IPC_M_DATA_WRITE calls using the async framework.
  *
- * @param phoneid Phone that will be used to contact the receiving side.
- * @param src     Address of the beginning of the source buffer.
- * @param size    Size of the source buffer.
- *
- * @return Zero on success or a negative error code from errno.h.
- *
+ * @param phoneid       Phone that will be used to contact the receiving side.
+ * @param src           Address of the beginning of the source buffer.
+ * @param size          Size of the source buffer.
+ *
+ * @return              Zero on success or a negative error code from errno.h.
  */
 int async_data_write_start(int phoneid, const void *src, size_t size)
@@ -1397 +1308 @@
  * So far, this wrapper is to be used from within a connection fibril.
  *
- * @param callid Storage where the hash of the IPC_M_DATA_WRITE call will
- *               be stored.
- * @param size   Storage where the suggested size will be stored. May be
- *               NULL
- *
- * @return Non-zero on success, zero on failure.
- *
+ * @param callid        Storage where the hash of the IPC_M_DATA_WRITE call will
+ *                      be stored.
+ * @param size          Storage where the suggested size will be stored. May be
+ *                      NULL
+ *
+ * @return              Non-zero on success, zero on failure.
  */
 int async_data_write_receive(ipc_callid_t *callid, size_t *size)
@@ -1410 +1320 @@
         
         assert(callid);
-        
+
         *callid = async_get_call(&data);
         if (IPC_GET_METHOD(data) != IPC_M_DATA_WRITE)
                 return 0;
-        
         if (size)
                 *size = (size_t) IPC_GET_ARG2(data);
-        
         return 1;
 }
@@ -1426 +1334 @@
  * so that the user doesn't have to remember the meaning of each IPC argument.
  *
- * @param callid Hash of the IPC_M_DATA_WRITE call to answer.
- * @param dst    Final destination address for the IPC_M_DATA_WRITE call.
- * @param size   Final size for the IPC_M_DATA_WRITE call.
+ * @param callid        Hash of the IPC_M_DATA_WRITE call to answer.
+ * @param dst           Final destination address for the IPC_M_DATA_WRITE call.
+ * @param size          Final size for the IPC_M_DATA_WRITE call.
+ *
+ * @return              Zero on success or a value from @ref errno.h on failure.
+ */
+int async_data_write_finalize(ipc_callid_t callid, void *dst, size_t size)
+{
+        return ipc_data_write_finalize(callid, dst, size);
+}
+
+/** Wrapper for receiving blobs via the async_data_write_*
+ *
+ * This wrapper only makes it more comfortable to use async_data_write_*
+ * functions to receive blobs.
+ *
+ * @param blob     Pointer to data pointer (which should be later disposed
+ *                 by free()). If the operation fails, the pointer is not
+ *                 touched.
+ * @param max_size Maximum size (in bytes) of the blob to receive. 0 means
+ *                 no limit.
+ * @param received If not NULL, the size of the received data is stored here.
  *
  * @return Zero on success or a value from @ref errno.h on failure.
  *
  */
-int async_data_write_finalize(ipc_callid_t callid, void *dst, size_t size)
-{
-        return ipc_data_write_finalize(callid, dst, size);
-}
-
-/** Wrapper for receiving binary data or strings
- *
- * This wrapper only makes it more comfortable to use async_data_write_*
- * functions to receive binary data or strings.
- *
- * @param data       Pointer to data pointer (which should be later disposed
- *                   by free()). If the operation fails, the pointer is not
- *                   touched.
- * @param nullterm   If true then the received data is always zero terminated.
- *                   This also causes to allocate one extra byte beyond the
- *                   raw transmitted data.
- * @param min_size   Minimum size (in bytes) of the data to receive.
- * @param max_size   Maximum size (in bytes) of the data to receive. 0 means
- *                   no limit.
- * @param granulariy If non-zero then the size of the received data has to
- *                   be divisible by this value.
- * @param received   If not NULL, the size of the received data is stored here.
- *
- * @return Zero on success or a value from @ref errno.h on failure.
- *
- */
-int async_data_write_accept(void **data, const bool nullterm,
-    const size_t min_size, const size_t max_size, const size_t granularity,
-    size_t *received)
+int async_data_blob_receive(char **blob, const size_t max_size, size_t *received)
 {
         ipc_callid_t callid;
@@ -1470 +1369 @@
         }
         
-        if (size < min_size) {
-                ipc_answer_0(callid, EINVAL);
-                return EINVAL;
-        }
-        
         if ((max_size > 0) && (size > max_size)) {
                 ipc_answer_0(callid, EINVAL);
@@ -1480 +1374 @@
         }
         
-        if ((granularity > 0) && ((size % granularity) != 0)) {
+        char *data = (char *) malloc(size);
+        if (data == NULL) {
+                ipc_answer_0(callid, ENOMEM);
+                return ENOMEM;
+        }
+        
+        int rc = async_data_write_finalize(callid, data, size);
+        if (rc != EOK) {
+                free(data);
+                return rc;
+        }
+        
+        *blob = data;
+        if (received != NULL)
+                *received = size;
+        
+        return EOK;
+}
+
+/** Wrapper for receiving strings via the async_data_write_*
+ *
+ * This wrapper only makes it more comfortable to use async_data_write_*
+ * functions to receive strings.
+ *
+ * @param str      Pointer to string pointer (which should be later disposed
+ *                 by free()). If the operation fails, the pointer is not
+ *                 touched.
+ * @param max_size Maximum size (in bytes) of the string to receive. 0 means
+ *                 no limit.
+ *
+ * @return Zero on success or a value from @ref errno.h on failure.
+ *
+ */
+int async_data_string_receive(char **str, const size_t max_size)
+{
+        ipc_callid_t callid;
+        size_t size;
+        if (!async_data_write_receive(&callid, &size)) {
                 ipc_answer_0(callid, EINVAL);
                 return EINVAL;
         }
         
-        void *_data;
-        
-        if (nullterm)
-                _data = malloc(size + 1);
-        else
-                _data = malloc(size);
-        
-        if (_data == NULL) {
+        if ((max_size > 0) && (size > max_size)) {
+                ipc_answer_0(callid, EINVAL);
+                return EINVAL;
+        }
+        
+        char *data = (char *) malloc(size + 1);
+        if (data == NULL) {
                 ipc_answer_0(callid, ENOMEM);
                 return ENOMEM;
         }
         
-        int rc = async_data_write_finalize(callid, _data, size);
+        int rc = async_data_write_finalize(callid, data, size);
         if (rc != EOK) {
-                free(_data);
+                free(data);
                 return rc;
         }
         
-        if (nullterm)
-                ((char *) _data)[size] = 0;
-        
-        *data = _data;
-        if (received != NULL)
-                *received = size;
-        
+        data[size] = 0;
+        *str = data;
         return EOK;
 }
 
-/** Wrapper for voiding any data that is about to be received
- *
- * This wrapper can be used to void any pending data
- *
- * @param retval Error value from @ref errno.h to be returned to the caller.
- *
- */
-void async_data_write_void(const int retval)
-{
-        ipc_callid_t callid;
-        async_data_write_receive(&callid, NULL);
-        ipc_answer_0(callid, retval);
-}
-
-/** Wrapper for forwarding any data that is about to be received
- *
- *
- */
-int async_data_write_forward_fast(int phoneid, ipcarg_t method, ipcarg_t arg1,
-    ipcarg_t arg2, ipcarg_t arg3, ipcarg_t arg4, ipc_call_t *dataptr)
-{
-        ipc_callid_t callid;
-        if (!async_data_write_receive(&callid, NULL)) {
-                ipc_answer_0(callid, EINVAL);
-                return EINVAL;
-        }
-        
-        aid_t msg = async_send_fast(phoneid, method, arg1, arg2, arg3, arg4,
-            dataptr);
-        if (msg == 0) {
-                ipc_answer_0(callid, EINVAL);
-                return EINVAL;
-        }
-        
-        int retval = ipc_forward_fast(callid, phoneid, 0, 0, 0,
-            IPC_FF_ROUTE_FROM_ME);
-        if (retval != EOK) {
-                async_wait_for(msg, NULL);
-                ipc_answer_0(callid, retval);
-                return retval;
-        }
-        
-        ipcarg_t rc;
-        async_wait_for(msg, &rc);
-        
-        return (int) rc;
-}
-
 /** @}
  */