← Back to branch summary

~ubuntu-branches/ubuntu/gutsy/vnc4/gutsy

« back to all changes in this revision

Viewing changes to unix/xc/programs/Xserver/hw/xfree86/doc/README.Solaris

  • Committer: Bazaar Package Importer
  • Author(s): Ola Lundqvist
  • Date: 2006-05-15 20:35:17 UTC
  • mfrom: (1.1.2 upstream)
  • Revision ID: james.westby@ubuntu.com-20060515203517-l4lre1ku942mn26k
Tags: 4.1.1+X4.3.0-10
* Correction of critical security issue. Thanks to Martin Kogler
  <e9925248@student.tuwien.ac.at> that informed me about the issue,
  and provided the patch.
  This flaw was originally found by Steve Wiseman of intelliadmin.com.
* Applied patch from Javier Kohen <jkohen@users.sourceforge.net> that
  inform the user that only 8 first characters of the password will
  actually be used when typing more than 8 characters, closes:
  #355619.

Show diffs side-by-side

added added

removed removed

Lines of Context:
unix/xc/programs/Xserver/hw/xfree86/doc/README.Solaris
 
1
                           Information for Solaris
 
2
 
 
3
              David Holland, modified by Marc Aurele La France
 
4
 
 
5
                               2001 October 01
 
6
 
 
7
1.  What is XFree86
 
8
 
 
9
XFree86 is a port of X11R6.5.1 that supports several versions of Unix.  It is
 
10
derived from X386 1.2 which was the X server distributed with X11R5.  This
 
11
release consists of many new features and performance improvements as well as
 
12
many bug fixes.  The release is available as a source code distribution, as
 
13
well as binary distributions for many architectures.
 
14
 
 
15
The sources for XFree86 are available by anonymous ftp from:
 
16
 
 
17
     ftp://ftp.XFree86.org/pub/XFree86/current
 
18
 
 
19
Solaris binaries for XFree86 are available for anonymous ftp at the same
 
20
address.  Currently, two binary distributions are available:  one for Solaris
 
21
8 x86, the other for previous Solaris x86 releases.  They are not inter-
 
22
changeable.  No binary distribution is available for Solaris/SPARC as it is
 
23
still under development.
 
24
 
 
25
2.  The VT-switching sub-system in Solaris x86
 
26
 
 
27
The virtual terminal sub-system is a undocumented, and unsupported feature of
 
28
Solaris x86.  Therefore if you use virtual terminals, you do so at YOUR OWN
 
29
RISK.
 
30
 
 
31
Virtual terminals are not available in Solaris SPARC, and their availability
 
32
has been removed in Solaris8 x86.
 
33
 
 
34
When available, the virtual terminals of Solaris work basically the same way
 
35
as most other SVR4 VT sub-systems.  However, there are a number of limita-
 
36
tions documented below.
 
37
 
 
38
First, if you are running a Solaris 2.4 x86 system, and you want VT's, you
 
39
will have to create the necessary devices first, so become root.
 
40
 
 
41
Verify the chanmux device driver's major number is 100:
 
42
 
 
43
          # grep -i chanmux /etc/name_to_major
 
44
          chanmux 100
 
45
          #
 
46
 
 
47
If the number after 'chanmux' is anything but 100, I would suggest you imme-
 
48
diately abort your attempt to create virtual terminals, and learn to live
 
49
without them.
 
50
 
 
51
However, if it is 100, then as root type the following commands to create the
 
52
maximum allowable number of virtual terminals.
 
53
 
 
54
          # cd /dev
 
55
          # mknod vt01 c 100 1
 
56
          # mknod vt02 c 100 2
 
57
          # mknod vt03 c 100 3
 
58
          # mknod vt04 c 100 4
 
59
          # mknod vt05 c 100 5
 
60
          # mknod vt06 c 100 6
 
61
          # mknod vt07 c 100 7
 
62
 
 
63
There is no need for a reconfiguration boot.
 
64
 
 
65
Secondly, for both 2.1, and 2.4 x86 systems, add a few lines to the inittab
 
66
to enable logins on them.
 
67
 
 
68
(Note, do NOT make a mistake here, you could lock yourself out of the system)
 
69
 
 
70
     --------------------->Snip Snip<-----------------------------------------------
 
