Tizen Native API  5.0
Eio Reference helper API

This are helper provided around core Eio API.

This set of functions do provide helper to work around data provided by Eio without the need to look at system header.

Functions

int eio_init (void)
 Initialize eio and all its required submodule.
int eio_shutdown (void)
 Shutdown eio and all its submodule if possible.
void eio_memory_burst_limit_set (size_t limit)
 Set the limit to the maximum amount of memory used.
size_t eio_memory_burst_limit_get (void)
 Get the actual limit to the maximum amount of memory used.
void * eio_file_container_get (Eio_File *ls)
 Return the container during EIO operation.
Eina_Bool eio_file_cancel (Eio_File *ls)
 Cancel any Eio_File.
Eina_Bool eio_file_check (Eio_File *ls)
 Check if an Eio_File operation has been cancelled.
Eina_Bool eio_file_associate_add (Eio_File *ls, const char *key, const void *data, Eina_Free_Cb free_cb)
 Associate data with the current filtered file.
Eina_Bool eio_file_associate_direct_add (Eio_File *ls, const char *key, const void *data, Eina_Free_Cb free_cb)
 Associate data with the current filtered file.
void * eio_file_associate_find (Eio_File *ls, const char *key)
 Get the data associated during the filter callback inside the main loop.
static double eio_file_atime (const Eina_Stat *stat)
 get access time from a Eina_Stat
static double eio_file_mtime (const Eina_Stat *stat)
 get modification time from a Eina_Stat
static long long eio_file_size (const Eina_Stat *stat)
 get the size of the file described in Eina_Stat
static Eina_Bool eio_file_is_dir (const Eina_Stat *stat)
 tell if the stated path was a directory or not.
static Eina_Bool eio_file_is_lnk (const Eina_Stat *stat)
 tell if the stated path was a link or not.

Function Documentation

Eina_Bool eio_file_associate_add ( Eio_File ls,
const char *  key,
const void *  data,
Eina_Free_Cb  free_cb 
)

Associate data with the current filtered file.

Parameters:
lsThe Eio_File ls request currently calling the filter callback.
keyThe key to associate data to.
dataThe data to associate the data to.
free_cbOptionally a function to call to free the associated data, data is passed as the callback data parameter. If no free_cb is provided the user data remains untouched.
Returns:
EINA_TRUE if insertion was fine.

This function can only be safely called from within the filter callback. If you don't need to copy the key around you can use eio_file_associate_direct_add

Since :
3.0
Eina_Bool eio_file_associate_direct_add ( Eio_File ls,
const char *  key,
const void *  data,
Eina_Free_Cb  free_cb 
)

Associate data with the current filtered file.

Parameters:
lsThe Eio_File ls request currently calling the filter callback.
keyThe key to associate data to (will not be copied, and the pointer will not be used as long as the file is not notified).
dataThe data to associate the data to.
free_cbThe function to call to free the associated data, free_cb will be called if not specified.
Returns:
EINA_TRUE if insertion was fine.

This function can only be safely called from within the filter callback. If you need eio to make a proper copy of the key to be safe use eio_file_associate_add instead.

Since :
3.0
void* eio_file_associate_find ( Eio_File ls,
const char *  key 
)

Get the data associated during the filter callback inside the main loop.

Parameters:
lsThe Eio_File ls request currently calling the notify callback.
keyThe key pointing to the data to retrieve.
Returns:
the data associated with the key or NULL if not found.
Since :
3.0
static double eio_file_atime ( const Eina_Stat stat) [static]

get access time from a Eina_Stat

Parameters:
statthe structure to get the atime from
Returns:
the last accessed time

This take care of doing type conversion to match rest of EFL time API.

Note:
some filesystem don't update that information.

Cancel any Eio_File.

Parameters:
lsThe asynchronous I/O operation to cancel.
Returns:
EINA_FALSE if the destruction is delayed, EINA_TRUE if it's done.

This will cancel any kind of I/O operation and cleanup the mess. This means that it could take time to cancel an I/O.

Since :
3.0

Check if an Eio_File operation has been cancelled.

Parameters:
lsThe asynchronous I/O operation to check.
Returns:
EINA_TRUE if it was canceled, EINA_FALSE other wise.

In case of an error it also return EINA_TRUE.

Since :
3.0

Return the container during EIO operation.

Parameters:
lsThe asynchronous I/O operation to retrieve container from.
Returns:
NULL if not available, a DIRP if it is.

This is only available and make sense in the thread callback, not in the mainloop.

Since :
3.0
static Eina_Bool eio_file_is_dir ( const Eina_Stat stat) [static]

tell if the stated path was a directory or not.

Parameters:
statthe structure to get the size from
Returns:
EINA_TRUE, if it was.
static Eina_Bool eio_file_is_lnk ( const Eina_Stat stat) [static]

tell if the stated path was a link or not.

Parameters:
statthe structure to get the size from
Returns:
EINA_TRUE, if it was.
static double eio_file_mtime ( const Eina_Stat stat) [static]

get modification time from a Eina_Stat

Parameters:
statthe structure to get the mtime from
Returns:
the last modification time

This take care of doing type conversion to match rest of EFL time API.

static long long eio_file_size ( const Eina_Stat stat) [static]

get the size of the file described in Eina_Stat

Parameters:
statthe structure to get the size from
Returns:
the size of the file
int eio_init ( void  )

Initialize eio and all its required submodule.

Returns:
the current number of eio users.
Since :
3.0
size_t eio_memory_burst_limit_get ( void  )

Get the actual limit to the maximum amount of memory used.

Returns:
The current limit being set.
Since (EFL) :
1.10
See also:
eio_memory_burst_limit_set
Since :
3.0
void eio_memory_burst_limit_set ( size_t  limit)

Set the limit to the maximum amount of memory used.

Parameters:
limitThe actual limit to set.

Eio work by burst, allocating memory in a thread and moving it back to the main loop. This result in quite some huge memory usage if the main loop is to slow to cope with the speed of the thread. By setting this limit, the thread will block until enough memory has been freed to be below the limit again.

By default no limit is set and any value < 0 will mean no limit.

Note:
You should give at least a reasonable amount of memory or the thread might stall.
Since (EFL) :
1.10
Since :
3.0
int eio_shutdown ( void  )

Shutdown eio and all its submodule if possible.

Returns:
the number of pending users of eio.
Since :
3.0