/* -*- mode: C; c-file-style: "gnu"; indent-tabs-mode: nil; -*- */ /* Metacity main() */ /* * Copyright (C) 2001 Havoc Pennington * Copyright (C) 2006 Elijah Newren * * 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 the Free Software Foundation; either version 2 of the * License, or (at your option) any later version. * * 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, see . */ /** * \file * Program startup. * Functions which parse the command-line arguments, create the display, * kick everything off and then close down Metacity when it's time to go. */ /** * \mainpage * Metacity - a boring window manager for the adult in you * * Many window managers are like Marshmallow Froot Loops; Metacity * is like Cheerios. * * The best way to get a handle on how the whole system fits together * is discussed in doc/code-overview.txt; if you're looking for functions * to investigate, read main(), meta_display_open(), and event_callback(). */ #define _GNU_SOURCE #define _XOPEN_SOURCE /* for putenv() and some signal-related functions */ #include #include "main.h" #include "util.h" #include "display-private.h" #include "errors.h" #include "meta-enum-types.h" #include "ui.h" #include "session.h" #include "prefs.h" #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include /** * Handle on the main loop, so that we have an easy way of shutting Metacity * down. */ static GMainLoop *meta_main_loop = NULL; /** * If set, Metacity will spawn an identical copy of itself immediately * before quitting. */ static gboolean meta_restart_after_quit = FALSE; static gboolean meta_shutdown_session = TRUE; /** * Prints the version notice. This is shown when Metacity is called * with the --version switch. */ static void version (void) { const int latest_year = 2009; char yearbuffer[256]; GDate date; /* this is all so the string to translate stays constant. * see how much we love the translators. */ g_date_set_dmy (&date, 1, G_DATE_JANUARY, latest_year); if (g_date_strftime (yearbuffer, sizeof (yearbuffer), "%Y", &date)==0) /* didn't work? fall back to decimal representation */ g_sprintf (yearbuffer, "%d", latest_year); g_print (_("metacity %s\n" "Copyright (C) 2001-%s Havoc Pennington, Red Hat, Inc., and others\n" "This is free software; see the source for copying conditions.\n" "There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.\n"), VERSION, yearbuffer); exit (0); } /** * Prints a list of which configure script options were used to * build this copy of Metacity. This is actually always called * on startup, but it's all no-op unless we're in verbose mode. */ static void meta_print_compilation_info (void) { #ifdef HAVE_XINERAMA meta_topic (META_DEBUG_XINERAMA, "Compiled with Xinerama extension\n"); #else meta_topic (META_DEBUG_XINERAMA, "Compiled without Xinerama extension\n"); #endif #ifdef HAVE_RANDR meta_verbose ("Compiled with randr extension\n"); #else meta_verbose ("Compiled without randr extension\n"); #endif #ifdef HAVE_STARTUP_NOTIFICATION meta_verbose ("Compiled with startup notification\n"); #else meta_verbose ("Compiled without startup notification\n"); #endif } /** * Prints the version number, the current timestamp (not the * build date), the locale, the character encoding, and a list * of configure script options that were used to build this * copy of Metacity. This is actually always called * on startup, but it's all no-op unless we're in verbose mode. */ static void meta_print_self_identity (void) { char buf[256]; GDate d; const char *charset; /* Version and current date. */ g_date_clear (&d, 1); g_date_set_time_t (&d, time (NULL)); g_date_strftime (buf, sizeof (buf), "%x", &d); meta_verbose ("Metacity version %s running on %s\n", VERSION, buf); /* Locale and encoding. */ g_get_charset (&charset); meta_verbose ("Running in locale \"%s\" with encoding \"%s\"\n", setlocale (LC_ALL, NULL), charset); /* Compilation settings. */ meta_print_compilation_info (); } /** * The set of possible options that can be set on Metacity's * command line. This type exists so that meta_parse_options() can * write to an instance of it. */ typedef struct { gchar *save_file; gchar *display_name; gchar *client_id; gboolean replace_wm; gboolean disable_sm; gboolean print_version; gboolean sync; gboolean composite; gboolean no_composite; gboolean no_force_fullscreen; MetaCompositorType compositor; gboolean compositor_set; } MetaArguments; static gboolean option_composite_cb (const char *option_name, const char *value, gpointer data, GError **error) { MetaArguments *args; args = data; args->composite = TRUE; g_warning (_("Option “%s” is deprecated, use the “--compositor” instead."), option_name); return TRUE; } static gboolean option_no_composite_cb (const char *option_name, const char *value, gpointer data, GError **error) { MetaArguments *args; args = data; args->no_composite = TRUE; g_warning (_("Option “%s” is deprecated, use the “--compositor” instead."), option_name); return TRUE; } static gboolean option_compositior_cb (const char *option_name, const char *value, gpointer data, GError **error) { MetaArguments *args; GEnumClass *enum_class; GEnumValue *enum_value; args = data; enum_class = g_type_class_ref (META_TYPE_COMPOSITOR_TYPE); enum_value = g_enum_get_value_by_nick (enum_class, value); if (enum_value == NULL) { g_type_class_unref (enum_class); g_set_error (error, G_OPTION_ERROR, G_OPTION_ERROR_FAILED, _("“%s” is not a valid compositor"), value); return FALSE; } args->compositor = enum_value->value; args->compositor_set = TRUE; g_type_class_unref (enum_class); return TRUE; } /** * Parses argc and argv and returns the * arguments that Metacity understands in meta_args. * * The strange call signature has to be written like it is so * that g_option_context_parse() gets a chance to modify argc and * argv. * * \param argc Pointer to the number of arguments Metacity was given * \param argv Pointer to the array of arguments Metacity was given * \param meta_args The result of parsing the arguments. **/ static void meta_parse_options (int *argc, char ***argv, MetaArguments *meta_args) { MetaArguments my_args = { 0 }; GOptionEntry options[] = { { "sm-disable", 0, 0, G_OPTION_ARG_NONE, &my_args.disable_sm, N_("Disable connection to session manager"), NULL }, { "replace", 0, 0, G_OPTION_ARG_NONE, &my_args.replace_wm, N_("Replace the running window manager with Metacity"), NULL }, { "sm-client-id", 0, 0, G_OPTION_ARG_STRING, &my_args.client_id, N_("Specify session management ID"), "ID" }, { "display", 'd', 0, G_OPTION_ARG_STRING, &my_args.display_name, N_("X Display to use"), "DISPLAY" }, { "sm-save-file", 0, 0, G_OPTION_ARG_FILENAME, &my_args.save_file, N_("Initialize session from savefile"), "FILE" }, { "version", 0, 0, G_OPTION_ARG_NONE, &my_args.print_version, N_("Print version"), NULL }, { "sync", 0, 0, G_OPTION_ARG_NONE, &my_args.sync, N_("Make X calls synchronous"), NULL }, { "composite", 'c', G_OPTION_FLAG_NO_ARG, G_OPTION_ARG_CALLBACK, option_composite_cb, N_("Turn compositing on"), NULL }, { "no-composite", 0, G_OPTION_FLAG_NO_ARG, G_OPTION_ARG_CALLBACK, option_no_composite_cb, N_("Turn compositing off"), NULL }, { "compositor", 0, G_OPTION_FLAG_NONE, G_OPTION_ARG_CALLBACK, option_compositior_cb, N_("Compositor to use"), "COMPOSITOR" }, { "no-force-fullscreen", 0, G_OPTION_ARG_NONE, G_OPTION_ARG_NONE, &my_args.no_force_fullscreen, N_("Don't make fullscreen windows that are maximized and have no decorations"), NULL }, {NULL} }; GOptionContext *ctx; GOptionGroup *group; GError *error = NULL; ctx = g_option_context_new (NULL); group = g_option_group_new (NULL, NULL, NULL, &my_args, NULL); g_option_context_set_main_group (ctx, group); g_option_context_add_main_entries (ctx, options, "metacity"); if (!g_option_context_parse (ctx, argc, argv, &error)) { g_print ("metacity: %s\n", error->message); exit(1); } g_option_context_free (ctx); /* Return the parsed options through the meta_args param. */ *meta_args = my_args; } /** * Selects which display Metacity should use. It first tries to use * display_name as the display. If display_name is NULL then * try to use the environment variable METACITY_DISPLAY. If that * also is NULL, use the default - :0.0 */ static void meta_select_display (gchar *display_name) { const gchar *env_var; if (display_name) env_var = (const gchar *) display_name; else env_var = g_getenv ("METACITY_DISPLAY"); if (env_var) { if (!g_setenv ("DISPLAY", env_var, TRUE)) g_warning ("Couldn't set DISPLAY"); } } static void meta_finalize (void) { MetaDisplay *display = meta_get_display(); if (display) { guint32 timestamp; timestamp = meta_display_get_current_time_roundtrip (display); meta_display_close (display, timestamp); } if (meta_shutdown_session) meta_session_shutdown (); } static gboolean sigterm_cb (gpointer user_data) { meta_quit (); return G_SOURCE_REMOVE; } static gboolean sigint_cb (gpointer user_data) { meta_shutdown_session = FALSE; meta_quit (); return G_SOURCE_REMOVE; } /** * This is where the story begins. It parses commandline options and * environment variables, sets up the screen, hands control off to * GTK, and cleans up afterwards. * * \param argc Number of arguments (as usual) * \param argv Array of arguments (as usual) * * \bug It's a bit long. It would be good to split it out into separate * functions. */ int main (int argc, char **argv) { struct sigaction act; sigset_t empty_mask; MetaArguments meta_args; if (setlocale (LC_ALL, "") == NULL) g_warning ("Locale not understood by C library, internationalization " "will not work"); sigemptyset (&empty_mask); act.sa_handler = SIG_IGN; act.sa_mask = empty_mask; act.sa_flags = 0; if (sigaction (SIGPIPE, &act, NULL) < 0) g_printerr ("Failed to register SIGPIPE handler: %s\n", g_strerror (errno)); #ifdef SIGXFSZ if (sigaction (SIGXFSZ, &act, NULL) < 0) g_printerr ("Failed to register SIGXFSZ handler: %s\n", g_strerror (errno)); #endif g_unix_signal_add (SIGTERM, sigterm_cb, NULL); g_unix_signal_add (SIGINT, sigint_cb, NULL); meta_init_debug (); if (g_getenv ("METACITY_DEBUG")) meta_set_debugging (TRUE); if (g_get_home_dir ()) { if (chdir (g_get_home_dir ()) < 0) g_warning ("Could not change to home directory %s.", g_get_home_dir ()); } meta_print_self_identity (); bindtextdomain (GETTEXT_PACKAGE, METACITY_LOCALEDIR); bind_textdomain_codeset (GETTEXT_PACKAGE, "UTF-8"); textdomain (GETTEXT_PACKAGE); /* Parse command line arguments.*/ meta_parse_options (&argc, &argv, &meta_args); meta_set_syncing (meta_args.sync || (g_getenv ("METACITY_SYNC") != NULL)); if (meta_args.print_version) version (); meta_select_display (meta_args.display_name); if (meta_args.replace_wm) meta_set_replace_current_wm (TRUE); if (meta_args.save_file && meta_args.client_id) { g_critical ("Can't specify both SM save file and SM client id"); exit (EXIT_FAILURE); } meta_main_loop = g_main_loop_new (NULL, FALSE); meta_ui_init (&argc, &argv); /* Load prefs */ meta_prefs_init (); /* Connect to SM as late as possible - but before managing display, * or we might try to manage a window before we have the session * info */ if (!meta_args.disable_sm) { if (meta_args.client_id == NULL) { const gchar *desktop_autostart_id; desktop_autostart_id = g_getenv ("DESKTOP_AUTOSTART_ID"); if (desktop_autostart_id != NULL) meta_args.client_id = g_strdup (desktop_autostart_id); } /* Unset DESKTOP_AUTOSTART_ID in order to avoid child processes to * use the same client id. */ g_unsetenv ("DESKTOP_AUTOSTART_ID"); meta_session_init (meta_args.client_id, meta_args.save_file); } /* Free memory possibly allocated by the argument parsing which are * no longer needed. */ g_free (meta_args.save_file); g_free (meta_args.display_name); g_free (meta_args.client_id); if (meta_args.compositor_set) { meta_prefs_set_compositor (meta_args.compositor); } else if (meta_args.composite || meta_args.no_composite) { if (meta_args.composite) meta_prefs_set_compositor (META_COMPOSITOR_TYPE_XRENDER); else meta_prefs_set_compositor (META_COMPOSITOR_TYPE_NONE); } if (meta_args.no_force_fullscreen) meta_prefs_set_force_fullscreen (FALSE); if (!meta_display_open ()) { exit (EXIT_FAILURE); } g_main_loop_run (meta_main_loop); meta_finalize (); if (meta_restart_after_quit) { GError *err; err = NULL; if (!g_spawn_async (NULL, argv, NULL, G_SPAWN_SEARCH_PATH, NULL, NULL, NULL, &err)) { g_critical ("Failed to restart: %s", err->message); g_error_free (err); return EXIT_FAILURE; } } return EXIT_SUCCESS; } /** * Stops Metacity. This tells the event loop to stop processing; it is rather * dangerous to use this rather than meta_restart() because this will leave * the user with no window manager. We generally do this only if, for example, * the session manager asks us to; we assume the session manager knows what * it's talking about. * * \param code The success or failure code to return to the calling process. */ void meta_quit (void) { if (g_main_loop_is_running (meta_main_loop)) g_main_loop_quit (meta_main_loop); } /** * Restarts Metacity. In practice, this tells the event loop to stop * processing, having first set the meta_restart_after_quit flag which * tells Metacity to spawn an identical copy of itself before quitting. * This happens on receipt of a _METACITY_RESTART_MESSAGE client event. */ void meta_restart (void) { meta_restart_after_quit = TRUE; meta_quit (); }