2 This file is part of systemd.
4 Copyright 2011 Lennart Poettering
6 systemd is free software; you can redistribute it and/or modify it
7 under the terms of the GNU Lesser General Public License as published by
8 the Free Software Foundation; either version 2.1 of the License, or
9 (at your option) any later version.
11 systemd is distributed in the hope that it will be useful, but
12 WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 Lesser General Public License for more details.
16 You should have received a copy of the GNU Lesser General Public License
17 along with systemd; If not, see <http://www.gnu.org/licenses/>.
22 #include <sys/mount.h>
25 #include "alloc-util.h"
26 #include "bus-common-errors.h"
27 #include "bus-error.h"
29 #include "clean-ipc.h"
30 #include "conf-parser.h"
34 #include "formats-util.h"
38 #include "logind-user.h"
40 #include "mount-util.h"
41 #include "parse-util.h"
42 #include "path-util.h"
44 #include "smack-util.h"
45 //#include "special.h"
46 #include "stdio-util.h"
47 #include "string-table.h"
48 #include "unit-name.h"
49 #include "user-util.h"
52 #if 1 /// elogind uses a static value here
53 # define SPECIAL_USER_SLICE "user.slice"
56 int user_new(User **out, Manager *m, uid_t uid, gid_t gid, const char *name) {
57 _cleanup_(user_freep) User *u = NULL;
58 char lu[DECIMAL_STR_MAX(uid_t) + 1];
72 xsprintf(lu, UID_FMT, uid);
74 u->name = strdup(name);
78 if (asprintf(&u->state_file, "/run/systemd/users/"UID_FMT, uid) < 0)
81 if (asprintf(&u->runtime_path, "/run/user/"UID_FMT, uid) < 0)
84 r = slice_build_subslice(SPECIAL_USER_SLICE, lu, &u->slice);
88 r = unit_name_build("user", lu, ".service", &u->service);
92 r = hashmap_put(m->users, UID_TO_PTR(uid), u);
96 r = hashmap_put(m->user_units, u->slice, u);
100 r = hashmap_put(m->user_units, u->service, u);
109 User *user_free(User *u) {
114 LIST_REMOVE(gc_queue, u->manager->user_gc_queue, u);
117 session_free(u->sessions);
120 hashmap_remove_value(u->manager->user_units, u->service, u);
123 hashmap_remove_value(u->manager->user_units, u->slice, u);
125 hashmap_remove_value(u->manager->users, UID_TO_PTR(u->uid), u);
127 #if 0 /// elogind neither supports slice nor service jobs.
128 u->slice_job = mfree(u->slice_job);
129 u->service_job = mfree(u->service_job);
132 u->service = mfree(u->service);
133 u->slice = mfree(u->slice);
134 u->runtime_path = mfree(u->runtime_path);
135 u->state_file = mfree(u->state_file);
136 u->name = mfree(u->name);
141 static int user_save_internal(User *u) {
142 _cleanup_free_ char *temp_path = NULL;
143 _cleanup_fclose_ FILE *f = NULL;
147 assert(u->state_file);
149 r = mkdir_safe_label("/run/systemd/users", 0755, 0, 0);
153 r = fopen_temporary(u->state_file, &f, &temp_path);
157 fchmod(fileno(f), 0644);
160 "# This is private data. Do not parse.\n"
164 user_state_to_string(user_get_state(u)));
166 /* LEGACY: no-one reads RUNTIME= anymore, drop it at some point */
168 fprintf(f, "RUNTIME=%s\n", u->runtime_path);
170 #if 0 /// elogind neither supports service nor slice jobs
172 fprintf(f, "SERVICE_JOB=%s\n", u->service_job);
175 fprintf(f, "SLICE_JOB=%s\n", u->slice_job);
179 fprintf(f, "DISPLAY=%s\n", u->display->id);
181 if (dual_timestamp_is_set(&u->timestamp))
183 "REALTIME="USEC_FMT"\n"
184 "MONOTONIC="USEC_FMT"\n",
185 u->timestamp.realtime,
186 u->timestamp.monotonic);
192 fputs("SESSIONS=", f);
194 LIST_FOREACH(sessions_by_user, i, u->sessions) {
203 fputs("\nSEATS=", f);
205 LIST_FOREACH(sessions_by_user, i, u->sessions) {
214 fputs(i->seat->id, f);
217 fputs("\nACTIVE_SESSIONS=", f);
219 LIST_FOREACH(sessions_by_user, i, u->sessions) {
220 if (!session_is_active(i))
231 fputs("\nONLINE_SESSIONS=", f);
233 LIST_FOREACH(sessions_by_user, i, u->sessions) {
234 if (session_get_state(i) == SESSION_CLOSING)
245 fputs("\nACTIVE_SEATS=", f);
247 LIST_FOREACH(sessions_by_user, i, u->sessions) {
248 if (!session_is_active(i) || !i->seat)
256 fputs(i->seat->id, f);
259 fputs("\nONLINE_SEATS=", f);
261 LIST_FOREACH(sessions_by_user, i, u->sessions) {
262 if (session_get_state(i) == SESSION_CLOSING || !i->seat)
270 fputs(i->seat->id, f);
275 r = fflush_and_check(f);
279 if (rename(temp_path, u->state_file) < 0) {
287 (void) unlink(u->state_file);
290 (void) unlink(temp_path);
292 return log_error_errno(r, "Failed to save user data %s: %m", u->state_file);
295 int user_save(User *u) {
301 return user_save_internal (u);
304 int user_load(User *u) {
305 _cleanup_free_ char *display = NULL, *realtime = NULL, *monotonic = NULL;
311 r = parse_env_file(u->state_file, NEWLINE,
312 #if 0 /// elogind neither supports service nor slice jobs
313 "SERVICE_JOB", &u->service_job,
314 "SLICE_JOB", &u->slice_job,
317 "REALTIME", &realtime,
318 "MONOTONIC", &monotonic,
324 return log_error_errno(r, "Failed to read %s: %m", u->state_file);
328 s = hashmap_get(u->manager->sessions, display);
330 if (s && s->display && display_is_local(s->display))
334 timestamp_deserialize(realtime, &u->timestamp.realtime);
336 timestamp_deserialize(monotonic, &u->timestamp.monotonic);
341 static int user_mkdir_runtime_path(User *u) {
346 r = mkdir_safe_label("/run/user", 0755, 0, 0);
348 return log_error_errno(r, "Failed to create /run/user: %m");
350 if (path_is_mount_point(u->runtime_path, 0) <= 0) {
351 _cleanup_free_ char *t = NULL;
353 (void) mkdir_label(u->runtime_path, 0700);
356 r = asprintf(&t, "mode=0700,smackfsroot=*,uid=" UID_FMT ",gid=" GID_FMT ",size=%zu", u->uid, u->gid, u->manager->runtime_dir_size);
358 r = asprintf(&t, "mode=0700,uid=" UID_FMT ",gid=" GID_FMT ",size=%zu", u->uid, u->gid, u->manager->runtime_dir_size);
364 r = mount("tmpfs", u->runtime_path, "tmpfs", MS_NODEV|MS_NOSUID, t);
366 if (errno != EPERM) {
367 r = log_error_errno(errno, "Failed to mount per-user tmpfs directory %s: %m", u->runtime_path);
371 /* Lacking permissions, maybe
372 * CAP_SYS_ADMIN-less container? In this case,
373 * just use a normal directory. */
375 r = chmod_and_chown(u->runtime_path, 0700, u->uid, u->gid);
377 log_error_errno(r, "Failed to change runtime directory ownership and mode: %m");
382 r = label_fix(u->runtime_path, false, false);
384 log_warning_errno(r, "Failed to fix label of '%s', ignoring: %m", u->runtime_path);
390 /* Try to clean up, but ignore errors */
391 (void) rmdir(u->runtime_path);
395 static int user_start_slice(User *u) {
396 #if 0 /// elogind can not ask systemd via dbus to start user services
397 _cleanup_(sd_bus_error_free) sd_bus_error error = SD_BUS_ERROR_NULL;
398 const char *description;
404 u->slice_job = mfree(u->slice_job);
405 description = strjoina("User Slice of ", u->name);
407 r = manager_start_slice(
411 "systemd-logind.service",
412 "systemd-user-sessions.service",
413 u->manager->user_tasks_max,
418 else if (!sd_bus_error_has_name(&error, BUS_ERROR_UNIT_EXISTS))
419 /* we don't fail due to this, let's try to continue */
420 log_error_errno(r, "Failed to start user slice %s, ignoring: %s (%s)",
421 u->slice, bus_error_message(&error, r), error.name);
425 hashmap_put(u->manager->user_units, u->slice, u);
431 static int user_start_service(User *u) {
432 #if 0 /// elogind can not ask systemd via dbus to start user services
433 _cleanup_(sd_bus_error_free) sd_bus_error error = SD_BUS_ERROR_NULL;
439 u->service_job = mfree(u->service_job);
441 r = manager_start_unit(
447 /* we don't fail due to this, let's try to continue */
448 log_error_errno(r, "Failed to start user service, ignoring: %s", bus_error_message(&error, r));
450 u->service_job = job;
455 hashmap_put(u->manager->user_units, u->service, u);
461 int user_start(User *u) {
466 if (u->started && !u->stopping)
470 * If u->stopping is set, the user is marked for removal and the slice
471 * and service stop-jobs are queued. We have to clear that flag before
472 * queing the start-jobs again. If they succeed, the user object can be
473 * re-used just fine (pid1 takes care of job-ordering and proper
474 * restart), but if they fail, we want to force another user_stop() so
475 * possibly pending units are stopped.
476 * Note that we don't clear u->started, as we have no clue what state
477 * the user is in on failure here. Hence, we pretend the user is
478 * running so it will be properly taken down by GC. However, we clearly
479 * return an error from user_start() in that case, so no further
480 * reference to the user is taken.
485 log_debug("New user %s logged in.", u->name);
487 /* Make XDG_RUNTIME_DIR */
488 r = user_mkdir_runtime_path(u);
494 r = user_start_slice(u);
498 /* Save the user data so far, because pam_systemd will read the
499 * XDG_RUNTIME_DIR out of it while starting up systemd --user.
500 * We need to do user_save_internal() because we have not
501 * "officially" started yet. */
502 user_save_internal(u);
504 /* Spawn user systemd */
505 r = user_start_service(u);
510 if (!dual_timestamp_is_set(&u->timestamp))
511 dual_timestamp_get(&u->timestamp);
512 user_send_signal(u, true);
516 /* Save new user data */
522 #if 0 /// UNNEEDED by elogind
523 static int user_stop_slice(User *u) {
524 _cleanup_(sd_bus_error_free) sd_bus_error error = SD_BUS_ERROR_NULL;
530 r = manager_stop_unit(u->manager, u->slice, &error, &job);
532 log_error("Failed to stop user slice: %s", bus_error_message(&error, r));
542 static int user_stop_service(User *u) {
543 _cleanup_(sd_bus_error_free) sd_bus_error error = SD_BUS_ERROR_NULL;
549 r = manager_stop_unit(u->manager, u->service, &error, &job);
551 log_error("Failed to stop user service: %s", bus_error_message(&error, r));
555 free(u->service_job);
556 u->service_job = job;
562 static int user_remove_runtime_path(User *u) {
567 r = rm_rf(u->runtime_path, 0);
569 log_error_errno(r, "Failed to remove runtime directory %s: %m", u->runtime_path);
571 /* Ignore cases where the directory isn't mounted, as that's
572 * quite possible, if we lacked the permissions to mount
574 r = umount2(u->runtime_path, MNT_DETACH);
575 if (r < 0 && errno != EINVAL && errno != ENOENT)
576 log_error_errno(errno, "Failed to unmount user runtime directory %s: %m", u->runtime_path);
578 r = rm_rf(u->runtime_path, REMOVE_ROOT);
580 log_error_errno(r, "Failed to remove runtime directory %s: %m", u->runtime_path);
585 int user_stop(User *u, bool force) {
590 /* Stop jobs have already been queued */
596 LIST_FOREACH(sessions_by_user, s, u->sessions) {
597 k = session_stop(s, force);
603 #if 0 /// elogind does not support service or slice jobs
604 k = user_stop_service(u);
609 k = user_stop_slice(u);
621 int user_finalize(User *u) {
628 log_debug("User %s logged out.", u->name);
630 LIST_FOREACH(sessions_by_user, s, u->sessions) {
631 k = session_finalize(s);
636 /* Kill XDG_RUNTIME_DIR */
637 k = user_remove_runtime_path(u);
641 /* Clean SysV + POSIX IPC objects */
642 if (u->manager->remove_ipc) {
643 k = clean_ipc(u->uid);
648 unlink(u->state_file);
649 user_add_to_gc_queue(u);
652 user_send_signal(u, false);
659 int user_get_idle_hint(User *u, dual_timestamp *t) {
661 bool idle_hint = true;
662 dual_timestamp ts = DUAL_TIMESTAMP_NULL;
666 LIST_FOREACH(sessions_by_user, s, u->sessions) {
670 ih = session_get_idle_hint(s, &k);
676 if (k.monotonic < ts.monotonic)
682 } else if (idle_hint) {
684 if (k.monotonic > ts.monotonic)
695 int user_check_linger_file(User *u) {
696 _cleanup_free_ char *cc = NULL;
699 cc = cescape(u->name);
703 p = strjoina("/var/lib/systemd/linger/", cc);
705 return access(p, F_OK) >= 0;
708 bool user_check_gc(User *u, bool drop_not_started) {
711 if (drop_not_started && !u->started)
717 if (user_check_linger_file(u) > 0)
720 #if 0 /// elogind neither supports service nor slice jobs
721 if (u->slice_job && manager_job_is_active(u->manager, u->slice_job))
724 if (u->service_job && manager_job_is_active(u->manager, u->service_job))
731 void user_add_to_gc_queue(User *u) {
737 LIST_PREPEND(gc_queue, u->manager->user_gc_queue, u);
738 u->in_gc_queue = true;
741 UserState user_get_state(User *u) {
749 #if 0 /// elogind neither supports service nor slice jobs.
750 if (!u->started || u->slice_job || u->service_job)
757 bool all_closing = true;
759 LIST_FOREACH(sessions_by_user, i, u->sessions) {
762 state = session_get_state(i);
763 if (state == SESSION_ACTIVE)
765 if (state != SESSION_CLOSING)
769 return all_closing ? USER_CLOSING : USER_ONLINE;
772 if (user_check_linger_file(u) > 0)
773 return USER_LINGERING;
778 int user_kill(User *u, int signo) {
779 #if 0 /// Without systemd unit support, elogind has to rely on its session system
782 return manager_kill_unit(u->manager, u->slice, KILL_ALL, signo, NULL);
789 LIST_FOREACH(sessions_by_user, s, u->sessions) {
790 int r = session_kill(s, KILL_ALL, signo);
791 if (res == 0 && r < 0)
799 static bool elect_display_filter(Session *s) {
800 /* Return true if the session is a candidate for the user’s ‘primary
801 * session’ or ‘display’. */
804 return (s->class == SESSION_USER && !s->stopping);
807 static int elect_display_compare(Session *s1, Session *s2) {
808 /* Indexed by SessionType. Lower numbers mean more preferred. */
809 const int type_ranks[_SESSION_TYPE_MAX] = {
810 [SESSION_UNSPECIFIED] = 0,
813 [SESSION_WAYLAND] = -3,
818 /* Calculate the partial order relationship between s1 and s2,
819 * returning < 0 if s1 is preferred as the user’s ‘primary session’,
820 * 0 if s1 and s2 are equally preferred or incomparable, or > 0 if s2
823 * s1 or s2 may be NULL. */
827 if ((s1 == NULL) != (s2 == NULL))
828 return (s1 == NULL) - (s2 == NULL);
830 if (s1->stopping != s2->stopping)
831 return s1->stopping - s2->stopping;
833 if ((s1->class != SESSION_USER) != (s2->class != SESSION_USER))
834 return (s1->class != SESSION_USER) - (s2->class != SESSION_USER);
836 if ((s1->type == _SESSION_TYPE_INVALID) != (s2->type == _SESSION_TYPE_INVALID))
837 return (s1->type == _SESSION_TYPE_INVALID) - (s2->type == _SESSION_TYPE_INVALID);
839 if (s1->type != s2->type)
840 return type_ranks[s1->type] - type_ranks[s2->type];
845 void user_elect_display(User *u) {
850 /* This elects a primary session for each user, which we call
851 * the "display". We try to keep the assignment stable, but we
852 * "upgrade" to better choices. */
853 log_debug("Electing new display for user %s", u->name);
855 LIST_FOREACH(sessions_by_user, s, u->sessions) {
856 if (!elect_display_filter(s)) {
857 log_debug("Ignoring session %s", s->id);
861 if (elect_display_compare(s, u->display) < 0) {
862 log_debug("Choosing session %s in preference to %s", s->id, u->display ? u->display->id : "-");
868 static const char* const user_state_table[_USER_STATE_MAX] = {
869 [USER_OFFLINE] = "offline",
870 [USER_OPENING] = "opening",
871 [USER_LINGERING] = "lingering",
872 [USER_ONLINE] = "online",
873 [USER_ACTIVE] = "active",
874 [USER_CLOSING] = "closing"
877 DEFINE_STRING_TABLE_LOOKUP(user_state, UserState);
879 int config_parse_tmpfs_size(
881 const char *filename,
884 unsigned section_line,
899 /* First, try to parse as percentage */
900 r = parse_percent(rvalue);
901 if (r > 0 && r < 100)
902 *sz = physical_memory_scale(r, 100U);
906 /* If the passed argument was not a percentage, or out of range, parse as byte size */
908 r = parse_size(rvalue, 1024, &k);
909 if (r < 0 || k <= 0 || (uint64_t) (size_t) k != k) {
910 log_syntax(unit, LOG_ERR, filename, line, r, "Failed to parse size value, ignoring: %s", rvalue);
914 *sz = PAGE_ALIGN((size_t) k);
920 int config_parse_user_tasks_max(
922 const char *filename,
925 unsigned section_line,
941 /* First, try to parse as percentage */
942 r = parse_percent(rvalue);
944 k = system_tasks_max_scale(r, 100U);
947 /* If the passed argument was not a percentage, or out of range, parse as byte size */
949 r = safe_atou64(rvalue, &k);
951 log_syntax(unit, LOG_ERR, filename, line, r, "Failed to parse tasks maximum, ignoring: %s", rvalue);
956 if (k <= 0 || k >= UINT64_MAX) {
957 log_syntax(unit, LOG_ERR, filename, line, 0, "Tasks maximum out of range, ignoring: %s", rvalue);