basedir_fs.h File Reference

#include <basedir.h>
#include <stdio.h>
#include <sys/types.h>

Go to the source code of this file.

Functions
Filesystem-related XDG Base Directory Queries
char *	xdgDataFind (const char *relativePath, xdgHandle *handle)
char *	xdgConfigFind (const char *relativePath, xdgHandle *handle)
FILE *	xdgDataOpen (const char *relativePath, const char *mode, xdgHandle *handle)
FILE *	xdgConfigOpen (const char *relativePath, const char *mode, xdgHandle *handle)
int	xdgMakePath (const char *path, mode_t mode)

Detailed Description

Filesystem functions related to the XDG Base Directory specification.

Function Documentation

char* xdgConfigFind	(	const char *	relativePath,
		xdgHandle *	handle
	)

Find all existing config files corresponding to relativePath. Consider as performing

fopen(filename, "r") 

on every possible filename and returning the successful filenames.

Parameters

relativePath	Path to scan for.
handle	Handle to data cache, initialized with xdgInitHandle().

Returns

A sequence of null-terminated strings terminated by a double-null (empty string) and allocated using malloc(), e.g.:

"/etc/xdg\0/home/jdoe/.config\0" 

FILE* xdgConfigOpen	(	const char *	relativePath,
		const char *	mode,
		xdgHandle *	handle
	)

Open first possible config file corresponding to relativePath. Consider as performing

fopen(filename, mode) 

on every possible filename and returning the first successful filename or NULL.

Parameters

relativePath	Path to scan for.
mode	Mode with which to attempt to open files (see fopen modes).
handle	Handle to data cache, initialized with xdgInitHandle().

Returns

File pointer if successful else NULL. Client must use fclose to close file.

char* xdgDataFind	(	const char *	relativePath,
		xdgHandle *	handle
	)

Find all existing data files corresponding to relativePath. Consider as performing

fopen(filename, "r") 

on every possible filename and returning the successful filenames.

Parameters

relativePath	Path to scan for.
handle	Handle to data cache, initialized with xdgInitHandle().

Returns

A sequence of null-terminated strings terminated by a double-null (empty string) and allocated using malloc(), e.g.:

"/etc/share\0/home/jdoe/.local\0" 

FILE* xdgDataOpen	(	const char *	relativePath,
		const char *	mode,
		xdgHandle *	handle
	)

Open first possible data file corresponding to relativePath. Consider as performing

fopen(filename, mode) 

on every possible filename and returning the first successful filename or NULL.

Parameters

relativePath	Path to scan for.
mode	Mode with which to attempt to open files (see fopen modes).
handle	Handle to data cache, initialized with xdgInitHandle().

Returns

File pointer if successful else NULL. Client must use fclose to close file.

int xdgMakePath	(	const char *	path,
		mode_t	mode
	)

Create path by recursively creating directories. This utility function is not part of the XDG specification, but nevertheless useful in context of directory manipulation.

Parameters

path	The path to be created.
mode	The permissions to use for created directories. This parameter is modified by the process's umask. For details, see mkdir(2)'s mode parameter.

Returns

Zero on success, -1 if an error occured (in which case errno will be set appropriately)