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:

#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;
}