1 /*-*- Mode: C; c-basic-offset: 8; indent-tabs-mode: nil -*-*/
4 This file is part of systemd.
6 Copyright 2010 Lennart Poettering
8 systemd is free software; you can redistribute it and/or modify it
9 under the terms of the GNU Lesser General Public License as published by
10 the Free Software Foundation; either version 2.1 of the License, or
11 (at your option) any later version.
13 systemd is distributed in the hope that it will be useful, but
14 WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16 Lesser General Public License for more details.
18 You should have received a copy of the GNU Lesser General Public License
19 along with systemd; If not, see <http://www.gnu.org/licenses/>.
22 #include "systemd/sd-id128.h"
24 #include "specifier.h"
25 #include "path-util.h"
27 #include "unit-name.h"
28 #include "unit-printf.h"
31 static char *specifier_prefix_and_instance(char specifier, void *data, void *userdata) {
35 return unit_name_to_prefix_and_instance(u->id);
38 static char *specifier_prefix(char specifier, void *data, void *userdata) {
42 return unit_name_to_prefix(u->id);
45 static char *specifier_prefix_unescaped(char specifier, void *data, void *userdata) {
51 p = unit_name_to_prefix(u->id);
55 r = unit_name_unescape(p);
61 static char *specifier_instance_unescaped(char specifier, void *data, void *userdata) {
66 return unit_name_unescape(u->instance);
71 static char *specifier_filename(char specifier, void *data, void *userdata) {
76 return unit_name_path_unescape(u->instance);
78 return unit_name_to_path(u->id);
81 static char *specifier_cgroup(char specifier, void *data, void *userdata) {
85 return unit_default_cgroup_path(u);
88 static char *specifier_cgroup_root(char specifier, void *data, void *userdata) {
94 return strdup(u->manager->cgroup_hierarchy);
96 if (path_get_parent(u->manager->cgroup_hierarchy, &p) < 0)
107 static char *specifier_runtime(char specifier, void *data, void *userdata) {
111 if (u->manager->running_as == SYSTEMD_USER) {
114 e = getenv("XDG_RUNTIME_DIR");
119 return strdup("/run");
122 static char *specifier_user_name(char specifier, void *data, void *userdata) {
126 const char *username;
127 _cleanup_free_ char *tmp = NULL;
129 char *printed = NULL;
133 c = unit_get_exec_context(u);
138 /* get USER env from env or our own uid */
139 username = tmp = getusername_malloc();
141 /* fish username from passwd */
142 r = get_user_creds(&username, &uid, NULL, NULL, NULL);
148 if (asprintf(&printed, "%d", uid) < 0)
152 printed = strdup(username);
159 static char *specifier_user_home(char specifier, void *data, void *userdata) {
163 const char *username, *home;
167 c = unit_get_exec_context(u);
169 /* return HOME if set, otherwise from passwd */
170 if (!c || !c->user) {
173 r = get_home_dir(&h);
181 r = get_user_creds(&username, NULL, NULL, &home, NULL);
188 static char *specifier_user_shell(char specifier, void *data, void *userdata) {
192 const char *username, *shell;
197 c = unit_get_exec_context(u);
204 /* return /bin/sh for root, otherwise the value from passwd */
205 r = get_user_creds(&username, NULL, NULL, NULL, &shell);
207 log_warning_unit(u->id,
208 "Failed to determine shell: %s",
213 if (!path_is_absolute(shell)) {
214 log_warning_unit(u->id,
215 "Shell %s is not absolute, ignoring.",
226 char *unit_name_printf(Unit *u, const char* format) {
229 * This will use the passed string as format string and
230 * replace the following specifiers:
232 * %n: the full id of the unit (foo@bar.waldo)
233 * %N: the id of the unit without the suffix (foo@bar)
234 * %p: the prefix (foo)
235 * %i: the instance (bar)
238 const Specifier table[] = {
239 { 'n', specifier_string, u->id },
240 { 'N', specifier_prefix_and_instance, NULL },
241 { 'p', specifier_prefix, NULL },
242 { 'i', specifier_string, u->instance },
249 return specifier_printf(format, table, u);
252 char *unit_full_printf(Unit *u, const char *format) {
254 /* This is similar to unit_name_printf() but also supports
255 * unescaping. Also, adds a couple of additional codes:
257 * %f the the instance if set, otherwise the id
258 * %c cgroup path of unit
259 * %r root cgroup path of this systemd instance (e.g. "/user/lennart/shared/systemd-4711")
260 * %R parent of root cgroup path (e.g. "/usr/lennart/shared")
261 * %t the runtime directory to place sockets in (e.g. "/run" or $XDG_RUNTIME_DIR)
262 * %U the UID of the configured user or running user
263 * %u the username of the configured user or running user
264 * %h the homedir of the configured user or running user
265 * %s the shell of the configured user or running user
266 * %m the machine ID of the running system
267 * %H the host name of the running system
268 * %b the boot ID of the running system
271 const Specifier table[] = {
272 { 'n', specifier_string, u->id },
273 { 'N', specifier_prefix_and_instance, NULL },
274 { 'p', specifier_prefix, NULL },
275 { 'P', specifier_prefix_unescaped, NULL },
276 { 'i', specifier_string, u->instance },
277 { 'I', specifier_instance_unescaped, NULL },
279 { 'f', specifier_filename, NULL },
280 { 'c', specifier_cgroup, NULL },
281 { 'r', specifier_cgroup_root, NULL },
282 { 'R', specifier_cgroup_root, NULL },
283 { 't', specifier_runtime, NULL },
284 { 'U', specifier_user_name, NULL },
285 { 'u', specifier_user_name, NULL },
286 { 'h', specifier_user_home, NULL },
287 { 's', specifier_user_shell, NULL },
289 { 'm', specifier_machine_id, NULL },
290 { 'H', specifier_host_name, NULL },
291 { 'b', specifier_boot_id, NULL },
297 return specifier_printf(format, table, u);
300 char **unit_full_printf_strv(Unit *u, char **l) {
304 /* Applies unit_full_printf to every entry in l */
313 for (i = l, j = r; *i; i++, j++) {
314 *j = unit_full_printf(u, *i);
323 for (j--; j >= r; j--)