gdm-session.h 11.2 KB
Newer Older
1 2
/* -*- Mode: C; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 8 -*-
 *
3
 * Copyright (C) 2006 Ray Strode <rstrode@redhat.com>
4 5 6
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
7 8
 * the Free Software Foundation; either version 2, or (at your option)
 * any later version.
9 10 11 12 13 14 15 16
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY 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, write to the Free Software
17 18
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
 * 02110-1301, USA.
19 20 21 22 23 24
 */

#ifndef __GDM_SESSION_H
#define __GDM_SESSION_H

#include <glib-object.h>
25
#include <sys/types.h>
26 27 28

G_BEGIN_DECLS

29 30 31 32 33 34
#define GDM_TYPE_SESSION (gdm_session_get_type ())
#define GDM_SESSION(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), GDM_TYPE_SESSION, GdmSession))
#define GDM_SESSION_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), GDM_TYPE_SESSION, GdmSessionClass))
#define GDM_IS_SESSION(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GDM_TYPE_SESSION))
#define GDM_IS_SESSION_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GDM_TYPE_SESSION))
#define GDM_SESSION_GET_CLASS(obj)  (G_TYPE_INSTANCE_GET_CLASS((obj), GDM_TYPE_SESSION, GdmSessionClass))
35

36
typedef struct _GdmSessionPrivate GdmSessionPrivate;
37

38 39 40
typedef enum
{
        GDM_SESSION_VERIFICATION_MODE_LOGIN,
41 42
        GDM_SESSION_VERIFICATION_MODE_CHOOSER,
        GDM_SESSION_VERIFICATION_MODE_REAUTHENTICATE
43 44
} GdmSessionVerificationMode;

45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61
typedef enum {
        /* We reuse the existing display server, e.g. X server
         * in "classic" mode from the greeter for the first seat. */
        GDM_SESSION_DISPLAY_MODE_REUSE_VT,

        /* Doesn't know anything about VTs. Tries to set DRM
         * master and will throw a tantrum if something bad
         * happens. e.g. weston-launch or mutter-launch. */
        GDM_SESSION_DISPLAY_MODE_NEW_VT,

        /* Uses logind sessions to manage itself. We need to set an
         * XDG_VTNR and it will switch to the correct VT on startup.
         * e.g. mutter-wayland with logind integration, X server with
         * logind integration. */
        GDM_SESSION_DISPLAY_MODE_LOGIND_MANAGED,
} GdmSessionDisplayMode;

62 63 64
GdmSessionDisplayMode gdm_session_display_mode_from_string (const char *str);
const char * gdm_session_display_mode_to_string (GdmSessionDisplayMode mode);

65
typedef struct
66
{
67 68 69
        GObject            parent;
        GdmSessionPrivate *priv;
} GdmSession;
70

71 72 73
typedef struct
{
        GObjectClass parent_class;
74 75

        /* Signals */
76 77 78 79 80
        void (* client_ready_for_session_to_start) (GdmSession   *session,
                                                    const char   *service_name,
                                                    gboolean      client_is_ready);

        void (* cancelled)                   (GdmSession   *session);
81
        void (* client_rejected)             (GdmSession   *session);
82 83 84
        void (* client_connected)            (GdmSession   *session);
        void (* client_disconnected)         (GdmSession   *session);
        void (* disconnected)                (GdmSession   *session);
85 86
        void (* verification_complete)       (GdmSession   *session,
                                              const char   *service_name);
87 88 89
        void (* authentication_failed)       (GdmSession   *session,
                                              const char   *service_name,
                                              GPid          worker_pid);
90 91
        void (* session_opened)              (GdmSession   *session,
                                              const char   *service_name,
92
                                              const char   *session_id);
93
        void (* session_started)             (GdmSession   *session,
94
                                              const char   *service_name,
95
                                              const char   *session_id,
96
                                              int           pid);
97
        void (* session_start_failed)        (GdmSession   *session,
98
                                              const char   *service_name,
99 100 101 102 103
                                              const char   *message);
        void (* session_exited)              (GdmSession   *session,
                                              int           exit_code);
        void (* session_died)                (GdmSession   *session,
                                              int           signal_number);
104 105 106 107
        void (* reauthentication_started)    (GdmSession   *session,
                                              GPid          pid_of_caller);
        void (* reauthenticated)             (GdmSession   *session,
                                              const char   *service_name);
108 109
        void (* conversation_started)        (GdmSession   *session,
                                              const char   *service_name);
110 111
        void (* conversation_stopped)        (GdmSession   *session,
                                              const char   *service_name);
112
        void (* setup_complete)              (GdmSession   *session,
113 114 115 116 117
                                              const char   *service_name);
} GdmSessionClass;

