aboutsummaryrefslogtreecommitdiff
path: root/src/users-service-dbus.h
blob: 0f082c3e97d879bc4518af1a124a16d47d96dead (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
/*
 * Copyright 2009 Canonical Ltd.
 *
 * Authors:
 *     Cody Russell <crussell@canonical.com>
 *     Charles Kerr <charles.kerr@canonical.com>
 *
 * This program is free software: you can redistribute it and/or modify it
 * under the terms of the GNU General Public License version 3, as published
 * by the Free Software Foundation.
 *
 * This program is distributed in the hope that it will be useful, but
 * WITHOUT ANY WARRANTY; without even the implied warranties of
 * MERCHANTABILITY, SATISFACTORY QUALITY, or FITNESS FOR A PARTICULAR
 * PURPOSE.  See the GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License along
 * with this program.  If not, see <http://www.gnu.org/licenses/>.
 */

#ifndef __USERS_SERVICE_DBUS_H__
#define __USERS_SERVICE_DBUS_H__

#include <glib.h>
#include <glib-object.h>

#include "dbus-user.h" /* for AccountsUser */

G_BEGIN_DECLS

#define USERS_SERVICE_DBUS_TYPE  (users_service_dbus_get_type ())
#define USERS_SERVICE_DBUS(o)    (G_TYPE_CHECK_INSTANCE_CAST ((o), USERS_SERVICE_DBUS_TYPE, UsersServiceDbus))
#define IS_USERS_SERVICE_DBUS(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), USERS_SERVICE_DBUS_TYPE))

typedef struct _UsersServiceDbus        UsersServiceDbus;
typedef struct _UsersServiceDbusClass   UsersServiceDbusClass;
typedef struct _UsersServiceDbusPrivate UsersServiceDbusPrivate;

/**
 * A facade class which interacts with multiple DBus services to
 * track info which is useful to the interactor's user menu:
 *
 *  1. A list of users to add to the user menu.
 *
 *     Each user is an AccountsUser object, which is a GDBusProxy
 *     to an org.freedesktop.Accounts.User object.
 *
 *     We initially build this list by calling org.freedesktop.Accounts'
 *     GetCachedUsers method. We also monitor o.f.Accounts' UserAdded
 *     and UserDeleted and update the list accordingly.
 *
 *  2. Track which users currently have X sessions.
 *     This is used for the menuitems' USER_ITEM_PROP_LOGGED_IN property.
 *
 *     We initially build this list by calling org.freedesktop.ConsoleKit.Seat's
 *     GetDevices method. We also monitor the seat for SessionAdded and
 *     SessionRemoved and update the list accordingly.
 *
 *  3. Provide an API for user switching and guest sessions.
 *     These are typically pass-through functions to GDBusProxies.
 *
 */
struct _UsersServiceDbus
{
  /*< private >*/
  GObject parent;
  UsersServiceDbusPrivate * priv;
};

struct _UsersServiceDbusClass
{
  GObjectClass parent_class;

  /* Signals */
  void (* user_list_changed)       (UsersServiceDbus*, gpointer);
  void (* user_logged_in_changed)  (UsersServiceDbus*, AccountsUser*, gpointer);
  void (* guest_logged_in_changed) (UsersServiceDbus*, gpointer);
};

GType     users_service_dbus_get_type               (void) G_GNUC_CONST;

GList   * users_service_dbus_get_user_list          (UsersServiceDbus * self);

gboolean  users_service_dbus_is_guest_logged_in     (UsersServiceDbus * self);
gboolean  users_service_dbus_is_user_logged_in      (UsersServiceDbus * self,
                                                     AccountsUser     * user);

void      users_service_dbus_show_greeter           (UsersServiceDbus * self);
gboolean  users_service_dbus_guest_session_enabled  (UsersServiceDbus * self);
gboolean  users_service_dbus_can_activate_session   (UsersServiceDbus * self);
void      users_service_dbus_activate_guest_session (UsersServiceDbus * self);
void      users_service_dbus_activate_user_session  (UsersServiceDbus * self,
                                                     AccountsUser     * user);

G_END_DECLS

#endif