doc/tmpl/greeter.sgml

   1 <!-- ##### SECTION Title ##### -->
   2 LdmGreeter
   3
   4 <!-- ##### SECTION Short_Description ##### -->
   5 LightDM greeter object
   6
   7 <!-- ##### SECTION Long_Description ##### -->
   8 <para>
   9 #LdmGreeter is an object that manages the connection to the LightDM server and provides common greeter functionality.
  10 </para>
  11 <para>
  12 To connect to the display manager instanciate a #LdmGreeter object from inside the greeter process:
  13 <example>
  14 <title>Connecting to the display manager</title>
  15 <programlisting><![CDATA[
  16 LdmGreeter *greeter = ldm_greeter_new ();
  17 if (!ldm_greeter_connect (LDM_GREETER (greeter))) {
  18     // Log an error
  19     exit (0);
  20 }
  21 ]]></programlisting>
  22 </example>
  23 Information on how to connect to the display manager is passed using environment variables.
  24 </para>
  25 <para>
  26 Once connected, start an authentication conversation like this:
  27 <example>
  28 <title>Example Authorization Conversation</title>
  29 <programlisting><![CDATA[
  30 static void show_prompt_cb (LdmGreeter *greeter, const char *text)
  31 {
  32     // Show the user the message and prompt for some response
  33     gchar *secret = prompt_user (text);
  34
  35     // Give the result to the user
  36     ldm_greeter_provide_secret (greeter, secret);
  37 }
  38
  39 static void authentication_complete_cb (LdmGreeter *greeter)
  40 {
  41     if (ldm_greeter_get_is_authenticated (greeter)) {
  42         // Log in to this session.
  43         ldm_greeter_login (greeter);
  44     }
  45     else {
  46         // Display a warning and reset the greeter
  47         reset_login_screen ();
  48     }
  49 }
  50
  51 static void quit_cb (LdmGreeter *greeter)
  52 {
  53     // Clean up
  54     // ...
  55
  56     exit (0);
  57 }
  58
  59 g_object_connect (G_OBJECT (greeter), "show-prompt", G_CALLBACK (show_prompt_cb), NULL);
  60 g_object_connect (G_OBJECT (greeter), "authentication-complete", G_CALLBACK (authentication_complete_cb), NULL);
  61 g_object_connect (G_OBJECT (greeter), "quit", G_CALLBACK (quit_cb), NULL);
  62 ]]></programlisting>
  63 </example>
  64 </para>
  65
  66 <!-- ##### SECTION See_Also ##### -->
  67 <para>
  68
  69 </para>
  70
  71 <!-- ##### SECTION Stability_Level ##### -->
  72
  73
  74 <!-- ##### SECTION Image ##### -->
  75
  76
  77 <!-- ##### STRUCT LdmGreeter ##### -->
  78 <para>
  79
  80 </para>
  81
  82
  83 <!-- ##### SIGNAL LdmGreeter::authentication-complete ##### -->
  84 <para>
  85
  86 </para>
  87
  88 @ldmgreeter: the object which received the signal.
  89
  90 <!-- ##### SIGNAL LdmGreeter::quit ##### -->
  91 <para>
  92
  93 </para>
  94
  95 @ldmgreeter: the object which received the signal.
  96
  97 <!-- ##### SIGNAL LdmGreeter::show-error ##### -->
  98 <para>
  99
 100 </para>
 101
 102 @ldmgreeter: the object which received the signal.
 103 @arg1:
 104
 105 <!-- ##### SIGNAL LdmGreeter::show-message ##### -->
 106 <para>
 107
 108 </para>
 109
 110 @ldmgreeter: the object which received the signal.
 111 @arg1:
 112
 113 <!-- ##### SIGNAL LdmGreeter::show-prompt ##### -->
 114 <para>
 115
 116 </para>
 117
 118 @ldmgreeter: the object which received the signal.
 119 @arg1:
 120
 121 <!-- ##### SIGNAL LdmGreeter::timed-login ##### -->
 122 <para>
 123
 124 </para>
 125
 126 @ldmgreeter: the object which received the signal.
 127 @arg1:
 128
 129 <!-- ##### ARG LdmGreeter:can-hibernate ##### -->
 130 <para>
 131
 132 </para>
 133
 134 <!-- ##### ARG LdmGreeter:can-restart ##### -->
 135 <para>
 136
 137 </para>
 138
 139 <!-- ##### ARG LdmGreeter:can-shutdown ##### -->
 140 <para>
 141
 142 </para>
 143
 144 <!-- ##### ARG LdmGreeter:can-suspend ##### -->
 145 <para>
 146
 147 </para>
 148
 149 <!-- ##### ARG LdmGreeter:is-authenticated ##### -->
 150 <para>
 151
 152 </para>
 153
 154 <!-- ##### ARG LdmGreeter:layout ##### -->
 155 <para>
 156
 157 </para>
 158
 159 <!-- ##### ARG LdmGreeter:login-delay ##### -->
 160 <para>
 161
 162 </para>
 163
 164 <!-- ##### ARG LdmGreeter:num-users ##### -->
 165 <para>
 166
 167 </para>
 168
 169 <!-- ##### ARG LdmGreeter:session ##### -->
 170 <para>
 171
 172 </para>
 173
 174 <!-- ##### ARG LdmGreeter:timed-login-user ##### -->
 175 <para>
 176
 177 </para>
 178
 179 <!-- ##### FUNCTION ldm_greeter_new ##### -->
 180 <para>
 181
 182 </para>
 183
 184 @void:
 185 @Returns:
 186
 187
 188 <!-- ##### FUNCTION ldm_greeter_connect ##### -->
 189 <para>
 190
 191 </para>
 192
 193 @greeter:
 194 @Returns:
 195
 196
 197 <!-- ##### FUNCTION ldm_greeter_get_num_users ##### -->
 198 <para>
 199
 200 </para>
 201
 202 @greeter:
 203 @Returns:
 204
 205
 206 <!-- ##### FUNCTION ldm_greeter_get_users ##### -->
 207 <para>
 208
 209 </para>
 210
 211 @greeter:
 212 @Returns:
 213
 214
 215 <!-- ##### FUNCTION ldm_greeter_get_languages ##### -->
 216 <para>
 217
 218 </para>
 219
 220 @greeter:
 221 @Returns:
 222
 223
 224 <!-- ##### FUNCTION ldm_greeter_get_language ##### -->
 225 <para>
 226
 227 </para>
 228
 229 @greeter:
 230 @Returns:
 231
 232
 233 <!-- ##### FUNCTION ldm_greeter_get_layout ##### -->
 234 <para>
 235
 236 </para>
 237
 238 @greeter:
 239 @Returns:
 240
 241
 242 <!-- ##### FUNCTION ldm_greeter_get_layouts ##### -->
 243 <para>
 244
 245 </para>
 246
 247 @greeter:
 248 @Returns:
 249
 250
 251 <!-- ##### FUNCTION ldm_greeter_set_layout ##### -->
 252 <para>
 253
 254 </para>
 255
 256 @greeter:
 257 @layout:
 258
 259
 260 <!-- ##### FUNCTION ldm_greeter_get_sessions ##### -->
 261 <para>
 262
 263 </para>
 264
 265 @greeter:
 266 @Returns:
 267
 268
 269 <!-- ##### FUNCTION ldm_greeter_get_session ##### -->
 270 <para>
 271
 272 </para>
 273
 274 @greeter:
 275 @Returns:
 276
 277
 278 <!-- ##### FUNCTION ldm_greeter_set_session ##### -->
 279 <para>
 280
 281 </para>
 282
 283 @greeter:
 284 @session:
 285
 286
 287 <!-- ##### FUNCTION ldm_greeter_get_timed_login_user ##### -->
 288 <para>
 289
 290 </para>
 291
 292 @greeter:
 293 @Returns:
 294
 295
 296 <!-- ##### FUNCTION ldm_greeter_get_timed_login_delay ##### -->
 297 <para>
 298
 299 </para>
 300
 301 @greeter:
 302 @Returns:
 303
 304
 305 <!-- ##### FUNCTION ldm_greeter_cancel_timed_login ##### -->
 306 <para>
 307
 308 </para>
 309
 310 @greeter:
 311
 312
 313 <!-- ##### FUNCTION ldm_greeter_start_authentication ##### -->
 314 <para>
 315
 316 </para>
 317
 318 @greeter:
 319 @username:
 320
 321
 322 <!-- ##### FUNCTION ldm_greeter_provide_secret ##### -->
 323 <para>
 324
 325 </para>
 326
 327 @greeter:
 328 @secret:
 329
 330
 331 <!-- ##### FUNCTION ldm_greeter_cancel_authentication ##### -->
 332 <para>
 333
 334 </para>
 335
 336 @greeter:
 337
 338
 339 <!-- ##### FUNCTION ldm_greeter_get_is_authenticated ##### -->
 340 <para>
 341
 342 </para>
 343
 344 @greeter:
 345 @Returns:
 346
 347
 348 <!-- ##### FUNCTION ldm_greeter_login ##### -->
 349 <para>
 350
 351 </para>
 352
 353 @greeter:
 354
 355
 356 <!-- ##### FUNCTION ldm_greeter_get_can_suspend ##### -->
 357 <para>
 358
 359 </para>
 360
 361 @greeter:
 362 @Returns:
 363
 364
 365 <!-- ##### FUNCTION ldm_greeter_suspend ##### -->
 366 <para>
 367
 368 </para>
 369
 370 @greeter:
 371
 372
 373 <!-- ##### FUNCTION ldm_greeter_get_can_hibernate ##### -->
 374 <para>
 375
 376 </para>
 377
 378 @greeter:
 379 @Returns:
 380
 381
 382 <!-- ##### FUNCTION ldm_greeter_hibernate ##### -->
 383 <para>
 384
 385 </para>
 386
 387 @greeter:
 388
 389
 390 <!-- ##### FUNCTION ldm_greeter_get_can_restart ##### -->
 391 <para>
 392
 393 </para>
 394
 395 @greeter:
 396 @Returns:
 397
 398
 399 <!-- ##### FUNCTION ldm_greeter_restart ##### -->
 400 <para>
 401
 402 </para>
 403
 404 @greeter:
 405
 406
 407 <!-- ##### FUNCTION ldm_greeter_get_can_shutdown ##### -->
 408 <para>
 409
 410 </para>
 411
 412 @greeter:
 413 @Returns:
 414
 415
 416 <!-- ##### FUNCTION ldm_greeter_shutdown ##### -->
 417 <para>
 418
 419 </para>
 420
 421 @greeter:
 422
 423