diff options
Diffstat (limited to 'contrib/libxdg-basedir')
| -rw-r--r-- | contrib/libxdg-basedir/Makefile.am | 7 | ||||
| -rw-r--r-- | contrib/libxdg-basedir/basedir.c | 486 | ||||
| -rw-r--r-- | contrib/libxdg-basedir/basedir.h | 185 |
3 files changed, 678 insertions, 0 deletions
diff --git a/contrib/libxdg-basedir/Makefile.am b/contrib/libxdg-basedir/Makefile.am new file mode 100644 index 000000000..420d85999 --- /dev/null +++ b/contrib/libxdg-basedir/Makefile.am @@ -0,0 +1,7 @@ +if !EXTERNAL_LIBXDG_BASEDIR +noinst_LTLIBRARIES = libxdg-basedir.la +endif + +AM_CFLAGS = $(DEFAULT_OCFLAGS) $(VISIBILITY_FLAG) + +libxdg_basedir_la_SOURCES = basedir.c basedir.h diff --git a/contrib/libxdg-basedir/basedir.c b/contrib/libxdg-basedir/basedir.c new file mode 100644 index 000000000..ae50d1bba --- /dev/null +++ b/contrib/libxdg-basedir/basedir.c @@ -0,0 +1,486 @@ +/* Copyright (c) 2007 Mark Nevill + * + * Permission is hereby granted, free of charge, to any person + * obtaining a copy of this software and associated documentation + * files (the "Software"), to deal in the Software without + * restriction, including without limitation the rights to use, + * copy, modify, merge, publish, distribute, sublicense, and/or sell + * copies of the Software, and to permit persons to whom the + * Software is furnished to do so, subject to the following + * conditions: + * + * The above copyright notice and this permission notice shall be + * included in all copies or substantial portions of the Software. + * + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, + * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES + * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND + * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT + * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, + * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING + * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR + * OTHER DEALINGS IN THE SOFTWARE. + */ + +/** @file basedir.c + * @brief Implementation of the XDG basedir specification. */ + +#ifdef HAVE_CONFIG_H +#include <config.h> +#endif + +#if STDC_HEADERS || HAVE_STDLIB_H +# include <stdlib.h> +#endif +#if HAVE_MEMORY_H +# include <memory.h> +#endif +#if HAVE_STRING_H +# include <string.h> +#else +# if HAVE_STRINGS_H +# include <strings.h> +# endif /* !HAVE_STRINGS_H */ +#endif /* !HAVE_STRING_H */ + +#if defined _WIN32 && !defined __CYGWIN__ + /* Use Windows separators on all _WIN32 defining + environments, except Cygwin. */ +# define DIR_SEPARATOR_CHAR '\\' +# define DIR_SEPARATOR_STR "\\" +# define PATH_SEPARATOR_CHAR ';' +# define PATH_SEPARATOR_STR ";" +# define NO_ESCAPES_IN_PATHS +#else +# define DIR_SEPARATOR_CHAR '/' +# define DIR_SEPARATOR_STR "/" +# define PATH_SEPARATOR_CHAR ':' +# define PATH_SEPARATOR_STR ":" +#endif + +#include <stdarg.h> +#include <basedir.h> + +#ifndef MAX +# define MAX(a, b) ((b) > (a) ? (b) : (a)) +#endif + +static const char + DefaultRelativeDataHome[] = DIR_SEPARATOR_STR ".local" DIR_SEPARATOR_STR "share", + DefaultRelativeConfigHome[] = DIR_SEPARATOR_STR ".config", + DefaultDataDirectories1[] = DIR_SEPARATOR_STR "usr" DIR_SEPARATOR_STR "local" DIR_SEPARATOR_STR "share", + DefaultDataDirectories2[] = DIR_SEPARATOR_STR "usr" DIR_SEPARATOR_STR "share", + DefaultConfigDirectories[] = DIR_SEPARATOR_STR "etc" DIR_SEPARATOR_STR "xdg", + DefaultRelativeCacheHome[] = DIR_SEPARATOR_STR ".cache"; + +typedef struct _xdgCachedData +{ + char * dataHome; + char * configHome; + char * cacheHome; + /* Note: string lists are null-terminated and all items */ + /* except the first are assumed to be allocated using malloc. */ + /* The first item is assumed to be allocated by malloc only if */ + /* it is not equal to the appropriate home directory string above. */ + char ** searchableDataDirectories; + char ** searchableConfigDirectories; +} xdgCachedData; + +#define GET_CACHE(handle) ((xdgCachedData*)(handle->reserved)) + +xdgHandle xdgAllocHandle() +{ + xdgHandle handle = (xdgHandle)malloc(sizeof(*handle)); + if (!handle) return 0; + handle->reserved = 0; /* So xdgUpdateData() doesn't free it */ + if (xdgUpdateData(handle)) + return handle; + else + free(handle); + return 0; +} + +/** Free all memory used by a NULL-terminated string list */ +static void xdgFreeStringList(char** list) +{ + char** ptr = list; + if (!list) return; + for (; *ptr; ptr++) + free(*ptr); + free(list); +} + +/** Free all data in the cache and set pointers to null. */ +static void xdgFreeData(xdgCachedData *cache) +{ + if (cache->dataHome); + { + /* the first element of the directory lists is usually the home directory */ + if (cache->searchableDataDirectories[0] != cache->dataHome) + free(cache->dataHome); + cache->dataHome = 0; + } + if (cache->configHome); + { + if (cache->searchableConfigDirectories[0] != cache->configHome) + free(cache->configHome); + cache->configHome = 0; + } + xdgFreeStringList(cache->searchableDataDirectories); + cache->searchableDataDirectories = 0; + xdgFreeStringList(cache->searchableConfigDirectories); + cache->searchableConfigDirectories = 0; +} + +void xdgFreeHandle(xdgHandle handle) +{ + xdgCachedData* cache = (xdgCachedData*)(handle->reserved); + xdgFreeData(cache); + free(cache); + free(handle); +} + +/** Get value for environment variable $name, defaulting to "defaultValue". + * @param name Name of environment variable. + * @param defaultValue Value to assume for environment variable if it is + * unset or empty. + */ +static char* xdgGetEnv(const char* name, const char* defaultValue) +{ + const char* env; + char* value; + + env = getenv(name); + if (env && env[0]) + { + if (!(value = (char*)malloc(strlen(env)+1))) return 0; + strcpy(value, env); + } + else + { + if (!(value = (char*)malloc(strlen(defaultValue)+1))) return 0; + strcpy(value, defaultValue); + } + return value; +} + +/** Split string at ':', return null-terminated list of resulting strings. + * @param string String to be split + */ +static char** xdgSplitPath(const char* string) +{ + unsigned int size, i, j, k; + char** itemlist; + + /* Get the number of paths */ + size=2; /* One item more than seperators + terminating null item */ + for (i = 0; string[i]; ++i) + { +#ifndef NO_ESCAPES_IN_PATHS + if (string[i] == '\\' && string[i+1]) ++i; /* skip escaped characters including seperators */ +#endif + else if (string[i] == PATH_SEPARATOR_CHAR) ++size; + } + + if (!(itemlist = (char**)malloc(sizeof(char*)*size))) return 0; + memset(itemlist, 0, sizeof(char*)*size); + + for (i = 0; *string; ++i) + { + /* get length of current string */ + for (j = 0; string[j] && string[j] != PATH_SEPARATOR_CHAR; ++j) +#ifndef NO_ESCAPES_IN_PATHS + if (string[j] == '\\' && string[j+1]) ++j +#endif + ; + + if (!(itemlist[i] = (char*)malloc(j+1))) { xdgFreeStringList(itemlist); return 0; } + + /* transfer string, unescaping any escaped seperators */ + for (k = j = 0; string[j] && string[j] != PATH_SEPARATOR_CHAR; ++j, ++k) + { +#ifndef NO_ESCAPES_IN_PATHS + if (string[j] == '\\' && string[j+1] == PATH_SEPARATOR_CHAR) ++j; /* replace escaped ':' with just ':' */ + else if (string[j] == '\\' && string[j+1]) /* skip escaped characters so escaping remains aligned to pairs. */ + { + itemlist[i][k]=string[j]; + ++j, ++k; + } +#endif + itemlist[i][k] = string[j]; + } + itemlist[i][k] = 0; // Bugfix provided by Diego 'Flameeyes' Pettenò + /* move to next string */ + string += j; + if (*string == PATH_SEPARATOR_CHAR) string++; /* skip seperator */ + } + return itemlist; +} + +/** Get $PATH-style environment variable as list of strings. + * If $name is unset or empty, use default strings specified by variable arguments. + * @param name Name of environment variable + * @param numDefaults Number of default paths in variable argument list + * @param ... numDefaults number of strings to be copied and used as defaults + */ +static char** xdgGetPathListEnv(const char* name, int numDefaults, ...) +{ + const char* env; + va_list ap; + char* item; + const char* arg; + char** itemlist; + int i; + + env = getenv(name); + if (env && env[0]) + { + if (!(item = (char*)malloc(strlen(env)+1))) return 0; + strcpy(item, env); + + itemlist = xdgSplitPath(item); + free(item); + } + else + { + if (!(itemlist = (char**)malloc(sizeof(char*)*numDefaults+1))) return 0; + memset(itemlist, 0, sizeof(char*)*(numDefaults+1)); + + /* Copy the varargs into the itemlist */ + va_start(ap, numDefaults); + for (i = 0; i < numDefaults; i++) + { + arg = va_arg(ap, const char*); + if (!(item = (char*)malloc(strlen(arg)+1))) { xdgFreeStringList(itemlist); return 0; } + strcpy(item, arg); + itemlist[i] = item; + } + va_end(ap); + } + return itemlist; +} + +/** Update all *Home variables of cache. + * This includes xdgCachedData::dataHome, xdgCachedData::configHome and xdgCachedData::cacheHome. + * @param cache Data cache to be updated + */ +static bool xdgUpdateHomeDirectories(xdgCachedData* cache) +{ + const char* env; + char* home, *defVal; + + env = getenv("HOME"); + if (!env || !env[0]) + return false; + if (!(home = (char*)malloc(strlen(env)+1))) return false; + strcpy(home, env); + + /* Allocate maximum needed for any of the 3 default values */ + defVal = (char*)malloc(strlen(home)+ + MAX(MAX(sizeof(DefaultRelativeDataHome), sizeof(DefaultRelativeConfigHome)), sizeof(DefaultRelativeCacheHome))); + if (!defVal) return false; + + strcpy(defVal, home); + strcat(defVal, DefaultRelativeDataHome); + if (!(cache->dataHome = xdgGetEnv("XDG_DATA_HOME", defVal))) return false; + + defVal[strlen(home)] = 0; + strcat(defVal, DefaultRelativeConfigHome); + if (!(cache->configHome = xdgGetEnv("XDG_CONFIG_HOME", defVal))) return false; + + defVal[strlen(home)] = 0; + strcat(defVal, DefaultRelativeCacheHome); + if (!(cache->cacheHome = xdgGetEnv("XDG_CACHE_HOME", defVal))) return false; + + free(defVal); + free(home); + + return true; +} + +/** Update all *Directories variables of cache. + * This includes xdgCachedData::searchableDataDirectories and xdgCachedData::searchableConfigDirectories. + * @param cache Data cache to be updated. + */ +static bool xdgUpdateDirectoryLists(xdgCachedData* cache) +{ + char** itemlist; + int size; + + itemlist = xdgGetPathListEnv("XDG_DATA_DIRS", 2, + DefaultDataDirectories1, DefaultDataDirectories2); + if (!itemlist) return false; + for (size = 0; itemlist[size]; size++) ; /* Get list size */ + if (!(cache->searchableDataDirectories = (char**)malloc(sizeof(char*)*(size+2)))) + { + xdgFreeStringList(itemlist); + return false; + } + /* "home" directory has highest priority according to spec */ + cache->searchableDataDirectories[0] = cache->dataHome; + memcpy(&(cache->searchableDataDirectories[1]), itemlist, sizeof(char*)*(size+1)); + free(itemlist); + + itemlist = xdgGetPathListEnv("XDG_CONFIG_DIRS", 1, DefaultConfigDirectories); + if (!itemlist) return false; + for (size = 0; itemlist[size]; size++) ; /* Get list size */ + if (!(cache->searchableConfigDirectories = (char**)malloc(sizeof(char*)*(size+2)))) + { + xdgFreeStringList(itemlist); + return false; + } + cache->searchableConfigDirectories[0] = cache->configHome; + memcpy(&(cache->searchableConfigDirectories[1]), itemlist, sizeof(char*)*(size+1)); + free(itemlist); + + return true; +} + +bool xdgUpdateData(xdgHandle handle) +{ + xdgCachedData* cache = (xdgCachedData*)malloc(sizeof(xdgCachedData)); + if (!cache) return false; + memset(cache, 0, sizeof(xdgCachedData)); + + if (xdgUpdateHomeDirectories(cache) && + xdgUpdateDirectoryLists(cache)) + { + /* Update successful, replace pointer to old cache with pointer to new cache */ + if (handle->reserved) free(handle->reserved); + handle->reserved = cache; + return true; + } + else + { + /* Update failed, discard new cache and leave old cache unmodified */ + xdgFreeData(cache); + free(cache); + return false; + } +} + +/** Find all existing files corresponding to relativePath relative to each item in dirList. + * @param relativePath Relative path to search for. + * @param dirList <tt>NULL</tt>-terminated list of directory paths. + * @return A sequence of null-terminated strings terminated by a + * double-<tt>NULL</tt> (empty string) and allocated using malloc(). + */ +static const char* xdgFindExisting(const char * relativePath, const char * const * dirList) +{ + char * fullPath; + char * returnString = 0; + char * tmpString; + int strLen = 0; + FILE * testFile; + const char * const * item; + + for (item = dirList; *item; item++) + { + if (!(fullPath = (char*)malloc(strlen(*item)+strlen(relativePath)+2))) + { + if (returnString) free(returnString); + return 0; + } + strcpy(fullPath, *item); + if (fullPath[strlen(fullPath)-1] != DIR_SEPARATOR_CHAR) + strcat(fullPath, DIR_SEPARATOR_STR); + strcat(fullPath, relativePath); + testFile = fopen(fullPath, "r"); + if (testFile) + { + if (!(tmpString = (char*)realloc(returnString, strLen+strlen(fullPath)+2))) + { + free(returnString); + free(fullPath); + return 0; + } + returnString = tmpString; + strcpy(&returnString[strLen], fullPath); + strLen = strLen+strlen(fullPath)+1; + fclose(testFile); + } + free(fullPath); + } + if (returnString) + returnString[strLen] = 0; + else + { + if ((returnString = (char*)malloc(2))) + strcpy(returnString, "\0"); + } + return returnString; +} + +/** Open first possible config file corresponding to relativePath. + * @param relativePath Path to scan for. + * @param mode Mode with which to attempt to open files (see fopen modes). + * @param dirList <tt>NULL</tt>-terminated list of paths in which to search for relativePath. + * @return File pointer if successful else @c NULL. Client must use @c fclose to close file. + */ +static FILE * xdgFileOpen(const char * relativePath, const char * mode, const char * const * dirList) +{ + char * fullPath; + FILE * testFile; + const char * const * item; + + for (item = dirList; *item; item++) + { + if (fullPath = (char*)malloc(strlen(*item)+strlen(relativePath)+2)) + return 0; + strcpy(fullPath, *item); + if (fullPath[strlen(fullPath)-1] != DIR_SEPARATOR_CHAR) + strcat(fullPath, DIR_SEPARATOR_STR); + strcat(fullPath, relativePath); + testFile = fopen(fullPath, mode); + free(fullPath); + if (testFile) + return testFile; + } + return 0; +} + +const char * xdgDataHome(xdgHandle handle) +{ + return GET_CACHE(handle)->dataHome; +} +const char * xdgConfigHome(xdgHandle handle) +{ + return GET_CACHE(handle)->configHome; +} +const char * const * xdgDataDirectories(xdgHandle handle) +{ + return &(GET_CACHE(handle)->searchableDataDirectories[1]); +} +const char * const * xdgSearchableDataDirectories(xdgHandle handle) +{ + return GET_CACHE(handle)->searchableDataDirectories; +} +const char * const * xdgConfigDirectories(xdgHandle handle) +{ + return &(GET_CACHE(handle)->searchableConfigDirectories[1]); +} +const char * const * xdgSearchableConfigDirectories(xdgHandle handle) +{ + return GET_CACHE(handle)->searchableConfigDirectories; +} +const char * xdgCacheHome(xdgHandle handle) +{ + return GET_CACHE(handle)->cacheHome; +} +const char * xdgDataFind(const char * relativePath, xdgHandle handle) +{ + return xdgFindExisting(relativePath, xdgSearchableDataDirectories(handle)); +} +const char * xdgConfigFind(const char * relativePath, xdgHandle handle) +{ + return xdgFindExisting(relativePath, xdgSearchableConfigDirectories(handle)); +} +FILE * xdgDataOpen(const char * relativePath, const char * mode, xdgHandle handle) +{ + return xdgFileOpen(relativePath, mode, xdgSearchableDataDirectories(handle)); +} +FILE * xdgConfigOpen(const char * relativePath, const char * mode, xdgHandle handle) +{ + return xdgFileOpen(relativePath, mode, xdgSearchableConfigDirectories(handle)); +} + diff --git a/contrib/libxdg-basedir/basedir.h b/contrib/libxdg-basedir/basedir.h new file mode 100644 index 000000000..cfdd88bec --- /dev/null +++ b/contrib/libxdg-basedir/basedir.h @@ -0,0 +1,185 @@ +/* Copyright (c) 2007 Mark Nevill + * + * Permission is hereby granted, free of charge, to any person + * obtaining a copy of this software and associated documentation + * files (the "Software"), to deal in the Software without + * restriction, including without limitation the rights to use, + * copy, modify, merge, publish, distribute, sublicense, and/or sell + * copies of the Software, and to permit persons to whom the + * Software is furnished to do so, subject to the following + * conditions: + * + * The above copyright notice and this permission notice shall be + * included in all copies or substantial portions of the Software. + * + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, + * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES + * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND + * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT + * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, + * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING + * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR + * OTHER DEALINGS IN THE SOFTWARE. + */ + +/** @file basedir.h + * @brief Functions for using the XDG basedir specification. + * See http://standards.freedesktop.org/basedir-spec/basedir-spec-0.6.html for details. */ + +#ifndef XDG_BASEDIR_H +#define XDG_BASEDIR_H + +#if !defined(__cplusplus) && !defined(__bool_true_false_are_defined) && !defined(_DOXYGEN) +#if defined(STDC_HEADERS) || defined(HAVE_STDBOOL_H) +#include <stdbool.h> +#else +#ifdef HAVE__BOOL +#define bool _Bool +#else +#define bool int +#endif // HAVE__BOOL +#define true 1 +#define false 0 +#define XDG_BASEDIR_H_LOCAL_BOOL_DEFINE +#define __bool_true_false_are_defined +#endif // STDC_HEADERS || HAVE_STDBOOL_H +#endif // !__cplusplus && !__bool_true_false_are_defined + +#include <stdio.h> + +#ifdef __cplusplus +extern "C" { +#endif + +/** Version of XDG basedir-spec implemented in this library. */ +#define XDG_BASEDIR_SPEC 0.6 + +/** @name XDG data cache management */ +/*@{*/ + +/** Handle to XDG data cache. + * Handles are allocated with xdgAllocHandle() and + * freed with xdgFreeHandle(). */ +typedef struct /*_xdgHandle*/ { + void *reserved; +} *xdgHandle; + + + +/** Get a handle to an XDG data cache and initialize the cache. + * Use xdgFreeHandle() to free the handle. */ +xdgHandle xdgAllocHandle(); + +/** Free handle to XDG data cache. + * Free handle allocated using xdgAllocHandle(). */ +void xdgFreeHandle(xdgHandle handle); + +/** Update the data cache. + * This should not be done frequently as it reallocates the cache. + * Even if updating the cache fails the handle remains valid and can + * be used to access XDG data as it was before xdgUpdateData() was called. + * @return 0 if update failed, non-0 if successful.*/ +bool xdgUpdateData(xdgHandle handle); + +/*@}*/ +/** @name Basic XDG-Basedir Queries */ +/*@{*/ + +/** Base directory for user specific data files. + * "${XDG_DATA_HOME:-$HOME/.local/share}" */ +const char * xdgDataHome(xdgHandle handle); + +/** Base directory for user specific configuration files. + * "${XDG_CONFIG_HOME:-$HOME/.config}" */ +const char * xdgConfigHome(xdgHandle handle); + +/** Preference-ordered set of base directories to search for data files + * in addition to the $XDG_DATA_HOME base directory. + * "${XDG_DATA_DIRS:-/usr/local/share/:/usr/share/}". + * @return A null-terminated list of directory strings. */ +const char * const * xdgDataDirectories(xdgHandle handle); + +/** Preference-ordered set of base directories to search for data files + * with $XDG_DATA_HOME prepended. + * The base directory defined by $XDG_DATA_HOME is considered more + * important than any of the base directories defined by $XDG_DATA_DIRS. + * @return A null-terminated list of directory strings. */ +const char * const * xdgSearchableDataDirectories(xdgHandle handle); + +/** Preference-ordered set of base directories to search for configuration + * files in addition to the $XDG_CONFIG_HOME base directory. + * "${XDG_CONFIG_DIRS:-/etc/xdg}". + * @return A null-terminated list of directory strings. */ +const char * const * xdgConfigDirectories(xdgHandle handle); + +/** Preference-ordered set of base directories to search for configuration + * files with $XDG_CONFIG_HOME prepended. + * The base directory defined by $XDG_CONFIG_HOME is considered more + * important than any of the base directories defined by $XDG_CONFIG_DIRS. + * @return A null-terminated list of directory strings. */ +const char * const * xdgSearchableConfigDirectories(xdgHandle handle); + +/** Base directory for user specific non-essential data files. + * "${XDG_CACHE_HOME:-$HOME/.cache}" */ +const char * xdgCacheHome(xdgHandle handle); + +/*@}*/ + +/** @name Higher-level XDG-Basedir Queries */ +/*@{*/ + +/** Find all existing data files corresponding to relativePath. + * Consider as performing @code fopen(filename, "r") @endcode on every possible @c filename + * and returning the successful <tt>filename</tt>s. + * @param relativePath Path to scan for. + * @param handle Handle to data cache. + * @return A sequence of null-terminated strings terminated by a double-null (empty string) + * and allocated using malloc(), e.g.: @code "/etc/share\0/home/jdoe/.local\0" @endcode + */ +const char * xdgDataFind(const char* relativePath, xdgHandle handle); + +/** Find all existing config files corresponding to relativePath. + * Consider as performing @code fopen(filename, "r") @endcode on every possible @c filename + * and returning the successful <tt>filename</tt>s. + * @param relativePath Path to scan for. + * @param handle Handle to data cache. + * @return A sequence of null-terminated strings terminated by a double-null (empty string) + * and allocated using malloc(), e.g.: @code "/etc/xdg\0/home/jdoe/.config\0" @endcode + */ +const char * xdgConfigFind(const char* relativePath, xdgHandle handle); + +/** Open first possible data file corresponding to relativePath. + * Consider as performing @code fopen(filename, mode) @endcode on every possible @c filename + * and returning the first successful @c filename or @c NULL. + * @param relativePath Path to scan for. + * @param mode Mode with which to attempt to open files (see fopen modes). + * @param handle Handle to data cache. + * @return File pointer if successful else @c NULL. Client must use @c fclose to close file. + */ +FILE * xdgDataOpen(const char* relativePath, const char* mode, xdgHandle handle); + +/** Open first possible config file corresponding to relativePath. + * Consider as performing @code fopen(filename, mode) @endcode on every possible @c filename + * and returning the first successful @c filename or @c NULL. + * @param relativePath Path to scan for. + * @param mode Mode with which to attempt to open files (see fopen modes). + * @param handle Handle to data cache. + * @return File pointer if successful else @c NULL. Client must use @c fclose to close file. + */ +FILE * xdgConfigOpen(const char* relativePath, const char* mode, xdgHandle handle); + +/*@}*/ + +#ifdef __cplusplus +} // extern "C" +#endif + +#ifdef XDG_BASEDIR_H_LOCAL_BOOL_DEFINE +#undef bool +#undef true +#undef false +#undef __bool_true_false_are_defined +#undef XDG_BASEDIR_H_LOCAL_BOOL_DEFINE +#endif + +#endif /*XDG_BASEDIR_H*/ |