]>
git.ipfire.org Git - thirdparty/systemd.git/blob - src/basic/unit-name.h
1 /* SPDX-License-Identifier: LGPL-2.1+ */
9 #define UNIT_NAME_MAX 256
11 typedef enum UnitNameFlags
{
12 UNIT_NAME_PLAIN
= 1 << 0, /* Allow foo.service */
13 UNIT_NAME_TEMPLATE
= 1 << 1, /* Allow foo@.service */
14 UNIT_NAME_INSTANCE
= 1 << 2, /* Allow foo@bar.service */
15 UNIT_NAME_ANY
= UNIT_NAME_PLAIN
|UNIT_NAME_TEMPLATE
|UNIT_NAME_INSTANCE
,
16 _UNIT_NAME_INVALID
= -1,
19 bool unit_name_is_valid(const char *n
, UnitNameFlags flags
) _pure_
;
20 bool unit_prefix_is_valid(const char *p
) _pure_
;
21 bool unit_instance_is_valid(const char *i
) _pure_
;
22 bool unit_suffix_is_valid(const char *s
) _pure_
;
24 int unit_name_to_prefix(const char *n
, char **ret
);
25 int unit_name_to_instance(const char *n
, char **ret
);
26 static inline int unit_name_classify(const char *n
) {
27 return unit_name_to_instance(n
, NULL
);
29 int unit_name_to_prefix_and_instance(const char *n
, char **ret
);
31 UnitType
unit_name_to_type(const char *n
) _pure_
;
33 int unit_name_change_suffix(const char *n
, const char *suffix
, char **ret
);
35 int unit_name_build(const char *prefix
, const char *instance
, const char *suffix
, char **ret
);
36 int unit_name_build_from_type(const char *prefix
, const char *instance
, UnitType
, char **ret
);
38 char *unit_name_escape(const char *f
);
39 int unit_name_unescape(const char *f
, char **ret
);
40 int unit_name_path_escape(const char *f
, char **ret
);
41 int unit_name_path_unescape(const char *f
, char **ret
);
43 int unit_name_replace_instance(const char *f
, const char *i
, char **ret
);
45 int unit_name_template(const char *f
, char **ret
);
47 int unit_name_from_path(const char *path
, const char *suffix
, char **ret
);
48 int unit_name_from_path_instance(const char *prefix
, const char *path
, const char *suffix
, char **ret
);
49 int unit_name_to_path(const char *name
, char **ret
);
51 typedef enum UnitNameMangle
{
52 UNIT_NAME_MANGLE_GLOB
= 1 << 0,
53 UNIT_NAME_MANGLE_WARN
= 1 << 1,
56 int unit_name_mangle_with_suffix(const char *name
, const char *operation
, UnitNameMangle flags
, const char *suffix
, char **ret
);
58 static inline int unit_name_mangle(const char *name
, UnitNameMangle flags
, char **ret
) {
59 return unit_name_mangle_with_suffix(name
, NULL
, flags
, ".service", ret
);
62 int slice_build_parent_slice(const char *slice
, char **ret
);
63 int slice_build_subslice(const char *slice
, const char *name
, char **subslice
);
64 bool slice_name_is_valid(const char *name
);