2 * Copyright (C) 2010-2011 Robert Ancell.
3 * Author: Robert Ancell <robert.ancell@canonical.com>
5 * This program is free software: you can redistribute it and/or modify it under
6 * the terms of the GNU General Public License as published by the Free Software
7 * Foundation, either version 3 of the License, or (at your option) any later
8 * version. See http://www.gnu.org/copyleft/gpl.html the full text of the
17 #include "configuration.h"
18 #include "guest-account.h"
20 #include "session-config.h"
29 static guint signals[LAST_SIGNAL] = { 0 };
33 /* Configuration for this seat */
34 GHashTable *properties;
36 /* TRUE if this seat can run multiple sessions at once */
37 gboolean supports_multi_session;
39 /* TRUE if display server can be shared for sessions */
40 gboolean share_display_server;
42 /* The display servers on this seat */
43 GList *display_servers;
45 /* The sessions on this seat */
48 /* The last session set to active */
49 Session *active_session;
51 /* The session belonging to the active greeter user */
52 Session *next_session;
54 /* The session to set active when it starts */
55 Session *session_to_activate;
57 /* TRUE once we have started */
60 /* TRUE if stopping this seat (waiting for displays to stop) */
67 static void seat_logger_iface_init (LoggerInterface *iface);
69 G_DEFINE_TYPE_WITH_CODE (Seat, seat, G_TYPE_OBJECT,
70 G_IMPLEMENT_INTERFACE (
71 LOGGER_TYPE, seat_logger_iface_init));
78 static GHashTable *seat_modules = NULL;
80 // FIXME: Make a get_display_server() that re-uses display servers if supported
81 static DisplayServer *create_display_server (Seat *seat, Session *session);
82 static Greeter *create_greeter_session (Seat *seat);
83 static void start_session (Seat *seat, Session *session);
86 seat_register_module (const gchar *name, GType type)
91 seat_modules = g_hash_table_new_full (g_str_hash, g_str_equal, g_free, NULL);
93 g_debug ("Registered seat module %s", name);
95 module = g_malloc0 (sizeof (SeatModule));
96 module->name = g_strdup (name);
98 g_hash_table_insert (seat_modules, g_strdup (name), module);
102 seat_new (const gchar *module_name)
105 SeatModule *m = NULL;
107 g_return_val_if_fail (module_name != NULL, NULL);
110 m = g_hash_table_lookup (seat_modules, module_name);
114 seat = g_object_new (m->type, NULL);
120 seat_set_property (Seat *seat, const gchar *name, const gchar *value)
122 g_return_if_fail (seat != NULL);
123 g_hash_table_insert (seat->priv->properties, g_strdup (name), g_strdup (value));
127 seat_get_string_property (Seat *seat, const gchar *name)
129 g_return_val_if_fail (seat != NULL, NULL);
130 return g_hash_table_lookup (seat->priv->properties, name);
134 seat_get_string_list_property (Seat *seat, const gchar *name)
136 g_return_val_if_fail (seat != NULL, NULL);
137 return g_strsplit (g_hash_table_lookup (seat->priv->properties, name), ";", 0);
141 seat_get_boolean_property (Seat *seat, const gchar *name)
143 return g_strcmp0 (seat_get_string_property (seat, name), "true") == 0;
147 seat_get_integer_property (Seat *seat, const gchar *name)
151 value = seat_get_string_property (seat, name);
152 return value ? atoi (value) : 0;
156 seat_get_name (Seat *seat)
160 name = seat_get_string_property (seat, "xdg-seat");
168 seat_set_supports_multi_session (Seat *seat, gboolean supports_multi_session)
170 g_return_if_fail (seat != NULL);
171 seat->priv->supports_multi_session = supports_multi_session;
175 seat_set_share_display_server (Seat *seat, gboolean share_display_server)
177 g_return_if_fail (seat != NULL);
178 seat->priv->share_display_server = share_display_server;
182 seat_start (Seat *seat)
184 g_return_val_if_fail (seat != NULL, FALSE);
186 l_debug (seat, "Starting");
188 SEAT_GET_CLASS (seat)->setup (seat);
189 seat->priv->started = SEAT_GET_CLASS (seat)->start (seat);
191 return seat->priv->started;
195 seat_get_sessions (Seat *seat)
197 g_return_val_if_fail (seat != NULL, NULL);
198 return seat->priv->sessions;
202 set_greeter_idle (gpointer greeter)
204 greeter_idle (GREETER (greeter));
209 seat_set_active_session (Seat *seat, Session *session)
213 g_return_if_fail (seat != NULL);
215 SEAT_GET_CLASS (seat)->set_active_session (seat, session);
217 /* Stop any greeters */
218 for (link = seat->priv->sessions; link; link = link->next)
220 Session *s = link->data;
222 if (s == session || session_get_is_stopping (s))
227 Greeter *greeter = GREETER (s);
228 if (greeter_get_resettable (greeter))
230 if (seat->priv->active_session == SESSION (greeter))
232 l_debug (seat, "Idling greeter");
233 /* Do this in an idle callback, because we might very well
234 be in the middle of responding to a START_SESSION
235 request by a greeter. So they won't expect an IDLE
236 call during that. Plus, this isn't time-sensitive. */
237 g_idle_add (set_greeter_idle, greeter);
242 l_debug (seat, "Stopping greeter");
248 /* Lock previous sessions */
249 if (seat->priv->active_session)
251 if (session != seat->priv->active_session && !IS_GREETER (seat->priv->active_session))
252 session_lock (seat->priv->active_session);
253 g_object_unref (seat->priv->active_session);
256 session_activate (session);
257 seat->priv->active_session = g_object_ref (session);
261 seat_get_active_session (Seat *seat)
263 g_return_val_if_fail (seat != NULL, NULL);
264 return SEAT_GET_CLASS (seat)->get_active_session (seat);
268 seat_get_next_session (Seat *seat)
270 g_return_val_if_fail (seat != NULL, NULL);
271 return seat->priv->next_session;
275 seat_get_can_switch (Seat *seat)
277 g_return_val_if_fail (seat != NULL, FALSE);
278 return seat_get_boolean_property (seat, "allow-user-switching") && seat->priv->supports_multi_session;
282 seat_get_allow_guest (Seat *seat)
284 g_return_val_if_fail (seat != NULL, FALSE);
285 return seat_get_boolean_property (seat, "allow-guest") && guest_account_is_installed ();
289 run_script (Seat *seat, DisplayServer *display_server, const gchar *script_name, User *user)
292 gboolean result = FALSE;
294 script = process_new (NULL, NULL);
296 process_set_command (script, script_name);
298 /* Set POSIX variables */
299 process_set_clear_environment (script, TRUE);
300 process_set_env (script, "SHELL", "/bin/sh");
302 /* Variables required for regression tests */
303 if (g_getenv ("LIGHTDM_TEST_ROOT"))
305 process_set_env (script, "LIGHTDM_TEST_ROOT", g_getenv ("LIGHTDM_TEST_ROOT"));
306 process_set_env (script, "LD_PRELOAD", g_getenv ("LD_PRELOAD"));
307 process_set_env (script, "LD_LIBRARY_PATH", g_getenv ("LD_LIBRARY_PATH"));
308 process_set_env (script, "PATH", g_getenv ("PATH"));
311 process_set_env (script, "PATH", "/usr/local/bin:/usr/bin:/bin");
315 process_set_env (script, "USER", user_get_name (user));
316 process_set_env (script, "LOGNAME", user_get_name (user));
317 process_set_env (script, "HOME", user_get_home_directory (user));
320 process_set_env (script, "HOME", "/");
322 SEAT_GET_CLASS (seat)->run_script (seat, display_server, script);
324 if (process_start (script, TRUE))
328 exit_status = process_get_exit_status (script);
329 if (WIFEXITED (exit_status))
331 l_debug (seat, "Exit status of %s: %d", script_name, WEXITSTATUS (exit_status));
332 result = WEXITSTATUS (exit_status) == EXIT_SUCCESS;
336 g_object_unref (script);
342 seat_real_run_script (Seat *seat, DisplayServer *display_server, Process *process)
347 emit_upstart_signal (const gchar *signal)
349 g_return_if_fail (signal != NULL);
350 g_return_if_fail (signal[0] != 0);
355 gchar *cmd = g_strdup_printf ("initctl -q emit %s DISPLAY_MANAGER=lightdm", signal);
356 g_spawn_command_line_async (cmd, NULL); /* OK if it fails, probably not installed */
361 check_stopped (Seat *seat)
363 if (seat->priv->stopping &&
364 !seat->priv->stopped &&
365 g_list_length (seat->priv->display_servers) == 0 &&
366 g_list_length (seat->priv->sessions) == 0)
368 seat->priv->stopped = TRUE;
369 l_debug (seat, "Stopped");
370 g_signal_emit (seat, signals[STOPPED], 0);
375 display_server_stopped_cb (DisplayServer *display_server, Seat *seat)
379 Session *active_session;
381 l_debug (seat, "Display server stopped");
383 /* Run a script right after stopping the display server */
384 script = seat_get_string_property (seat, "display-stopped-script");
386 run_script (seat, NULL, script, NULL);
388 g_signal_handlers_disconnect_matched (display_server, G_SIGNAL_MATCH_DATA, 0, 0, NULL, NULL, seat);
389 seat->priv->display_servers = g_list_remove (seat->priv->display_servers, display_server);
391 if (seat->priv->stopping || !seat->priv->started)
393 check_stopped (seat);
394 g_object_unref (display_server);
398 /* Stop all sessions on this display server */
399 list = g_list_copy (seat->priv->sessions);
400 for (link = list; link; link = link->next)
401 g_object_ref (link->data);
402 for (link = list; link; link = link->next)
404 Session *session = link->data;
406 if (session_get_display_server (session) != display_server || session_get_is_stopping (session))
409 /* Stop seat if this is the only display server and it failed to start a greeter */
410 if (IS_GREETER (session) &&
411 !session_get_is_started (session) &&
412 g_list_length (seat->priv->display_servers) == 0)
414 l_debug (seat, "Stopping; greeter display server failed to start");
418 l_debug (seat, "Stopping session");
419 session_stop (session);
421 g_list_free_full (list, g_object_unref);
423 if (!seat->priv->stopping)
425 /* If we were the active session, switch to a greeter */
426 active_session = seat_get_active_session (seat);
427 if (!active_session || session_get_display_server (active_session) == display_server)
429 l_debug (seat, "Active display server stopped, starting greeter");
430 if (!seat_switch_to_greeter (seat))
432 l_debug (seat, "Stopping; failed to start a greeter");
438 g_object_unref (display_server);
442 can_share_display_server (Seat *seat, DisplayServer *display_server)
444 return seat->priv->share_display_server && display_server_get_can_share (display_server);
448 find_greeter_session (Seat *seat)
452 for (link = seat->priv->sessions; link; link = link->next)
454 Session *session = link->data;
455 if (!session_get_is_stopping (session) && IS_GREETER (session))
456 return GREETER (session);
463 find_resettable_greeter (Seat *seat)
467 for (link = seat->priv->sessions; link; link = link->next)
469 Session *session = link->data;
470 if (!session_get_is_stopping (session) && IS_GREETER (session) &&
471 greeter_get_resettable (GREETER (session)))
472 return GREETER (session);
479 set_greeter_hints (Seat *seat, Greeter *greeter_session)
481 greeter_clear_hints (greeter_session);
482 greeter_set_hint (greeter_session, "default-session", seat_get_string_property (seat, "user-session"));
483 greeter_set_hint (greeter_session, "hide-users", seat_get_boolean_property (seat, "greeter-hide-users") ? "true" : "false");
484 greeter_set_hint (greeter_session, "show-manual-login", seat_get_boolean_property (seat, "greeter-show-manual-login") ? "true" : "false");
485 greeter_set_hint (greeter_session, "show-remote-login", seat_get_boolean_property (seat, "greeter-show-remote-login") ? "true" : "false");
486 greeter_set_hint (greeter_session, "has-guest-account", seat_get_allow_guest (seat) && seat_get_boolean_property (seat, "greeter-allow-guest") ? "true" : "false");
490 switch_to_greeter_from_failed_session (Seat *seat, Session *session)
492 Greeter *greeter_session;
493 gboolean existing = FALSE;
495 /* Switch to greeter if one open */
496 greeter_session = find_resettable_greeter (seat);
499 l_debug (seat, "Switching to existing greeter");
500 set_greeter_hints (seat, greeter_session);
505 greeter_session = create_greeter_session (seat);
508 if (session_get_is_guest (session))
509 greeter_set_hint (greeter_session, "select-guest", "true");
511 greeter_set_hint (greeter_session, "select-user", session_get_username (session));
515 greeter_reset (greeter_session);
516 seat_set_active_session (seat, SESSION (greeter_session));
520 if (seat->priv->session_to_activate)
521 g_object_unref (seat->priv->session_to_activate);
522 seat->priv->session_to_activate = g_object_ref (greeter_session);
524 if (can_share_display_server (seat, session_get_display_server (session)))
525 session_set_display_server (SESSION (greeter_session), session_get_display_server (session));
528 DisplayServer *display_server;
530 display_server = create_display_server (seat, session);
531 session_set_display_server (session, display_server);
532 if (!display_server_start (display_server))
534 l_debug (seat, "Failed to start display server for greeter");
539 start_session (seat, SESSION (greeter_session));
542 /* Stop failed session */
543 session_stop (session);
547 start_session (Seat *seat, Session *session)
549 /* Use system location for greeter log file */
550 if (IS_GREETER (session))
552 gchar *log_dir, *filename, *log_filename;
554 log_dir = config_get_string (config_get_instance (), "LightDM", "log-directory");
555 filename = g_strdup_printf ("%s-greeter.log", display_server_get_name (session_get_display_server (session)));
556 log_filename = g_build_filename (log_dir, filename, NULL);
559 session_set_log_file (session, log_filename);
560 g_free (log_filename);
563 if (session_start (session))
566 if (IS_GREETER (session))
568 l_debug (seat, "Failed to start greeter");
569 display_server_stop (session_get_display_server (session));
573 l_debug (seat, "Failed to start session, starting greeter");
574 switch_to_greeter_from_failed_session (seat, session);
578 run_session (Seat *seat, Session *session)
582 if (IS_GREETER (session))
583 script = seat_get_string_property (seat, "greeter-setup-script");
585 script = seat_get_string_property (seat, "session-setup-script");
586 if (script && !run_script (seat, session_get_display_server (session), script, session_get_user (session)))
588 l_debug (seat, "Switching to greeter due to failed setup script");
589 switch_to_greeter_from_failed_session (seat, session);
593 if (!IS_GREETER (session))
595 g_signal_emit (seat, signals[RUNNING_USER_SESSION], 0, session);
596 emit_upstart_signal ("desktop-session-start");
599 session_run (session);
601 // FIXME: Wait until the session is ready
603 if (session == seat->priv->session_to_activate)
605 seat_set_active_session (seat, session);
606 g_object_unref (seat->priv->session_to_activate);
607 seat->priv->session_to_activate = NULL;
609 else if (seat->priv->active_session)
611 /* Multiple sessions can theoretically be on the same VT (especially
612 if using Mir). If a new session appears on an existing active VT,
613 logind will mark it as active, while ConsoleKit will re-mark the
614 oldest session as active. In either case, that may not be the
615 session that we want to be active. So let's be explicit and
616 re-activate the correct session whenever a new session starts.
617 There's no harm to do this in seats that enforce separate VTs. */
618 session_activate (seat->priv->active_session);
623 find_user_session (Seat *seat, const gchar *username, Session *ignore_session)
630 for (link = seat->priv->sessions; link; link = link->next)
632 Session *session = link->data;
634 if (session == ignore_session)
637 if (!session_get_is_stopping (session) && g_strcmp0 (session_get_username (session), username) == 0)
645 greeter_active_username_changed_cb (Greeter *greeter, GParamSpec *pspec, Seat *seat)
649 session = find_user_session (seat, greeter_get_active_username (greeter), seat->priv->active_session);
651 if (seat->priv->next_session)
652 g_object_unref (seat->priv->next_session);
653 seat->priv->next_session = session ? g_object_ref (session) : NULL;
655 SEAT_GET_CLASS (seat)->set_next_session (seat, session);
659 session_authentication_complete_cb (Session *session, Seat *seat)
661 if (session_get_is_authenticated (session))
665 s = find_user_session (seat, session_get_username (session), session);
668 l_debug (seat, "Session authenticated, switching to existing user session");
669 seat_set_active_session (seat, s);
670 session_stop (session);
674 l_debug (seat, "Session authenticated, running command");
675 run_session (seat, session);
678 else if (!IS_GREETER (session))
680 l_debug (seat, "Switching to greeter due to failed authentication");
681 switch_to_greeter_from_failed_session (seat, session);
685 l_debug (seat, "Stopping session that failed authentication");
686 session_stop (session);
691 session_stopped_cb (Session *session, Seat *seat)
693 DisplayServer *display_server;
695 l_debug (seat, "Session stopped");
697 g_signal_handlers_disconnect_matched (session, G_SIGNAL_MATCH_DATA, 0, 0, NULL, NULL, seat);
698 seat->priv->sessions = g_list_remove (seat->priv->sessions, session);
699 if (session == seat->priv->active_session)
701 g_object_unref (seat->priv->active_session);
702 seat->priv->active_session = NULL;
704 if (session == seat->priv->next_session)
706 g_object_unref (seat->priv->next_session);
707 seat->priv->next_session = NULL;
709 if (session == seat->priv->session_to_activate)
711 g_object_unref (seat->priv->session_to_activate);
712 seat->priv->session_to_activate = NULL;
715 display_server = session_get_display_server (session);
718 g_object_unref (session);
723 if (!IS_GREETER (session))
726 script = seat_get_string_property (seat, "session-cleanup-script");
728 run_script (seat, display_server, script, session_get_user (session));
731 /* We were waiting for this session, but it didn't start :( */
732 // FIXME: Start a greeter on this?
733 if (session == seat->priv->session_to_activate)
735 g_object_unref (seat->priv->session_to_activate);
736 seat->priv->session_to_activate = NULL;
739 if (seat->priv->stopping)
741 check_stopped (seat);
742 g_object_unref (session);
746 /* If this is the greeter session then re-use this display server */
747 if (IS_GREETER (session) &&
748 can_share_display_server (seat, display_server) &&
749 greeter_get_start_session (GREETER (session)))
753 for (link = seat->priv->sessions; link; link = link->next)
755 Session *s = link->data;
757 /* Skip this session and sessions on other display servers */
758 if (s == session || session_get_display_server (s) != display_server || session_get_is_stopping (s))
761 if (session_get_is_authenticated (s))
763 l_debug (seat, "Greeter stopped, running session");
764 run_session (seat, s);
768 l_debug (seat, "Greeter stopped, starting session authentication");
769 start_session (seat, s);
774 /* If this is the greeter and nothing else is running then stop the seat */
775 else if (IS_GREETER (session) &&
776 !greeter_get_start_session (GREETER (session)) &&
777 g_list_length (seat->priv->display_servers) == 1 &&
778 g_list_nth_data (seat->priv->display_servers, 0) == display_server)
780 l_debug (seat, "Stopping; failed to start a greeter");
783 /* If we were the active session, switch to a greeter */
784 else if (!IS_GREETER (session) && session == seat_get_active_session (seat))
786 l_debug (seat, "Active session stopped, starting greeter");
787 if (!seat_switch_to_greeter (seat))
789 l_debug (seat, "Stopping; failed to start a greeter");
794 /* Stop the display server if no-longer required */
795 if (display_server && !display_server_get_is_stopping (display_server))
800 for (link = seat->priv->sessions; link; link = link->next)
802 Session *s = link->data;
805 if (session_get_display_server (s) == display_server)
810 l_debug (seat, "Stopping display server, no sessions require it");
811 display_server_stop (display_server);
815 g_signal_emit (seat, signals[SESSION_REMOVED], 0, session);
816 g_object_unref (session);
820 set_session_env (Session *session)
822 /* Connect using the session bus */
825 if (g_getenv ("DBUS_SESSION_BUS_ADDRESS"))
826 session_set_env (session, "DBUS_SESSION_BUS_ADDRESS", g_getenv ("DBUS_SESSION_BUS_ADDRESS"));
827 session_set_env (session, "LDM_BUS", "SESSION");
828 if (g_getenv ("LD_PRELOAD"))
829 session_set_env (session, "LD_PRELOAD", g_getenv ("LD_PRELOAD"));
830 if (g_getenv ("LD_LIBRARY_PATH"))
831 session_set_env (session, "LD_LIBRARY_PATH", g_getenv ("LD_LIBRARY_PATH"));
832 if (g_getenv ("PATH"))
833 session_set_env (session, "PATH", g_getenv ("PATH"));
836 /* Variables required for regression tests */
837 if (g_getenv ("LIGHTDM_TEST_ROOT"))
839 session_set_env (session, "LIGHTDM_TEST_ROOT", g_getenv ("LIGHTDM_TEST_ROOT"));
840 session_set_env (session, "DBUS_SYSTEM_BUS_ADDRESS", g_getenv ("DBUS_SYSTEM_BUS_ADDRESS"));
841 session_set_env (session, "DBUS_SESSION_BUS_ADDRESS", g_getenv ("DBUS_SESSION_BUS_ADDRESS"));
842 session_set_env (session, "LD_PRELOAD", g_getenv ("LD_PRELOAD"));
843 session_set_env (session, "LD_LIBRARY_PATH", g_getenv ("LD_LIBRARY_PATH"));
844 session_set_env (session, "GI_TYPELIB_PATH", g_getenv ("GI_TYPELIB_PATH"));
849 create_session (Seat *seat, gboolean autostart)
853 session = SEAT_GET_CLASS (seat)->create_session (seat);
854 seat->priv->sessions = g_list_append (seat->priv->sessions, session);
856 g_signal_connect (session, "authentication-complete", G_CALLBACK (session_authentication_complete_cb), seat);
857 g_signal_connect (session, "stopped", G_CALLBACK (session_stopped_cb), seat);
859 set_session_env (session);
861 g_signal_emit (seat, signals[SESSION_ADDED], 0, session);
867 get_session_argv (Seat *seat, SessionConfig *session_config, const gchar *session_wrapper)
872 GError *error = NULL;
874 /* If configured, run sessions through a wrapper */
877 argv = g_malloc (sizeof (gchar *) * 3);
878 path = g_find_program_in_path (session_wrapper);
879 argv[0] = path ? path : g_strdup (session_wrapper);
880 argv[1] = g_strdup (session_config_get_command (session_config));
885 /* Split command into an array listing and make command absolute */
886 result = g_shell_parse_argv (session_config_get_command (session_config), &argc, &argv, &error);
888 l_debug (seat, "Invalid session command '%s': %s", session_config_get_command (session_config), error->message);
889 g_clear_error (&error);
892 path = g_find_program_in_path (argv[0]);
902 static SessionConfig *
903 find_session_config (Seat *seat, const gchar *sessions_dir, const gchar *session_name)
906 SessionConfig *session_config = NULL;
908 GError *error = NULL;
910 g_return_val_if_fail (sessions_dir != NULL, NULL);
911 g_return_val_if_fail (session_name != NULL, NULL);
913 dirs = g_strsplit (sessions_dir, ":", -1);
914 for (i = 0; dirs[i]; i++)
916 gchar *filename, *path;
918 filename = g_strdup_printf ("%s.desktop", session_name);
919 path = g_build_filename (dirs[i], filename, NULL);
921 session_config = session_config_new_from_file (path, &error);
926 if (dirs[i+1] == NULL)
927 l_debug (seat, "Failed to find session configuration %s", session_name);
928 g_clear_error (&error);
932 return session_config;
936 configure_session (Session *session, SessionConfig *config, const gchar *session_name, const gchar *language)
938 const gchar *desktop_name;
940 session_set_config (session, config);
941 session_set_env (session, "XDG_SESSION_DESKTOP", session_name);
942 session_set_env (session, "DESKTOP_SESSION", session_name);
943 session_set_env (session, "GDMSESSION", session_name);
944 desktop_name = session_config_get_desktop_name (config);
946 session_set_env (session, "XDG_CURRENT_DESKTOP", desktop_name);
947 if (language && language[0] != '\0')
949 session_set_env (session, "LANG", language);
950 session_set_env (session, "GDM_LANG", language);
955 create_user_session (Seat *seat, const gchar *username, gboolean autostart)
959 const gchar *session_name, *language;
960 SessionConfig *session_config;
961 Session *session = NULL;
963 l_debug (seat, "Creating user session");
965 /* Load user preferences */
966 user = accounts_get_user_by_name (username);
969 l_debug (seat, "Can't login unknown user '%s'", username);
972 session_name = user_get_xsession (user);
973 language = user_get_language (user);
976 session_name = seat_get_string_property (seat, "user-session");
977 sessions_dir = config_get_string (config_get_instance (), "LightDM", "sessions-directory");
978 session_config = find_session_config (seat, sessions_dir, session_name);
979 g_free (sessions_dir);
984 session = create_session (seat, autostart);
985 configure_session (session, session_config, session_name, language);
986 session_set_username (session, username);
987 session_set_do_authenticate (session, TRUE);
988 argv = get_session_argv (seat, session_config, seat_get_string_property (seat, "session-wrapper"));
989 session_set_argv (session, argv);
991 g_object_unref (session_config);
994 l_debug (seat, "Can't find session '%s'", session_name);
996 g_object_unref (user);
1002 prepend_argv (gchar ***argv, const gchar *value)
1004 gchar **old_argv, **new_argv;
1008 new_argv = g_malloc (sizeof (gchar *) * (g_strv_length (*argv) + 2));
1009 new_argv[0] = g_strdup (value);
1010 for (i = 0; old_argv[i]; i++)
1011 new_argv[i + 1] = old_argv[i];
1012 new_argv[i + 1] = NULL;
1019 create_guest_session (Seat *seat, const gchar *session_name)
1021 const gchar *guest_wrapper;
1022 gchar *sessions_dir, **argv;
1023 SessionConfig *session_config;
1027 session_name = seat_get_string_property (seat, "guest-session");
1029 session_name = seat_get_string_property (seat, "user-session");
1030 sessions_dir = config_get_string (config_get_instance (), "LightDM", "sessions-directory");
1031 session_config = find_session_config (seat, sessions_dir, session_name);
1032 g_free (sessions_dir);
1033 if (!session_config)
1035 l_debug (seat, "Can't find session '%s'", session_name);
1039 session = create_session (seat, TRUE);
1040 configure_session (session, session_config, session_name, NULL);
1041 session_set_do_authenticate (session, TRUE);
1042 session_set_is_guest (session, TRUE);
1043 argv = get_session_argv (seat, session_config, seat_get_string_property (seat, "session-wrapper"));
1044 guest_wrapper = seat_get_string_property (seat, "guest-wrapper");
1048 path = g_find_program_in_path (guest_wrapper);
1049 prepend_argv (&argv, path ? path : guest_wrapper);
1053 session_set_argv (session, argv);
1055 g_object_unref (session_config);
1061 greeter_create_session_cb (Greeter *greeter, Seat *seat)
1065 session = create_session (seat, FALSE);
1066 session_set_config (session, session_get_config (SESSION (greeter)));
1067 session_set_display_server (session, session_get_display_server (SESSION (greeter)));
1069 return g_object_ref (session);
1073 greeter_start_session_cb (Greeter *greeter, SessionType type, const gchar *session_name, Seat *seat)
1075 Session *session, *existing_session;
1076 const gchar *username;
1077 DisplayServer *display_server;
1079 /* Get the session to use */
1080 if (greeter_get_guest_authenticated (greeter))
1082 session = create_guest_session (seat, session_name);
1085 session_set_pam_service (session, seat_get_string_property (seat, "pam-autologin-service"));
1089 const gchar *language = NULL;
1090 SessionConfig *session_config;
1092 gchar *sessions_dir = NULL;
1095 session = greeter_get_authentication_session (greeter);
1097 /* Get session command to run */
1100 case SESSION_TYPE_LOCAL:
1101 sessions_dir = config_get_string (config_get_instance (), "LightDM", "sessions-directory");
1103 case SESSION_TYPE_REMOTE:
1104 sessions_dir = config_get_string (config_get_instance (), "LightDM", "remote-sessions-directory");
1108 /* Load user preferences */
1109 user = session_get_user (session);
1113 session_name = user_get_xsession (user);
1114 language = user_get_language (user);
1118 session_name = seat_get_string_property (seat, "user-session");
1120 user_set_xsession (session_get_user (session), session_name);
1122 session_config = find_session_config (seat, sessions_dir, session_name);
1123 g_free (sessions_dir);
1124 if (!session_config)
1126 l_debug (seat, "Can't find session '%s'", session_name);
1130 configure_session (session, session_config, session_name, language);
1131 argv = get_session_argv (seat, session_config, seat_get_string_property (seat, "session-wrapper"));
1132 session_set_argv (session, argv);
1134 g_object_unref (session_config);
1137 /* Switch to this session when it is ready */
1138 if (seat->priv->session_to_activate)
1139 g_object_unref (seat->priv->session_to_activate);
1140 seat->priv->session_to_activate = g_object_ref (session);
1142 /* Return to existing session if it is open */
1143 username = session_get_username (session);
1144 existing_session = find_user_session (seat, username, NULL);
1145 if (existing_session && session != existing_session)
1147 l_debug (seat, "Returning to existing user session %s", username);
1148 session_stop (session);
1149 session_unlock (existing_session);
1150 seat_set_active_session (seat, existing_session);
1154 /* If can re-use the display server, stop the greeter first */
1155 display_server = session_get_display_server (SESSION (greeter));
1156 if (!greeter_get_resettable (greeter) &&
1157 can_share_display_server (seat, display_server) &&
1158 strcmp (display_server_get_session_type (display_server), session_get_session_type (session)) == 0)
1160 l_debug (seat, "Stopping greeter; display server will be re-used for user session");
1162 /* Run on the same display server after the greeter has stopped */
1163 session_set_display_server (session, display_server);
1165 /* Stop the greeter */
1166 session_stop (SESSION (greeter));
1170 /* Otherwise start a new display server for this session */
1173 display_server = create_display_server (seat, session);
1174 session_set_display_server (session, display_server);
1175 if (!display_server_start (display_server))
1177 l_debug (seat, "Failed to start display server for new session");
1186 create_greeter_session (Seat *seat)
1188 gchar *sessions_dir, **argv;
1189 SessionConfig *session_config;
1190 Greeter *greeter_session;
1191 const gchar *greeter_wrapper;
1192 const gchar *autologin_username;
1193 int autologin_timeout;
1194 gboolean autologin_guest;
1196 l_debug (seat, "Creating greeter session");
1198 sessions_dir = config_get_string (config_get_instance (), "LightDM", "greeters-directory");
1199 session_config = find_session_config (seat, sessions_dir, seat_get_string_property (seat, "greeter-session"));
1200 g_free (sessions_dir);
1201 if (!session_config)
1204 argv = get_session_argv (seat, session_config, NULL);
1205 greeter_wrapper = seat_get_string_property (seat, "greeter-wrapper");
1206 if (greeter_wrapper)
1209 path = g_find_program_in_path (greeter_wrapper);
1210 prepend_argv (&argv, path ? path : greeter_wrapper);
1214 greeter_session = SEAT_GET_CLASS (seat)->create_greeter_session (seat);
1215 session_set_config (SESSION (greeter_session), session_config);
1216 seat->priv->sessions = g_list_append (seat->priv->sessions, SESSION (greeter_session));
1217 g_signal_connect (greeter_session, "notify::active-username", G_CALLBACK (greeter_active_username_changed_cb), seat);
1218 g_signal_connect (greeter_session, "authentication-complete", G_CALLBACK (session_authentication_complete_cb), seat);
1219 g_signal_connect (greeter_session, "stopped", G_CALLBACK (session_stopped_cb), seat);
1221 set_session_env (SESSION (greeter_session));
1222 session_set_env (SESSION (greeter_session), "XDG_SESSION_CLASS", "greeter");
1224 session_set_pam_service (SESSION (greeter_session), seat_get_string_property (seat, "pam-greeter-service"));
1227 gchar *greeter_user;
1228 greeter_user = config_get_string (config_get_instance (), "LightDM", "greeter-user");
1229 session_set_username (SESSION (greeter_session), greeter_user);
1230 g_free (greeter_user);
1234 /* In test mode run the greeter as ourself */
1235 session_set_username (SESSION (greeter_session), user_get_name (accounts_get_current_user ()));
1237 session_set_argv (SESSION (greeter_session), argv);
1240 greeter_set_pam_services (greeter_session,
1241 seat_get_string_property (seat, "pam-service"),
1242 seat_get_string_property (seat, "pam-autologin-service"));
1243 g_signal_connect (greeter_session, "create-session", G_CALLBACK (greeter_create_session_cb), seat);
1244 g_signal_connect (greeter_session, "start-session", G_CALLBACK (greeter_start_session_cb), seat);
1246 /* Set hints to greeter */
1247 greeter_set_allow_guest (greeter_session, seat_get_allow_guest (seat));
1248 set_greeter_hints (seat, greeter_session);
1250 /* Configure for automatic login */
1251 autologin_username = seat_get_string_property (seat, "autologin-user");
1252 if (g_strcmp0 (autologin_username, "") == 0)
1253 autologin_username = NULL;
1254 autologin_timeout = seat_get_integer_property (seat, "autologin-user-timeout");
1255 autologin_guest = seat_get_boolean_property (seat, "autologin-guest");
1256 if (autologin_timeout > 0)
1260 value = g_strdup_printf ("%d", autologin_timeout);
1261 greeter_set_hint (greeter_session, "autologin-timeout", value);
1263 if (autologin_username)
1264 greeter_set_hint (greeter_session, "autologin-user", autologin_username);
1265 if (autologin_guest)
1266 greeter_set_hint (greeter_session, "autologin-guest", "true");
1269 g_object_unref (session_config);
1271 return greeter_session;
1275 find_session_for_display_server (Seat *seat, DisplayServer *display_server)
1279 for (link = seat->priv->sessions; link; link = link->next)
1281 Session *session = link->data;
1282 if (session_get_display_server (session) == display_server && !session_get_is_stopping (session))
1290 display_server_ready_cb (DisplayServer *display_server, Seat *seat)
1292 const gchar *script;
1295 /* Run setup script */
1296 script = seat_get_string_property (seat, "display-setup-script");
1297 if (script && !run_script (seat, display_server, script, NULL))
1299 l_debug (seat, "Stopping display server due to failed setup script");
1300 display_server_stop (display_server);
1304 emit_upstart_signal ("login-session-start");
1306 /* Start the session waiting for this display server */
1307 session = find_session_for_display_server (seat, display_server);
1310 if (session_get_is_authenticated (session))
1312 l_debug (seat, "Display server ready, running session");
1313 run_session (seat, session);
1317 l_debug (seat, "Display server ready, starting session authentication");
1318 start_session (seat, session);
1323 l_debug (seat, "Stopping not required display server");
1324 display_server_stop (display_server);
1328 static DisplayServer *
1329 create_display_server (Seat *seat, Session *session)
1331 DisplayServer *display_server;
1333 l_debug (seat, "Creating display server of type %s", session_get_session_type (session));
1335 display_server = SEAT_GET_CLASS (seat)->create_display_server (seat, session);
1336 if (!display_server)
1339 seat->priv->display_servers = g_list_append (seat->priv->display_servers, display_server);
1340 g_signal_connect (display_server, "ready", G_CALLBACK (display_server_ready_cb), seat);
1341 g_signal_connect (display_server, "stopped", G_CALLBACK (display_server_stopped_cb), seat);
1343 return display_server;
1347 seat_switch_to_greeter (Seat *seat)
1349 Greeter *greeter_session;
1350 DisplayServer *display_server;
1352 g_return_val_if_fail (seat != NULL, FALSE);
1354 if (!seat_get_can_switch (seat))
1357 /* Switch to greeter if one open */
1358 greeter_session = find_greeter_session (seat);
1359 if (greeter_session)
1361 l_debug (seat, "Switching to existing greeter");
1362 seat_set_active_session (seat, SESSION (greeter_session));
1366 greeter_session = create_greeter_session (seat);
1367 if (!greeter_session)
1370 if (seat->priv->session_to_activate)
1371 g_object_unref (seat->priv->session_to_activate);
1372 seat->priv->session_to_activate = g_object_ref (greeter_session);
1374 display_server = create_display_server (seat, SESSION (greeter_session));
1375 session_set_display_server (SESSION (greeter_session), display_server);
1377 return display_server_start (display_server);
1381 switch_authentication_complete_cb (Session *session, Seat *seat)
1383 Greeter *greeter_session;
1384 DisplayServer *display_server;
1385 gboolean existing = FALSE;
1387 /* If authenticated, then unlock existing session or start new one */
1388 if (session_get_is_authenticated (session))
1392 s = find_user_session (seat, session_get_username (session), session);
1395 l_debug (seat, "Session authenticated, switching to existing user session");
1397 seat_set_active_session (seat, s);
1398 session_stop (session);
1402 l_debug (seat, "Session authenticated, starting display server");
1403 if (seat->priv->session_to_activate)
1404 g_object_unref (seat->priv->session_to_activate);
1405 seat->priv->session_to_activate = g_object_ref (session);
1406 display_server = create_display_server (seat, session);
1407 session_set_display_server (session, display_server);
1408 display_server_start (display_server);
1414 session_stop (session);
1416 /* See if we already have a greeter up and reuse it if so */
1417 greeter_session = find_resettable_greeter (seat);
1418 if (greeter_session)
1420 l_debug (seat, "Switching to existing greeter to authenticate session");
1421 set_greeter_hints (seat, greeter_session);
1426 l_debug (seat, "Starting greeter to authenticate session");
1427 greeter_session = create_greeter_session (seat);
1430 if (session_get_is_guest (session))
1431 greeter_set_hint (greeter_session, "select-guest", "true");
1433 greeter_set_hint (greeter_session, "select-user", session_get_username (session));
1437 greeter_reset (greeter_session);
1438 seat_set_active_session (seat, SESSION (greeter_session));
1442 if (seat->priv->session_to_activate)
1443 g_object_unref (seat->priv->session_to_activate);
1444 seat->priv->session_to_activate = g_object_ref (greeter_session);
1446 display_server = create_display_server (seat, SESSION (greeter_session));
1447 session_set_display_server (SESSION (greeter_session), display_server);
1448 display_server_start (display_server);
1453 seat_switch_to_user (Seat *seat, const gchar *username, const gchar *session_name)
1457 g_return_val_if_fail (seat != NULL, FALSE);
1458 g_return_val_if_fail (username != NULL, FALSE);
1460 if (!seat_get_can_switch (seat))
1463 /* If we're already on this session, then ignore */
1464 session = find_user_session (seat, username, NULL);
1465 if (session && session == seat->priv->active_session)
1468 l_debug (seat, "Switching to user %s", username);
1470 /* Attempt to authenticate them */
1471 session = create_user_session (seat, username, FALSE);
1472 g_signal_connect (session, "authentication-complete", G_CALLBACK (switch_authentication_complete_cb), seat);
1473 session_set_pam_service (session, seat_get_string_property (seat, "pam-service"));
1475 return session_start (session);
1479 find_guest_session (Seat *seat)
1483 for (link = seat->priv->sessions; link; link = link->next)
1485 Session *session = link->data;
1486 if (!session_get_is_stopping (session) && session_get_is_guest (session))
1494 seat_switch_to_guest (Seat *seat, const gchar *session_name)
1497 DisplayServer *display_server;
1499 g_return_val_if_fail (seat != NULL, FALSE);
1501 if (!seat_get_can_switch (seat) || !seat_get_allow_guest (seat))
1504 /* Switch to session if one open */
1505 session = find_guest_session (seat);
1508 l_debug (seat, "Switching to existing guest account %s", session_get_username (session));
1509 seat_set_active_session (seat, session);
1513 session = create_guest_session (seat, session_name);
1517 display_server = create_display_server (seat, session);
1519 if (seat->priv->session_to_activate)
1520 g_object_unref (seat->priv->session_to_activate);
1521 seat->priv->session_to_activate = g_object_ref (session);
1522 session_set_pam_service (session, seat_get_string_property (seat, "pam-autologin-service"));
1523 session_set_display_server (session, display_server);
1525 return display_server_start (display_server);
1529 seat_lock (Seat *seat, const gchar *username)
1531 Greeter *greeter_session;
1532 DisplayServer *display_server;
1533 gboolean existing = FALSE;
1535 g_return_val_if_fail (seat != NULL, FALSE);
1537 if (!seat_get_can_switch (seat))
1540 l_debug (seat, "Locking");
1542 /* Switch to greeter we can reuse */
1543 greeter_session = find_resettable_greeter (seat);
1544 if (greeter_session)
1546 l_debug (seat, "Switching to existing greeter");
1547 set_greeter_hints (seat, greeter_session);
1552 greeter_session = create_greeter_session (seat);
1553 if (!greeter_session)
1557 greeter_set_hint (greeter_session, "lock-screen", "true");
1559 greeter_set_hint (greeter_session, "select-user", username);
1563 greeter_reset (greeter_session);
1564 seat_set_active_session (seat, SESSION (greeter_session));
1569 display_server = create_display_server (seat, SESSION (greeter_session));
1571 if (seat->priv->session_to_activate)
1572 g_object_unref (seat->priv->session_to_activate);
1573 seat->priv->session_to_activate = g_object_ref (greeter_session);
1574 session_set_display_server (SESSION (greeter_session), display_server);
1576 return display_server_start (display_server);
1581 seat_stop (Seat *seat)
1583 g_return_if_fail (seat != NULL);
1585 if (seat->priv->stopping)
1588 l_debug (seat, "Stopping");
1589 seat->priv->stopping = TRUE;
1590 SEAT_GET_CLASS (seat)->stop (seat);
1594 seat_get_is_stopping (Seat *seat)
1596 g_return_val_if_fail (seat != NULL, FALSE);
1597 return seat->priv->stopping;
1601 seat_real_setup (Seat *seat)
1606 seat_real_start (Seat *seat)
1608 const gchar *autologin_username;
1609 int autologin_timeout;
1610 gboolean autologin_guest;
1611 gboolean autologin_in_background;
1612 Session *session = NULL, *background_session = NULL;
1614 /* Get autologin settings */
1615 autologin_username = seat_get_string_property (seat, "autologin-user");
1616 if (g_strcmp0 (autologin_username, "") == 0)
1617 autologin_username = NULL;
1618 autologin_timeout = seat_get_integer_property (seat, "autologin-user-timeout");
1619 autologin_guest = seat_get_boolean_property (seat, "autologin-guest");
1620 autologin_in_background = seat_get_boolean_property (seat, "autologin-in-background");
1622 /* Autologin if configured */
1623 if (autologin_timeout == 0 || autologin_in_background)
1625 if (autologin_guest)
1626 session = create_guest_session (seat, NULL);
1627 else if (autologin_username != NULL)
1628 session = create_user_session (seat, autologin_username, TRUE);
1631 session_set_pam_service (session, seat_get_string_property (seat, "pam-autologin-service"));
1633 /* Load in background if required */
1634 if (autologin_in_background && session)
1636 background_session = session;
1642 DisplayServer *display_server;
1644 if (seat->priv->session_to_activate)
1645 g_object_unref (seat->priv->session_to_activate);
1646 seat->priv->session_to_activate = g_object_ref (session);
1648 display_server = create_display_server (seat, session);
1649 session_set_display_server (session, display_server);
1650 if (!display_server || !display_server_start (display_server))
1652 l_debug (seat, "Can't create display server for automatic login");
1653 session_stop (session);
1655 display_server_stop (display_server);
1661 /* Fallback to a greeter */
1664 Greeter *greeter_session;
1665 DisplayServer *display_server;
1667 greeter_session = create_greeter_session (seat);
1668 if (!greeter_session)
1670 l_debug (seat, "Failed to create greeter session");
1674 if (seat->priv->session_to_activate)
1675 g_object_unref (seat->priv->session_to_activate);
1676 seat->priv->session_to_activate = g_object_ref (greeter_session);
1677 session = SESSION (greeter_session);
1679 display_server = create_display_server (seat, session);
1680 session_set_display_server (session, display_server);
1681 if (!display_server || !display_server_start (display_server))
1683 l_debug (seat, "Can't create display server for greeter");
1684 session_stop (session);
1686 display_server_stop (display_server);
1691 /* Fail if can't start a session */
1698 /* Start background session */
1699 if (background_session)
1701 DisplayServer *background_display_server;
1703 background_display_server = create_display_server (seat, background_session);
1704 session_set_display_server (background_session, background_display_server);
1705 if (!display_server_start (background_display_server))
1706 l_warning (seat, "Failed to start display server for background session");
1713 seat_real_create_greeter_session (Seat *seat)
1715 return greeter_new ();
1719 seat_real_create_session (Seat *seat)
1721 return session_new ();
1725 seat_real_set_active_session (Seat *seat, Session *session)
1730 seat_real_set_next_session (Seat *seat, Session *session)
1735 seat_real_get_active_session (Seat *seat)
1741 seat_real_stop (Seat *seat)
1745 check_stopped (seat);
1746 if (seat->priv->stopped)
1749 /* Stop all the display servers and sessions on the seat. Copy the list as
1750 * it might be modified if a display server / session stops during this loop */
1751 list = g_list_copy (seat->priv->display_servers);
1752 for (link = list; link; link = link->next)
1753 g_object_ref (link->data);
1754 for (link = list; link; link = link->next)
1756 DisplayServer *display_server = link->data;
1757 if (!display_server_get_is_stopping (display_server))
1759 l_debug (seat, "Stopping display server");
1760 display_server_stop (display_server);
1763 g_list_free_full (list, g_object_unref);
1764 list = g_list_copy (seat->priv->sessions);
1765 for (link = list; link; link = link->next)
1766 g_object_ref (link->data);
1767 for (link = list; link; link = link->next)
1769 Session *session = link->data;
1770 if (!session_get_is_stopping (session))
1772 l_debug (seat, "Stopping session");
1773 session_stop (session);
1776 g_list_free_full (list, g_object_unref);
1780 seat_init (Seat *seat)
1782 seat->priv = G_TYPE_INSTANCE_GET_PRIVATE (seat, SEAT_TYPE, SeatPrivate);
1783 seat->priv->properties = g_hash_table_new_full (g_str_hash, g_str_equal, g_free, g_free);
1784 seat->priv->share_display_server = TRUE;
1788 seat_finalize (GObject *object)
1793 self = SEAT (object);
1795 g_hash_table_unref (self->priv->properties);
1796 for (link = self->priv->display_servers; link; link = link->next)
1798 DisplayServer *display_server = link->data;
1799 g_signal_handlers_disconnect_matched (display_server, G_SIGNAL_MATCH_DATA, 0, 0, NULL, NULL, self);
1801 g_list_free_full (self->priv->display_servers, g_object_unref);
1802 for (link = self->priv->sessions; link; link = link->next)
1804 Session *session = link->data;
1805 g_signal_handlers_disconnect_matched (session, G_SIGNAL_MATCH_DATA, 0, 0, NULL, NULL, self);
1807 g_list_free_full (self->priv->sessions, g_object_unref);
1808 if (self->priv->active_session)
1809 g_object_unref (self->priv->active_session);
1810 if (self->priv->next_session)
1811 g_object_unref (self->priv->next_session);
1812 if (self->priv->session_to_activate)
1813 g_object_unref (self->priv->session_to_activate);
1815 G_OBJECT_CLASS (seat_parent_class)->finalize (object);
1819 seat_class_init (SeatClass *klass)
1821 GObjectClass *object_class = G_OBJECT_CLASS (klass);
1823 klass->setup = seat_real_setup;
1824 klass->start = seat_real_start;
1825 klass->create_greeter_session = seat_real_create_greeter_session;
1826 klass->create_session = seat_real_create_session;
1827 klass->set_active_session = seat_real_set_active_session;
1828 klass->get_active_session = seat_real_get_active_session;
1829 klass->set_next_session = seat_real_set_next_session;
1830 klass->run_script = seat_real_run_script;
1831 klass->stop = seat_real_stop;
1833 object_class->finalize = seat_finalize;
1835 g_type_class_add_private (klass, sizeof (SeatPrivate));
1837 signals[SESSION_ADDED] =
1838 g_signal_new ("session-added",
1839 G_TYPE_FROM_CLASS (klass),
1841 G_STRUCT_OFFSET (SeatClass, session_added),
1844 G_TYPE_NONE, 1, SESSION_TYPE);
1845 signals[RUNNING_USER_SESSION] =
1846 g_signal_new ("running-user-session",
1847 G_TYPE_FROM_CLASS (klass),
1849 G_STRUCT_OFFSET (SeatClass, running_user_session),
1852 G_TYPE_NONE, 1, SESSION_TYPE);
1853 signals[SESSION_REMOVED] =
1854 g_signal_new ("session-removed",
1855 G_TYPE_FROM_CLASS (klass),
1857 G_STRUCT_OFFSET (SeatClass, session_removed),
1860 G_TYPE_NONE, 1, SESSION_TYPE);
1862 g_signal_new ("stopped",
1863 G_TYPE_FROM_CLASS (klass),
1865 G_STRUCT_OFFSET (SeatClass, stopped),
1872 seat_real_logprefix (Logger *self, gchar *buf, gulong buflen)
1874 Seat *seat = SEAT (self);
1875 const gchar *name = seat_get_string_property (seat, "seat-name");
1877 return g_snprintf (buf, buflen, "Seat %s: ", name);
1879 return g_snprintf (buf, buflen, "Seat: ");
1883 seat_logger_iface_init (LoggerInterface *iface)
1885 iface->logprefix = &seat_real_logprefix;