71
     v1:234:respawn:/usr/lib/saf/ttymon -g -h -p "`uname -n` VT01 login: " -T AT386 -d /dev/vt01 -l console
 
72
     v2:234:respawn:/usr/lib/saf/ttymon -g -h -p "`uname -n` VT02 login: " -T AT386 -d /dev/vt02 -l console
 
73
     v3:234:respawn:/usr/lib/saf/ttymon -g -h -p "`uname -n` VT03 login: " -T AT386 -d /dev/vt03 -l console
 
74
     v4:234:respawn:/usr/lib/saf/ttymon -g -h -p "`uname -n` VT04 login: " -T AT386 -d /dev/vt04 -l console
 
75
     ---------------------->End Here<-----------------------------------------------
 
76
 
 
77
These four lines enable four VT's on Alt-SysReq-F1 through Alt-SysReq-F4.
 
78
 
 
79
Then execute the command 'init q' to immediately enable the virtual termi-
 
80
nals.
 
81
 
 
82
The keys used for VT switching are as follows:
 
83
 
 
84
     Alt-SysReq-F1 through Alt-SysReq-F7 enable VT screens 1-7 respec-
 
85
     tively (if the VT is active).
 
86
 
 
87
     Alt-SysReq-n enables the next active VT screen.
 
88
 
 
89
     Alt-SysReq-p enables the previous active VT screen.
 
90
 
 
91
     Alt-SysReq-h returns to the console.
 
92
 
 
93
If you are using virtual terminals, you must leave at least one free for use
 
94
by the Xserver.
 
95
 
 
96
Limitations of the virtual terminal sub-system under Solaris x86:
 
97
 
 
98
There are only a total of 8 available VT's (7 normal VT's + 1 console) not
 
99
the usual 15.  If you have all 8 allocated, and you attempt to allocate a
 
100
additional VT you will panic the system.  (This bug is worked around in the
 
101
Solaris XFree86 Xserver.)
 
102
 
 
103
From a programming stand point, they work pretty much as documented in the
 
104
AT&T Unix System V/386 Release 4 Integrated Software Development Guide, how-
 
105
ever a number of ioctl() calls are broken.
 
106
 
 
107
3.  Notes for building XFree86 on Solaris
 
108
 
 
109
  1.  Both GCC, and ProWorks are supported by XFree86.  The minimum recom-
 
110
      mended GCC release is 2.7.2.  Some earlier GCC's are known to not work
 
111
      and should be avoided.
 
