Xsun(1)Xsun(1)NAMEXsun - Solaris server for X Version 11
SYNOPSISXsun [ option ] ...
DESCRIPTIONXsun is the Solaris display server for Version 11 of the X window sys‐
tem on Solaris hardware. It is normally started by dtlogin, but may
also be started via xinit(1) or xdm(1).
OPTIONS
In addition to the options described in Xserver(1), Xsun accepts the
following command-line switches:
-audiobell audiodev
This option switches on an audio bell. The audiodev specifier is
defined to be filename, a specified audio file. You use the
specified file as an audio device to play bell tones. The file
must be an audio output device compatible with the audio(7i)
specification. If you do not supply an audiodev argument on the
command line with the this option, then the default audio output
device is the /dev/audio file. This option is ignored when the
display is a SunRay device.
-clients [128|1024]
sets maximum number of clients which can be connected to the
Xserver at the same time. Default is 1024.
-defclass [ GrayScale | StaticGray | PseudoColor
| StaticColor | DirectColor | TrueColor ]
Use the specified visual class as the default visual. If not
specified, the default is device dependent. defclass entries in
a -dev option override this option for that device.
-defdepth n
Use a visual of depth n as the default visual. If not speci‐
fied, the default is device dependent. defdepth entries in a
-dev option override this option for that device.
-dev filename
This option specifies the name of the framebuffer device file to
be used instead of the default framebuffer /dev/fb. Multiple
instances of this option indicate multiple screens on the same
server. After each -dev option a list of modifiers changes the
behavior of the named device.
[ left | right | top | bottom ]
Specify the position of a given screen in relation to the
previous one on the command line. The default right.
dpix n The dpi in the x direction for this screen is n. The
default is 90.
dpiy n The dpi in the y direction for this screen is n. The
default is 90.
defclass [ GrayScale | StaticGray | PseudoColor |
StaticColor | DirectColor | TrueColor ] Use the specified
visual as the default visual. The default is device
dependent.
defdepth n
A visual of depth n is the default visual. The default
is device dependent.
grayvis
Only report GrayScale and/or StaticGray visuals.
The following is an example of the -dev option that might be
used on a system with two frame buffers:
-dev /dev/fb0 defclass TrueColor -dev /dev/fb1 right
The Xsun server also supports the format used by the X11R6 sam‐
ple X Server. Multiple screen systems are specified by using the
following syntax on the command line:
-dev <device 1>:<device 2>:...:<device n>
The server uses device 1 as screen 0, device 2 as screen 1,
etc., and the server assumes that screens are ordered left to
right in ascending screen number. This means that the cursor
moves off the right side of screen n and onto the left side of
screen n + 1. When this format is used, no other -dev options
are valid.
-banner Display the banner screen at startup. The banner is displayed
by default.
-dur milliseconds
Set the duration of the bell in units of milliseconds. Default
is 100.
-dpsfileops
Allow the Display PostScript file operators access to the UNIX
file system.
-flipPixels
Reverse black and white pixel locations in the colormap. This
is not the same as a reverse video option.
-pit percentage
Set the percentage of the maximum pitch available to be used
for the bell. Most Sun hardware does not support alternative
pitch values. On such hardware this option has no effect
unless the -audiobell option is also specified.
-probe [ probe-module ]
This option is valid only on x86 platform with XFree86 based
DDXs installed. Load probe-module, and call the probe function
in the loaded module to probe installed graphics devices and
generate configuration data. Configuration data include driv‐
ers, vendor id, device id, PCI position, vendor name and device
name. If probe-module is not specified, the bridge module for
the XFree86 DDXs is loaded.
-mden denominator
Set the pointer acceleration denominator. The acceleration
numerator is set with the -a option described in
Xserver(1). This permits fractional acceleration such as 3/2
or 1.5. Default value is 1.
±nkeyboard
enables [+] or disables [-] null keyboard mode. When this
option is enabled the Xserver runs without a keyboard. Default
is disabled.
±nmouse enables [+] or disables [-] null mouse mode. When this option
is enabled the Xserver runs without a mouse. Default is dis‐
abled.
-nobanner
Do not display the banner screen at startup.
-nominexp
This option is used to disable "minimized exposure", which is
used only by multi-planegroup devices such as gt, cg12 and cg8.
"Minimized Exposure" means that the server will not send
expose events to windows in one planegroup that are exposed by
windows in another planegroup. By default the minimized expo‐
sure feature is turned ON.
-sharedretainedpath directory_path
This option is currently supported only for Sun internal soft‐
ware APIs.
+xrender
Starts Xsun with the Xrender extension enabled.
-xrender
Starts Xsun with the Xrender extension disabled. This is the
default option.
+xinerama
Starts Xsun with the Xinerama option enabled. See the XINERAMA
section below for details.
-xinerama
Starts Xsun with the Xinerama option disabled. This is the
default option.
-xoverlap nn
Sets the x axis overlap to nn pixels when used with the xin‐
erama option. This command is used for projection screen dis‐
plays. These types of displays require overlap so that edge
blending can be performed.
-yoverlap nn
Sets the y axis overlap to nn pixels when used with the xin‐
erama option. This command is used for projection screen dis‐
plays. These types of displays require overlap so that edge
blending can be performed.
KEYBOARD OPTIONSXsun supports the following options when the XKEYBOARD (XKB) extension
is not enabled. When XKEYBOARD is enabled, these options are replaced
by those documented in the XKEYBOARD OPTIONS section of the Xserver(1)
manual page. In this release, XKEYBOARD is disabled by default, but
may be enabled via the +kb option. This default may change in a future
release.
-accessX
This option enables activation of the SlowKeys and StickyKeys
functionality of the AccessX extension using the shift key on
the keyboard. Note that this is the opposite of the equivalent
XKB option, since -accessx disables this functionality when XKB
is active.
-ar1 milliseconds
Specify amount of time in milliseconds before a pressed key
begins to autorepeating. The default is 500 milliseconds.
-ar2 milliseconds
specify the interval in milliseconds between autorepeats of
pressed keys. The default is 50 milliseconds.
NETWORK CONNECTIONS
In addition to the network connections described in Xserver(1), Xsun
provides the following connection:
Shared Memory
Sun provides a shared memory transport mechanism via the SUN_SME
extension. This extension provides the capability of sending
client requests to the server via shared memory. Shared memory is
used for client requests only. Replies from the server and events
are sent via the default transport mechanism. To enable this
transport mechanism, one has to set the DISPLAY environment vari‐
able to :x.y (where x is the display number and y is the screen
number), and the environment variable XSUNTRANSPORT to "shmem".
The size of the segment can be set by setting enviroment variable
XSUNSMESIZE. By default, it is set to "64" which implies that the
size of the shared memory segment is 64K.
POWER MANAGEMENTXsun screen-saver causes displays to be power managed. The default
video-off screen-saver preference achieves the effect of turning off
the video by power managing the display. Instead of calling directly
into the frame buffer's driver to turn the video off, Xsun calls into
the power management pseudo driver (pm(7D)) to request the change in
power level of the display. It turns the video-off by setting the power
level of the display to zero and turns it back on by setting the dis‐
play to its normal operating power level. See Using Power Management
for more information.
XINERAMA
Xinerama mode ties multiple physical screens together as one virtual
screen, providing the advantage of a single screen topology. Xinerama
requires homogeneous (identical) graphics hardware.
With -xinerama, a system with four screens is addressed as :0.0, :0.1,
:0.2, :0.3. A window created on one of these screens is confined to
that screen over its lifetime. Only multiscreen-aware clients (e.g.,
dtwm) may take advantage of more than one screen.
With +xinerama, this system is entirely addressed as :0.0 and the win‐
dow manager and applications can move over or straddle all available
physical display surfaces.
SEE ALSOdtlogin(1), X11(5), Xserver(1), xdm(1), xinit(1)
03 November 2004 Xsun(1)
