Enlightenment CVS committal
Author : davemds
Project : e17
Module : libs/ecore
Dir : e17/libs/ecore/src/lib/ecore_file
Modified Files:
Ecore_File.h ecore_file.c ecore_file_download.c
ecore_file_monitor.c ecore_file_path.c
Log Message:
Ecore_File documented with doxy tags
===================================================================
RCS file: /cvs/e/e17/libs/ecore/src/lib/ecore_file/Ecore_File.h,v
retrieving revision 1.33
retrieving revision 1.34
diff -u -3 -r1.33 -r1.34
--- Ecore_File.h 25 Jul 2007 17:00:55 -0000 1.33
+++ Ecore_File.h 6 Aug 2007 20:00:28 -0000 1.34
@@ -30,6 +30,11 @@
# endif
#endif
+/**
+ * @file Ecore_File.h
+ * @brief Files utility functions
+ */
+
#include <Ecore_Data.h>
#ifdef __cplusplus
===================================================================
RCS file: /cvs/e/e17/libs/ecore/src/lib/ecore_file/ecore_file.c,v
retrieving revision 1.65
retrieving revision 1.66
diff -u -3 -r1.65 -r1.66
--- ecore_file.c 25 Jul 2007 17:00:55 -0000 1.65
+++ ecore_file.c 6 Aug 2007 20:00:28 -0000 1.66
@@ -60,6 +60,11 @@
return st.st_mtime;
}
+/**
+ * Get the size of the given file
+ * @param file The name of the file
+ * @return The size of the file in byte
+ */
EAPI long long
ecore_file_size(const char *file)
{
@@ -69,6 +74,11 @@
return st.st_size;
}
+/**
+ * Check if file exists
+ * @param file The name of the file
+ * @return 1 if file exists on local filesystem, 0 otherwise
+ */
EAPI int
ecore_file_exists(const char *file)
{
@@ -79,6 +89,11 @@
return 1;
}
+/**
+ * Check if file is a directory
+ * @param file The name of the file
+ * @return 1 if file exist and is a directory, 0 otherwise
+ */
EAPI int
ecore_file_is_dir(const char *file)
{
@@ -90,7 +105,13 @@
}
static mode_t default_mode = S_IRUSR | S_IWUSR | S_IXUSR | S_IRGRP | S_IXGRP |
S_IROTH | S_IXOTH;
-
+/**
+ * Create a new directory
+ * @param dir The name of the directory to create
+ * @return 1 on successfull creation, 0 on failure
+ *
+ * The directory is created with the mode: S_IRUSR | S_IWUSR | S_IXUSR |
S_IRGRP | S_IXGRP | S_IROTH | S_IXOTH
+ */
EAPI int
ecore_file_mkdir(const char *dir)
{
@@ -98,6 +119,11 @@
return 1;
}
+/**
+ * Delete the given dir
+ * @param dir The name of the directory to delete
+ * @return 1 on success, 0 on failure
+ */
EAPI int
ecore_file_rmdir(const char *dir)
{
@@ -105,6 +131,11 @@
return 1;
}
+/**
+ * Delete the given file
+ * @param file The name of the file to delete
+ * @return 1 on success, 0 on failure
+ */
EAPI int
ecore_file_unlink(const char *file)
{
@@ -112,6 +143,13 @@
return 1;
}
+/**
+ * Delete a directory and all its contents
+ * @param dir The name of the directory to delete
+ * @return 1 on success, 0 on failure
+ *
+ * If dir is a link only the link is removed
+ */
EAPI int
ecore_file_recursive_rm(const char *dir)
{
@@ -156,6 +194,11 @@
return 1;
}
+/**
+ * Create a complete path
+ * @param path The path to create
+ * @return 1 on success, 0 on failure
+ */
EAPI int
ecore_file_mkpath(const char *path)
{
@@ -183,6 +226,12 @@
return 1;
}
+/**
+ * Copy a file
+ * @param src The name of the source file
+ * @param dst The name of the destination file
+ * @return 1 on success, 0 on failure
+ */
EAPI int
ecore_file_cp(const char *src, const char *dst)
{
@@ -213,6 +262,12 @@
return ret;
}
+/**
+ * Move a file
+ * @param src The name of the source file
+ * @param dst The name of the destination file
+ * @return 1 on success, 0 on failure
+ */
EAPI int
ecore_file_mv(const char *src, const char *dst)
{
@@ -237,6 +292,12 @@
return 1;
}
+/**
+ * Create a symbolic link
+ * @param src The name of the file to link
+ * @param dest The name of link
+ * @return 1 on success, 0 on failure
+ */
EAPI int
ecore_file_symlink(const char *src, const char *dest)
{
@@ -244,6 +305,11 @@
return 0;
}
+/**
+ * Get the canonicalized absolute pathname
+ * @param file The file path
+ * @return The canonicalized absolute pathname
+ */
EAPI char *
ecore_file_realpath(const char *file)
{
@@ -253,6 +319,11 @@
return strdup(buf);
}
+/**
+ * Get the filename from a give path
+ * @param path The complete path
+ * @return Only the file name
+ */
EAPI const char *
ecore_file_file_get(const char *path)
{
@@ -264,6 +335,11 @@
return result;
}
+/**
+ * Get the directory where file reside
+ * @param file The name of the file
+ * @return The directory name
+ */
EAPI char *
ecore_file_dir_get(const char *file)
{
@@ -283,6 +359,11 @@
return strdup(buf);
}
+/**
+ * Check if file can be read
+ * @param file The name of the file
+ * @return 1 if the file is readable, 0 otherwise
+ */
EAPI int
ecore_file_can_read(const char *file)
{
@@ -291,6 +372,11 @@
return 0;
}
+/**
+ * Check if file can be written
+ * @param file The name of the file
+ * @return 1 if the file is writable, 0 otherwise
+ */
EAPI int
ecore_file_can_write(const char *file)
{
@@ -299,6 +385,11 @@
return 0;
}
+/**
+ * Check if file can be executed
+ * @param file The name of the file
+ * @return 1 if the file can be executed, 0 otherwise
+ */
EAPI int
ecore_file_can_exec(const char *file)
{
@@ -307,6 +398,11 @@
return 0;
}
+/**
+ * Get the path pointed by link
+ * @param link The name of the link
+ * @return The path pointed by link or NULL
+ */
EAPI char *
ecore_file_readlink(const char *link)
{
@@ -318,6 +414,11 @@
return strdup(buf);
}
+/**
+ * Get the list of the files in a given directory
+ * @param dir The name of the directory to list
+ * @return An Ecore_List containing all the file in the directory
+ */
EAPI Ecore_List *
ecore_file_ls(const char *dir)
{
@@ -493,6 +594,11 @@
return exe;
}
+/**
+ * Add the escape sequence ('\\') to the given filename
+ * @param filename The file name
+ * @return The file name with special characters escaped
+ */
EAPI char *
ecore_file_escape_name(const char *filename)
{
@@ -527,6 +633,11 @@
return strdup(buf);
}
+/**
+ * Remove the extension from a given path
+ * @param path The name of the file
+ * @return A newly allocated string with the extension stripped out or NULL on
errors
+ */
EAPI char *
ecore_file_strip_ext(const char *path)
{
===================================================================
RCS file: /cvs/e/e17/libs/ecore/src/lib/ecore_file/ecore_file_download.c,v
retrieving revision 1.15
retrieving revision 1.16
diff -u -3 -r1.15 -r1.16
--- ecore_file_download.c 25 Jul 2007 17:00:55 -0000 1.15
+++ ecore_file_download.c 6 Aug 2007 20:00:28 -0000 1.16
@@ -105,6 +105,19 @@
#endif
}
+
+/**
+ * Download @p url to the given @p dst
+ * @param url The complete url to download
+ * @param dst The local file to save the downloaded to
+ * @param completion_cb A callback called on download complete
+ * @param progress_cb A callback called during the download operation
+ * @return 1 if the download start or 0 on failure
+ *
+ * You must provide the full url, including 'http://', 'ftp://' or 'file://'.\n
+ * If @p dst already exist it will not be overwritten and the function will
fail.\n
+ * Ecore must be compiled with CURL to download using http and ftp protocols.
+ */
EAPI int
ecore_file_download(const char *url, const char *dst,
void (*completion_cb)(void *data, const char *file, int
status),
@@ -151,6 +164,14 @@
#endif
}
+/**
+ * Check if the given protocol is available
+ * @param protocol The protocol to check
+ * @return 1 if protocol is handled or 0 if not
+ *
+ * @p protocol can be 'http://', 'ftp://' or 'file://'.\n
+ * Ecore must be compiled with CURL to handle http and ftp protocols.
+ */
EAPI int
ecore_file_download_protocol_available(const char *protocol)
{
===================================================================
RCS file: /cvs/e/e17/libs/ecore/src/lib/ecore_file/ecore_file_monitor.c,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -3 -r1.7 -r1.8
--- ecore_file_monitor.c 6 Jan 2006 18:46:30 -0000 1.7
+++ ecore_file_monitor.c 6 Aug 2007 20:00:28 -0000 1.8
@@ -74,6 +74,13 @@
return init;
}
+/**
+ * Monitor a path using inotify, fam or polling
+ * @param path The path to monitor
+ * @param func The function to call on changes
+ * @param data The data passed to func
+ * @return An Ecore_File_Monitor pointer or NULL on failure
+ */
EAPI Ecore_File_Monitor *
ecore_file_monitor_add(const char *path,
void (*func) (void *data, Ecore_File_Monitor *em,
@@ -101,6 +108,10 @@
return NULL;
}
+/**
+ * Stop monitoring a path
+ * @param em The Ecore_File_Monitor to stop
+ */
EAPI void
ecore_file_monitor_del(Ecore_File_Monitor *em)
{
@@ -126,6 +137,11 @@
}
}
+/**
+ * Get the monitored path
+ * @param em The Ecore_File_Monitor to query
+ * @return The path that is monitored by @p em
+ */
EAPI const char *
ecore_file_monitor_path_get(Ecore_File_Monitor *em)
{
===================================================================
RCS file: /cvs/e/e17/libs/ecore/src/lib/ecore_file/ecore_file_path.c,v
retrieving revision 1.21
retrieving revision 1.22
diff -u -3 -r1.21 -r1.22
--- ecore_file_path.c 25 Jul 2007 17:00:55 -0000 1.21
+++ ecore_file_path.c 6 Aug 2007 20:00:28 -0000 1.22
@@ -59,6 +59,11 @@
return path;
}
+/**
+ * Check if the given directory is in PATH
+ * @param The name of the directory to search in PATH
+ * @return 1 if the directory exist in PATH, 0 otherwise
+ */
EAPI int
ecore_file_path_dir_exists(const char *in_dir)
{
@@ -73,6 +78,13 @@
return 0;
}
+/**
+ * Check if the given application is installed
+ * @param exe The name of the application
+ * @return 1 if the exe is in PATH and is executable
+ *
+ * This function check if the given name exist in PATH and is executable
+ */
EAPI int
ecore_file_app_installed(const char *exe)
{
@@ -91,6 +103,10 @@
return 0;
}
+/**
+ * Get a list of all the applications installed on the system
+ * @return An Ecore_List containing all the executable files in the system
+ */
EAPI Ecore_List *
ecore_file_app_list(void)
{
-------------------------------------------------------------------------
This SF.net email is sponsored by: Splunk Inc.
Still grepping through log files to find problems? Stop.
Now Search log events and configuration files using AJAX and a browser.
Download your FREE copy of Splunk now >> http://get.splunk.com/
_______________________________________________
enlightenment-cvs mailing list
enlightenment-cvs@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/enlightenment-cvs
