1 /* SPDX-License-Identifier: LGPL-2.1-or-later */
7 #include "alloc-util.h"
10 #include "pretty-print.h"
11 #include "string-util.h"
13 #include "unit-name.h"
19 } arg_action
= ACTION_ESCAPE
;
20 static const char *arg_suffix
= NULL
;
21 static const char *arg_template
= NULL
;
22 static bool arg_path
= false;
23 static bool arg_instance
= false;
25 static int help(void) {
26 _cleanup_free_
char *link
= NULL
;
29 r
= terminal_urlify_man("systemd-escape", "1", &link
);
33 printf("%s [OPTIONS...] [NAME...]\n\n"
34 "Escape strings for usage in systemd unit names.\n\n"
35 " -h --help Show this help\n"
36 " --version Show package version\n"
37 " --suffix=SUFFIX Unit suffix to append to escaped strings\n"
38 " --template=TEMPLATE Insert strings as instance into template\n"
39 " --instance With --unescape, show just the instance part\n"
40 " -u --unescape Unescape strings\n"
41 " -m --mangle Mangle strings\n"
42 " -p --path When escaping/unescaping assume the string is a path\n"
43 "\nSee the %s for details.\n",
44 program_invocation_short_name
,
50 static int parse_argv(int argc
, char *argv
[]) {
58 static const struct option options
[] = {
59 { "help", no_argument
, NULL
, 'h' },
60 { "version", no_argument
, NULL
, ARG_VERSION
},
61 { "suffix", required_argument
, NULL
, ARG_SUFFIX
},
62 { "template", required_argument
, NULL
, ARG_TEMPLATE
},
63 { "unescape", no_argument
, NULL
, 'u' },
64 { "mangle", no_argument
, NULL
, 'm' },
65 { "path", no_argument
, NULL
, 'p' },
66 { "instance", no_argument
, NULL
, 'i' },
75 while ((c
= getopt_long(argc
, argv
, "hump", options
, NULL
)) >= 0)
87 if (unit_type_from_string(optarg
) < 0)
88 return log_error_errno(SYNTHETIC_ERRNO(EINVAL
),
89 "Invalid unit suffix type %s.", optarg
);
96 if (!unit_name_is_valid(optarg
, UNIT_NAME_TEMPLATE
))
97 return log_error_errno(SYNTHETIC_ERRNO(EINVAL
),
98 "Template name %s is not valid.", optarg
);
100 arg_template
= optarg
;
104 arg_action
= ACTION_UNESCAPE
;
108 arg_action
= ACTION_MANGLE
;
123 assert_not_reached("Unhandled option");
127 return log_error_errno(SYNTHETIC_ERRNO(EINVAL
),
128 "Not enough arguments.");
130 if (arg_template
&& arg_suffix
)
131 return log_error_errno(SYNTHETIC_ERRNO(EINVAL
),
132 "--suffix= and --template= may not be combined.");
134 if ((arg_template
|| arg_suffix
) && arg_action
== ACTION_MANGLE
)
135 return log_error_errno(SYNTHETIC_ERRNO(EINVAL
),
136 "--suffix= and --template= are not compatible with --mangle.");
138 if (arg_suffix
&& arg_action
== ACTION_UNESCAPE
)
139 return log_error_errno(SYNTHETIC_ERRNO(EINVAL
),
140 "--suffix is not compatible with --unescape.");
142 if (arg_path
&& !IN_SET(arg_action
, ACTION_ESCAPE
, ACTION_UNESCAPE
))
143 return log_error_errno(SYNTHETIC_ERRNO(EINVAL
),
144 "--path may not be combined with --mangle.");
146 if (arg_instance
&& arg_action
!= ACTION_UNESCAPE
)
147 return log_error_errno(SYNTHETIC_ERRNO(EINVAL
),
148 "--instance must be used in conjunction with --unescape.");
150 if (arg_instance
&& arg_template
)
151 return log_error_errno(SYNTHETIC_ERRNO(EINVAL
),
152 "--instance may not be combined with --template.");
157 static int run(int argc
, char *argv
[]) {
163 r
= parse_argv(argc
, argv
);
167 STRV_FOREACH(i
, argv
+ optind
) {
168 _cleanup_free_
char *e
= NULL
;
170 switch (arg_action
) {
174 r
= unit_name_path_escape(*i
, &e
);
176 return log_error_errno(r
, "Failed to escape string: %m");
178 e
= unit_name_escape(*i
);
186 r
= unit_name_replace_instance(arg_template
, e
, &x
);
188 return log_error_errno(r
, "Failed to replace instance: %m");
190 free_and_replace(e
, x
);
191 } else if (arg_suffix
) {
194 x
= strjoin(e
, ".", arg_suffix
);
198 free_and_replace(e
, x
);
203 case ACTION_UNESCAPE
: {
204 _cleanup_free_
char *name
= NULL
;
206 if (arg_template
|| arg_instance
) {
207 _cleanup_free_
char *template = NULL
;
209 r
= unit_name_to_instance(*i
, &name
);
211 return log_error_errno(r
, "Failed to extract instance: %m");
213 return log_error_errno(SYNTHETIC_ERRNO(EINVAL
),
214 "Unit %s is missing the instance name.", *i
);
216 r
= unit_name_template(*i
, &template);
218 return log_error_errno(r
, "Failed to extract template: %m");
219 if (arg_template
&& !streq(arg_template
, template))
220 return log_error_errno(SYNTHETIC_ERRNO(EINVAL
),
221 "Unit %s template %s does not match specified template %s.",
222 *i
, template, arg_template
);
230 r
= unit_name_path_unescape(name
, &e
);
232 r
= unit_name_unescape(name
, &e
);
234 return log_error_errno(r
, "Failed to unescape string: %m");
240 r
= unit_name_mangle(*i
, 0, &e
);
242 return log_error_errno(r
, "Failed to mangle name: %m");
247 if (i
!= argv
+ optind
)
258 DEFINE_MAIN_FUNCTION(run
);