112
 
 
113
      You should also make certain your version of GCC predefines `sun'.  If
 
114
      needed edit /usr/local/lib/gcc-lib/*/*/specs, and modify the *prede-
 
115
      fines: line.
 
116
 
 
117
      On SPARCs, regardless of the compiler you use, ensure it generates
 
118
      32-bit binaries.  At this time, 64-bit binaries will probably not work.
 
119
 
 
120
  2.  Also on SPARCs, you will need to set BuildXFree86OnSparcSunOS to YES in
 
121
      ~xc/config/cf/host.def.  Otherwise, you can only build the old depre-
 
122
      cated Xsun* servers.
 
123
 
 
124
  3.  A Threaded Xlib compiled with GCC has subtle problems.  It'll work 98%
 
125
      of the time, however clients will occasionally exhibit strange hangs.
 
126
      Most notably image viewers such as xv-3.10 exhibit this problem.
 
127
 
 
128
      It is recommended that you set ThreadedX in ~xc/config/cf/host.def to
 
129
      NO, if you are using GCC.  ProWorks does not have this problem.
 
130
      Whether this behaviour still exists with newer GCC's has not been veri-
 
131
      fied.
 
132
 
 
133
  4.  To build XFree86 with GCC you need gcc and (optionally) c++filt from
 
134
      GNU binutils.  Don't install gas or ld from GNU binutils, use the one
 
135
      provided by Sun.
 
136
 
 
137
      You might need to setup a /opt/SUNWspro/bin directory containing sym-
 
138
      bolic links named cc, CC, and c++filt pointing respectively to the
 
139
      actual gcc, g++ and c++filt commands.
 
140
 
 
141
  5.  If you are using ProWorks to compile the XFree86 distribution, you need
 
142
      to modify your PATH appropriately so the ProWorks tools are available.
 
143
      Normally, they should be in /opt/SUNWspro/bin
 
144
 
 
145
  6.  You MUST put /usr/ccs/bin at the front of your PATH.  There are known
 
146
      problems with some GNU replacements for the utilities found there.  So
 
147
      the /usr/ccs/bin versions of these programs must be found before any
 
148
      possible GNU versions.  (Most notably GNU 'ar' does not work during the
 
149
      build).
 
150
 
 
151
4.  Notes for running XFree86 on Solaris
 
152
 
 
153
  1.  Depending on the release or architecture of Solaris you are running,
 
154
      you might need to install an OS driver for an aperture device.
 
155
 
 
156
      Under Solaris x86 2.5 and later, there's a system driver (/dev/xsvc)
 
157
      that provides this functionality.  It will be detected automatically by
 
158
      the server, so you don't need to install the aperture driver.
 
159
 
 
160
      For older Solaris x86 and for Solaris SPARC releases, the source for
 
161
      this driver is included in xc/programs/Xserver/hw/xfree86/etc/apSo-
 
162
      laris.shar of the source distribution.  This file can usually also be
 
163
      found in the /usr/X11R6/lib/X11/etc directory when XFree86 is
 
164
      installed.  Building, and installing the driver is relatively straight
 
165
      forward. Please read its accompanying README file.
 
166
 
 
167
  2.  If you have not made the Virtual Terminal devices, you will need to
 
168
      specify the terminal device to run the Xserver on.  The correct device
 
169
      is vt00 so your xinit command would look like so:
 
170
 
 
171
                xinit -- vt00
 
172
 
 
173
      If you have made the virtual terminal devices you do not need to spec-
 
174
      ify the VT to run the Xserver on.
 
175
 
 
176
  3.  For Solaris you will probably want to set your LD_LIBRARY_PATH to
 
177
      /usr/X11R6/lib:/usr/openwin/lib:/usr/dt/lib.  Including /usr/X11R6/lib
 
178
      in your LD_LIBRARY_PATH is probably not necessary, however it doesn't
 
179
      hurt. :)
 
180
 
 
181
      Including /usr/openwin/lib in the LD_LIBRARY_PATH is recommended
 
182
      because some Sun supplied binaries were not compiled with LD_RUN_PATH
 
183
      set properly at compile time.
 
184
 
 
185
      Motif and CDE applications may require /usr/dt/lib in your
 
186
      LD_LIBRARY_PATH too.
 
187
 
 
188
  4.  Xqueue is NOT supported under Solaris.  The includes necessary for
 
189
      Xqueue are available, however the driver does not seem to be in the
 
190
      kernel.  (Go figure)
 
191
 
 
192
  5.  If you want to use xdm with Solaris, extract the files from the shar
 
193
      file in /usr/X11R6/lib/X11/etc/XdmConf.svr4 into a temporary directory.
 
194
      The README file tells where the individual files need to be installed.
 
195
      Be sure to read through each file and make any site-specific changes
 
196
      that you need.
 
197
 
 
198
5.  Known bugs, and work arounds with Solaris
 
199
 
 
200
  1.  The Solaris 2.1 for x86 OpenWindows filemgr does not work against a
 
201
      X11R5 Xserver, it probably will also not work against a X11R6 Xserver.
 
202
      Attempting to 'Drag and Drop' a file causes the filemgr to abort with
 
203
      an 'X error'
 
204
 
 
205
      Solaris x86 2.4 does not have this problem.
 
206
 
 
207
      There is no known work around.
 
208
 
 
209
  2.  The SPARC port is still quite new, so instability is to be expected
 
210
      (and reported!).  It might even have broken some aspects of the x86
 
211
      port.
 
212
 
 
213
6.  Bug Notification
 
214
 
 
215
Bug reports should be sent to <XFree86@XFree86.org>.
 
216
 
 
217
     Generated from XFree86: xc/programs/Xserver/hw/xfree86/doc/sgml/Solaris.sgml,v 1.4 2003/01/04 04:20:23 dawes Exp $
 
218
 
 
219
 
 
220
$XFree86: xc/programs/Xserver/hw/xfree86/doc/README.Solaris,v 1.4 2003/01/04 04:28:27 dawes Exp $