openbox/openbox.c

   1 /* -*- indent-tabs-mode: nil; tab-width: 4; c-basic-offset: 4; -*-
   2
   3    openbox.c for the Openbox window manager
   4    Copyright (c) 2006        Mikael Magnusson
   5    Copyright (c) 2003-2007   Dana Jansens
   6
   7    This program is free software; you can redistribute it and/or modify
   8    it under the terms of the GNU General Public License as published by
   9    the Free Software Foundation; either version 2 of the License, or
  10    (at your option) any later version.
  11
  12    This program is distributed in the hope that it will be useful,
  13    but WITHOUT ANY WARRANTY; without even the implied warranty of
  14    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15    GNU General Public License for more details.
  16
  17    See the COPYING file for a copy of the GNU General Public License.
  18 */
  19
  20 #include "debug.h"
  21 #include "openbox.h"
  22 #include "session.h"
  23 #include "dock.h"
  24 #include "modkeys.h"
  25 #include "event.h"
  26 #include "menu.h"
  27 #include "client.h"
  28 #include "xerror.h"
  29 #include "prop.h"
  30 #include "screen.h"
  31 #include "startupnotify.h"
  32 #include "focus.h"
  33 #include "focus_cycle.h"
  34 #include "focus_cycle_indicator.h"
  35 #include "focus_cycle_popup.h"
  36 #include "moveresize.h"
  37 #include "frame.h"
  38 #include "keyboard.h"
  39 #include "mouse.h"
  40 #include "extensions.h"
  41 #include "menuframe.h"
  42 #include "grab.h"
  43 #include "group.h"
  44 #include "propwin.h"
  45 #include "config.h"
  46 #include "mainloop.h"
  47 #include "gettext.h"
  48 #include "parser/parse.h"
  49 #include "render/render.h"
  50 #include "render/theme.h"
  51
  52 #ifdef HAVE_FCNTL_H
  53 #  include <fcntl.h>
  54 #endif
  55 #ifdef HAVE_SIGNAL_H
  56 #  include <signal.h>
  57 #endif
  58 #ifdef HAVE_STDLIB_H
  59 #  include <stdlib.h>
  60 #endif
  61 #ifdef HAVE_LOCALE_H
  62 #  include <locale.h>
  63 #endif
  64 #ifdef HAVE_SYS_STAT_H
  65 #  include <sys/stat.h>
  66 #  include <sys/types.h>
  67 #endif
  68 #ifdef HAVE_SYS_WAIT_H
  69 #  include <sys/types.h>
  70 #  include <sys/wait.h>
  71 #endif
  72 #ifdef HAVE_UNISTD_H
  73 #  include <unistd.h>
  74 #endif
  75 #include <errno.h>
  76
  77 #include <X11/cursorfont.h>
  78 #if USE_XCURSOR
  79 #include <X11/Xcursor/Xcursor.h>
  80 #endif
  81
  82 #include <X11/Xlib.h>
  83 #include <X11/keysym.h>
  84
  85
  86 RrInstance *ob_rr_inst;
  87 RrTheme    *ob_rr_theme;
  88 ObMainLoop *ob_main_loop;
  89 Display    *ob_display;
  90 gint        ob_screen;
  91 gboolean    ob_replace_wm = FALSE;
  92 gboolean    ob_sm_use = TRUE;
  93 gchar      *ob_sm_id = NULL;
  94 gchar      *ob_sm_save_file = NULL;
  95 gboolean    ob_debug_xinerama = FALSE;
  96
  97 static ObState   state;
  98 static gboolean  xsync = FALSE;
  99 static gboolean  reconfigure = FALSE;
 100 static gboolean  restart = FALSE;
 101 static gchar    *restart_path = NULL;
 102 static Cursor    cursors[OB_NUM_CURSORS];
 103 static KeyCode   keys[OB_NUM_KEYS];
 104 static gint      exitcode = 0;
 105 static guint     remote_control = 0;
 106 static gboolean  being_replaced = FALSE;
 107
 108 static void signal_handler(gint signal, gpointer data);
 109 static void remove_args(gint *argc, gchar **argv, gint index, gint num);
 110 static void parse_env();
 111 static void parse_args(gint *argc, gchar **argv);
 112 static Cursor load_cursor(const gchar *name, guint fontval);
 113
 114 gint main(gint argc, gchar **argv)
 115 {
 116     gchar *program_name;
 117
 118     state = OB_STATE_STARTING;
 119
 120     /* initialize the locale */
 121     if (!setlocale(LC_ALL, ""))
 122         g_message("Couldn't set locale from environment.");
 123     bindtextdomain(PACKAGE_NAME, LOCALEDIR);
 124     bind_textdomain_codeset(PACKAGE_NAME, "UTF-8");
 125     textdomain(PACKAGE_NAME);
 126
 127     if (chdir(g_get_home_dir()) == -1)
 128         g_message(_("Unable to change to home directory '%s': %s"),
 129                   g_get_home_dir(), g_strerror(errno));
 130
 131     /* parse the command line args, which can change the argv[0] */
 132     parse_args(&argc, argv);
 133     /* parse the environment variables */
 134     parse_env();
 135
 136     program_name = g_path_get_basename(argv[0]);
 137     g_set_prgname(program_name);
 138
 139     if (!remote_control) {
 140         parse_paths_startup();
 141
 142         session_startup(argc, argv);
 143     }
 144
 145
 146     ob_display = XOpenDisplay(NULL);
 147     if (ob_display == NULL)
 148         ob_exit_with_error(_("Failed to open the display from the DISPLAY environment variable."));
 149     if (fcntl(ConnectionNumber(ob_display), F_SETFD, 1) == -1)
 150         ob_exit_with_error("Failed to set display as close-on-exec");
 151
 152     if (remote_control) {
 153         prop_startup();
 154
 155         /* Send client message telling the OB process to:
 156          * remote_control = 1 -> reconfigure
 157          * remote_control = 2 -> restart */
 158         PROP_MSG(RootWindow(ob_display, ob_screen),
 159                  ob_control, remote_control, 0, 0, 0);
 160         XCloseDisplay(ob_display);
 161         exit(EXIT_SUCCESS);
 162     }
 163
 164     ob_main_loop = ob_main_loop_new(ob_display);
 165
 166     /* set up signal handler */
 167     ob_main_loop_signal_add(ob_main_loop, SIGUSR1, signal_handler, NULL, NULL);
 168     ob_main_loop_signal_add(ob_main_loop, SIGUSR2, signal_handler, NULL, NULL);
 169     ob_main_loop_signal_add(ob_main_loop, SIGTERM, signal_handler, NULL, NULL);
 170     ob_main_loop_signal_add(ob_main_loop, SIGINT, signal_handler, NULL, NULL);
 171     ob_main_loop_signal_add(ob_main_loop, SIGHUP, signal_handler, NULL, NULL);
 172     ob_main_loop_signal_add(ob_main_loop, SIGPIPE, signal_handler, NULL, NULL);
 173     ob_main_loop_signal_add(ob_main_loop, SIGCHLD, signal_handler, NULL, NULL);
 174
 175     ob_screen = DefaultScreen(ob_display);
 176
 177     ob_rr_inst = RrInstanceNew(ob_display, ob_screen);
 178     if (ob_rr_inst == NULL)
 179         ob_exit_with_error(_("Failed to initialize the render library."));
 180
 181     XSynchronize(ob_display, xsync);
 182
 183     /* check for locale support */
 184     if (!XSupportsLocale())
 185         g_message(_("X server does not support locale."));
 186     if (!XSetLocaleModifiers(""))
 187         g_message(_("Cannot set locale modifiers for the X server."));
 188
 189     /* set our error handler */
 190     XSetErrorHandler(xerror_handler);
 191
 192     /* set the DISPLAY environment variable for any lauched children, to the
 193        display we're using, so they open in the right place. */
 194     putenv(g_strdup_printf("DISPLAY=%s", DisplayString(ob_display)));
 195
 196     /* create available cursors */
 197     cursors[OB_CURSOR_NONE] = None;
 198     cursors[OB_CURSOR_POINTER] = load_cursor("left_ptr", XC_left_ptr);
 199     cursors[OB_CURSOR_BUSY] = load_cursor("left_ptr_watch", XC_watch);
 200     cursors[OB_CURSOR_MOVE] = load_cursor("fleur", XC_fleur);
 201     cursors[OB_CURSOR_NORTH] = load_cursor("top_side", XC_top_side);
 202     cursors[OB_CURSOR_NORTHEAST] = load_cursor("top_right_corner",
 203                                                XC_top_right_corner);
 204     cursors[OB_CURSOR_EAST] = load_cursor("right_side", XC_right_side);
 205     cursors[OB_CURSOR_SOUTHEAST] = load_cursor("bottom_right_corner",
 206                                                XC_bottom_right_corner);
 207     cursors[OB_CURSOR_SOUTH] = load_cursor("bottom_side", XC_bottom_side);
 208     cursors[OB_CURSOR_SOUTHWEST] = load_cursor("bottom_left_corner",
 209                                                XC_bottom_left_corner);
 210     cursors[OB_CURSOR_WEST] = load_cursor("left_side", XC_left_side);
 211     cursors[OB_CURSOR_NORTHWEST] = load_cursor("top_left_corner",
 212                                                XC_top_left_corner);
 213
 214
 215     prop_startup(); /* get atoms values for the display */
 216     extensions_query_all(); /* find which extensions are present */
 217
 218     if (screen_annex()) { /* it will be ours! */
 219         do {
 220             modkeys_startup(reconfigure);
 221
 222             /* get the keycodes for keys we use */
 223             keys[OB_KEY_RETURN] = modkeys_sym_to_code(XK_Return);
 224             keys[OB_KEY_ESCAPE] = modkeys_sym_to_code(XK_Escape);
 225             keys[OB_KEY_LEFT] = modkeys_sym_to_code(XK_Left);
 226             keys[OB_KEY_RIGHT] = modkeys_sym_to_code(XK_Right);
 227             keys[OB_KEY_UP] = modkeys_sym_to_code(XK_Up);
 228             keys[OB_KEY_DOWN] = modkeys_sym_to_code(XK_Down);
 229
 230             {
 231                 ObParseInst *i;
 232                 xmlDocPtr doc;
 233                 xmlNodePtr node;
 234
 235                 /* startup the parsing so everything can register sections
 236                    of the rc */
 237                 i = parse_startup();
 238
 239                 /* start up config which sets up with the parser */
 240                 config_startup(i);
 241
 242                 /* parse/load user options */
 243                 if (parse_load_rc(NULL, &doc, &node)) {
 244                     parse_tree(i, doc, node->xmlChildrenNode);
 245                     parse_close(doc);
 246                 } else
 247                     g_message(_("Unable to find a valid config file, using some simple defaults"));
 248
 249 /*
 250                 if (config_type != NULL)
 251                     PROP_SETS(RootWindow(ob_display, ob_screen),
 252                               ob_config, config_type);
 253 */
 254
 255                 /* we're done with parsing now, kill it */
 256                 parse_shutdown(i);
 257             }
 258
 259             /* load the theme specified in the rc file */
 260             {
 261                 RrTheme *theme;
 262                 if ((theme = RrThemeNew(ob_rr_inst, config_theme,
 263                                         config_font_activewindow,
 264                                         config_font_inactivewindow,
 265                                         config_font_menutitle,
 266                                         config_font_menuitem,
 267                                         config_font_osd)))
 268                 {
 269                     RrThemeFree(ob_rr_theme);
 270                     ob_rr_theme = theme;
 271                 }
 272                 if (ob_rr_theme == NULL)
 273                     ob_exit_with_error(_("Unable to load a theme."));
 274             }
 275
 276             if (reconfigure) {
 277                 GList *it;
 278
 279                 /* update all existing windows for the new theme */
 280                 for (it = client_list; it; it = g_list_next(it)) {
 281                     ObClient *c = it->data;
 282                     frame_adjust_theme(c->frame);
 283                 }
 284             }
 285             event_startup(reconfigure);
 286             /* focus_backup is used for stacking, so this needs to come before
 287                anything that calls stacking_add */
 288             focus_startup(reconfigure);
 289             focus_cycle_startup(reconfigure);
 290             focus_cycle_indicator_startup(reconfigure);
 291             focus_cycle_popup_startup(reconfigure);
 292             window_startup(reconfigure);
 293             sn_startup(reconfigure);
 294             screen_startup(reconfigure);
 295             grab_startup(reconfigure);
 296             propwin_startup(reconfigure);
 297             group_startup(reconfigure);
 298             client_startup(reconfigure);
 299             dock_startup(reconfigure);
 300             moveresize_startup(reconfigure);
 301             keyboard_startup(reconfigure);
 302             mouse_startup(reconfigure);
 303             menu_startup(reconfigure);
 304             menu_frame_startup(reconfigure);
 305
 306             if (!reconfigure) {
 307                 guint32 xid;
 308                 ObWindow *w;
 309
 310                 /* get all the existing windows */
 311                 client_manage_all();
 312                 focus_nothing();
 313
 314                 /* focus what was focused if a wm was already running */
 315                 if (PROP_GET32(RootWindow(ob_display, ob_screen),
 316                                net_active_window, window, &xid) &&
 317                     (w = g_hash_table_lookup(window_map, &xid)) &&
 318                     WINDOW_IS_CLIENT(w))
 319                 {
 320                     client_focus(WINDOW_AS_CLIENT(w));
 321                 }
 322             } else {
 323                 GList *it;
 324
 325                 /* redecorate all existing windows */
 326                 for (it = client_list; it; it = g_list_next(it)) {
 327                     ObClient *c = it->data;
 328                     /* the new config can change the window's decorations */
 329                     client_setup_decor_and_functions(c);
 330                     /* redraw the frames */
 331                     frame_adjust_area(c->frame, TRUE, TRUE, FALSE);
 332                 }
 333             }
 334
 335             reconfigure = FALSE;
 336
 337             state = OB_STATE_RUNNING;
 338             ob_main_loop_run(ob_main_loop);
 339             state = OB_STATE_EXITING;
 340
 341             if (!reconfigure) {
 342                 dock_remove_all();
 343                 client_unmanage_all();
 344             }
 345
 346             menu_frame_shutdown(reconfigure);
 347             menu_shutdown(reconfigure);
 348             mouse_shutdown(reconfigure);
 349             keyboard_shutdown(reconfigure);
 350             moveresize_shutdown(reconfigure);
 351             dock_shutdown(reconfigure);
 352             client_shutdown(reconfigure);
 353             group_shutdown(reconfigure);
 354             propwin_shutdown(reconfigure);
 355             grab_shutdown(reconfigure);
 356             screen_shutdown(reconfigure);
 357             focus_cycle_popup_shutdown(reconfigure);
 358             focus_cycle_indicator_shutdown(reconfigure);
 359             focus_cycle_shutdown(reconfigure);
 360             focus_shutdown(reconfigure);
 361             sn_shutdown(reconfigure);
 362             window_shutdown(reconfigure);
 363             event_shutdown(reconfigure);
 364             config_shutdown();
 365             modkeys_shutdown(reconfigure);
 366         } while (reconfigure);
 367     }
 368
 369     XSync(ob_display, FALSE);
 370
 371     RrThemeFree(ob_rr_theme);
 372     RrInstanceFree(ob_rr_inst);
 373
 374     session_shutdown(being_replaced);
 375
 376     XCloseDisplay(ob_display);
 377
 378     parse_paths_shutdown();
 379
 380     if (restart) {
 381         if (restart_path != NULL) {
 382             gint argcp;
 383             gchar **argvp;
 384             GError *err = NULL;
 385
 386             /* run other window manager */
 387             if (g_shell_parse_argv(restart_path, &argcp, &argvp, &err)) {
 388                 execvp(argvp[0], argvp);
 389                 g_strfreev(argvp);
 390             } else {
 391                 g_message(
 392                     _("Restart failed to execute new executable '%s': %s"),
 393                     restart_path, err->message);
 394                 g_error_free(err);
 395             }
 396         }
 397
 398         /* we remove the session arguments from argv, so put them back */
 399         if (ob_sm_save_file != NULL || ob_sm_id != NULL) {
 400             gchar **nargv;
 401             gint i, l;
 402
 403             l = argc +
 404                 (ob_sm_save_file != NULL ? 2 : 0) +
 405                 (ob_sm_id != NULL ? 2 : 0);
 406             nargv = g_new0(gchar*, l+1);
 407             for (i = 0; i < argc; ++i)
 408                 nargv[i] = argv[i];
 409
 410             if (ob_sm_save_file != NULL) {
 411                 nargv[i++] = g_strdup("--sm-save-file");
 412                 nargv[i++] = ob_sm_save_file;
 413             }
 414             if (ob_sm_id != NULL) {
 415                 nargv[i++] = g_strdup("--sm-client-id");
 416                 nargv[i++] = ob_sm_id;
 417             }
 418             g_assert(i == l);
 419             argv = nargv;
 420         }
 421
 422         /* re-run me */
 423         execvp(argv[0], argv); /* try how we were run */
 424         execlp(argv[0], program_name, (gchar*)NULL); /* last resort */
 425     }
 426
 427     /* free stuff passed in from the command line or environment */
 428     g_free(ob_sm_save_file);
 429     g_free(ob_sm_id);
 430     g_free(program_name);
 431
 432     return exitcode;
 433 }
 434
 435 static void signal_handler(gint signal, gpointer data)
 436 {
 437     switch (signal) {
 438     case SIGUSR1:
 439         ob_debug("Caught signal %d. Restarting.\n", signal);
 440         ob_restart();
 441         break;
 442     case SIGUSR2:
 443         ob_debug("Caught signal %d. Reconfiguring.\n", signal);
 444         ob_reconfigure();
 445         break;
 446     case SIGCHLD:
 447         /* reap children */
 448         while (waitpid(-1, NULL, WNOHANG) > 0);
 449         break;
 450     default:
 451         ob_debug("Caught signal %d. Exiting.\n", signal);
 452         /* TERM and INT return a 0 code */
 453         ob_exit(!(signal == SIGTERM || signal == SIGINT));
 454     }
 455 }
 456
 457 static void print_version()
 458 {
 459     g_print("Openbox %s\n", PACKAGE_VERSION);
 460     g_print(_("Copyright (c)"));
 461     g_print(" 2007        Mikael Magnusson\n");
 462     g_print(_("Copyright (c)"));
 463     g_print(" 2003-2007   Dana Jansens\n\n");
 464     g_print("This program comes with ABSOLUTELY NO WARRANTY.\n");
 465     g_print("This is free software, and you are welcome to redistribute it\n");
 466     g_print("under certain conditions. See the file COPYING for details.\n\n");
 467 }
 468
 469 static void print_help()
 470 {
 471     g_print(_("Syntax: openbox [options]\n"));
 472     g_print(_("\nOptions:\n"));
 473     g_print(_("  --help              Display this help and exit\n"));
 474     g_print(_("  --version           Display the version and exit\n"));
 475     g_print(_("  --replace           Replace the currently running window manager\n"));
 476     g_print(_("  --sm-disable        Disable connection to the session manager\n"));
 477     g_print(_("\nPassing messages to a running Openbox instance:\n"));
 478     g_print(_("  --reconfigure       Reload Openbox's configuration\n"));
 479     g_print(_("\nDebugging options:\n"));
 480     g_print(_("  --sync              Run in synchronous mode\n"));
 481     g_print(_("  --debug             Display debugging output\n"));
 482     g_print(_("  --debug-focus       Display debugging output for focus handling\n"));
 483     g_print(_("  --debug-xinerama    Split the display into fake xinerama screens\n"));
 484     g_print(_("\nPlease report bugs at %s\n"), PACKAGE_BUGREPORT);
 485 }
 486
 487 static void remove_args(gint *argc, gchar **argv, gint index, gint num)
 488 {
 489     gint i;
 490
 491     for (i = index; i < *argc - num; ++i)
 492         argv[i] = argv[i+num];
 493     for (; i < *argc; ++i)
 494         argv[i] = NULL;
 495     *argc -= num;
 496 }
 497
 498 static void parse_env()
 499 {
 500     /* unset this so we don't pass it on unknowingly */
 501     unsetenv("DESKTOP_STARTUP_ID");
 502 }
 503
 504 static void parse_args(gint *argc, gchar **argv)
 505 {
 506     gint i;
 507
 508     for (i = 1; i < *argc; ++i) {
 509         if (!strcmp(argv[i], "--version")) {
 510             print_version();
 511             exit(0);
 512         }
 513         else if (!strcmp(argv[i], "--help")) {
 514             print_help();
 515             exit(0);
 516         }
 517         else if (!strcmp(argv[i], "--g-fatal-warnings")) {
 518             g_log_set_always_fatal(G_LOG_LEVEL_CRITICAL);
 519         }
 520         else if (!strcmp(argv[i], "--replace")) {
 521             ob_replace_wm = TRUE;
 522             remove_args(argc, argv, i, 1);
 523             --i; /* this arg was removed so go back */
 524         }
 525         else if (!strcmp(argv[i], "--sync")) {
 526             xsync = TRUE;
 527         }
 528         else if (!strcmp(argv[i], "--debug")) {
 529             ob_debug_show_output(TRUE);
 530             ob_debug_enable(OB_DEBUG_SM, TRUE);
 531             ob_debug_enable(OB_DEBUG_APP_BUGS, TRUE);
 532         }
 533         else if (!strcmp(argv[i], "--debug-focus")) {
 534             ob_debug_show_output(TRUE);
 535             ob_debug_enable(OB_DEBUG_SM, TRUE);
 536             ob_debug_enable(OB_DEBUG_APP_BUGS, TRUE);
 537             ob_debug_enable(OB_DEBUG_FOCUS, TRUE);
 538         }
 539         else if (!strcmp(argv[i], "--debug-xinerama")) {
 540             ob_debug_xinerama = TRUE;
 541         }
 542         else if (!strcmp(argv[i], "--reconfigure")) {
 543             remote_control = 1;
 544 /* don't make this do anything if it's not in --help ..
 545         } else if (!strcmp(argv[i], "--restart")) {
 546             remote_control = 2;
 547 */
 548         }
 549         else if (!strcmp(argv[i], "--sm-save-file")) {
 550             if (i == *argc - 1) /* no args left */
 551                 /* not translated cuz it's sekret */
 552                 g_printerr("--sm-save-file requires an argument\n");
 553             else {
 554                 ob_sm_save_file = g_strdup(argv[i+1]);
 555                 remove_args(argc, argv, i, 2);
 556                 --i; /* this arg was removed so go back */
 557                 ob_debug_type(OB_DEBUG_SM, "--sm-save-file %s\n",
 558                               ob_sm_save_file);
 559             }
 560         }
 561         else if (!strcmp(argv[i], "--sm-client-id")) {
 562             if (i == *argc - 1) /* no args left */
 563                 /* not translated cuz it's sekret */
 564                 g_printerr("--sm-client-id requires an argument\n");
 565             else {
 566                 ob_sm_id = g_strdup(argv[i+1]);
 567                 remove_args(argc, argv, i, 2);
 568                 --i; /* this arg was removed so go back */
 569                 ob_debug_type(OB_DEBUG_SM, "--sm-client-id %s\n", ob_sm_id);
 570             }
 571         }
 572         else if (!strcmp(argv[i], "--sm-disable")) {
 573             ob_sm_use = FALSE;
 574         }
 575         else {
 576             /* this is a memleak.. oh well.. heh */
 577             gchar *err = g_strdup_printf
 578                 (_("Invalid command line argument '%s'\n"), argv[i]);
 579             ob_exit_with_error(err);
 580         }
 581     }
 582 }
 583
 584 static Cursor load_cursor(const gchar *name, guint fontval)
 585 {
 586     Cursor c = None;
 587
 588 #if USE_XCURSOR
 589     c = XcursorLibraryLoadCursor(ob_display, name);
 590 #endif
 591     if (c == None)
 592         c = XCreateFontCursor(ob_display, fontval);
 593     return c;
 594 }
 595
 596 void ob_exit_with_error(const gchar *msg)
 597 {
 598     g_message(msg);
 599     session_shutdown(TRUE);
 600     exit(EXIT_FAILURE);
 601 }
 602
 603 void ob_restart_other(const gchar *path)
 604 {
 605     restart_path = g_strdup(path);
 606     ob_restart();
 607 }
 608
 609 void ob_restart()
 610 {
 611     restart = TRUE;
 612     ob_exit(0);
 613 }
 614
 615 void ob_reconfigure()
 616 {
 617     reconfigure = TRUE;
 618     ob_exit(0);
 619 }
 620
 621 void ob_exit(gint code)
 622 {
 623     exitcode = code;
 624     ob_main_loop_exit(ob_main_loop);
 625 }
 626
 627 void ob_exit_replace()
 628 {
 629     exitcode = 0;
 630     being_replaced = TRUE;
 631     ob_main_loop_exit(ob_main_loop);
 632 }
 633
 634 Cursor ob_cursor(ObCursor cursor)
 635 {
 636     g_assert(cursor < OB_NUM_CURSORS);
 637     return cursors[cursor];
 638 }
 639
 640 KeyCode ob_keycode(ObKey key)
 641 {
 642     g_assert(key < OB_NUM_KEYS);
 643     return keys[key];
 644 }
 645
 646 ObState ob_state()
 647 {
 648     return state;
 649 }