Eio

Date

2012 (created)

Table of Contents

• Introduction
• How to compile
• Next Steps
• Introductory Example

Introduction

The Eio library is a library that implements an API for asynchronous input/output operation. Most operations are done in a separate thread to prevent lock. See Eio. Some helper to work on data received in Eio callback are also provided see Eio Reference helper API. It is also possible to work asynchronously on Eina_File with Manipulate an Eina_File asynchronously or on Eet_File with Eio asynchronous API for Eet file.. It comes with way to manipulate eXtended attribute asynchronous with Eio manipulation of eXtended attribute..

This library is cross-platform and can be compiled and used on Linux, BSD, Opensolaris and Windows (XP and CE). It is heavily based on Ecore main loop.

How to compile

Eio is a library your application links to. The procedure for this is very simple. You simply have to compile your application with the appropriate compiler flags that the pkg-config script outputs. For example:

Compiling C or C++ files into object files:

gcc -c -o main.o main.c `pkg-config --cflags eio`

Linking object files into a binary executable:

gcc -o my_application main.o `pkg-config --libs eio`

See pkgconfig

Next Steps

After you understand what Eio is and installed it on your system you should proceed understand the programming interface.

Recommended reading:

• Eio Reference helper API for common functions and library initialization.
• Eio file listing API for listing files asynchronous.
• Eio file management API. for anyone who want to do a file manager (copy, rm, ...).
• Manipulate an Eina_File asynchronously to manipulate files asynchronously (mmap).
• Eio manipulation of eXtended attribute. to access file extended attributes (xattr).
• Eio file and directory monitoring API to monitor for file changes (inotify).
• Eio asynchronous API for Eet file. to access Eet files asynchronously.

Introductory Example

//Compile with:
//gcc -o eio_file_ls eio_file_ls.c `pkg-config --cflags --libs ecore eio`
 
#include <stdlib.h>
#include <stdio.h>
#include <string.h>
#include <Eio.h>
#include <Ecore.h>
 
static Eina_Bool
_filter_cb(void *data EINA_UNUSED, Eio_File *handler EINA_UNUSED, const char *file)
{
   char *last_slash = strrchr(file, '/');
 
   //Check if it is a hidden file
   if (last_slash != NULL && strlen(last_slash) > 1 && last_slash[1] == '.')
     return EINA_FALSE;
 
   return EINA_TRUE;
}
 
static void
_main_cb(void *data, Eio_File *handler EINA_UNUSED, const char *file)
{
   int *number_of_listed_files = (int *)data;
 
   printf("Processing file:%s\n", file);
 
   (*number_of_listed_files)++;
}
 
static void
_done_cb(void *data, Eio_File *handler EINA_UNUSED)
{
   int *number_of_listed_files = (int *)data;
 
   printf("Number of listed files:%d\n" \
           "ls operation is done, quitting.\n", *number_of_listed_files);
 
   ecore_main_loop_quit();
}
 
static void
_error_cb(void *data EINA_UNUSED, Eio_File *handler EINA_UNUSED, int error)
{
   fprintf(stderr, "Something has gone wrong:%s\n", strerror(error));
   ecore_main_loop_quit();
}
 
int
main(int argc, char **argv)
{
   int number_of_listed_files = 0;
 
   ecore_init();
   eio_init();
 
   if (argc < 2)
     {
        fprintf(stderr, "You must pass a path to execute the command.\n");
        return  -1;
     }
 
   eio_file_ls(argv[1], _filter_cb, _main_cb, _done_cb, _error_cb,
               &number_of_listed_files);
 
   ecore_main_loop_begin();
 
   eio_shutdown();
   ecore_shutdown();
 
   return 0;
}

More examples can be found at Eio Examples.