1 files changed, 115 insertions, 0 deletions
diff --git a/spectro/xdg_bds.h b/spectro/xdg_bds.h
new file mode 100644
index 0000000..5c29790
--- /dev/null
+++ b/spectro/xdg_bds.h
@@ -0,0 +1,115 @@
+
+#ifndef XDG_BDS_H
+
+ /* XDG Base Directory Specifications support library */
+
+/*************************************************************************
+ Copyright 2011, 2013 Graeme W. Gill
+
+ 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.
+
+ *************************************************************************/
+
+#ifdef __cplusplus
+	extern "C" {
+#endif
+
+/* Which type of storage */
+typedef enum {
+	xdg_data,
+	xdg_conf,
+	xdg_cache			/* Note there is no xdg_local cache */
+} xdg_storage_type;
+
+/* What operation is being performed */
+typedef enum {
+	xdg_write,			/* Create or write */
+	xdg_read			/* Read */
+} xdg_op_type;
+
+/* What scope to write to */
+/* (For write only. Read always searches */
+/* the user context then the local system context.) */
+typedef enum {
+	xdg_user,			/* User context */
+	xdg_local			/* Local system wide context */
+} xdg_scope;
+
+/* An error code */
+typedef enum {
+	xdg_ok = 0,
+	xdg_alloc,		/* A memory allocation failed */
+	xdg_nohome,		/* There is no $HOME */
+	xdg_noalluserprofile,	/* There is no $ALLUSERSPROFILE */
+	xdg_nopath,		/* There is no resulting path */
+	xdg_mallformed	/* Malfomed path */
+} xdg_error;
+
+#ifdef NT
+#define SSEP ';'		/* Since ':' is used for drive letter */
+#define SSEPS ";"
+#else
+#define SSEP ':'
+#define SSEPS ":"
+#endif
+
+								/* ONLY use this for xdg_data type */
+#ifdef __APPLE__				/* fudge to assist OS X migration from */
+#define XDG_FUDGE SSEPS "../"	/* Library/color to Library/Application Support/ArgyllCMS */
+#else
+#define XDG_FUDGE SSEPS
+#endif
+
+/* Return the number of matching full paths to the given subpath for the */
+/* type of storage and access required. Return 0 if there is an error. */
+/* The files are always unique (ie. the first match to a given filename */
+/* in the possible XDG list of directories is returned, and files with */
+/* the same name in other XDG directories are ignored) */
+/* Wildcards should only be for the filename portion, and not be used for xdg_write. */
+/* The list should be free'd using xdg_free() after use. */
+/* XDG environment variables and the subpath are assumed to be using */
+/* the '/' path separator. Multiple read paths are separated by SSEP */
+/* When "xdg_write", the necessary path to the file will be created. */
+/* If we're running as sudo and are creating a user dir/file, */
+/* we drop to using the underlying SUDO_UID/GID. If we are creating a */
+/* local system dir/file as sudo and have dropped to the SUDO_UID/GID, */
+/* then revert back to root uid/gid. */
+int xdg_bds(
+	xdg_error *er,			/* Return an error code */
+	char ***paths,			/* Return array of pointers to paths */
+	xdg_storage_type st,	/* Specify the storage type */
+	xdg_op_type op,			/* Operation type */
+	xdg_scope sc,			/* Scope if write */
+	char *spath				/* Sub-path and file name or file pattern */
+);
+
+/* Free the list */
+void xdg_free(char **paths, int nopaths);
+
+/* Return a string corresponding to the error value */
+char *xdg_errstr(xdg_error er);
+
+
+#define XDG_BDS_H
+#endif /* XDG_BDS_H */
+
+#ifdef __cplusplus
+	}
+#endif
+