Solaris.xml revision 972599cf 
1<?xml version="1.0" encoding="UTF-8"?>
2<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
3                      "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd"
4[
5<!ENTITY % defs SYSTEM "defs.ent"> %defs;
6]>
7
8<article id='Solaris'>
9
10<!-- Title information -->
11<articleinfo>
12
13 <title>X Window System on <trademark>Solaris</trademark></title>
14 <releaseinfo>X Version 11, Release &fullrelvers;</releaseinfo>
15 <authorgroup>
16  <author>
17    <firstname>David</firstname><surname>Holland</surname>
18      <affiliation><orgname><ulink url="http://www.xfree86.org/">XFree86
19	      Project</ulink></orgname></affiliation>
20  </author>
21
22  <author>
23    <firstname>Marc</firstname><surname>Aurele La France</surname>
24      <affiliation><orgname><ulink url="http://www.xfree86.org/">XFree86
25	      Project</ulink></orgname></affiliation>
26  </author>
27
28  <author>
29      <firstname>Alan</firstname><surname>Coopersmith</surname>
30      <affiliation><orgname><ulink url="http://www.oracle.com/">Oracle
31	      Corp.</ulink></orgname></affiliation>
32  </author>
33 </authorgroup>
34
35 <date>2012 March 20</date>
36</articleinfo>
37
38<!-- Table of contents -->
39
40<!-- Begin the document -->
41<sect1 id='The_VT-switching_sub-system_in_Solaris'>
42<title>The VT-switching sub-system in Solaris</title>
43
44<para>
45The original virtual terminal sub-system is a undocumented, and
46unsupported feature of Solaris x86 releases 2.1 through 7.  It was removed
47in Solaris 8 and later releases, and was never present on Solaris SPARC.
48Support for this version of virtual terminals is only present in Xorg 1.6.x
49and earlier releases of Xorg, and has been removed in Xorg 1.7 and later.
50If you use this form of virtual terminals, you do so at
51<emphasis remap="bf">YOUR OWN RISK</emphasis>.
52</para>
53
54<para>
55A new virtual terminal sub-system has been introduced in Solaris 11,
56and is also available in systems based on the OpenSolaris or illumos sources.
57This version is supported on both SPARC and x86 platforms, though SPARC
58support is limited to devices with "Coherent Console" support in the kernel
59frame buffer driver.  Support for it is found only in Xorg 1.7 and later
60server releases.
61</para>
62
63<para>
64When available, the virtual terminals of Solaris work basically the same way as
65most other VT sub-systems.
66</para>
67
68</sect1>
69
70<sect1 id='Notes_for_building_X11R&relvers;_on_Solaris'>
71<title>Notes for building X11R&relvers; on Solaris</title>
72
73<para>
74
75<orderedlist>
76<listitem>
77<para>
78Both GCC, and the Sun Studio compilers are supported by X11R&relvers;.
79The minimum recommended GCC release is 3.4.
80Some earlier GCC's are known to not work and should be avoided.
81</para>
82<para>
83You should also make certain your version of GCC predefines `sun'.
84If needed edit <filename>/usr/local/lib/gcc-lib/*/*/specs</filename>, and modify the
85<literal remap="tt">*predefines:</literal> line.
86</para>
87
88</listitem>
89<listitem>
90<para>
91To build X11R&relvers; with GCC you need gcc and (optionally) c++filt from GNU
92binutils.
93Don't install gas or ld from GNU binutils, use the one provided by Sun.
94</para>
95</listitem>
96<listitem>
97<para>
98If you are using Sun compilers to compile the X11R&relvers; distribution, you need to
99modify your PATH appropriately so the Sun compiler tools are available.
100Normally, they should be in
101<filename class="directory">/opt/SUNWspro/bin</filename>
102</para>
103</listitem>
104<listitem>
105<para>
106You <emphasis remap="bf">MUST</emphasis> put
107<filename class="directory">/usr/ccs/bin</filename>
108at the front of your PATH.  There are known problems with some GNU
109replacements for the utilities found there,
110so the <filename class="directory">/usr/ccs/bin</filename> versions of
111these programs must be found before any possible GNU versions.
112(Most notably GNU '<command>ar</command>' does not work during the build).
113</para>
114</listitem>
115
116</orderedlist>
117
118</para>
119
120</sect1>
121
122<sect1 id='Notes_for_running_Xorg_on_Solaris'>
123<title>Notes for running Xorg on Solaris</title>
124
125<para>
126
127<orderedlist>
128<listitem>
129<para>
130Depending on the release or architecture of Solaris you are running, you might
131need to install an OS driver for an aperture device.
132</para>
133<para>
134Under Solaris x86 2.5 and later, there's a system driver
135(<filename class="devicefile">/dev/xsvc</filename>)
136that provides this functionality.
137It will be detected automatically by the server, so you don't need to install
138the aperture driver.
139</para>
140
141<para>
142For older Solaris x86 and for Solaris SPARC releases, the source for this
143driver is included in
144<filename>hw/xfree86/os-support/solaris/apSolaris.shar</filename>
145in the xserver source distribution.
146Building, and installing the driver is relatively straight forward. Please read
147its accompanying README file.
148</para>
149</listitem>
150<listitem>
151<para>
152Xqueue is <emphasis remap="bf">NOT</emphasis> supported under Solaris.
153</para>
154</listitem>
155
156</orderedlist>
157
158</para>
159
160</sect1>
161
162
163<sect1 id='Bug_Notification'>
164<title>Bug Notification</title>
165
166<para>
167Bug reports should be reported at
168<ulink url="http://bugs.freedesktop.org/"></ulink> using the
169xorg product or sent to <email>xorg@lists.freedesktop.org</email>.
170</para>
171
172</sect1>
173
174</article>
175