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