Table of Contents

Name

XDarwin - X window system server for Darwin operating system

Synopsis

XDarwin [ options ] ...

Description

XDarwin is the window server for Version 11 of the X window system on the Darwin operating system. 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 accesss 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 screeen 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.

-screen screenum
Specifies which screen number the X server should run on. Screen number 0 is the default.

-showconfig
Print out the server version and patchlevel.
-version
Same as -showconfig.

See Also

X(7) , Xserver(1) , xdm(1) , xinit(1)

Bugs

XDarwin and this man page still have many limitations. Some of the more obvious ones are:
- The display mode can not 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 XFree86 4.1 release:

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


Table of Contents