Debian Codegraph @

src/basic/unit-name.h

raw
1 /* SPDX-License-Identifier: LGPL-2.1-or-later */
2 #pragma once
3
4 #include "basic-forward.h"
5
6 #define UNIT_NAME_MAX 256
7
8 typedef enum UnitNameFlags {
9 UNIT_NAME_PLAIN = 1 << 0, /* Allow foo.service */
10 UNIT_NAME_TEMPLATE = 1 << 1, /* Allow [email protected] */
11 UNIT_NAME_INSTANCE = 1 << 2, /* Allow [email protected] */
12 UNIT_NAME_ANY = UNIT_NAME_PLAIN|UNIT_NAME_TEMPLATE|UNIT_NAME_INSTANCE,
13 _UNIT_NAME_INVALID = -EINVAL,
14 } UnitNameFlags;
15
16 bool unit_name_is_valid(const char *n, UnitNameFlags flags) _pure_;
17 bool unit_prefix_is_valid(const char *p) _pure_;
18 bool unit_instance_is_valid(const char *i) _pure_;
19 bool unit_suffix_is_valid(const char *s) _pure_;
20
21 int unit_name_to_prefix(const char *n, char **ret);
22 UnitNameFlags unit_name_to_instance(const char *n, char **ret);
23 static inline UnitNameFlags unit_name_classify(const char *n) {
24 return unit_name_to_instance(n, NULL);
25 }
26 int unit_name_to_prefix_and_instance(const char *n, char **ret);
27
28 UnitType unit_name_to_type(const char *n) _pure_;
29
30 int unit_name_change_suffix(const char *n, const char *suffix, char **ret);
31
32 int unit_name_build(const char *prefix, const char *instance, const char *suffix, char **ret);
33 int unit_name_build_from_type(const char *prefix, const char *instance, UnitType type, char **ret);
34
35 char* unit_name_escape(const char *f);
36 int unit_name_unescape(const char *f, char **ret);
37 int unit_name_path_escape(const char *f, char **ret);
38 int unit_name_path_unescape(const char *f, char **ret);
39
40 int unit_name_replace_instance_full(
41 const char *original,
42 const char *instance,
43 bool accept_glob,
44 char **ret);
45 static inline int unit_name_replace_instance(const char *original, const char *instance, char **ret) {
46 return unit_name_replace_instance_full(original, instance, false, ret);
47 }
48
49 int unit_name_template(const char *f, char **ret);
50
51 int unit_name_hash_long(const char *name, char **ret);
52 bool unit_name_is_hashed(const char *name);
53
54 int unit_name_from_path(const char *path, const char *suffix, char **ret);
55 int unit_name_from_path_instance(const char *prefix, const char *path, const char *suffix, char **ret);
56 int unit_name_to_path(const char *name, char **ret);
57
58 typedef enum UnitNameMangle {
59 UNIT_NAME_MANGLE_GLOB = 1 << 0,
60 UNIT_NAME_MANGLE_WARN = 1 << 1,
61 } UnitNameMangle;
62
63 int unit_name_mangle_with_suffix(const char *name, const char *operation, UnitNameMangle flags, const char *suffix, char **ret);
64
65 static inline int unit_name_mangle(const char *name, UnitNameMangle flags, char **ret) {
66 return unit_name_mangle_with_suffix(name, NULL, flags, ".service", ret);
67 }
68
69 int slice_build_parent_slice(const char *slice, char **ret);
70 int slice_build_subslice(const char *slice, const char *name, char **ret);
71 bool slice_name_is_valid(const char *name);
72
73 bool unit_name_prefix_equal(const char *a, const char *b);