1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
|
#ifndef SFDO_BASEDIR_H
#define SFDO_BASEDIR_H
#ifdef __cplusplus
extern "C" {
#endif
#include <sfdo-common.h>
#include <stdbool.h>
// libsfdo-basedir implements the XDG base directory specification, version 0.8:
//
// https://specifications.freedesktop.org/basedir-spec/0.8/
//
// For convenience, all paths end with a slash.
struct sfdo_basedir_ctx;
// Create a context.
//
// Returns NULL on memory allocation error.
struct sfdo_basedir_ctx *sfdo_basedir_ctx_create(void);
// Destroy a context.
//
// ctx may be NULL, in which case the function is no-op.
void sfdo_basedir_ctx_destroy(struct sfdo_basedir_ctx *ctx);
// Get the preference-ordered set of base directories to search for data files including the
// user-specific directory.
//
// The number of directories is saved to n_directories.
const struct sfdo_string *sfdo_basedir_get_data_dirs(
struct sfdo_basedir_ctx *ctx, size_t *n_directories);
// Get the base directory relative to which user-specific data files should be stored.
//
// The length of the path is saved to len. len may be NULL.
const char *sfdo_basedir_get_data_home(struct sfdo_basedir_ctx *ctx, size_t *len);
// Get the preference-ordered set of base directories to search for data files excluding the
// user-specific directory.
//
// The number of directories is saved to n_directories.
const struct sfdo_string *sfdo_basedir_get_data_system_dirs(
struct sfdo_basedir_ctx *ctx, size_t *n_directories);
// Get the preference-ordered set of base directories to search for configuration files including
// the user-specific directory.
//
// The number of directories is saved to n_directories.
const struct sfdo_string *sfdo_basedir_get_config_dirs(
struct sfdo_basedir_ctx *ctx, size_t *n_directories);
// Get the base directory relative to which user-specific configuration files should be stored.
//
// The length of the path is saved to len. len may be NULL.
const char *sfdo_basedir_get_config_home(struct sfdo_basedir_ctx *ctx, size_t *len);
// Get the preference-ordered set of base directories to search for configuration files excluding
// the user-specific directory.
//
// The number of directories is saved to n_directories.
const struct sfdo_string *sfdo_basedir_get_config_system_dirs(
struct sfdo_basedir_ctx *ctx, size_t *n_directories);
// Get the base directory relative to which user-specific state files should be stored.
//
// The length of the path is saved to len. len may be NULL.
const char *sfdo_basedir_get_state_home(struct sfdo_basedir_ctx *ctx, size_t *len);
// Get the base directory relative to which user-specific non-essential data files should be stored.
//
// The length of the path is saved to len. len may be NULL.
const char *sfdo_basedir_get_cache_home(struct sfdo_basedir_ctx *ctx, size_t *len);
// Get the base directory relative to which user-specific non-essential runtime files and other file
// objects (such as sockets, named pipes, ...) should be stored.
//
// The length of the path is saved to len. len may be NULL.
//
// Returns NULL if the corresponding environment variable is unset or invalid.
const char *sfdo_basedir_get_runtime_dir(struct sfdo_basedir_ctx *ctx, size_t *len);
#ifdef __cplusplus
}
#endif
#endif
|
