1 /* SPDX-License-Identifier: LGPL-2.1+ */
6 typedef struct LookupPaths LookupPaths
;
11 typedef enum LookupPathsFlags
{
12 LOOKUP_PATHS_EXCLUDE_GENERATED
= 1 << 0,
13 LOOKUP_PATHS_TEMPORARY_GENERATED
= 1 << 1,
14 LOOKUP_PATHS_SPLIT_USR
= 1 << 2,
18 /* Where we look for unit files. This includes the individual special paths below, but also any vendor
19 * supplied, static unit file paths. */
22 /* Where we shall create or remove our installation symlinks, aka "configuration", and where the user/admin
23 * shall place his own unit files. */
24 char *persistent_config
;
27 /* Where units from a portable service image shall be placed. */
28 char *persistent_attached
;
29 char *runtime_attached
;
31 /* Where to place generated unit files (i.e. those a "generator" tool generated). Note the special semantics of
32 * this directory: the generators are flushed each time a "systemctl daemon-reload" is issued. The user should
33 * not alter these directories directly. */
35 char *generator_early
;
38 /* Where to place transient unit files (i.e. those created dynamically via the bus API). Note the special
39 * semantics of this directory: all units created transiently have their unit files removed as the transient
40 * unit is unloaded. The user should not alter this directory directly. */
43 /* Where the snippets created by "systemctl set-property" are placed. Note that for transient units, the
44 * snippets are placed in the transient directory though (see above). The user should not alter this directory
46 char *persistent_control
;
47 char *runtime_control
;
49 /* The root directory prepended to all items above, or NULL */
52 /* A temporary directory when running in test mode, to be nuked */
56 int lookup_paths_init(LookupPaths
*p
, UnitFileScope scope
, LookupPathsFlags flags
, const char *root_dir
);
58 int xdg_user_dirs(char ***ret_config_dirs
, char ***ret_data_dirs
);
59 int xdg_user_runtime_dir(char **ret
, const char *suffix
);
60 int xdg_user_config_dir(char **ret
, const char *suffix
);
61 int xdg_user_data_dir(char **ret
, const char *suffix
);
63 bool path_is_user_data_dir(const char *path
);
64 bool path_is_user_config_dir(const char *path
);
66 int lookup_paths_reduce(LookupPaths
*p
);
68 int lookup_paths_mkdir_generator(LookupPaths
*p
);
69 void lookup_paths_trim_generator(LookupPaths
*p
);
70 void lookup_paths_flush_generator(LookupPaths
*p
);
72 void lookup_paths_free(LookupPaths
*p
);
74 char **generator_binary_paths(UnitFileScope scope
);