logind-user.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 User User;
  25
  26 #include "list.h"
  27 #include "util.h"
  28 #include "logind.h"
  29 #include "logind-session.h"
  30
  31 typedef enum UserState {
  32         USER_OFFLINE,    /* Not logged in at all */
  33         USER_OPENING,    /* Is logging in */
  34         USER_LINGERING,  /* Lingering has been enabled by the admin for this user */
  35         USER_ONLINE,     /* User logged in */
  36         USER_ACTIVE,     /* User logged in and has a session in the fg */
  37         USER_CLOSING,    /* User logged out, but processes still remain and lingering is not enabled */
  38         _USER_STATE_MAX,
  39         _USER_STATE_INVALID = -1
  40 } UserState;
  41
  42 struct User {
  43         Manager *manager;
  44
  45         uid_t uid;
  46         gid_t gid;
  47         char *name;
  48
  49         char *state_file;
  50         char *runtime_path;
  51
  52         char *service;
  53         char *slice;
  54
  55         char *service_job;
  56         char *slice_job;
  57
  58         Session *display;
  59
  60         dual_timestamp timestamp;
  61
  62         bool in_gc_queue:1;
  63         bool started:1;
  64
  65         LIST_HEAD(Session, sessions);
  66         LIST_FIELDS(User, gc_queue);
  67 };
  68
  69 User* user_new(Manager *m, uid_t uid, gid_t gid, const char *name);
  70 void user_free(User *u);
  71 bool user_check_gc(User *u, bool drop_not_started);
  72 void user_add_to_gc_queue(User *u);
  73 int user_start(User *u);
  74 int user_stop(User *u);
  75 int user_finalize(User *u);
  76 UserState user_get_state(User *u);
  77 int user_get_idle_hint(User *u, dual_timestamp *t);
  78 int user_save(User *u);
  79 int user_load(User *u);
  80 int user_kill(User *u, int signo);
  81 int user_check_linger_file(User *u);
  82
  83 extern const sd_bus_vtable user_vtable[];
  84 int user_node_enumerator(sd_bus *bus, const char *path, void *userdata, char ***nodes, sd_bus_error *error);
  85 int user_object_find(sd_bus *bus, const char *path, const char *interface, void *userdata, void **found, sd_bus_error *error);
  86 char *user_bus_path(User *s);
  87
  88 int user_send_signal(User *u, bool new_user);
  89 int user_send_changed(User *u, const char *properties, ...) _sentinel_;
  90
  91 const char* user_state_to_string(UserState s) _const_;
  92 UserState user_state_from_string(const char *s) _pure_;