src/login/logind-session.h

   1 /*-*- Mode: C; c-basic-offset: 8; indent-tabs-mode: nil -*-*/
   2
   3 #pragma once
   4
   5 /***
   6   This file is part of systemd.
   7
   8   Copyright 2011 Lennart Poettering
   9
  10   systemd is free software; you can redistribute it and/or modify it
  11   under the terms of the GNU Lesser General Public License as published by
  12   the Free Software Foundation; either version 2.1 of the License, or
  13   (at your option) any later version.
  14
  15   systemd is distributed in the hope that it will be useful, but
  16   WITHOUT ANY WARRANTY; without even the implied warranty of
  17   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  18   Lesser General Public License for more details.
  19
  20   You should have received a copy of the GNU Lesser General Public License
  21   along with systemd; If not, see <http://www.gnu.org/licenses/>.
  22 ***/
  23
  24 typedef struct Session Session;
  25 typedef enum KillWho KillWho;
  26
  27 #include "list.h"
  28 #include "util.h"
  29 #include "logind.h"
  30 #include "logind-seat.h"
  31 #include "logind-session-device.h"
  32 #include "logind-user.h"
  33 #include "login-shared.h"
  34
  35 typedef enum SessionState {
  36         SESSION_OPENING,  /* Session scope is being created */
  37         SESSION_ONLINE,   /* Logged in */
  38         SESSION_ACTIVE,   /* Logged in and in the fg */
  39         SESSION_CLOSING,  /* Logged out, but scope is still there */
  40         _SESSION_STATE_MAX,
  41         _SESSION_STATE_INVALID = -1
  42 } SessionState;
  43
  44 typedef enum SessionClass {
  45         SESSION_USER,
  46         SESSION_GREETER,
  47         SESSION_LOCK_SCREEN,
  48         SESSION_BACKGROUND,
  49         _SESSION_CLASS_MAX,
  50         _SESSION_CLASS_INVALID = -1
  51 } SessionClass;
  52
  53 typedef enum SessionType {
  54         SESSION_UNSPECIFIED,
  55         SESSION_TTY,
  56         SESSION_X11,
  57         SESSION_WAYLAND,
  58         SESSION_MIR,
  59         _SESSION_TYPE_MAX,
  60         _SESSION_TYPE_INVALID = -1
  61 } SessionType;
  62
  63 enum KillWho {
  64         KILL_LEADER,
  65         KILL_ALL,
  66         _KILL_WHO_MAX,
  67         _KILL_WHO_INVALID = -1
  68 };
  69
  70 struct Session {
  71         Manager *manager;
  72
  73         char *id;
  74         unsigned int pos;
  75         SessionType type;
  76         SessionClass class;
  77
  78         char *state_file;
  79
  80         User *user;
  81
  82         dual_timestamp timestamp;
  83
  84         char *tty;
  85         char *display;
  86
  87         bool remote;
  88         char *remote_user;
  89         char *remote_host;
  90         char *service;
  91         char *desktop;
  92
  93         char *scope;
  94         char *scope_job;
  95
  96         Seat *seat;
  97         unsigned int vtnr;
  98         int vtfd;
  99         sd_event_source *vt_source;
 100
 101         pid_t leader;
 102         uint32_t audit_id;
 103
 104         int fifo_fd;
 105         char *fifo_path;
 106
 107         sd_event_source *fifo_event_source;
 108
 109         bool idle_hint;
 110         dual_timestamp idle_hint_timestamp;
 111
 112         bool in_gc_queue:1;
 113         bool started:1;
 114         bool stopping:1;
 115
 116         sd_bus_message *create_message;
 117
 118         sd_event_source *timer_event_source;
 119
 120         char *controller;
 121         Hashmap *devices;
 122
 123         LIST_FIELDS(Session, sessions_by_user);
 124         LIST_FIELDS(Session, sessions_by_seat);
 125
 126         LIST_FIELDS(Session, gc_queue);
 127 };
 128
 129 Session *session_new(Manager *m, const char *id);
 130 void session_free(Session *s);
 131 void session_set_user(Session *s, User *u);
 132 bool session_check_gc(Session *s, bool drop_not_started);
 133 void session_add_to_gc_queue(Session *s);
 134 int session_activate(Session *s);
 135 bool session_is_active(Session *s);
 136 int session_get_idle_hint(Session *s, dual_timestamp *t);
 137 void session_set_idle_hint(Session *s, bool b);
 138 int session_create_fifo(Session *s);
 139 int session_start(Session *s);
 140 int session_stop(Session *s, bool force);
 141 int session_finalize(Session *s);
 142 void session_release(Session *s);
 143 int session_save(Session *s);
 144 int session_load(Session *s);
 145 int session_kill(Session *s, KillWho who, int signo);
 146
 147 SessionState session_get_state(Session *u);
 148
 149 extern const sd_bus_vtable session_vtable[];
 150 int session_node_enumerator(sd_bus *bus, const char *path,void *userdata, char ***nodes, sd_bus_error *error);
 151 int session_object_find(sd_bus *bus, const char *path, const char *interface, void *userdata, void **found, sd_bus_error *error);
 152 char *session_bus_path(Session *s);
 153
 154 int session_send_signal(Session *s, bool new_session);
 155 int session_send_changed(Session *s, const char *properties, ...) _sentinel_;
 156 int session_send_lock(Session *s, bool lock);
 157 int session_send_lock_all(Manager *m, bool lock);
 158
 159 int session_send_create_reply(Session *s, sd_bus_error *error);
 160
 161 const char* session_state_to_string(SessionState t) _const_;
 162 SessionState session_state_from_string(const char *s) _pure_;
 163
 164 const char* session_type_to_string(SessionType t) _const_;
 165 SessionType session_type_from_string(const char *s) _pure_;
 166
 167 const char* session_class_to_string(SessionClass t) _const_;
 168 SessionClass session_class_from_string(const char *s) _pure_;
 169
 170 const char *kill_who_to_string(KillWho k) _const_;
 171 KillWho kill_who_from_string(const char *s) _pure_;
 172
 173 void session_mute_vt(Session *s);
 174 void session_restore_vt(Session *s);
 175
 176 bool session_is_controller(Session *s, const char *sender);
 177 int session_set_controller(Session *s, const char *sender, bool force);
 178 void session_drop_controller(Session *s);