home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 January / usenetsourcesnewsgroupsinfomagicjanuary1994.iso / answers / x-faq / Intel-Unix-X-faq next >
Text File  |  1993-12-01  |  30KB  |  695 lines

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