Changes between Version 8 and Version 9 of IPC

Timestamp:

2018-07-05T09:50:32Z (6 years ago)

Author:

Martin Decky

Comment:

update according to async framework API changes

IPC

@@ -197 +197 @@
 
 {{{
-        async_answer_1(callid, EOK, fd);
-}}}
-
-In this example, ''callid'' is the capability of the received call, ''EOK'' is the return value and ''fd'' is the only return argument.
+        async_answer_1(&call, EOK, fd);
+}}}
+
+In this example, ''call'' is the received call, ''EOK'' is the return value and ''fd'' is the only return argument.
 
 == Passing large data via IPC == #IpcDataCopy
@@ -246 +246 @@
 #include <async.h>
 ...
-        ipc_callid_t callid;
+        ipc_call_t call;
         size_t len;
-        if (!async_data_write_receive(&callid, &len)) {
+        if (!async_data_write_receive(&call, &len)) {
                 /* Protocol error - the sender is not sending data */
         }
@@ -266 +266 @@
         /* Allocate the receive buffer */
 
-        (void) async_data_write_finalize(callid, path, len);
+        (void) async_data_write_finalize(&call, path, len);
 }}}
 
@@ -299 +299 @@
 #include <async.h>
 ...
-        ipc_callid_t callid;
+        ipc_call_t call;
         size_t len;
-        if (!async_data_read_receive(&callid, &len)) {
+        if (!async_data_read_receive(&call, &len)) {
                 /* Protocol error - the sender is not accepting data */
         }
@@ -312 +312 @@
 
 {{{
-        (void) async_data_read_finalize(callid, dentry->data + pos, bytes);
+        (void) async_data_read_finalize(&call, dentry->data + pos, bytes);
 }}}
 
@@ -357 +357 @@
 #include <async.h>
 ...
-        ipc_callid_t callid;
+        ipc_call_t call;
         size_t len;
         int flags;
-        if (!async_share_out_receive(&callid, &len, &flags)) {
+        if (!async_share_out_receive(&call, &len, &flags)) {
                 /* Protocol error - the sender is sharing out an area */
         }
@@ -367 +367 @@
 }}}
 
-After the offer is received, the server has a chance to reject it by answering ''callid'' with an error code distinct from EOK. The reason for denial can be an inappropriate ''len'' or non-suitable address space area flags in the ''flags'' variable. If the offer looks good to the server, it will accept it like this:
+After the offer is received, the server has a chance to reject it by answering ''call'' with an error code distinct from EOK. The reason for denial can be an inappropriate ''len'' or non-suitable address space area flags in the ''flags'' variable. If the offer looks good to the server, it will accept it like this:
 
 {{{
         void *fs_va;
-        (void) async_share_out_finalize(callid, fs_va);
+        (void) async_share_out_finalize(&call, fs_va);
 }}}
 
@@ -402 +402 @@
 #include <async.h>
 ...
-        ipc_callid_t callid;
+        ipc_call_t call;
         size_t size;
-        if (!async_share_in_receive(&callid, &size)) {
+        if (!async_share_in_receive(&call, &size)) {
                 /* Protocol error - the sender is not requesting a share */
         }
@@ -415 +415 @@
 {{{
         uint8_t *plb;
-        (void) async_share_in_finalize(callid, plb, AS_AREA_READ | AS_AREA_CACHEABLE);
+        (void) async_share_in_finalize(&call, plb, AS_AREA_READ | AS_AREA_CACHEABLE);
 }}}