src/login/logind-user.h

   1 /* SPDX-License-Identifier: LGPL-2.1+ */
   2 #pragma once
   3
   4 /***
   5   This file is part of systemd.
   6
   7   Copyright 2011 Lennart Poettering
   8 ***/
   9
  10 typedef struct User User;
  11
  12 #include "list.h"
  13 #include "logind.h"
  14
  15 typedef enum UserState {
  16         USER_OFFLINE,    /* Not logged in at all */
  17         USER_OPENING,    /* Is logging in */
  18         USER_LINGERING,  /* Lingering has been enabled by the admin for this user */
  19         USER_ONLINE,     /* User logged in */
  20         USER_ACTIVE,     /* User logged in and has a session in the fg */
  21         USER_CLOSING,    /* User logged out, but processes still remain and lingering is not enabled */
  22         _USER_STATE_MAX,
  23         _USER_STATE_INVALID = -1
  24 } UserState;
  25
  26 struct User {
  27         Manager *manager;
  28         uid_t uid;
  29         gid_t gid;
  30         char *name;
  31         char *state_file;
  32         char *runtime_path;
  33         char *slice;
  34         char *service;
  35
  36 #if 0 /// UNNEEDED by elogind
  37         char *service_job;
  38         char *slice_job;
  39 #endif // 0
  40
  41         Session *display;
  42
  43         dual_timestamp timestamp;
  44
  45         bool in_gc_queue:1;
  46         bool started:1;
  47         bool stopping:1;
  48
  49         LIST_HEAD(Session, sessions);
  50         LIST_FIELDS(User, gc_queue);
  51 };
  52
  53 int user_new(User **out, Manager *m, uid_t uid, gid_t gid, const char *name);
  54 User *user_free(User *u);
  55
  56 DEFINE_TRIVIAL_CLEANUP_FUNC(User *, user_free);
  57
  58 bool user_may_gc(User *u, bool drop_not_started);
  59 void user_add_to_gc_queue(User *u);
  60 int user_start(User *u);
  61 int user_stop(User *u, bool force);
  62 int user_finalize(User *u);
  63 UserState user_get_state(User *u);
  64 int user_get_idle_hint(User *u, dual_timestamp *t);
  65 int user_save(User *u);
  66 int user_load(User *u);
  67 int user_kill(User *u, int signo);
  68 int user_check_linger_file(User *u);
  69 void user_elect_display(User *u);
  70
  71 extern const sd_bus_vtable user_vtable[];
  72 int user_node_enumerator(sd_bus *bus, const char *path, void *userdata, char ***nodes, sd_bus_error *error);
  73 int user_object_find(sd_bus *bus, const char *path, const char *interface, void *userdata, void **found, sd_bus_error *error);
  74 char *user_bus_path(User *s);
  75
  76 int user_send_signal(User *u, bool new_user);
  77 int user_send_changed(User *u, const char *properties, ...) _sentinel_;
  78
  79 const char* user_state_to_string(UserState s) _const_;
  80 UserState user_state_from_string(const char *s) _pure_;
  81
  82 int bus_user_method_terminate(sd_bus_message *message, void *userdata, sd_bus_error *error);
  83 int bus_user_method_kill(sd_bus_message *message, void *userdata, sd_bus_error *error);
  84
  85 int config_parse_compat_user_tasks_max(const char *unit, const char *filename, unsigned line, const char *section, unsigned section_line, const char *lvalue, int ltype, const char *rvalue, void *data, void *userdata);