components/x11/xorg-docs/src/platforms/Solaris.txt

   1 X Window System on Solaris™
   2
   3 David Holland
   4
   5 XFree86 Project
   6
   7 Marc Aurele La France
   8
   9 XFree86 Project
  10
  11 Alan Coopersmith
  12
  13 Oracle Corp.
  14
  15 X Version 11, Release 7.7
  16
  17 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  18
  19 Table of Contents
  20
  21 The VT-switching sub-system in Solaris
  22 Notes for building X11R7.7 on Solaris
  23 Notes for running Xorg on Solaris
  24 Bug Notification
  25
  26 The VT-switching sub-system in Solaris
  27
  28 The original virtual terminal sub-system is a undocumented, and unsupported
  29 feature of Solaris x86 releases 2.1 through 7. It was removed in Solaris 8 and
  30 later releases, and was never present on Solaris SPARC. Support for this
  31 version of virtual terminals is only present in Xorg 1.6.x and earlier releases
  32 of Xorg, and has been removed in Xorg 1.7 and later. If you use this form of
  33 virtual terminals, you do so at YOUR OWN RISK.
  34
  35 A new virtual terminal sub-system has been introduced in Solaris 11, and is
  36 also available in systems based on the OpenSolaris or illumos sources. This
  37 version is supported on both SPARC and x86 platforms, though SPARC support is
  38 limited to devices with "Coherent Console" support in the kernel frame buffer
  39 driver. Support for it is found only in Xorg 1.7 and later server releases.
  40
  41 When available, the virtual terminals of Solaris work basically the same way as
  42 most other VT sub-systems.
  43
  44 Notes for building X11R7.7 on Solaris
  45
  46  1. Both GCC, and the Sun Studio compilers are supported by X11R7.7. The
  47     minimum recommended GCC release is 3.4. Some earlier GCC's are known to not
  48     work and should be avoided.
  49
  50     You should also make certain your version of GCC predefines `sun'. If
  51     needed edit /usr/local/lib/gcc-lib/*/*/specs, and modify the *predefines:
  52     line.
  53
  54  2. To build X11R7.7 with GCC you need gcc and (optionally) c++filt from GNU
  55     binutils. Don't install gas or ld from GNU binutils, use the one provided
  56     by Sun.
  57
  58  3. If you are using Sun compilers to compile the X11R7.7 distribution, you
  59     need to modify your PATH appropriately so the Sun compiler tools are
  60     available. Normally, they should be in /opt/SUNWspro/bin
  61
  62  4. You MUST put /usr/ccs/bin at the front of your PATH. There are known
  63     problems with some GNU replacements for the utilities found there, so the /
  64     usr/ccs/bin versions of these programs must be found before any possible
  65     GNU versions. (Most notably GNU 'ar' does not work during the build).
  66
  67 Notes for running Xorg on Solaris
  68
  69  1. Depending on the release or architecture of Solaris you are running, you
  70     might need to install an OS driver for an aperture device.
  71
  72     Under Solaris x86 2.5 and later, there's a system driver (/dev/xsvc) that
  73     provides this functionality. It will be detected automatically by the
  74     server, so you don't need to install the aperture driver.
  75
  76     For older Solaris x86 and for Solaris SPARC releases, the source for this
  77     driver is included in hw/xfree86/os-support/solaris/apSolaris.shar in the
  78     xserver source distribution. Building, and installing the driver is
  79     relatively straight forward. Please read its accompanying README file.
  80
  81  2. Xqueue is NOT supported under Solaris.
  82
  83 Bug Notification
  84
  85 Bug reports should be reported at http://bugs.freedesktop.org/ using the xorg
  86 product or sent to <xorg@lists.freedesktop.org>.
  87