README
1A joint production of:
2
3 Adam de Boor University of California, Berkeley
4
5 David Rosenthal
6 Stuart Marks
7 Robin Schaufler
8 Mike Schwartz
9 Frances Ho
10 Geoff Lee
11 Mark Opperman Sun Microsystems
12
13 Bob Scheifler MIT Laboratory for Computer Science
14 Keith Packard
15
16This version of the Sun X11 drivers uses ../mi, ../mfb and ../cfb to support
17the following configurations:
18
19 Sun/2 bw2 cg2/3/5
20 Sun/3 bw2 cg2/3/4/5
21 Sun/4 bw2 cg2/4
22 SPARCstation cg3/6
23 Sun/386i mono color
24
25The following configurations are NOT supported:
26
27 Sun/1 bw1 cg1 (requires separate port)
28 Sun/2 gp (use /dev/cgtwo0)
29 Sun/3 gp (use /dev/cgtwo0)
30 Sun/4 gp (use /dev/cgtwo0)
31
32The mfb and cfb code has been substantially tuned for 1- and 8-bit framebuffers
33(with code for both fast and slow cpu-to-memory ratios). It installs and runs
34on these configurations under SunOS 3.2, 3.4, and 4.0. However, we must stress
35that it is completely unsupported, and if you have problems installing or using
36it you are on your own.
37
38
39Things to check before building:
40
411) config/sun.cf - set the SunOSMajorVersion and SunOSMinorVersion
42 parameters to the right values.
43
442) config/Project.tmpl - check LIBDIR, FONTDIR, etc.; set
45 define LibDir, FontDir, etc. in site.def as required.
46
47
48
49Then build the system by:
50
511) Go for it. In the top-level directory, type
52
53 make World
54
55 This takes about forty minutes on a 4/260, and somewhat longer
56 on other Suns.
57
58
592) Go for it. In the top-level directory, type
60
61 make install
62
63 Otherwise, you'll want to create a bunch of symbolic links to
64 the various executables and data files scattered throughout
65 the hierarchy.
66
67
68
693) On the console, or from an rlogin connection, put whatever you
70 chose for BINDIR (in Imake.tmpl) in your search path, and then
71 start the server:
72
73 xinit
74 or
75 xinit -- -dev /dev/??? [see below]
76
77 If it's from the console, you probably want to redirect the
78 output thus:
79
80 xinit >& /tmp/x11.out
81
824) xinit should start up an xterm window that acts as a console. When
83 this xterm terminates, the xinit will kill the server. You can also
84 start up client programs from a terminal or rlogin, but you must
85 first set the DISPLAY environment variable:
86
87 setenv DISPLAY unix:0
88 xterm &
89
90
915) Make sure that you have special devices in /dev for the appropriate
92 framebuffer. See the manual page for Xsun for details or run the
93 constype program. VME systems require special .o files when more
94 than one of a particular frame buffer type is installed.
95
96
976) In general, Xsun auto-configures to use all the available framebuffers
98 (see the Xsun manual page). In some circumstances, you may need to
99 use the -dev switch on the command line to specify a specific device
100 to use. In particular, on the GP, GP+, and GP2, you'll need to
101 specify -dev /dev/cgtwo0 your xdm Xservers file or your xinit script.
102
103
1047) To shut the server down, send it a Hangup or Terminate signal.
105
106
1078) If X crashes, it will leave the keyboard in a funny state. There is a
108 program called "kbd_mode" that will reset the mode of the keyboard.
109 "kbd_mode -a" is the appropriate setting for the bare console, and
110 "kbd_mode -e" is the appropriate setting for running with SunWindows.
111 You may have to issue this command from a terminal or from an rlogin
112 connection. If you run from the bare console, you can give the
113 command
114
115 xinit ; kbd_mode -a
116
117 so that the keyboard mode will ALWAYS be set properly when the server
118 terminates.
119