Tizen Native API  5.0
Tools

Eina tools aims to help application development, providing ways to make it safer, log errors, manage memory more efficiently and more.

For more information refer to the string example.

Functions

const char * eina_environment_home_get (void)
 Returns the content of the environment referred by HOME on this system.
const char * eina_environment_tmp_get (void)
 Returns the content of the environment referred as TMPDIR on this system.
Eina_Iteratoreina_xattr_ls (const char *file)
 Gets an iterator that list all extended attribute of a file.
Eina_Iteratoreina_xattr_value_ls (const char *file)
 Gets an iterator that list all extended attribute value related to a fd.
Eina_Iteratoreina_xattr_fd_ls (int fd)
 Gets an iterator that list all extended attribute related to a fd.
Eina_Iteratoreina_xattr_value_fd_ls (int fd)
 Gets an iterator that list all extended attribute value related to a fd.
Eina_Bool eina_xattr_copy (const char *src, const char *dst) 2)
 Copies the extended attribute from one file to another.
Eina_Bool eina_xattr_fd_copy (int src, int dst)
 Copies the extended attribute from one file descriptor to another.
void * eina_xattr_get (const char *file, const char *attribute, ssize_t *size) 2
 Retrieves an extended attribute from a file.
void void * eina_xattr_fd_get (int fd, const char *attribute, ssize_t *size) 3)
 Retrieves an extended attribute from a file descriptor.
Eina_Bool eina_xattr_set (const char *file, const char *attribute, const void *data, ssize_t length, Eina_Xattr_Flags flags) 2
 Sets an extended attribute on a file.
Eina_Bool Eina_Bool eina_xattr_fd_set (int fd, const char *attribute, const void *data, ssize_t length, Eina_Xattr_Flags flags) 3)
 Sets an extended attribute on a file descriptor.
Eina_Bool eina_xattr_del (const char *file, const char *attribute) 2)
 Deletes (removes) an extended attribute from a file.
Eina_Bool eina_xattr_fd_del (int fd, const char *attribute)
 Deletes (removes) an extended attribute from a file descriptor.
Eina_Bool eina_xattr_string_set (const char *file, const char *attribute, const char *data, Eina_Xattr_Flags flags)
 Sets a string as a extended attribute properties.
char * eina_xattr_string_get (const char *file, const char *attribute)
 Gets a string from an extended attribute properties.
Eina_Bool eina_xattr_double_set (const char *file, const char *attribute, double value, Eina_Xattr_Flags flags)
 Sets a double as a extended attribute properties.
Eina_Bool eina_xattr_double_get (const char *file, const char *attribute, double *value)
 Gets a double from an extended attribute properties.
Eina_Bool eina_xattr_int_set (const char *file, const char *attribute, int value, Eina_Xattr_Flags flags)
 Sets an int as a extended attribute properties.
Eina_Bool eina_xattr_int_get (const char *file, const char *attribute, int *value)
 Gets a int from an extended attribute properties.

Enumeration Type Documentation

define extended attribute creation

Since (EFL) :
1.1
Enumerator:
EINA_XATTR_INSERT 

This is the default behaviour, it will either create or replace the extended attribute

EINA_XATTR_REPLACE 

This will only succeed if the extended attribute previously existed

EINA_XATTR_CREATED 

This will only succeed if the extended attribute wasn't previously set


Function Documentation

const char* eina_environment_home_get ( void  )

Returns the content of the environment referred by HOME on this system.

Returns:
A temporary string to the content refered by HOME on this system.
Note:
The result of this call is highly system dependent and you better use it instead of the naive getenv("HOME").
Since (EFL) :
1.15
Since :
3.0
const char* eina_environment_tmp_get ( void  )

Returns the content of the environment referred as TMPDIR on this system.

Returns:
A temporary string to the content refered by TMPDIR on this system.
Note:
The result of this call is highly system dependent and you better use it instead of the naive getenv("TMPDIR").
Since (EFL) :
1.15
Since :
3.0
Eina_Bool eina_xattr_copy ( const char *  src,
const char *  dst 
)

Copies the extended attribute from one file to another.

Parameters:
srcsource file to use as input.
dstdestination file to use as output.
Returns:
EINA_TRUE on success, EINA_FALSE otherwise.
See also:
eina_xattr_fd_copy()
Since (EFL) :
1.8
Since :
3.0
Eina_Bool eina_xattr_del ( const char *  file,
const char *  attribute 
)

Deletes (removes) an extended attribute from a file.

Parameters:
fileThe file to del the extended attribute from.
attributeThe attribute to del.
Returns:
EINA_TRUE on success, EINA_FALSE otherwise.
Since (EFL) :
1.8
Since :
3.0
Eina_Bool eina_xattr_double_get ( const char *  file,
const char *  attribute,
double *  value 
)

Gets a double from an extended attribute properties.

Parameters:
fileThe file to get the string from.
attributeThe attribute to get.
valueWhere to put the extracted value
Returns:
EINA_TRUE on success, EINA_FALSE otherwise.

This call check that the double is correctly set.

Since (EFL) :
1.1
Since :
2.3
Eina_Bool eina_xattr_double_set ( const char *  file,
const char *  attribute,
double  value,
Eina_Xattr_Flags  flags 
)

Sets a double as a extended attribute properties.

Parameters:
fileThe file to set the double to.
attributeThe attribute to set.
valueThe NULL-terminated double to set.
flagsDefine the set policy.
Returns:
EINA_TRUE on success, EINA_FALSE otherwise.
Since (EFL) :
1.1
Since :
2.3
Eina_Bool eina_xattr_fd_copy ( int  src,
int  dst 
)

Copies the extended attribute from one file descriptor to another.

