Solaris.xml 4.93 KB
Newer Older
1 2 3 4
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
                      "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd"
[
5
<!ENTITY % defs SYSTEM "defs.ent"> %defs;
6
]>
7

8
<article id='Solaris'>
9 10

<!-- Title information -->
11 12
<articleinfo>

13
 <title>X Window System on <trademark>Solaris</trademark></title>
14
 <releaseinfo>X Version 11, Release &fullrelvers;</releaseinfo>
15 16 17
 <authorgroup>
  <author>
    <firstname>David</firstname><surname>Holland</surname>
18
      <affiliation><orgname><ulink url="https://www.xfree86.org/">XFree86
19 20 21 22 23
	      Project</ulink></orgname></affiliation>
  </author>

  <author>
    <firstname>Marc</firstname><surname>Aurele La France</surname>
24
      <affiliation><orgname><ulink url="https://www.xfree86.org/">XFree86
25 26 27 28 29
	      Project</ulink></orgname></affiliation>
  </author>

  <author>
      <firstname>Alan</firstname><surname>Coopersmith</surname>
30
      <affiliation><orgname><ulink url="https://www.oracle.com/">Oracle
31
	      Corp.</ulink></orgname></affiliation>
32 33 34
  </author>
 </authorgroup>

35
 <date>2012 March 20</date>
36
</articleinfo>
37 38 39 40

<!-- Table of contents -->

<!-- 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>
45 46 47 48 49 50
The original virtual terminal sub-system is a undocumented, and
unsupported feature of Solaris x86 releases 2.1 through 7.  It was removed
in Solaris 8 and later releases, and was never present on Solaris SPARC.
Support for this version of virtual terminals is only present in Xorg 1.6.x
and earlier releases of Xorg, and has been removed in Xorg 1.7 and later.
If you use this form of virtual terminals, you do so at
51 52
<emphasis remap="bf">YOUR OWN RISK</emphasis>.
</para>
53

54
<para>
55 56 57 58 59 60
A new virtual terminal sub-system has been introduced in Solaris 11,
and is also available in systems based on the OpenSolaris or illumos sources.
This version is supported on both SPARC and x86 platforms, though SPARC
support is limited to devices with "Coherent Console" support in the kernel
frame buffer driver.  Support for it is found only in Xorg 1.7 and later
server releases.
61
</para>
62

63
<para>
64
When available, the virtual terminals of Solaris work basically the same way as
65
most 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 76 77
<orderedlist>
<listitem>
<para>
78
Both GCC, and the Sun Studio compilers are supported by X11R&relvers;.
79
The minimum recommended GCC release is 3.4.
80
Some earlier GCC's are known to not work and should be avoided.
81 82
</para>
<para>
83
You should also make certain your version of GCC predefines `sun'.
84
If needed edit <filename>/usr/local/lib/gcc-lib/*/*/specs</filename>, and modify the
85 86
<literal remap="tt">*predefines:</literal> line.
</para>
87

88 89 90
</listitem>
<listitem>
<para>
91
To build X11R&relvers; with GCC you need gcc and (optionally) c++filt from GNU
92
binutils.
93
Don't install gas or ld from GNU binutils, use the one provided by Sun.
94 95 96 97
</para>
</listitem>
<listitem>
<para>
98 99
If you are using Sun compilers to compile the X11R&relvers; distribution, you need to
modify your PATH appropriately so the Sun compiler tools are available.
100 101
Normally, they should be in
<filename class="directory">/opt/SUNWspro/bin</filename>
102 103 104 105 106
</para>
</listitem>
<listitem>
<para>
You <emphasis remap="bf">MUST</emphasis> put
107 108 109 110 111 112
<filename class="directory">/usr/ccs/bin</filename>
at the front of your PATH.  There are known problems with some GNU
replacements for the utilities found there,
so the <filename class="directory">/usr/ccs/bin</filename> versions of
these programs must be found before any possible GNU versions.
(Most notably GNU '<command>ar</command>' does not work during the build).
113 114
</para>
</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 128 129
<orderedlist>
<listitem>
<para>
130
Depending on the release or architecture of Solaris you are running, you might
131
need to install an OS driver for an aperture device.
132 133
</para>
<para>
134 135
Under Solaris x86 2.5 and later, there's a system driver
(<filename class="devicefile">/dev/xsvc</filename>)
136 137
that provides this functionality.
It will be detected automatically by the server, so you don't need to install
138
the aperture driver.
139
</para>
140

141
<para>
142 143
For older Solaris x86 and for Solaris SPARC releases, the source for this
driver is included in
144 145
<filename>hw/xfree86/os-support/solaris/apSolaris.shar</filename>
in the xserver source distribution.
146
Building, and installing the driver is relatively straight forward. Please read
147
its accompanying README file.
148 149 150 151 152 153 154
</para>
</listitem>
<listitem>
<para>
Xqueue is <emphasis remap="bf">NOT</emphasis> supported under Solaris.
</para>
</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>
167
Bug reports should be reported at
168
<ulink url="https://gitlab.freedesktop.org/xorg" />.
169
</para>
170

171
</sect1>
172

173
</article>