Annotation of researchv9/X11/src/X.V11R1/server/ddx/sun/README, revision 1.1.1.1

1.1       root        1: 
                      2:        Sun X11 drivers -  10 September 1987
                      3: 
                      4: A joint production of:
                      5: 
                      6:        Adam de Boor            University of California,  Berkeley
                      7: 
                      8:        David Rosenthal
                      9:        Stuart Marks
                     10:        Robin Schaufler
                     11:        Mike Schwartz
                     12:        Frances Ho
                     13:        Geoff Lee
                     14:        Mark Opperman           Sun Microsystems
                     15: 
                     16: Special thanks to:
                     17: 
                     18:        MIT's Statistics Center,  for generously allowing us to monopolize
                     19:        their Suns while we integrated the Sun code into the releases.
                     20: 
                     21: This version of the Sun X.11 drivers uses ../mi,  ../mfb and ../cfb to support
                     22: the following configurations:
                     23: 
                     24:        Sun/2           bw2     cg2/3/5
                     25:        Sun/3           bw2     cg2/3/4/5
                     26:        Sun/4           bw2
                     27: 
                     28: The following configurations are NOT supported:
                     29: 
                     30:        Sun/1           bw1     cg1     (requires separate port)
                     31:        Sun/2                   gp      (use /dev/cgtwo0)
                     32:        Sun/3                   gp      (use /dev/cgtwo0)
                     33:        Sun/4                   cg2     (we're working on it)
                     34: 
                     35: The drivers are completely untuned, and have inferior performance.  The code
                     36: is lint-free.  It installs and runs on these configurations under SunOS 3.2,
                     37: 3.4, and 4.0.  However, we must stress that it is completely unsupported, and
                     38: if you have problems installing or using it you are on your own.
                     39: 
                     40: Things to check before building:
                     41: 
                     42: 1)     server/include/site.h - replace the font and rgb paths.
                     43: 
                     44: 2)     Make sure the fonts/Makefile uses the pad flag on the font
                     45:        compiler to pad the glyphs to 4-byte boundaries.
                     46: 
                     47: 3)     If you want the non-portable zoids extension, add -DZOIDS to CFLAGS.
                     48:        The non-portable zoids have worse performance than portable zoids
                     49:        but prove that the extension mechanism works for output.
                     50: 
                     51: Then build the system by:
                     52: 
                     53: 1)     Make the dependency generator:
                     54: 
                     55:        cd makedepend ; make ; cd ..
                     56: 
                     57: 2)     Update the dependencies by:
                     58: 
                     59:        find . -name Makefile -exec chmod u+w {} \;
                     60:        make depend
                     61:        find . -name Makefile -exec chmod u-w {} \;
                     62: 
                     63: 3)     Go for it.  In the top-level directory, type
                     64: 
                     65:            make
                     66: 
                     67:        This takes about forty minutes on a 4/260, and somewhat longer
                     68:        on other Suns.
                     69: 
                     70: 3)     Exit suntools or whatever other window system you use.
                     71: 
                     72: 4)     On the console, or from an rlogin connection,  start the server:
                     73: 
                     74:            clients/xinit/xinit
                     75:        or
                     76:            clients/xinit/xinit -- -dev /dev/??? [see below]
                     77: 
                     78:        If it's from the console,  you probably want to redirect the
                     79:        output thus:
                     80: 
                     81:            clients/xinit/xinit >& /tmp/x11.out
                     82: 
                     83: 5)     xinit should start up an xterm window that acts as a console.  When
                     84:        this xterm terminates, the xinit will kill the server.  You can also
                     85:        start up client programs from a terminal or rlogin, but you must
                     86:        first set the DISPLAY environment variable:
                     87: 
                     88:            setenv DISPLAY unix:0
                     89:            clients/xterm/xterm &
                     90: 
                     91: 
                     92: 6)     In general,  Xsun auto-configures to use all the available
                     93:        framebuffers.  In some circumstances,  you may need to use a
                     94:        -dev argument on the command line to prevent this:
                     95: 
                     96:        3/110LC, 3/110C, 3/60C 
                     97: 
                     98:        If you want to use color, use "xinit -- -dev /dev/cgfour0".
                     99:        If you want to use monochrome, use "xinit -- -dev /dev/bwtwo0".
                    100:                
                    101:        GP, GP+, GP2
                    102: 
                    103:        If you have one of these GP's installed, use 
                    104: 
                    105:            xinit -- -dev /dev/cgtwo0
                    106: 
                    107: 7)     To shut the server down,  it  it with a Hangup or Terminate signal.
                    108: 
                    109: 8)     Xsun coexists with the SunWindows environment.  If you run Xsun
                    110:        from a shell window under suntools, then Xsun will overlay that
                    111:        desktop.  If you have two desktops, then 'adjacentscreens' will still
                    112:        be in effect.  You may want to redirect the output of the server to a
                    113:        window that is visible on another desktop.
                    114: 
                    115: 9)     If X crashes, it will leave the keyboard in a funny state.  There is a
                    116:        program called "kbd_mode" that will reset the mode of the keyboard.
                    117:        "kbd_mode -a" is the appropriate setting for the bare console, and
                    118:        "kbd_mode -e" is the appropriate setting for running with SunWindows.
                    119:        You may have to issue this command from a terminal or from an rlogin
                    120:        connection.  If you run from the bare console, you can give the
                    121:        command
                    122: 
                    123:        xinit ; kbd_mode -a
                    124: 
                    125:        so that the keyboard mode will ALWAYS be set properly when the server
                    126:        terminates.  The kbd_mode program is in the server/ddx/sun directory.

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.