home *** CD-ROM | disk | FTP | other *** search
/ minnie.tuhs.org / unixen.tar / unixen / Other / Coherent / DemonArchives / docs / intel.x.faq.z / intel.x.faq
Encoding:
Text File  |  1993-10-12  |  30.0 KB  |  714 lines

  1. Archive-name: Intel-Unix-X-faq
  2. Last-modified: 1 Oct 1993
  3.  
  4. This article includes answers to:
  5.  
  6. I) What options do I have for X software on my Intel-based Unix system?
  7.     1. Free options
  8.     2. Commercial options
  9. II) What is XFree86 and where do I get it?
  10.     3. What is XFree86?
  11.     4. What OSs are supported?
  12.     5. What video hardware is supported?
  13.     6. What about accelerated boards?
  14.     7. Why doesn't XFree86 support 16-color VGA modes?
  15.     8. What other hardware or software requirements are there?
  16.     9. Where can I get source for XFree86?
  17.     10. Where can I get binaries for XFree86?
  18. IV) What general things should I know about running XFree86?
  19.     11. Installation directories
  20.     12. Configuration files
  21.     13. Determining VGA dot clocks and monitor modes
  22.     14. Rebuilding/reconfiguring the server from the link kit
  23. V) What OS-specific things should I know about running XFree86?
  24.     15. SVR4
  25.     16. SVR3
  26.     17. 386BSD
  27.     18. Linux
  28.     19. Mach
  29. VI) What things should I know for building XFree86 from source?
  30. VII) Is there anything special about building clients with XFree86?
  31.     20. BSD compatibility library
  32.     21. ANSICCOPTIONS
  33. VIII) Where to get more information
  34. IX)  [Special, for this month only] Preliminary information on XFree86 2.0
  35.  
  36. This article does NOT include answers to general X questions, since they
  37. are already covered by the X FAQ that is regularly posted by David B. Lewis
  38. <faq%craft@uunet.uu.net>.
  39.  
  40. For information on X packages for DOS systems, consult the (PC)NFS FAQ
  41. available from seagull.rtd.com:/pub/tcpip/pcnfs.FAQ.v1.2.Z
  42.  
  43. If you have anything to add or change on this FAQ just let me know.
  44. (especially if you had a problem that someone else was able to help you with)
  45. Send changes to steve@ecf.toronto.edu, please put 'FAQ' somewhere
  46. in the subject line so that my mail filter will put it in the correct folder.
  47.  
  48. Please DO NOT ask me questions that are not answered in this FAQ.  I do not
  49. have time to respond to these individually.  Instead, post your question
  50. to the net, and send me the question and answer together when you get it.
  51.  
  52. Frequently Asked Questions About X on Intel-based Unix (with answers)
  53. =====================================================================
  54.  
  55. I) What options do I have for X software on my Intel-based Unix system?
  56.  
  57. 1. Free options
  58.  
  59.     The BEST option is XFree86, which is an enhanced version of X386 1.2.
  60.     Any other version of X386 will be more difficult to compile.
  61.     Information on how to obtain it is listed below.
  62.  
  63.     X386 is the port of the X11 server to System V/386 that was done by
  64.     Thomas Roell (roell@sgcs.com).  It supports a wide variety of SVGA boards.
  65.     There are 2 major free versions: X386 1.1 is based on X11R4,
  66.     X386 1.2 is included in MIT's X11R5 distribution (ie. you
  67.     don't need to patch it into the MIT source any more).
  68.     X386 1.3 is the current commercial offering from SGCS (see below).
  69.  
  70.     Several other options are available for people running NeXTSTEP on
  71.     i486 and Pentium hardware. Information on mouseX, Cub'X and Co-Xist
  72.     is available via anonymous ftp from cs.orst.edu in /pub/next/XNeXT.
  73.  
  74. 2. Commercial options
  75.  
  76.      1) Metro Link
  77.     2213 W. McNab Road
  78.     Pompano Beach, FL  33069
  79.     (305) 970-7353
  80.     Fax: (305) 970-7351
  81.     email: sales@metrolink.com
  82.  
  83.     Summary: OS:    QNX, SVR3, SVR4.[012], SCO, UnixWare, LynxOS, 
  84.             DESQview/X, Venix, ISC, Solaris, Pyramid, SunOS
  85.          HW:    EGA, VGA, SVGA, TIGA, TARGA, 8514/A, Mach, 
  86.             S3, WD, Fujistu, Matrox, Microfield Graphics, R33020
  87.          Other: Motif, OpenLook/XView, XIE Imaging Extension,
  88.             Xv Video Extension, Audio Drivers, Multi Media
  89.  
  90.      2) SGCS (Snitily Graphics Consulting Services)
  91.     894 Brookgrove Lane
  92.     Cupertino, CA  95014
  93.     (800) 645-5501, (408) 255-9665
  94.     Fax: (408) 255-9740
  95.     email: info@sgcs.com  or ...!mips!zok!info
  96.  
  97.     Summary: OS: SVR3.2, SVR4 
  98.          HW: 8514/A (ATI Ultra), S3 (Diamond Stealth), SVGA
  99.          Other: Motif, Dual-headed server
  100.  
  101.      3) Consensys Corporation
  102.     1301 Pat Booker Rd.
  103.     Universal City, TX 78148
  104.     Phone: 1-800-388-1896
  105.     FAX:   1-416-940-2903
  106.     email: info@consensys.com
  107.  
  108.     Summary: OS: Consensys V4.2, Consensys' version of
  109.              Unix System V Release 4.2
  110.          HW: X11R4 server support for VGA, SVGA
  111.          Other: MoOLIT, Motif, X11R5 Clients
  112.  
  113.      4) The Santa Cruz Operation, Inc.
  114.     p.o. box 1900
  115.     Santa Cruz, California 95061
  116.     (408) 425 7222, (800) SCO UNIX,
  117.     FAX: (408) 458 4227
  118.     email: info@sco.com
  119.  
  120.     Summary: OS: ODT 1.1, ODT 2.0, ODT 3.0
  121.          HW: X11R5 server support for SVGA, 8514/A, S3, TMS340x0,
  122.              WD90C31, XGA2, QVision, misc. localbus video systems
  123.              (see Hardware Compatibility Handbook for actual card
  124.              vendors).
  125.          Other: Motif
  126.  
  127.      5) Answer Software & Consulting
  128.     p.o. box 14171
  129.     Columbus, Ohio 43214
  130.     614-263-XLAB
  131.     email: sales@x4coher.com
  132.  
  133.     Summary: OS: Coherent 4.0.1r72 or greater
  134.          HW: works with any VESA compliant video
  135.  
  136.  
  137.      6) OpenWindows (shipped as part of the Solaris for x86 OS)
  138.     SunSoft Inc.
  139.     2550 Garcia Ave.
  140.     Mountain View, CA  94043
  141.     Phone: 415-960-3200
  142.  
  143.     Summary: OS: Solaris for x86, SunSoft's version of SVR4.2
  144.          HW: Orchid ProDesigner II, Compaq QVision, Paradise
  145.              Accelerator Board, ET 4000 video card with VESA
  146.              configuration file, WD90C30 video card with VESA
  147.              configuration file, IBM XGA.
  148.          Other: X11R4 clients, XView, OLIT, DeskSet
  149.  
  150.   NOTE: Other commercial vendors (including OS vendors describing
  151.     bundled software) are welcome to submit summary information
  152.     summary information such as the above.
  153.  
  154. II) What is XFree86 and where do I get it?
  155.  
  156. 3. What is XFree86?
  157.  
  158.    XFree86 is an enhanced version of X386 1.2, which was distributed with
  159.    X11R5.  This release consists of many bug fixes, speed improvements, and
  160.    other enhancements. The release is available as source patches against the
  161.    MIT X11R5 code, as well as binary distributions for many architectures.
  162.  
  163.    Here are the highlights of the enhancements:
  164.  
  165.     1) The SpeedUp package from Glenn Lai is an integral part of XFree86,
  166.        selectable at run-time via the Xconfig file.  Some SpeedUps require
  167.        an ET4000 based SVGA, and others require a virtual screen width of
  168.        1024.  The SpeedUps suitable to the configuration are selected by
  169.        default.  With a high-quality ET4000 board (VRAM), this can yield
  170.        up to 40% improvement of the xStones benchmark over X386 1.2.
  171.     2) The fX386 packages from Jim Tsillas are included as the default
  172.        operating mode if SpeedUp is not selected.  This mode is now
  173.        equivalent in performance to X386 1.1b (X11R4), and approximately
  174.        20% faster than X386 1.2.
  175.     3) A monochrome server that supports bank-switching of available SVGA
  176.        memory to allow virtual screens up to 1600x1200.
  177.     4) Support for the Hercules mono card has been added to the monochrome
  178.        server, and with it the ability to support a "two headed" server -
  179.        one VGA, and one Hercules.
  180.     5) SVR3 shared libraries, tested under ISC SVR3 2.0.2, 2.2 and 3.0.1;
  181.        SCO 3.2.2, 3.2.4.
  182.     6) Support for Linux, 386BSD, Mach, SVR4.2, SCO, Amoeba, and Minix-386.
  183.     7) Support for LOCALCONN.  This support is for both SVR3.2 and SVR4.
  184.        For SVR4.0.4 with the 'Advanced Compatibility Package', local
  185.        connections from SCO XSight/ODT clients are supported.
  186.     8) Drivers for ATI, Trident, NCR, Compaq, and Cirrus SVGA chipsets.
  187.        Refer to the files README.ati and README.trident for details about
  188.        the ATI and Trident drivers.
  189.     9) Support for compressed bitmap fonts has been added (Thomas
  190.        Eberhardt's code from the contrib directory on export.lcs.mit.edu).
  191.    10) Type1 Font code from MIT contrib tape has been included, and is
  192.        compile-time selectable.  There are contributed Type1 fonts in the
  193.        contrib directory on export.lcs.mit.edu.
  194.    11) New configuration method which allows the server's drivers and font
  195.        renderers to be reconfigured from both source and binary
  196.        distributions.
  197.    12) A new tutorial on how to develop correct video card and monitor
  198.        timing data, written by Eric Raymond (derived from previous
  199.        documentation and a lot of experimentation).
  200.    13) Greatly improved support for international keyboards, including
  201.        implementation of the Compose key functionality found on many
  202.        vendor servers.
  203.    14) Many enhancements in error handling and parsing of the Xconfig
  204.        configuration file.  Error messages are much more informative and
  205.        intuitive, and more validation is done.  There are many new options
  206.        that can be enabled in the Xconfig file.
  207.  
  208.    The following key features were added with the release of XFree86 1.3
  209.    (they were not in XFree86 1.2):
  210.  
  211.     0) The server binary names have been changed from 'X386' and
  212.        'X386mono' to 'XF86_SVGA' and 'XF86_Mono'.  This is not
  213.        particularly important, but may confuse people at first.
  214.     1) MIT public fixes to X11R5 up to fix-25 have been incorporated
  215.     2) Support for the following operating systems has been added:
  216.         SCO SVR3 3.2.2 and 3.2.4
  217.         ISC 2.0.2
  218.         Amoeba
  219.         Minix-386
  220.     3) Support for the following SVGA chipsets has been added:
  221.         Western Digital 90C3x
  222.         Cirrus 542x
  223.         Trident 8800CS, 8900B, 8900CL
  224.         NCR 77C22, 77C22E
  225.         Compaq AVGA
  226.        We believe that the ET4000/W32 will also work with this release.
  227.     4) For SVR3/4, the local connection mechanism used is selectable at
  228.        run-time, rather than compile time.
  229.     5) For 386BSD, the server now determines the console driver at
  230.        run-time, removing the need for separate server binaries.
  231.     6) Support for building Linux shared libraries is integrated into the
  232.        source kit.
  233.     7) The server Link Kit now includes driver sources, which allows for
  234.        modification and addition of new drivers, without requiring the
  235.        server source tree.
  236.     8) The interface between the server and the drivers has been fully
  237.        documented, and a stub driver is included.
  238.     9) A preliminary version of the 'SuperProbe' program is included.
  239.        This is a Unix-based program designed to detect and identify
  240.        installed video hardware.
  241.    10) The binary package is no longer required to exist in /usr/X386.
  242.        Support for a $XWINHOME environment variable has been added to all
  243.        hard-coded paths.
  244.    11) PEX is now supported in the XFree86 source tree, and has been
  245.        ported to Linux.
  246.    12) The Hercules code has been fixed for Linux, 386BSD, Mach and SCO.
  247.    13) The handling of the "overscan" region of the display has been
  248.        dramatically improved.  This should prevent the area of the display
  249.        outside the raster from changing to odd colors when colormap
  250.        changes are made.
  251.    14) Support has been added to handle mice that can switch between
  252.        Microsoft and MouseSystems modes via toggling of DTR for OSs that
  253.        provide a mechanism for manipulating RS-232 control leads.
  254.    15) Support for a banked operation has been added to the ET3000 driver
  255.        in the monochrome server.
  256.  
  257.        Plus a number of other small things.  Refer to the CHANGELOG file
  258.        in the source distribution for full details.
  259.  
  260.    Also included are a tutorial on monitor timing by Eric Raymond, and the
  261.    current X386 mode database and a sample xdm configuration by David Wexelblat.
  262.  
  263. 4. What OSs are supported?
  264.  
  265.     SVR4.0:
  266.     Esix: 4.0.3A, 4.0.4
  267.     Microport: 2.2, 3.1, 4.1, 4.2
  268.     Dell: 2.1, 2.2
  269.     UHC: 2.0, 3.6
  270.     Consensys: 1.2
  271.     MST: 4.0.3
  272.     ISC: 4.0.3
  273.     AT&T: 2.1, 4.0
  274.     NCR: MP-RAS
  275.  
  276.     SVR4.2:
  277.     Consensys
  278.     Univel UnixWare
  279.  
  280.     SVR3:
  281.     Interactive: 2.0.2, 2.2, 3.0
  282.     SCO: 3.2.2, 3.2.4
  283.     AT&T: 3.2.2
  284.  
  285.     Others:
  286.     386BSD 0.1, NetBSD 0.8
  287.     Mach 386
  288.     Linux
  289.     Amoeba
  290.     Minix-386
  291.  
  292.     A set of patches to support XFree86 1.3 on BSDI's BSD/386 is available
  293.     from the following sites:
  294.  
  295.     ftp.physics.su.oz.au:/XFree86/bsdi-1.3-unoff
  296.     export.lcs.mit.edu:/contrib/XFree86/bsdi-1.3-unoff
  297.  
  298.     This is contributed code, and not part of the official 1.3 release.
  299.     These patches will be integrated into XFree86 2.0, hence 2.0 will
  300.     have native support for BSD/386.
  301.  
  302.     Note that Esix 3.2D is not supported yet, but anyone should feel
  303.     free to submit patches.  If you are interested in tackling this,
  304.     send mail to xfree86@physics.su.oz.au
  305.  
  306. 5. What video hardware is supported?
  307.  
  308.    At this time, XFree86 1.3 supports the following SVGA chipsets:
  309.     
  310.     Tseng ET3000, ET4000
  311.     Western Digital/Paradise PVGA1
  312.     Western Digital WD90C00, WD90C10, WD90C11, WD90C30, WD90C31
  313.     Genoa GVGA
  314.     Trident TVGA8800CS, TVGA8900B, TVGA8900C, TVGA8900CL, TVGA9000
  315.     ATI 28800-4, 28800-5, 28800-a [18800-1 reportedly works too]
  316.     NCR 77C22, 77C22E
  317.     Cirrus Logic CLGD5420, CLGD5422, CLGD5424, CLGD5426
  318.     Compaq AVGA
  319.     
  320.     All of the above are supported in both 256 color and monochrome modes,
  321.     with the exception of the ATI and Cirrus chipsets, which are only
  322.     supported in 256 color mode.
  323.  
  324.     Refer to the chipset-specific README files (currently for Tseng, Western
  325.     Digital, ATI, and Trident) for more information about using those chipsets.
  326.  
  327.     The monochrome server also supports generic VGA cards, using 64k of video
  328.     memory in a single bank, and the Hercules card.  On the Compaq AVGA, only
  329.     64k of video memory is supported for the monochrome server, and the GVGA
  330.     has not been tested with more than 64k.
  331.  
  332.     It appears that some of the SVGA card manufacturers are going to
  333.     non-traditional mechanisms for selecting pixel-clock frequencies.  To
  334.     avoid having to modify the server to accommodate these schemes XFree86 1.2
  335.     added support for using an external program to select the pixel clock.
  336.     This allows programs to be written as new mechanisms are discovered.
  337.     Refer to the README.clkprog file for information on how these programs
  338.     work, if you need to write one.  If you do develop such a program, we
  339.     would be interested in including it with future XFree86 releases.
  340.  
  341.     If you are purchasing new hardware for the purpose of using XFree86,
  342.     it is suggested that you purchase an ET4000-based board such as the
  343.     Orchid ProDesigner IIs.  Avoid recent Diamond boards; XFree86 will not
  344.     work with them, because Diamond won't provide programming details.
  345.     In fact, the XFree86 project is actively not supporting new Diamond
  346.     products, as long as such policies remain in effect.  Contributions
  347.     of code will NOT be accepted (because of the potential liabilities).
  348.     If you would like to see this change, tell Diamond about it.
  349.  
  350.     Some people have asked if XFree86 would work with local bus or EISA
  351.     video cards. Theoretically, the means of communication between the
  352.     CPU and the video card is irrelevant to Xfree86 compatibility. It
  353.     could be ISA, EISA, or local bus.  What should matter is the chipset
  354.     on the video card.  Unfortunately, the developers don't have a lot
  355.     of access to EISA or VLB machines, so this is largely an untested
  356.     theory.  However, we have yet to see any reports of things not
  357.     working on one of these buses and we have several reports of Xfree86
  358.     working fine on them.
  359.  
  360. 6. What about accelerated boards?
  361.  
  362.     At this point, XFree86 does not support any accelerated chipsets.
  363.     These include the S3 86Cxxx, the ATI Mach8 and Mach32, the IBM 8514/A,
  364.     the new Western Digital chipset (on the Diamond SpeedStar 24X), the new
  365.     Cirrus and Tseng chipsets, and TIGA (TI 340x0).  This support is available
  366.     in commercial products from SGCS and MetroLink (for SVR3 and SVR4).
  367.     Some of these will be supported in XFree86 2.0.
  368.  
  369.     An S3 server is available for 386BSD and Linux.  Contact
  370.     <hasty@netcom.com> for 386BSD or <???> for Linux.
  371.  
  372.     A beta 8514/A server is available for Linux. Contact <martin@cs.unc.edu>.
  373.     Note: these servers are NOT part of XFree86.
  374.  
  375. 7. Why doesn't XFree86 support 16-color VGA modes?
  376.  
  377.     The reason that this is not supported is the way VGA implements the
  378.     16-color modes.  In 256-color modes, each byte of frame buffer memory
  379.     contains 1 pixel.  But the 16-color modes are implemented as bit-
  380.     planes.  Each byte of frame- buffer memory contains 1 bit from each
  381.     of each of 8 pixels, and there are four such planes.  The MIT frame-
  382.     buffer code is not designed to deal with this.  If VGA handled
  383.     16-color modes by packing 2 4-bit pixels into each byte, the MIT code
  384.     could be modified to support this (or it already may; I'm not sure).
  385.     But for the VGA way of doing things, a complete new frame-buffer
  386.     implementation is required.  Some beta testers are looking into this,
  387.     but nothing is yet available from the project.
  388.  
  389. 8. What other hardware or software requirements are there?
  390.  
  391.     Obviously, a supported SVGA board and OS are required.  To run
  392.     X efficiently, 12-16MB of real memory should be considered a minimum.
  393.     The various binary releases take 10-40MB of disk space, depending
  394.     on the OS (e.g. whether or not it supports shared libraries).
  395.     To build from sources, at least 80MB of free disk space will
  396.     be required, although 120MB should be considered a comfortable 
  397.     lower bound.
  398.  
  399. 9. Where can I get source for XFree86?
  400.  
  401.     Source patches for the current version (1.3, based on X11R5 PL25
  402.     from MIT), are available via anonymous FTP from:
  403.         export.lcs.mit.edu (under /contrib/XFree86)
  404.         ftp.physics.su.oz.au (under /XFree86)
  405.         ftp.win.tue.nl (under /pub/XFree86)
  406.     (For the rest of this FAQ, these 3 location will be called $FTP)
  407.  
  408.     Refer to the README file under the specified directory for information
  409.     on which files you need to get to build your distribution (which will
  410.     depend on whether this is a new installation or an upgrade from an
  411.     earlier version of XFree86).
  412.  
  413. 10. Where can I get binaries for XFree86?
  414.  
  415.     Binaries are available via anonymous FTP from:
  416.         ftp.physics.su.oz.au            - SVR4 binaries
  417.             under /XFree86/SVR4
  418.         ftp.win.tue.nl                  - SVR4 binaries
  419.             under /pub/XFree86/SVR4
  420.         ftp.tcp.com                     - SVR4 binaries
  421.             under /pub/SVR4/XFree86
  422.         stasi.bradley.edu               - SVR4 binaries
  423.             under /pub/XFree86/SVR4
  424.         stasi.bradley.edu               - SVR3 (SCO) binaries
  425.             under /pub/XFree86/sco
  426.         blancmange.ma.utexas.edu        - SVR3 (ISC) binaries
  427.             under /pub/ISC
  428.         ftp.prz.tu-berlin.de            - SVR3 (ISC) binaries
  429.             under /pub/pc/isc/XFree86
  430.         tsx-11.mit.edu                  - Linux binaries
  431.             under /pub/linux/packages/X11
  432.         agate.berkeley.edu              - 386BSD binaries
  433.             under /pub/386BSD/0.1-ports/XFree86-1.3
  434.         gatekeeper.dec.com              - 386BSD binaries
  435.             under /pub/BSD/386bsd/0.1-ports/XFree86-1.3
  436.         wuarchive.wustl.edu             - 386BSD binaries
  437.             under /mirrors4/386bsd/0.1-ports/XFree86-1.3
  438.         XFree86.cdrom.com               - 386BSD binaries
  439.             under /pub/XFree86/XFree86-1.3
  440.         ftp.cs.uwm.edu                  - Mach386 binaries
  441.             under /i386
  442.  
  443.     Ensure that you are getting XFree86 1.3 - some of these sites may
  444.     archive older releases as well.  Each binary distribution will
  445.     contain a README file that describes what files you need to take
  446.     from the archive, and which compile-time option selections were
  447.     made when building the distribution.
  448.  
  449. IV) What general things should I know about running XFree86?
  450.  
  451. 11. Installation directories
  452.  
  453.     The top-level installation directory is specified by the ProjectRoot
  454.     (/usr/X386, by default) variable in config/site.def. Binaries, include
  455.     files, and libraries are installed in $ProjectRoot/{bin,include,lib}.
  456.  
  457.     This can be changed when rebuilding from sources, and can be modified
  458.     via symbolic links for those OSs that support them. This directory is
  459.     nonstandard, and was chosen this way to allow XFree86 to be installed
  460.     alongside a commercial/vendor-supplied X implementation.
  461.  
  462. 12. Configuration files
  463.  
  464.     The XFree86 server reads a configuration file ("Xconfig") on startup.
  465.     The search path, contents and syntax for this file are documented in
  466.     the server manpage, which should be consulted before asking questions.
  467.  
  468. 13. Determining VGA dot clocks and monitor modes
  469.  
  470.     David E Wexelblat (dwex@mtgzfs3.att.com) maintains a database of known
  471.     clock settings for VGA cards and monitor settings.
  472.     The database is installed in /usr/X386/lib/X11/etc/modeDB.txt, and
  473.     is in the source tree under mit/server/ddx/x386/etc. This database is
  474.     also available from him (for the latest copy), and is kept on
  475.     export.lcs.mit.edu in ~/contrib/X386.modeDB.Z, which is updated
  476.     occasionally.  Obtain a copy of this database.  It just might have the
  477.     settings you need.  If you create new settings, please send them to
  478.     David for inclusion in the database.
  479.  
  480.     If this doesn't help you, the VideoModes.doc (by Eric Raymond) file 
  481.     with XFree86 contains tutorials on how to come up with these timings.
  482.     It may be helpful to start with settings that almost work, and use
  483.     this description to get them right.  When you do, send the information
  484.     to David Wexelblat for inclusion in the database.
  485.  
  486.     NOTE: The old 'clock.exe' program is not supported any more, and
  487.       is completely unnecessary.  If you need to determine dot
  488.       clock values for a new board, remove the 'Clocks' line from
  489.       your Xconfig file (if present), and start the server.  The
  490.       server will probe for clocks itself and print them out.
  491.       You can use these values to put a 'Clocks' line into your
  492.       Xconfig file, which is not necessary, but will speed up
  493.       starting the server in the future.
  494.  
  495. 14. Rebuilding/reconfiguring the server from the link kit
  496.  
  497.     If you have installed the server Binary Link Kit, it is possible to
  498.     reconfigure the drivers and font renderers in the server.  This is
  499.     fully explained in the README file that is available with the link kit.
  500.  
  501. V) What OS-specific things should I know about running XFree86?
  502.  
  503.     First of all, the server must be installed suid-root (mode 4755).
  504.  
  505. 15. SVR4
  506.     Why won't my xterm run properly?
  507.  
  508.     If your kernel is not built with the consem module, you should define
  509.     CONSEM=no in you environment. Otherwise xterm won't run.
  510.     csh users should use 'setenv CONSEM no'
  511.  
  512.     The Esix console driver patch 403019 is known to cause keymapping
  513.     problems with XFree86.  It recommended that this patch not be
  514.     installed.  Alternatively they keymap can be fixed with xmodmap.
  515.  
  516. 16. SVR3
  517.  
  518.     Make sure you look at $FTP/README.ISC, if that's what you are running.
  519.  
  520. 17. 386BSD
  521.  
  522.     Make sure you look at $FTP/README.386BSD.
  523.  
  524.     Also, a separate 386BSD FAQ is maintained by Richard Murphey
  525.     <Rich@Rice.edu>.  The latest version should be available in the
  526.     file XFree86-1.2-386BSD-FAQ at the following ftp sites:
  527.  
  528.     agate.berkeley.edu:/pub/386BSD/0.1-ports/XFree86-1.2
  529.     wuarchive.wustl.edu:/mirrors4/386bsd/0.1-ports/XFree86-1.2
  530.     grasp.insa-lyon.fr:pub/386BSD/0.1-ports/XFree86-1.3
  531.  
  532. 18. Linux
  533.  
  534.     You must be running Linux 0.99pl10 or greater, and have the 4.4 gcc
  535.     jump libraries installed.
  536.  
  537.     Make sure the binaries XF86_SVGA, XF86_mono, xload and xterm are setuid
  538.     root.
  539.  
  540.     If your kernel doesn't have TCP support compiled in, you'll have to
  541.     run the server as "X -pn". The default startup configuration assumes
  542.     that TCP is not available. If it is, change the two files
  543.     /usr/X386/bin/startx and /usr/X386/lib/X11/xdm/Xservers, removing the
  544.     -pn argument to X386.
  545.  
  546.     Make sure /dev/console is either a link to /dev/tty0 or has the major
  547.     number 4, minor number 0. Also note that if /dev/console is not
  548.     owned by the user running X, then xconsole and xterm will not permit
  549.     console output redirection. Xdm will properly change the owner, but
  550.     startx won't.
  551.  
  552.     When running xdm from rc.local, you will need to provide it with
  553.     a tty, for example "xdm < /dev/console &".
  554.  
  555.     For more detailed information, please read the file README present
  556.     with the distribution on tsx-11.mit.edu.
  557.  
  558. 19. Mach
  559.  
  560.     Make sure you look at $FTP/README.Mach.
  561.  
  562. VI) What things should I know for building XFree86 from source?
  563.  
  564.     This section has been removed from the FAQ, since it is
  565.     fully explained in $FTP/README and the OS-specific READMEs.
  566.     Please look at those files for information on building XFree86.
  567.  
  568. VII) Is there anything special about building clients with XFree86?
  569.  
  570. 20. BSD compatibility library
  571.  
  572.     A lot of clients make use of BSD functions like bcopy(), etc.
  573.     The default configuration files are set up to link with libXbsd.a
  574.     which contains emulation for bcopy(), bzero(), bcmp(), ffs(), random(),
  575.     seed(). A better way of providing the 'b' functions is to include
  576.     <X11/Xfuncs.h> in source files that call them.  Xfuncs.h provides macro
  577.     definitions for these in terms of the SYSV 'mem' functions.  If you are
  578.     linking with a vendor supplied library which calls some of these
  579.     functions, then you should link with libXbsd.a
  580.  
  581. 21. ANSICCOPTIONS
  582.  
  583.     This is something that was added to allow a developer to get rid of the
  584.     ANSI-ness defined in the default CCOPTIONS without having to rewrite
  585.     the entire CCOPTIONS line.  For example, with stock MIT, you'd see
  586.     something like
  587.         CCOPTIONS="-ansi -O2 -fwritable-strings"
  588.     and to get rid of the ANSI-ness, the developer would have to put
  589.         CCOPTIONS="-O2 -fwritable-strings"
  590.     in his Imakefile.  With this change, you would see a default of
  591.         ANSICCOPTIONS="-ansi"
  592.         CCOPTIONS="-O2 -fwritable-strings"
  593.     and all the developer would have to put in the Imakefile is:
  594.         ANSICCOPTIONS=
  595.     to get rid of the ANSI-ness (many X clients will die a horrible death
  596.     with -ansi).  The effect is even more dramatic in practice, because
  597.     CCOPTIONS is actually quite complex.  The other issue is that one must
  598.     add 'ANSICCOPTIONS=$(ANSICCOPTIONS)' to a PassCDebugFlags definition.
  599.  
  600. VIII) Where to get more information
  601.  
  602.     Additional documentation is available in the XFree86(1) and XF86keybd(1)
  603.     manual pages.  In addition, several README files and tutorial documents
  604.     are provided.  These are available in /usr/X386/lib/X11/etc in the binary
  605.     distributions, and in mit/server/ddx/x386 and ddx/x386/etc in the source
  606.     distribution.
  607.  
  608.     Documentation on SVGA driver development can be found in the directory
  609.     /usr/X386/Server/VGADriverDoc in the binary distribution, and in the
  610.     directory mit/server/ddx/x386/VGADriverDoc in the source distribution.
  611.  
  612.     If you are totally at a loss, you can contact the XFree86 Core Team at
  613.     xfree86@physics.su.oz.au.
  614.  
  615. IX)  [Special, for this month only] Preliminary information on XFree86 2.0
  616.  
  617. This was recently posted to comp.windows.x.i386unix by David E. Wexelblat:
  618.  
  619. Subject: Preliminary information on XFree86 2.0...
  620.  
  621. Just to frustrate you (:->), here's some pre-release information on
  622. XFree86 2.0.  We currently plan to release 2.0 at the end of October,
  623. barring any unforseen problems.  Here's a list of what's definitely
  624. in (i.e the code is in the base and tested), on top of the 1.3 feature
  625. list:
  626.  
  627.     - OS support:
  628.         - BSDI BSD/386
  629.         - OSF/1
  630.         - NetBSD, FreeBSD
  631.             (including VT switching with syscons)
  632.     - New hardware supported:
  633.         - VGA: Generic 16-color
  634.         - SVGA: Oak 067/057
  635.         - Monochrome: Sigma Designs LView, Hyndai HGC-1280
  636.         - Accelerated hardware:
  637.             - Cirrus 542{6,8}
  638.             - Western Digital WD90C31
  639.             - IBM 8514/A
  640.             - ATI Mach-8, Mach-32
  641.             - S3 911/924, 801/805, 928
  642.     - Input devices:
  643.         - Hitachi Puma Plus digitizer
  644.         - Support OS mouse driver for SCO
  645.     - Lots and lots of bug fixes
  646.  
  647. The Cirrus and WD accelerated support is incorporated in the SVGA server.
  648. The 8514, Mach-8, Mach-32, and S3 each have their own servers (for now;
  649. we will likely merge these for 2.1).  The 16-color server is still 
  650. experimental; it has known bugs, and does not support banking yet.
  651.  
  652. For the Mach-32 and S3 servers, linear framebuffer access is supported
  653. for EISA and VLB cards for OSs that support such access (currently
  654. Linux, SVR4, Mach, OSF/1, BSD/386 and SVR3 (with the installation of 
  655. a device driver to support this access, which will be included)).  On
  656. ISA bus cards, and OSs that don't support the linear framebuffer access,
  657. the normal 64k VGA window is used.
  658.  
  659. We will be supplying a list of know working accelerated cards (i.e. those
  660. that the beta testers are using).  All of the ATI Ultra boards should
  661. be supported, and S3 boards from Actix, #9, ELSA, and STB are known to
  662. work (there may be others, but I haven't compiled the list yet).  
  663.  
  664. We have just completed our 5th beta-test release since 1.3 was released
  665. in June; there have been 28 alpha releases.  So far.  There will be
  666. one more beta before the final code freeze, and an unknown number of
  667. alphas.
  668.  
  669. We have been making extensive use of the MIT X Test Suite with these
  670. servers.  The accelerated servers are know to have the same pass/fail
  671. cases as the SVGA server has (there were bugs in the MIT X11R5 server;
  672. we haven't gone out of our way to fix them, but we don't fail anything
  673. that passes in the MIT code).
  674.  
  675. There may be other features added before 2.0, but they will not be 
  676. significant.  We are hoping to add one or two more SVGA chipset drivers,
  677. but we haven't seen the code for them yet.
  678.  
  679. Please do not bombard us with questions; we are working very hard to
  680. complete this release, and get it out when we say it will be out.  Between
  681. now and then, Jon Tombs will be leaving the scene (headed for a location
  682. without net access), and I will be changing jobs and moving.  This is
  683. a very hectic time, but we believe that people will be quite pleased
  684. with the results when the release is made.
  685.  
  686.     --------------------------------------------------
  687.  
  688. XFree86 Contact Information
  689.  
  690.     Ongoing development planning and support is coordinated by the XFree86
  691.     Core Team.  At this time the Core Team consists of (in alphabetical order):
  692.  
  693.        Robert Baron <Robert.Baron@ernst.mach.cs.cmu.edu>
  694.        David Dawes <dawes@physics.su.oz.au>
  695.        Dirk Hohndel <hohndel@informatik.uni-wuerzburg.de>
  696.        Glenn Lai <glenn@cs.utexas.edu>
  697.        Rich Murphey <Rich@Rice.edu>
  698.        Jon Tombs <Jon has moved, and doesn't have email any more>
  699.        David Wexelblat <dwex@mtgzfs3.att.com>
  700.        Thomas Wolfram <wolf@prz.tu-berlin.de>
  701.        Orest Zborowski <obz@Kodak.com>
  702.  
  703.     E-mail sent to <xfree86@physics.su.oz.au> will reach all of the Core Team.
  704.  
  705.     --------------------------------------------------
  706.  
  707. Thanks to all the people who already sent me corrections or additions,
  708. especially David Wexelblat (one of the major contributors of updates).
  709. -- 
  710. Steve Kotsopoulos  P.Eng.           mail:   steve@ecf.toronto.edu
  711. Systems Analyst                     bitnet: steve@ecf.UTORONTO.BITNET
  712. Engineering Computing Facility      uucp:   uunet!utai!ecf!steve
  713. University of Toronto               phone:  (416) 978-5898
  714.