Changeset 51ec40f in mainline for uspace/libc/generic/ipc.c

Timestamp:

2007-05-18T10:27:01Z (18 years ago)

Author:

Jakub Jermar <jakub@…>

Branches:

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

Children:

f6d2c81

Parents:

ddf1255

Message:

Improve comments for the IPC subsystem.
Fix formatting and indentation.

File:

• uspace/libc/generic/ipc.c (modified) (2 diffs)

uspace/libc/generic/ipc.c

@@ -418 +418 @@
 }
 
-/** Ask destination to do a callback connection
- *
- * @return 0 - OK, error code
- */
-int ipc_connect_to_me(int phoneid, int arg1, int arg2, ipcarg_t *phone)
-{
-        return ipc_call_sync_3(phoneid, IPC_M_CONNECT_TO_ME, arg1,
-                               arg2, 0, 0, 0, phone);
-}
-
-/** Ask through phone for a new connection to some service
- *
- * @return new phoneid - OK, error code
+/** Ask destination to do a callback connection.
+ *
+ * @param phoneid       Phone ID used for contacting the other side.
+ * @param arg1          User defined argument.
+ * @param arg2          User defined argument.
+ * @param phonehash     Pointer to a place where the library will store an opaque
+ *                      identifier of the phone that will be used for incoming
+ *                      calls.
+ * @return Zero on success or a negative error code.
+ */
+int ipc_connect_to_me(int phoneid, int arg1, int arg2, ipcarg_t *phonehash)
+{
+        return ipc_call_sync_3(phoneid, IPC_M_CONNECT_TO_ME, arg1, arg2, 0, 0, 0,
+            phonehash);
+}
+
+/** Ask through phone for a new connection to some service.
+ *
+ * @param phoneid       Phone ID used for contacting the other side.
+ * @param arg1          User defined argument.
+ * @param arg2          User defined argument.
+ *
+ * @return New phone ID on success or a negative error code.
  */
 int ipc_connect_me_to(int phoneid, int arg1, int arg2)
@@ -437 +447 @@
         int res;
 
-        res =  ipc_call_sync_3(phoneid, IPC_M_CONNECT_ME_TO, arg1,
-                               arg2, 0, 0, 0, &newphid);
+        res =  ipc_call_sync_3(phoneid, IPC_M_CONNECT_ME_TO, arg1, arg2, 0, 0, 0,
+            &newphid);
         if (res)
                 return res;