Go to main content

man pages section 8: System Administration Commands

Exit Print View

Updated: Wednesday, July 27, 2022

x11-server (8s)


x11-server - X Window System display service


Please see following description for synopsis


SMF Services                                    application/x11/x11-server(8s)

       svc:/application/x11/x11-server - X Window System display service

       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.

       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.

       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:

              (Type  astring) The absolute path to the X server binary to run,
              currently must be one of:


              (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.

              (Type boolean) Setting this to true enables listening for incom-
              ing TCP/IP connections.

              (Type int) Sets the depth of the default visual of the X  server

              (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.

              (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.

              (Type boolean) Setting this  to  true  starts  the  Xorg  server
              instead of the Xvnc server for platforms that have ILOM VNC sup-

   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

       /usr/bin/Xserver              Script  used  to  start an X server using
                                     the properties set in SMF.

       See attributes(7) for descriptions of the following attributes:

       |Availability   | x11/server/xserver-common |
       |Stability      | Volatile                  |

       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)

       Source code for open source software components in Oracle  Solaris  can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-

       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-

       Further information about this software can be found on the open source
       community website at https://www.x.org.

Oracle Solaris                    26 Nov 2018