summaryrefslogtreecommitdiff
path: root/libegg/eggsmclient.h
blob: 1911b89ef9842647c999d5c0e30fb4bf157ff4c8 (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
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
/* eggsmclient.h
 * Copyright (C) 2007 Novell, Inc.
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2 of the License, or (at your option) any later version.
 *
 * This library 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
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with this library; if not, write to the
 * Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
 * Boston, MA 02110-1301, USA.
 */

#ifndef __EGG_SM_CLIENT_H__
#define __EGG_SM_CLIENT_H__

#include <glib-object.h>

G_BEGIN_DECLS

#define EGG_TYPE_SM_CLIENT            (egg_sm_client_get_type ())
#define EGG_SM_CLIENT(obj)            (G_TYPE_CHECK_INSTANCE_CAST ((obj), EGG_TYPE_SM_CLIENT, EggSMClient))
#define EGG_SM_CLIENT_CLASS(klass)    (G_TYPE_CHECK_CLASS_CAST ((klass), EGG_TYPE_SM_CLIENT, EggSMClientClass))
#define EGG_IS_SM_CLIENT(obj)         (G_TYPE_CHECK_INSTANCE_TYPE ((obj), EGG_TYPE_SM_CLIENT))
#define EGG_IS_SM_CLIENT_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), EGG_TYPE_SM_CLIENT))
#define EGG_SM_CLIENT_GET_CLASS(obj)  (G_TYPE_INSTANCE_GET_CLASS ((obj), EGG_TYPE_SM_CLIENT, EggSMClientClass))

typedef struct _EggSMClient        EggSMClient;
typedef struct _EggSMClientClass   EggSMClientClass;
typedef struct _EggSMClientPrivate EggSMClientPrivate;

typedef enum
{
    EGG_SM_CLIENT_END_SESSION_DEFAULT,
    EGG_SM_CLIENT_LOGOUT,
    EGG_SM_CLIENT_REBOOT,
    EGG_SM_CLIENT_SHUTDOWN
} EggSMClientEndStyle;

typedef enum
{
    EGG_SM_CLIENT_MODE_DISABLED,
    EGG_SM_CLIENT_MODE_NO_RESTART,
    EGG_SM_CLIENT_MODE_NORMAL
} EggSMClientMode;

struct _EggSMClient
{
    GObject parent;
};

struct _EggSMClientClass
{
    GObjectClass parent_class;

    /* signals */
    void (*save_state)       (EggSMClient *client,
                              GKeyFile    *state_file);

    void (*quit_requested)   (EggSMClient *client);
    void (*quit_cancelled)   (EggSMClient *client);
    void (*quit)             (EggSMClient *client);

    /* virtual methods */
    void (*startup)             (EggSMClient          *client,
                                 const char           *client_id);
    void (*set_restart_command) (EggSMClient          *client,
                                 int                   argc,
                                 const char          **argv);
    void (*will_quit)           (EggSMClient          *client,
                                 gboolean              will_quit);
    gboolean (*end_session)     (EggSMClient          *client,
                                 EggSMClientEndStyle   style,
                                 gboolean              request_confirmation);

    /* Padding for future expansion */
    void (*_egg_reserved1) (void);
    void (*_egg_reserved2) (void);
    void (*_egg_reserved3) (void);
    void (*_egg_reserved4) (void);
};

GType            egg_sm_client_get_type            (void) G_GNUC_CONST;

GOptionGroup    *egg_sm_client_get_option_group    (void);

/* Initialization */
void             egg_sm_client_set_mode            (EggSMClientMode mode);
EggSMClientMode  egg_sm_client_get_mode            (void);
EggSMClient     *egg_sm_client_get                 (void);

/* Resuming a saved session */
gboolean         egg_sm_client_is_resumed          (EggSMClient *client);
GKeyFile        *egg_sm_client_get_state_file      (EggSMClient *client);

/* Alternate means of saving state */
void             egg_sm_client_set_restart_command (EggSMClient  *client,
                                                    int           argc,
                                                    const char  **argv);

/* Handling "quit_requested" signal */
void             egg_sm_client_will_quit           (EggSMClient *client,
                                                    gboolean     will_quit);

/* Initiate a logout/reboot/shutdown */
gboolean         egg_sm_client_end_session         (EggSMClientEndStyle  style,
                                                    gboolean             request_confirmation);

G_END_DECLS

#endif /* __EGG_SM_CLIENT_H__ */