Changes between Initial Version and Version 1 of Proto/cModules/d0NetworkServiceAPI/a0DesignUsage

Timestamp:

Nov 30, 2014, 5:12:27 AM (9 years ago)

Author:

wontoniii

Comment:

--

Proto/cModules/d0NetworkServiceAPI/a0DesignUsage

@@ +1 @@
+= MobilityFirst Network Service API Design and Usage =
+
+== 1. Design ==
+
+=== 1.1 Basic Operations ===
+
+=== 1.2 Content Operations ===
+
+=== 1.3 Service Operations ===
+
+== 2. Usage ==
+
+=== 2.1 Discussion ===
+
+=== 2.2 Examples ===
+
+The following code snippet shows a simple C program written using the API that sends a message to another GUID identified endpoint and receives the corresponding response:
+
+{{{#!c
+  #include <stdio.h>
+  #include <stdlib.h>
+  #include <mfapi.h>
+
+  int main(int argc, char *argv[]) {
+    struct Handle handle;
+    //Choosing GUIDs 1 and 2 as reference
+    int mine = 1, other = 2, sent = 0, received = 0, size = 65*1024;
+    
+    //Buffer to send and receive messages; I don't care about the content
+    u_char buf[size];
+    
+    //Requesting basic transport. Listening for GUID mine
+    ret = mfopen(&handle, "basic\0", NULL, mine);
+    if(ret) {
+        fprintf(stderr, "receiver: mfopen error\n");
+        return (EXIT_FAILURE);
+    }
+    
+    //Send message to other. No additional services requested
+    sent = mfsend(&handle, buf, size, other, NULL);
+    if (sent < 0) {
+        fprintf (stderr,"mfsendmsg error\n");
+        return EXIT_FAILURE;
+    }
+    
+    //Wait to receive new message
+    received = mfrecv_blk(&handle, buf, size, NULL, 0);
+    if (received < 0) {
+        fprintf (stderr,"mfrecv_blk error\n");
+        return EXIT_FAILURE;
+    }
+    
+    printf("Intended to send %d bytes, sent %d bytes, received %d bytes\n", size, sent, received);
+
+    mfclose(&handle);
+    return EXIT_SUCCESS;
+  }
+}}}