Manpage of XDARWIN

XDARWIN

Section: User Commands (1)
Updated: Version 6.8.2.0
Index Return to Main Contents

NAME

XDarwin - X window system server for Darwin operating system

SYNOPSIS

XDarwin [ options ] ...

DESCRIPTION

XDarwin is the X window server for Mac OS X and the Darwin operating system provided by the X.Org Foundation. This version of XDarwin can only be started from the Darwin text console. The Mac OS X Aqua GUI, if present, must be shut down. XDarwin uses IOKit services to access the display framebuffer, mouse and keyboard and to provide a layer of hardware abstraction. XDarwin will normally be started by the xdm(1) display manager or by a script that runs the program xinit(1).

OPTIONS

In addition to the normal server options described in the Xserver(1) manual page, XDarwin accepts the following command line switches:

-fakebuttons: Emulates a 3 button mouse using modifier keys. By default, the Command modifier is used to emulate button 2 and Option is used for button 3. Thus, clicking the first mouse button while holding down Command will act like clicking button 2. Holding down Option will simulate button 3.
-nofakebuttons: Do not emulate a 3 button mouse. This is the default.
-fakemouse2 modifiers: Change the modifier keys used to emulate the second mouse button. By default, Command is used to emulate the second button. Any combination of the following modifier names may be used: Shift, Option, Control, Command, Fn. For example, -fakemouse2 Option,Shift will set holding Option, Shift and clicking on button one as equivalent to clicking the second mouse button.
-fakemouse3 modifiers: Change the modifier keys used to emulate the third mouse button. By default, Option is used to emulate the third button. Any combination of the following modifier names may be used: Shift, Option, Control, Command, Fn. For example, -fakemouse3 Control,Shift will set holding Control, Shift and clicking on button one as equivalent to clicking the third mouse button.
-keymap file: On startup XDarwin translates a Darwin keymapping into an X keymap. The default is to read this keymapping from USA.keymapping. With this option the keymapping will be read from file instead. If the file's path is not specified, it will be searched for in Library/Keyboards/ underneath the following directories (in order): ~, /, /Network, /System.
-nokeymap: On startup XDarwin translates a Darwin keymapping into an X keymap. With this option XDarwin queries the kernel for the current keymapping instead of reading it from a file. This will often fail on newer kernels.
-size width height: Sets the screen resolution for the X server to use.
-depth depth: Specifies the color bit depth to use. Currently only 8, 15, and 24 color bits per pixel are supported.
-refresh rate: Gives the refresh rate to use in Hz. For LCD displays this should be 0.
-showconfig: Print out the server version and patchlevel.
-version: Same as -showconfig.

BUGS

XDarwin and this man page still have many limitations. Some of the more obvious ones are:
- The display mode cannot be changed once the X server has started.
- A screen saver is not supported.

AUTHORS

XFree86 was originally ported to Mac OS X Server by John Carmack. Dave Zarzycki used this as the basis of his port of XFree86 4.0 to Darwin 1.0. Torrey T. Lyons improved and integrated this code into the XFree86 Project's mainline for the 4.0.2 release.

The following members of the XonX Team contributed to the following releases (in alphabetical order):

XFree86 4.1.0:: Rob Braun - Darwin x86 support
Torrey T. Lyons - Project Lead
Andreas Monitzer - Cocoa version of XDarwin front end
Gregory Robert Parker - Original Quartz implementation
Christoph Pfisterer - Dynamic shared X libraries
Toshimitsu Tanaka - Japanese localization
XFree86 4.2.0:: Rob Braun - Darwin x86 support
Pablo Di Noto - Spanish localization
Paul Edens - Dutch localization
Kyunghwan Kim - Korean localization
Mario Klebsch - Non-US keyboard support
Torrey T. Lyons - Project Lead
Andreas Monitzer - German localization
Patrik Montgomery - Swedish localization
Greg Parker - Rootless support
Toshimitsu Tanaka - Japanese localization
Olivier Verdier - French localization

This document was created by man2html, using the manual pages.
Time: 22:01:03 GMT, May 16, 2005