2017-11-18 17:09:20 +01:00
|
|
|
/* SPDX-License-Identifier: LGPL-2.1+ */
|
2012-07-18 19:07:51 +02:00
|
|
|
#pragma once
|
2011-05-24 00:19:22 +02:00
|
|
|
|
|
|
|
typedef struct User User;
|
|
|
|
|
2018-05-22 13:10:17 +02:00
|
|
|
#include "conf-parser.h"
|
2011-05-24 00:19:22 +02:00
|
|
|
#include "list.h"
|
|
|
|
#include "logind.h"
|
|
|
|
|
|
|
|
typedef enum UserState {
|
2012-06-21 16:14:53 +02:00
|
|
|
USER_OFFLINE, /* Not logged in at all */
|
2013-07-02 01:46:30 +02:00
|
|
|
USER_OPENING, /* Is logging in */
|
2012-06-21 16:14:53 +02:00
|
|
|
USER_LINGERING, /* Lingering has been enabled by the admin for this user */
|
|
|
|
USER_ONLINE, /* User logged in */
|
|
|
|
USER_ACTIVE, /* User logged in and has a session in the fg */
|
|
|
|
USER_CLOSING, /* User logged out, but processes still remain and lingering is not enabled */
|
2011-05-24 00:19:22 +02:00
|
|
|
_USER_STATE_MAX,
|
|
|
|
_USER_STATE_INVALID = -1
|
|
|
|
} UserState;
|
|
|
|
|
|
|
|
struct User {
|
|
|
|
Manager *manager;
|
|
|
|
uid_t uid;
|
|
|
|
gid_t gid;
|
|
|
|
char *name;
|
2018-08-08 15:27:49 +02:00
|
|
|
char *home;
|
2011-05-24 00:19:22 +02:00
|
|
|
char *state_file;
|
|
|
|
char *runtime_path;
|
2018-08-06 21:44:45 +02:00
|
|
|
|
|
|
|
char *slice; /* user-UID.slice */
|
|
|
|
char *service; /* user@UID.service */
|
|
|
|
char *runtime_dir_service; /* user-runtime-dir@UID.service */
|
2011-05-24 00:19:22 +02:00
|
|
|
|
2013-07-02 01:46:30 +02:00
|
|
|
char *service_job;
|
|
|
|
|
2011-05-24 00:19:22 +02:00
|
|
|
Session *display;
|
|
|
|
|
2018-08-07 11:02:00 +02:00
|
|
|
dual_timestamp timestamp; /* When this User object was 'started' the first time */
|
|
|
|
usec_t last_session_timestamp; /* When the number of sessions of this user went from 1 to 0 the last time */
|
|
|
|
|
|
|
|
/* Set up when the last session of the user logs out */
|
|
|
|
sd_event_source *timer_event_source;
|
2011-05-24 00:19:22 +02:00
|
|
|
|
2011-05-25 00:55:58 +02:00
|
|
|
bool in_gc_queue:1;
|
2018-08-06 18:14:11 +02:00
|
|
|
|
|
|
|
bool started:1; /* Whenever the user being started, has been started or is being stopped again. */
|
|
|
|
bool stopping:1; /* Whenever the user is being stopped or has been stopped. */
|
2011-05-25 00:55:58 +02:00
|
|
|
|
2011-05-24 00:19:22 +02:00
|
|
|
LIST_HEAD(Session, sessions);
|
2011-05-25 00:55:58 +02:00
|
|
|
LIST_FIELDS(User, gc_queue);
|
2011-05-24 00:19:22 +02:00
|
|
|
};
|
|
|
|
|
2018-08-08 15:27:49 +02:00
|
|
|
int user_new(User **out, Manager *m, uid_t uid, gid_t gid, const char *name, const char *home);
|
2015-09-29 11:10:01 +02:00
|
|
|
User *user_free(User *u);
|
|
|
|
|
|
|
|
DEFINE_TRIVIAL_CLEANUP_FUNC(User *, user_free);
|
|
|
|
|
2018-02-15 13:14:35 +01:00
|
|
|
bool user_may_gc(User *u, bool drop_not_started);
|
2011-05-25 00:55:58 +02:00
|
|
|
void user_add_to_gc_queue(User *u);
|
2011-05-24 00:19:22 +02:00
|
|
|
int user_start(User *u);
|
2014-02-09 02:29:56 +01:00
|
|
|
int user_stop(User *u, bool force);
|
2013-08-13 17:59:28 +02:00
|
|
|
int user_finalize(User *u);
|
2011-05-24 00:19:22 +02:00
|
|
|
UserState user_get_state(User *u);
|
2011-06-17 15:59:18 +02:00
|
|
|
int user_get_idle_hint(User *u, dual_timestamp *t);
|
2011-05-24 00:19:22 +02:00
|
|
|
int user_save(User *u);
|
|
|
|
int user_load(User *u);
|
2011-07-13 19:58:35 +02:00
|
|
|
int user_kill(User *u, int signo);
|
2013-11-05 01:27:27 +01:00
|
|
|
int user_check_linger_file(User *u);
|
2014-05-19 02:03:20 +02:00
|
|
|
void user_elect_display(User *u);
|
2018-08-07 11:02:00 +02:00
|
|
|
void user_update_last_session_timer(User *u);
|
2011-05-24 00:19:22 +02:00
|
|
|
|
2013-05-03 04:51:50 +02:00
|
|
|
const char* user_state_to_string(UserState s) _const_;
|
|
|
|
UserState user_state_from_string(const char *s) _pure_;
|
2015-02-18 12:55:25 +01:00
|
|
|
|
2018-05-22 13:10:17 +02:00
|
|
|
CONFIG_PARSER_PROTOTYPE(config_parse_compat_user_tasks_max);
|