GType            gdm_session_get_type                 (void);

118
GdmSession      *gdm_session_new                      (GdmSessionVerificationMode verification_mode,
119 120 121 122 123 124 125 126
                                                       uid_t         allowed_user,
                                                       const char   *display_name,
                                                       const char   *display_hostname,
                                                       const char   *display_device,
                                                       const char   *display_seat_id,
                                                       const char   *display_x11_authority_file,
                                                       gboolean      display_is_local,
                                                       const char * const *environment);
127 128 129 130
uid_t             gdm_session_get_allowed_user       (GdmSession     *session);
void              gdm_session_start_reauthentication (GdmSession *session,
                                                      GPid        pid_of_caller,
                                                      uid_t       uid_of_caller);
131

132 133 134 135 136
const char       *gdm_session_get_server_address          (GdmSession     *session);
const char       *gdm_session_get_username                (GdmSession     *session);
const char       *gdm_session_get_display_device          (GdmSession     *session);
const char       *gdm_session_get_display_seat_id         (GdmSession     *session);
const char       *gdm_session_get_session_id              (GdmSession     *session);
137
gboolean          gdm_session_bypasses_xsession           (GdmSession     *session);
138
GdmSessionDisplayMode gdm_session_get_display_mode  (GdmSession     *session);
139

140 141 142 143
#ifdef ENABLE_WAYLAND_SUPPORT
void              gdm_session_set_ignore_wayland          (GdmSession *session,
                                                           gboolean    ignore_wayland);
#endif
144
gboolean          gdm_session_start_conversation          (GdmSession *session,
145 146 147
                                                           const char *service_name);
void              gdm_session_stop_conversation           (GdmSession *session,
                                                           const char *service_name);
148 149
const char       *gdm_session_get_conversation_session_id (GdmSession *session,
                                                           const char *service_name);
150 151 152 153 154 155 156
void              gdm_session_setup                       (GdmSession *session,
                                                           const char *service_name);
void              gdm_session_setup_for_user              (GdmSession *session,
                                                           const char *service_name,
                                                           const char *username);
void              gdm_session_setup_for_program           (GdmSession *session,
                                                           const char *service_name,
157
                                                           const char *username,
158 159 160 161
                                                           const char *log_file);
void              gdm_session_set_environment_variable    (GdmSession *session,
                                                           const char *key,
                                                           const char *value);
162 163
void              gdm_session_send_environment            (GdmSession *self,
                                                           const char *service_name);
164
void              gdm_session_reset                       (GdmSession *session);
165
void              gdm_session_cancel                      (GdmSession *session);
166 167 168 169 170
void              gdm_session_authenticate                (GdmSession *session,
                                                           const char *service_name);
void              gdm_session_authorize                   (GdmSession *session,
                                                           const char *service_name);
void              gdm_session_accredit                    (GdmSession *session,
171
                                                           const char *service_name);
172 173 174 175 176 177 178 179 180 181 182 183 184 185 186
void              gdm_session_open_session                (GdmSession *session,
                                                           const char *service_name);
void              gdm_session_start_session               (GdmSession *session,
                                                           const char *service_name);
void              gdm_session_close                       (GdmSession *session);

void              gdm_session_answer_query                (GdmSession *session,
                                                           const char *service_name,
                                                           const char *text);
void              gdm_session_select_program              (GdmSession *session,
                                                           const char *command_line);
void              gdm_session_select_session              (GdmSession *session,
                                                           const char *session_name);
void              gdm_session_select_user                 (GdmSession *session,
                                                           const char *username);
187
void              gdm_session_set_timed_login_details     (GdmSession *session,
188 189 190
                                                           const char *username,
                                                           int         delay);
gboolean          gdm_session_client_is_connected         (GdmSession *session);
191
gboolean          gdm_session_is_running                  (GdmSession *session);
192
GPid              gdm_session_get_pid                     (GdmSession *session);
193

194 195
G_END_DECLS

196
#endif /* GDM_SESSION_H */