x11-server - X Window System display service
Please see following description for synopsis
SMF Services application/x11/x11-server(8s)
NAME
svc:/application/x11/x11-server - X Window System display service
DESCRIPTION
svc:/application/x11/x11-server is the service identifier for configur-
ing the X Window System display server with the service management
facility, smf(5). In this release of Oracle Solaris, /usr/bin/X is a
link to the Xserver program which starts the appropriate X server based
on properties set for this service.
STARTING THE SERVER
On Oracle Solaris 11, the X server is usually started from the GNOME
Display Manager program gdm(8). This role may also be performed by the
X Display Manager program xdm(1), or another display manager. Besides
starting the X server, these display managers also provide a login dia-
log for users and start their desktop environment.
While the configuration of the X server may be managed via SMF, the
svcs(8) command will not list any instances of the x11-server service
in a normal configuration, as the X server will be started via a dis-
play manager instead of by the SMF system directly, or on demand via a
program such as startx(1).
An SMF instance may be created when necessary to have the system auto-
matically start an X server without a display manager or other control
program. An example of this is provided in the EXAMPLES section below.
SMF PROPERTIES
Use svccfg(8) to make configuration changes and to view configuration
information for the svc:/application/x11/x11-server service.
/usr/bin/Xserver will look for configuration options in the instances
in this order, stopping at the first match for the given property:
1. :displayN (where N is the display number of the X server, i.e.
:display0 for :0)
2. Any class names provided via the -c options to /usr/bin/Xserver.
Multiple -c options may be provided, if so, they are searched in
the order found on the command line.
3. If any XDMCP options are provided to open a remote display con-
nection, :remote, otherwise :local
4. The default properties for the service
Class names may be any valid FMRI instance name. Sun reserves all
class names beginning with lowercase letters for its own use - cus-
tomers wishing to create their own class names may use names beginning
with an uppercase letter.
These properties may be set in any instance of x11-server or for the
service itself:
options/server
(Type astring) The absolute path to the X server binary to run,
currently must be one of:
/usr/bin/Xorg
/usr/bin/Xvfb
/usr/bin/Xvnc
options/config_file
(Type string) Setting this to a filename causes this file to be
used as the configuration file for the X server. Currently
this property is only available when used with the Xorg server.
The value of this property must be a relative path from one of
the directories in the Xorg config file search path, and not an
absolute path.
options/tcp_listen
(Type boolean) Setting this to true enables listening for incom-
ing TCP/IP connections.
options/default_depth
(Type int) Sets the depth of the default visual of the X server
started.
options/server_args
(Type astring) Sets additional arguments to pass to the X server
started. Care must be used when using options specific to a
particular X server as then it may cause failure to start the X
server if the server to be started is later changed to one that
does not support those options.
options/display_0_on_console
(Type boolean) Setting this to true starts the X server with a
DISPLAY ":0.0" on "/dev/console" rather than the first available
"/dev/vt/#", see vt(4i), this preserves backward compatibility
with programs such as "xterm -C" that expect have access to
"/dev/console". X servers with any other DISPLAY are not
affected. The default is false.
options/vncplatform_override
(Type boolean) Setting this to true starts the Xorg server
instead of the Xvnc server for platforms that have ILOM VNC sup-
port.
EXAMPLES
Example: Allow remote access
The following command allows access from remote clients.
svccfg -s svc:/application/x11/x11-server \
setprop options/tcp_listen = true
Restart the Xserver by either logging out and logging back in, or manu-
ally if the Xserver was started from the command line.
Example: Use of VESA driver
The following command overrides the default Xorg driver selection to
use the /usr/lib/X11/xorg.conf.vesa configuration file to select the
"vesa" driver.
svccfg -s svc:/application/x11/x11-server \
setprop options/config_file=xorg.conf.vesa
Example: Enabling the XINERAMA extension
The following command enables the XINERAMA extension.
svccfg -s svc:/application/x11/x11-server \
setprop options/server_args = +xinerama
FILES
/usr/bin/Xserver Script used to start an X server using
the properties set in SMF.
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
+---------------+---------------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+---------------------------+
|Availability | x11/server/xserver-common |
+---------------+---------------------------+
|Stability | Volatile |
+---------------+---------------------------+
SEE ALSO
General information: X(7), Xserver(1), Xsecurity(7)
Starting the server: gdm(1m), startx(1), xdm(1), xinit(1)
Server-specific man pages: Xorg(1), Xephyr(1), Xvfb(1), Xvnc(1).
Service management framework: smf(7), svcadm(8), svccfg(8)
NOTES
Source code for open source software components in Oracle Solaris can
be found at https://www.oracle.com/downloads/opensource/solaris-source-
code-downloads.html.
This software was built from source available at
https://github.com/oracle/solaris-userland. The original community
source was downloaded from https://www.x.org/releases/individ-
ual/xserver/xorg-server-1.20.13.tar.gz.
Further information about this software can be found on the open source
community website at https://www.x.org.
Oracle Solaris 26 Nov 2018
application/x11/x11-server(8s)