Parameters:
srcsource file descriptor to use as input.
dstdestination file descriptor to use as output.
Returns:
EINA_TRUE on success, EINA_FALSE otherwise.
See also:
eina_xattr_copy()
Since (EFL) :
1.8
Since :
3.0
Eina_Bool eina_xattr_fd_del ( int  fd,
const char *  attribute 
)

Deletes (removes) an extended attribute from a file descriptor.

Parameters:
fdThe file descriptor to del the extended attribute from.
attributeThe attribute to del.
Returns:
EINA_TRUE on success, EINA_FALSE otherwise.
Since (EFL) :
1.8
Since :
3.0
void void* eina_xattr_fd_get ( int  fd,
const char *  attribute,
ssize_t *  size 
)

Retrieves an extended attribute from a file descriptor.

Parameters:
fdThe file descriptor to retrieve the extended attribute from.
attributeThe extended attribute name to retrieve.
sizeThe size of the retrieved extended attribute.
Returns:
the allocated data that hold the extended attribute value.

It will return NULL and *size will be 0 if it fails.

Since (EFL) :
1.8
Since :
3.0

Gets an iterator that list all extended attribute related to a fd.

Parameters:
fdThe file descriptor to retrieve the extended attribute list from.
Returns:
an iterator.

The iterator will not allocate any data during the iteration step, so you need to copy them yourself if you need.

Since (EFL) :
1.2
Since :
2.3
Eina_Bool Eina_Bool eina_xattr_fd_set ( int  fd,
const char *  attribute,
const void *  data,
ssize_t  length,
Eina_Xattr_Flags  flags 
)

Sets an extended attribute on a file descriptor.

Parameters:
fdThe file descriptor to set the extended attribute to.
attributeThe attribute to set.
dataThe data to set.
lengthThe length of the data to set.
flagsDefine the set policy.
Returns:
EINA_TRUE on success, EINA_FALSE otherwise.
Since (EFL) :
1.8
Since :
3.0
void* eina_xattr_get ( const char *  file,
const char *  attribute,
ssize_t *  size 
)

Retrieves an extended attribute from a file.

Parameters:
fileThe file to retrieve the extended attribute from.
attributeThe extended attribute name to retrieve.
sizeThe size of the retrieved extended attribute.
Returns:
the allocated data that hold the extended attribute value.

It will return NULL and *size will be 0 if it fails.

Since (EFL) :
1.1
Since :
2.3
Eina_Bool eina_xattr_int_get ( const char *  file,
const char *  attribute,
int *  value 
)

Gets a int from an extended attribute properties.

Parameters:
fileThe file to get the string from.
attributeThe attribute to get.
valueWhere to put the extracted value
Returns:
EINA_TRUE on success, EINA_FALSE otherwise.

This call check that the int is correctly set.

Since (EFL) :
1.1
Since :
2.3
Eina_Bool eina_xattr_int_set ( const char *  file,
const char *  attribute,
int  value,
Eina_Xattr_Flags  flags 
)

Sets an int as a extended attribute properties.

Parameters:
fileThe file to set the int to.
attributeThe attribute to set.
valueThe NULL-terminated int to set.
flagsDefine the set policy.
Returns:
EINA_TRUE on success, EINA_FALSE otherwise.
Since (EFL) :
1.1
Since :
2.3
Eina_Iterator* eina_xattr_ls ( const char *  file)

Gets an iterator that list all extended attribute of a file.

Parameters:
fileThe filename to retrieve the extended attribute list from.
Returns:
an iterator.

The iterator will not allocate any data during the iteration step, so you need to copy them yourself if you need.

Since (EFL) :
1.1
Since :
2.3
Eina_Bool eina_xattr_set ( const char *  file,
const char *  attribute,
const void *  data,
ssize_t  length,
Eina_Xattr_Flags  flags 
)

Sets an extended attribute on a file.

Parameters:
fileThe file to set the extended attribute to.
attributeThe attribute to set.
dataThe data to set.
lengthThe length of the data to set.
flagsDefine the set policy.
Returns:
EINA_TRUE on success, EINA_FALSE otherwise.
Since (EFL) :
1.1
Since :
2.3
char* eina_xattr_string_get ( const char *  file,
const char *  attribute 
)

Gets a string from an extended attribute properties.

Parameters:
fileThe file to get the string from.
attributeThe attribute to get.
Returns:
A valid string on success, NULL otherwise.

This call check that the string is properly NULL-terminated before returning it.

Since (EFL) :
1.1
Since :
2.3
Eina_Bool eina_xattr_string_set ( const char *  file,
const char *  attribute,
const char *  data,
Eina_Xattr_Flags  flags 
)

Sets a string as a extended attribute properties.

Parameters:
fileThe file to set the string to.
attributeThe attribute to set.
dataThe NULL-terminated string to set.
flagsDefine the set policy.
Returns:
EINA_TRUE on success, EINA_FALSE otherwise.
Since (EFL) :
1.1
Since :
2.3

Gets an iterator that list all extended attribute value related to a fd.

Parameters:
fdThe file descriptor to retrieve the extended attribute list from.
Returns:
An iterator.

The iterator will not allocate any data during the iteration step, so you need to copy them yourself if you need. The iterator will provide an Eina_Xattr structure.

Since (EFL) :
1.2
Since :
2.3
Eina_Iterator* eina_xattr_value_ls ( const char *  file)

Gets an iterator that list all extended attribute value related to a fd.

Parameters:
fileThe filename to retrieve the extended attribute list from.
Returns:
An iterator.

The iterator will not allocate any data during the iteration step, so you need to copy them yourself if you need. The iterator will provide an Eina_Xattr structure.

Since (EFL) :
1.2
Since :
2.3