1 /* SPDX-License-Identifier: LGPL-2.1-or-later */
7 #include <sys/utsname.h>
11 #include "alloc-util.h"
12 #include "architecture.h"
15 #include "format-util.h"
17 #include "hostname-util.h"
18 #include "id128-util.h"
21 #include "path-lookup.h"
22 #include "path-util.h"
23 #include "specifier.h"
24 #include "string-util.h"
26 #include "user-util.h"
29 * Generic infrastructure for replacing %x style specifiers in
30 * strings. Will call a callback for each replacement.
33 /* Any ASCII character or digit: our pool of potential specifiers,
34 * and "%" used for escaping. */
35 #define POSSIBLE_SPECIFIERS ALPHANUMERICAL "%"
37 int specifier_printf(const char *text
, size_t max_length
, const Specifier table
[], const char *root
, const void *userdata
, char **ret
) {
38 _cleanup_free_
char *result
= NULL
;
49 if (!GREEDY_REALLOC(result
, l
+ 1))
53 for (const char *f
= text
; *f
!= '\0'; f
++, l
--) {
62 for (i
= table
; i
->specifier
; i
++)
63 if (i
->specifier
== *f
)
67 _cleanup_free_
char *w
= NULL
;
70 r
= i
->lookup(i
->specifier
, i
->data
, root
, userdata
, &w
);
79 if (!GREEDY_REALLOC(result
, j
+ k
+ l
+ 1))
81 t
= mempcpy(result
+ j
, w
, k
);
82 } else if (strchr(POSSIBLE_SPECIFIERS
, *f
))
83 /* Oops, an unknown specifier. */
95 if ((size_t) (t
- result
) > max_length
)
99 /* If string ended with a stray %, also end with % */
102 if ((size_t) (t
- result
) > max_length
)
103 return -ENAMETOOLONG
;
107 *ret
= TAKE_PTR(result
);
111 /* Generic handler for simple string replacements */
113 int specifier_string(char specifier
, const void *data
, const char *root
, const void *userdata
, char **ret
) {
114 return strdup_to(ASSERT_PTR(ret
), empty_to_null(data
));
117 int specifier_real_path(char specifier
, const void *data
, const char *root
, const void *userdata
, char **ret
) {
118 const char *path
= data
;
125 return chase(path
, root
, 0, ret
, NULL
);
128 int specifier_real_directory(char specifier
, const void *data
, const char *root
, const void *userdata
, char **ret
) {
129 _cleanup_free_
char *path
= NULL
;
134 r
= specifier_real_path(specifier
, data
, root
, userdata
, &path
);
139 return path_extract_directory(path
, ret
);
142 int specifier_id128(char specifier
, const void *data
, const char *root
, const void *userdata
, char **ret
) {
143 const sd_id128_t
*id
= ASSERT_PTR(data
);
146 n
= new(char, SD_ID128_STRING_MAX
);
150 *ret
= sd_id128_to_string(*id
, n
);
154 int specifier_uuid(char specifier
, const void *data
, const char *root
, const void *userdata
, char **ret
) {
155 const sd_id128_t
*id
= ASSERT_PTR(data
);
158 n
= new(char, SD_ID128_UUID_STRING_MAX
);
162 *ret
= sd_id128_to_uuid_string(*id
, n
);
166 int specifier_uint64(char specifier
, const void *data
, const char *root
, const void *userdata
, char **ret
) {
167 const uint64_t *n
= ASSERT_PTR(data
);
169 return asprintf(ret
, "%" PRIu64
, *n
) < 0 ? -ENOMEM
: 0;
172 int specifier_machine_id(char specifier
, const void *data
, const char *root
, const void *userdata
, char **ret
) {
178 r
= id128_get_machine(root
, &id
);
179 if (r
< 0) /* Translate error for missing /etc/machine-id file to EUNATCH. */
180 return r
== -ENOENT
? -EUNATCH
: r
;
182 return specifier_id128(specifier
, &id
, root
, userdata
, ret
);
185 int specifier_boot_id(char specifier
, const void *data
, const char *root
, const void *userdata
, char **ret
) {
191 r
= sd_id128_get_boot(&id
);
195 return specifier_id128(specifier
, &id
, root
, userdata
, ret
);
198 int specifier_hostname(char specifier
, const void *data
, const char *root
, const void *userdata
, char **ret
) {
203 n
= gethostname_malloc();
211 int specifier_short_hostname(char specifier
, const void *data
, const char *root
, const void *userdata
, char **ret
) {
216 n
= gethostname_short_malloc();
224 int specifier_pretty_hostname(char specifier
, const void *data
, const char *root
, const void *userdata
, char **ret
) {
229 if (get_pretty_hostname(&n
) < 0) {
230 n
= gethostname_short_malloc();
239 int specifier_kernel_release(char specifier
, const void *data
, const char *root
, const void *userdata
, char **ret
) {
247 return strdup_to(ret
, uts
.release
);
250 int specifier_architecture(char specifier
, const void *data
, const char *root
, const void *userdata
, char **ret
) {
251 return strdup_to(ASSERT_PTR(ret
),
252 architecture_to_string(uname_architecture()));
255 /* Note: fields in /etc/os-release might quite possibly be missing, even if everything is entirely valid
256 * otherwise. We'll return an empty value or NULL in that case from the functions below. But if the
257 * os-release file is missing, we'll return -EUNATCH. This means that something is seriously wrong with the
260 static int parse_os_release_specifier(const char *root
, const char *id
, char **ret
) {
261 _cleanup_free_
char *v
= NULL
;
266 r
= parse_os_release(root
, id
, &v
);
268 /* parse_os_release() calls parse_env_file() which only sets the return value for
269 * entries found. Let's make sure we set the return value in all cases. */
272 /* Translate error for missing os-release file to EUNATCH. */
273 return r
== -ENOENT
? -EUNATCH
: r
;
276 int specifier_os_id(char specifier
, const void *data
, const char *root
, const void *userdata
, char **ret
) {
277 return parse_os_release_specifier(root
, "ID", ret
);
280 int specifier_os_version_id(char specifier
, const void *data
, const char *root
, const void *userdata
, char **ret
) {
281 return parse_os_release_specifier(root
, "VERSION_ID", ret
);
284 int specifier_os_build_id(char specifier
, const void *data
, const char *root
, const void *userdata
, char **ret
) {
285 return parse_os_release_specifier(root
, "BUILD_ID", ret
);
288 int specifier_os_variant_id(char specifier
, const void *data
, const char *root
, const void *userdata
, char **ret
) {
289 return parse_os_release_specifier(root
, "VARIANT_ID", ret
);
292 int specifier_os_image_id(char specifier
, const void *data
, const char *root
, const void *userdata
, char **ret
) {
293 return parse_os_release_specifier(root
, "IMAGE_ID", ret
);
296 int specifier_os_image_version(char specifier
, const void *data
, const char *root
, const void *userdata
, char **ret
) {
297 return parse_os_release_specifier(root
, "IMAGE_VERSION", ret
);
300 int specifier_group_name(char specifier
, const void *data
, const char *root
, const void *userdata
, char **ret
) {
301 RuntimeScope scope
= PTR_TO_INT(data
);
306 if (scope
== RUNTIME_SCOPE_GLOBAL
)
309 t
= gid_to_name(scope
== RUNTIME_SCOPE_USER
? getgid() : 0);
317 int specifier_group_id(char specifier
, const void *data
, const char *root
, const void *userdata
, char **ret
) {
318 RuntimeScope scope
= PTR_TO_INT(data
);
323 if (scope
== RUNTIME_SCOPE_GLOBAL
)
326 gid
= scope
== RUNTIME_SCOPE_USER
? getgid() : 0;
328 if (asprintf(ret
, UID_FMT
, gid
) < 0)
334 int specifier_user_name(char specifier
, const void *data
, const char *root
, const void *userdata
, char **ret
) {
335 RuntimeScope scope
= PTR_TO_INT(data
);
341 if (scope
== RUNTIME_SCOPE_GLOBAL
)
344 uid
= scope
== RUNTIME_SCOPE_USER
? getuid() : 0;
346 /* If we are UID 0 (root), this will not result in NSS, otherwise it might. This is good, as we want
347 * to be able to run this in PID 1, where our user ID is 0, but where NSS lookups are not allowed.
349 * We don't use getusername_malloc() here, because we don't want to look at $USER, to remain
350 * consistent with specifer_user_id() below.
353 t
= uid_to_name(uid
);
361 int specifier_user_id(char specifier
, const void *data
, const char *root
, const void *userdata
, char **ret
) {
362 RuntimeScope scope
= PTR_TO_INT(data
);
367 if (scope
== RUNTIME_SCOPE_GLOBAL
)
370 uid
= scope
== RUNTIME_SCOPE_USER
? getuid() : 0;
372 if (asprintf(ret
, UID_FMT
, uid
) < 0)
378 int specifier_user_home(char specifier
, const void *data
, const char *root
, const void *userdata
, char **ret
) {
381 /* On PID 1 (which runs as root) this will not result in NSS,
382 * which is good. See above */
384 return get_home_dir(ret
);
387 int specifier_user_shell(char specifier
, const void *data
, const char *root
, const void *userdata
, char **ret
) {
390 /* On PID 1 (which runs as root) this will not result in NSS,
391 * which is good. See above */
393 return get_shell(ret
);
396 int specifier_tmp_dir(char specifier
, const void *data
, const char *root
, const void *userdata
, char **ret
) {
402 if (root
) /* If root dir is set, don't honour $TMP or similar */
410 return strdup_to(ret
, p
);
413 int specifier_var_tmp_dir(char specifier
, const void *data
, const char *root
, const void *userdata
, char **ret
) {
427 return strdup_to(ret
, p
);
430 int specifier_escape_strv(char **l
, char ***ret
) {
431 _cleanup_strv_free_
char **z
= NULL
;
436 if (strv_isempty(l
)) {
441 z
= new(char*, strv_length(l
)+1);
445 for (p
= l
, q
= z
; *p
; p
++, q
++) {
447 *q
= specifier_escape(*p
);
458 const Specifier system_and_tmp_specifier_table
[] = {
459 COMMON_SYSTEM_SPECIFIERS
,
460 COMMON_TMP_SPECIFIERS
,