1 files changed, 0 insertions, 483 deletions

diff --git a/libraries/eina/src/include/eina_file.h b/libraries/eina/src/include/eina_file.h
deleted file mode 100644
index 1af22af..0000000
--- a/libraries/eina/src/include/eina_file.h
+++ /dev/null
@@ -1,483 +0,0 @@
-/* EINA - EFL data type library
- * Copyright (C) 2007-2008 Jorge Luis Zapata Muga
- *                    2011 Cedric Bail
- *
- * This library is free software; you can redistribute it and/or
- * modify it under the terms of the GNU Lesser General Public
- * License as published by the Free Software Foundation; either
- * version 2.1 of the License, or (at your option) any later version.
- *
- * This library is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
- * Lesser General Public License for more details.
- *
- * You should have received a copy of the GNU Lesser General Public
- * License along with this library;
- * if not, see <http://www.gnu.org/licenses/>.
- */
-
-#ifndef EINA_FILE_H_
-#define EINA_FILE_H_
-
-#include <limits.h>
-#include <time.h>
-#include <sys/stat.h>
-
-#include "eina_types.h"
-#include "eina_array.h"
-#include "eina_iterator.h"
-
-
-/**
- * @page eina_file_example_01_page
- * @dontinclude eina_file_01.c
- *
- * For brevity includes, variable declarations and initialization was omitted
- * from this page, however the full source code can be seen @ref
- * eina_file_example_01 "here".
- *
- * Here we have a simple callback to print the name of a file and the path that
- * contains it:
- * @skip static
- * @until }
- *
- * We can use this callback in the following call:
- * @skipline eina_file_dir_list
- *
- * The above was a way to print the files in a directory, but it is not the only
- * one:
- * @until iterator_free
- *
- * And now two ways to get more information than just file names:
- * @until iterator_free
- * @until iterator_free
- *
- * The above ways of getting files on a list may produce the same output, but
- * they have an important difference, eina_file_direct_ls() will @b not call
- * stat, this means that on some systems it might not have file type
- * information. On the other hand it might be faster than eina_file_stat_ls().
- */
-/**
- * @page eina_file_example_01
- * @include eina_file_01.c
- * @example eina_file_01.c
- */
-/**
- * @addtogroup Eina_Tools_Group Tools
- *
- * @{
- */
-/**
- * @addtogroup Eina_File_Group File
- *
- * @brief Functions to handle files and directories.
- *
- * This functions make it easier to do a number o file and directory operations
- * such as getting the list of files in a directory, spliting paths and finding
- * out file size and type.
- *
- * @warning All functions in this group are @b blocking which means they make
- * take a long time to return, use them carefully.
- *
- * See an example @ref eina_file_example_01_page "here".
- *
- * @{
- */
-
-/**
- * @typedef Eina_File_Direct_Info
- * A typedef to #_Eina_File_Direct_Info.
- */
-typedef struct _Eina_File_Direct_Info Eina_File_Direct_Info;
-
-/**
- * @typedef Eina_Stat
- * A typedef to #_Eina_Stat.
- * @since 1.2
- */
-typedef struct _Eina_Stat Eina_Stat;
-
-/**
- * @typedef Eina_File_Dir_List_Cb
- * Type for a callback to be called when iterating over the files of a
- * directory.
- * @param The file name EXCLUDING the path
- * @param path The path passed to eina_file_dir_list()
- * @param data The data passed to eina_file_dir_list()
- */
-typedef void (*Eina_File_Dir_List_Cb)(const char *name, const char *path, void *data);
-
-/**
- * @typedef Eina_File_Type
- * file type in Eina_File_Direct_Info.
- */
-typedef enum {
-  EINA_FILE_UNKNOWN, /**< Unknown file type. */
-  EINA_FILE_FIFO,    /**< Named pipe (FIFO) type (unused on Windows). */
-  EINA_FILE_CHR,     /**< Character device type (unused on Windows). */
-  EINA_FILE_DIR,     /**< Directory type. */
-  EINA_FILE_BLK,     /**< Block device type (unused on Windows). */
-  EINA_FILE_REG,     /**< Regular file type. */
-  EINA_FILE_LNK,     /**< Symbolic link type. */
-  EINA_FILE_SOCK,    /**< UNIX domain socket type (unused on Windows). */
-  EINA_FILE_WHT      /**< Whiteout file type (unused on Windows). */
-} Eina_File_Type;
-
-typedef struct _Eina_File Eina_File;
-
-typedef enum {
-  EINA_FILE_RANDOM,     /**< Advise random memory access to the mapped memory. */
-  EINA_FILE_SEQUENTIAL, /**< Advise sequential memory access to the mapped memory. */
-  EINA_FILE_WILLNEED,   /**< Advise need for all the mapped memory. */
-  EINA_FILE_POPULATE    /**< Request all the mapped memory. */
-} Eina_File_Populate;
-
-/* Why do this? Well PATH_MAX may vary from when eina itself is compiled
- * to when the app using eina is compiled. exposing the path buffer below
- * can't safely and portably vary based on how/when you compile. it should
- * always be the same for both eina inside AND for apps outside that use eina
- * so define this to 8192 - most PATH_MAX values are like 4096 or 1024 (with
- * windows i think being 260), so 8192 should cover almost all cases. there
- * is a possibility that PATH_MAX could be more than 8192. if anyone spots
- * a path_max that is bigger - let us know, but, for now we will assume
- * it never happens */
-#define EINA_PATH_MAX 8192
-/**
- * @struct _Eina_File_Direct_Info
- * A structure to store informations of a path.
- */
-struct _Eina_File_Direct_Info
-{
-   size_t               path_length; /**< size of the whole path */
-   size_t               name_length; /**< size of the filename/basename component */
-   size_t               name_start; /**< where the filename/basename component starts */
-   Eina_File_Type       type; /**< file type */
-   char                 path[EINA_PATH_MAX]; /**< the path */
-};
-
-/**
- * @struct _Eina_Stat
- * A structure to store informations of a path.
- * @since 1.2
- */
-struct _Eina_Stat
-{
-   unsigned long int    dev;
-   unsigned long int    ino;
-   unsigned int         mode;
-   unsigned int         nlink;
-   unsigned int         uid;
-   unsigned int         gid;
-   unsigned long int    rdev;
-   unsigned long int    size;
-   unsigned long int    blksize;
-   unsigned long int    blocks;
-   unsigned long int    atime;
-   unsigned long int    atimensec;
-   unsigned long int    mtime;
-   unsigned long int    mtimensec;
-   unsigned long int    ctime;
-   unsigned long int    ctimensec;
-};
-
-/**
- * @def EINA_FILE_DIR_LIST_CB
- * @brief cast to an #Eina_File_Dir_List_Cb.
- *
- * @param function The function to cast.
- *
- * This macro casts @p function to Eina_File_Dir_List_Cb.
- */
-#define EINA_FILE_DIR_LIST_CB(function) ((Eina_File_Dir_List_Cb)function)
-
-
-/**
- * @brief List all files on the directory calling the function for every file found.
- *
- * @param dir The directory name.
- * @param recursive Iterate recursively in the directory.
- * @param cb The callback to be called.
- * @param data The data to pass to the callback.
- * @return #EINA_TRUE on success, #EINA_FALSE otherwise.
- *
- * This function calls @p cb for each file that is in @p dir. To have @p cb
- * called on files that are in subdirectories of @p dir @p recursive should be
- * EINA_TRUE. In other words if @p recursive is EINA_FALSE, only direct children
- * of @p dir will be operated on, if @p recursive is EINA_TRUE the entire tree
- * of files that is below @p dir will be operated on.
- *
- * If @p cb or @p dir are @c NULL, or if @p dir is a string of size 0,
- * or if @p dir can not be opened, this function returns #EINA_FALSE
- * immediately. otherwise, it returns #EINA_TRUE.
- */
-EAPI Eina_Bool eina_file_dir_list(const char           *dir,
-                                  Eina_Bool             recursive,
-                                  Eina_File_Dir_List_Cb cb,
-                                  void                 *data) EINA_ARG_NONNULL(1, 3);
-
-/**
- * @brief Split a path according to the delimiter of the filesystem.
- *
- * @param path The path to split.
- * @return An array of the parts of the path to split.
- *
- * This function splits @p path according to the delimiter of the used
- * filesystem. If  @p path is @c NULL or if the array can not be
- * created, @c NULL is returned, otherwise, an array with each part of @p path
- * is returned.
- */
-EAPI Eina_Array    *eina_file_split(char *path) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_MALLOC;
-
-/**
- * @brief Get an iterator to list the content of a directory.
- *
- * @param  dir The name of the directory to list
- * @return Return an Eina_Iterator that will walk over the files and directories
- *         in @p dir. On failure it will return NULL.
- *
- * Returns an iterator for shared strings, the name of each file in @p dir will
- * only be fetched when advancing the iterator, which means there is very little
- * cost associated with creating the list and stopping halfway through it.
- *
- * @warning The iterator will hand the user a stringshared value with the full
- * path. The user must free the string using eina_stringshare_del() on it.
- *
- * @note The container for the iterator is of type DIR*.
- * @note The iterator will walk over '.' and '..' without returning them.
- *
- * @see eina_file_direct_ls()
- */
-EAPI Eina_Iterator *eina_file_ls(const char *dir) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_MALLOC;
-
-/**
- * @brief Get an iterator to list the content of a directory, with direct
- * information.
- *
- * @param  dir The name of the directory to list
- *
- * @return Return an Eina_Iterator that will walk over the files and
- *         directory in the pointed directory. On failure it will
- *         return NULL.
- *
- * Returns an iterator for Eina_File_Direct_Info, the name of each file in @p
- * dir will only be fetched when advancing the iterator, which means there is
- * cost associated with creating the list and stopping halfway through it.
- *
- * @warning The Eina_File_Direct_Info returned by the iterator <b>must not</b>
- * be modified in any way.
- * @warning When the iterator is advanced or deleted the Eina_File_Direct_Info
- * returned is no longer valid.
- *
- * @note The container for the iterator is of type DIR*.
- * @note The iterator will walk over '.' and '..' without returning them.
- * @note The difference between this function ahd eina_file_direct_ls() is that
- *       it guarantees the file type information will be correct incurring a
- *       possible performance penalty.
- *
- * @see eina_file_direct_ls()
- */
-EAPI Eina_Iterator *eina_file_stat_ls(const char *dir) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_MALLOC;
-
-/**
- * @brief Use information provided by Eina_Iterator of eina_file_stat_ls or eina_file_direct_ls
- * to call stat in the most efficient way on your system.
- *
- * @param container The container returned by the Eina_Iterator using eina_iterator_container_get().
- * @param info The content of the current Eina_File_Direct_Info provided by the Eina_Iterator
- * @param buf Where to put the result of the stat
- * @return On success 0 is returned, On error -1 is returned and errno is set appropriately.
- *
- * This function calls fstatat or stat depending on what your system supports. This makes it efficient and simple
- * to use on your side without complex detection already done inside Eina on what the system can do.
- *
- * @see eina_file_direct_ls()
- * @see eina_file_stat_ls()
- * @since 1.2
- */
-EAPI int eina_file_statat(void *container, Eina_File_Direct_Info *info, Eina_Stat *buf) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1, 2, 3);
-
-/**
- * @brief Get an iterator to list the content of a directory, with direct
- * information.
- *
- * @param  dir The name of the directory to list
- *
- * @return Return an Eina_Iterator that will walk over the files and
- *         directory in the pointed directory. On failure it will
- *         return NULL.
- *
- * Returns an iterator for Eina_File_Direct_Info, the name of each file in @p
- * dir will only be fetched when advancing the iterator, which means there is
- * cost associated with creating the list and stopping halfway through it.
- *
- * @warning If readdir_r doesn't contain file type information file type will
- * be DT_UNKNOW.
- * @warning The Eina_File_Direct_Info returned by the iterator <b>must not</b>
- * be modified in any way.
- * @warning When the iterator is advanced or deleted the Eina_File_Direct_Info
- * returned is no longer valid.
- *
- * @note The container for the iterator is of type DIR*.
- * @note The iterator will walk over '.' and '..' without returning them.
- * @note The difference between this function ahd eina_file_stat_ls() is that
- *       it may not get the file type information however it is likely to be
- *       faster.
- *
- * @see eina_file_ls()
- */
-EAPI Eina_Iterator *eina_file_direct_ls(const char *dir) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_MALLOC;
-
-/**
- * @brief Sanitize file path.
- *
- * @param path The path to sanitize
- *
- * @return an allocated string with the sanitized path.
- *
- * This function take care of adding the current working directory if it's a
- * relative path and also remove all '..' and '//' reference in the original
- * path.
- *
- * @since 1.1
- */
-EAPI char *eina_file_path_sanitize(const char *path);
-
-/**
- * @brief Get a read-only handler to a file.
- *
- * @param name Filename to open
- * @param shared Requested a shm
- *
- * Opens a file in read-only mode. @p name should be an absolute path. An
- * Eina_File handle can be shared among multiple instances if @p shared is
- * EINA_TRUE.
- *
- * @since 1.1
- */
-EAPI Eina_File *eina_file_open(const char *name, Eina_Bool shared) EINA_WARN_UNUSED_RESULT EINA_ARG_NONNULL(1) EINA_MALLOC;
-
-/**
- * @brief Unref file handler.
- *
- * @param file File handler to unref.
- *
- * Decremente file's refcount and if it reaches zero close it.
- *
- * @since 1.1
- */
-EAPI void eina_file_close(Eina_File *file);
-
-/**
- * @brief Get file size at open time.
- *
- * @param file The file handler to request the size from.
- * @return The length of the file.
- *
- * @since 1.1
- */
-EAPI size_t eina_file_size_get(Eina_File *file);
-
-/**
- * @brief Get the last modification time of an open file.
- *
- * @param file The file handler to request the modification time from.
- * @return The last modification time.
- *
- * @since 1.1
- */
-EAPI time_t eina_file_mtime_get(Eina_File *file);
-
-/**
- * @brief Get the filename of an open file.
- *
- * @param file The file handler to request the name from.
- * @return Stringshared filename of the file.
- *
- * @since 1.1
- */
-EAPI const char *eina_file_filename_get(Eina_File *file);
-
-/**
- * @brief Get the eXtended attribute of an open file.
- *
- * @param file The file handler to request the eXtended attribute from.
- * @return an iterator.
- *
- * The iterator will list all eXtended attribute name without allocating
- * them, so you need to copy them yourself if needed.
- *
- * @since 1.2
- */
-EAPI Eina_Iterator *eina_file_xattr_get(Eina_File *file);
-
-/**
- * @brief Get the eXtended attribute of an open file.
- *
- * @param file The file handler to request the eXtended attribute from.
- * @return an iterator.
- *
- * The iterator will list all eXtended attribute without allocating
- * them, so you need to copy them yourself if needed. It is returning
- * Eina_Xattr structure.
- *
- * @since 1.2
- */
-EAPI Eina_Iterator *eina_file_xattr_value_get(Eina_File *file);
-
-/**
- * @brief Map all the file to a buffer.
- *
- * @param file The file handler to map in memory
- * @param rule The rule to apply to the mapped memory
- * @return A pointer to a buffer that map all the file content. @c NULL if it fail.
- *
- * @since 1.1
- */
-EAPI void *eina_file_map_all(Eina_File *file, Eina_File_Populate rule);
-
-/**
- * @brief Map a part of the file.
- *
- * @param file The file handler to map in memory
- * @param rule The rule to apply to the mapped memory
- * @param offset The offset inside the file
- * @param length The length of the memory to map
- * @return A valid pointer to the system memory with @p length valid byte in it. And @c NULL if not inside the file or anything else goes wrong.
- *
- * This does handle refcounting so it will share map that target the same memory area.
- *
- * @since 1.1
- */
-EAPI void *eina_file_map_new(Eina_File *file, Eina_File_Populate rule,
-                             unsigned long int offset, unsigned long int length);
-
-/**
- * @brief Unref and unmap memory if possible.
- *
- * @param file The file handler to unmap memory from.
- * @param map Memory map to unref and unmap.
- *
- * @since 1.1
- */
-EAPI void eina_file_map_free(Eina_File *file, void *map);
-
-/**
- * @brief Tell if their was an IO error during the life of a mmaped file
- *
- * @param file The file handler to the mmaped file.
- * @param map Memory map to check if an error occured on it.
- *
- * @since 1.2
- */
-EAPI Eina_Bool eina_file_map_faulted(Eina_File *file, void *map);
-
-/**
- * @}
- */
-
-/**
- * @}
- */
-
-#endif /* EINA_FILE_H_ */