* add mu_util_is_local_file, improve mu_util_play:

add some checks whether the file is 'local' or on some remote place (http://
 etc.), and explicitly mention what is acceptible in mu_util_play; for
 security reasons sometimes local, and sometimes remote
This commit is contained in:
Dirk-Jan C. Binnema
2011-01-11 23:21:24 +02:00
parent f2e8927f6f
commit 5d6fe733a0
2 changed files with 37 additions and 5 deletions

View File

@ -120,15 +120,29 @@ int mu_util_create_writeable_fd (const char* path, mode_t mode,
G_GNUC_WARN_UNUSED_RESULT;
/**
/**
* check if file is local, ie. on the local file system. this means
* that it's either having a file URI, *or* that it's an existing file
*
* @param path a path
*
* @return TRUE if the file is local, FALSE otherwise
*/
gboolean mu_util_is_local_file (const char* path);
/**
* try to 'play' (ie., open with it's associated program) a
* file. depends on xdg-open to do the actual opening
*
* @param path full path of the file to open
* @param allow_local allow local files (ie. with file:// prefix or fs paths)
* @param allow_remote allow URIs (ie., http, mailto)
*
* @return TRUE if it succeeded, FALSE otherwise
*/
gboolean mu_util_play (const char *path);
gboolean mu_util_play (const char *path,
gboolean allow_local, gboolean allow_remote);
/**