home *** CD-ROM | disk | FTP | other *** search
/ Enter 1999 April - Disc 1 / enter_04_1999_1.iso / OS2 / XFREE86 / XDOC.ZIP / XFree86 / lib / X11 / doc / README.OS2 < prev    next >
Encoding:
Text File  |  1999-01-09  |  31.4 KB  |  1,057 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.                           README for XFree86 on OS/2
  11.  
  12.                                   Holger Veit
  13.  
  14.                       Last modified on: December 29, 1998
  15.  
  16.  
  17.  
  18. 1.  Introductory Note about the release 3.3.3
  19.  
  20. Before looking into this file, please check for any LATEST.OS2 files that may
  21. come with the binary distribution. Please also check out the following
  22. XFree86/OS2 WWW pages:
  23.  
  24.    o http://set.gmd.de/~veit/os2/xf86os2.html
  25.  
  26.    o http://set.gmd.de/~veit/os2/xf86bugs.html
  27.  
  28.    o http://set.gmd.de/~veit/os2/x11os2faq.html
  29.  
  30. before you claim to have found any problems.
  31.  
  32. This version of the code is called XFree86/OS2 3.3.3. This is a bugfix release
  33. for 3.3 and later which also adds hardware support for some newer cards
  34. (including AGP boards). XFree86-3.3.3 contains all security fixes that were
  35. released for earlier versions. See the RELNOTES document for details.
  36.  
  37. XFree86/OS2-3.3.3 is a full, unrestricted version which does not expire, and
  38. for which the complete  source code is available. In contrast to beta versions,
  39. we consider this  code as sufficiently stable for use by an end user. Since
  40. there  have been numerous bugfixes, we recommend this version, even if you had
  41. XFree86/OS2 3.3 before and it worked satisfyingly with your hardware. By the
  42. time 3.3.3 is released, the older version 3.3 will be withdrawn, and archives
  43. will be updated to this version. There may still be references  to 3.3 still in
  44. documents; these apply to 3.3.3 as well, unless otherwise noted.
  45.  
  46. Previous versions have been tested in a large number of configurations and have
  47. been found to be working, with some bugs left, rather flawlessly.
  48.  
  49. This release is almost complete (with a few exceptions) regarding the X11R6.3
  50. ``core'' distribution. A subset of the ``contrib'' distribution is available
  51. from the ported software page http://set.gmd.de/~veit/os2/xf86ported.html
  52.  
  53. In the past beta testing, it has been found that the software itself is rather
  54. stable and does not damage hardware - provided the user does not try to push
  55. the builtin limits and change certain configuration parameters which could
  56. operate the video hardware out of specs.
  57.  
  58. However,
  59.  
  60.    o even with a code we consider stable there is no explicit or implicit war-
  61.      ranty that certain code works correctly or works at all
  62.  
  63.  
  64. README for XFree86 on OS/2                                                    1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. README for XFree86 on OS/2                                                    2
  71.  
  72.  
  73.  
  74.    o although no damage reports are known, it does not mean that it is impossi-
  75.      ble to damage hardware with this code; some deeply hidden bugs may still
  76.      be present in the software.
  77.  
  78. It is recommended that you backup essential data of your system before
  79. installing this software, but this should be your general precautions before
  80. ANY installation. No reports exist that a crashing X server itself actively
  81. destroys or modifies data, but it is possible in rare cases that the system is
  82. left in an unusable state (video display mode garbled or system unresponsive,
  83. not reacting to mouse or keyboard actions).  If you then hard reset or switch
  84. off the system, file caches of the operating system might not be written cor-
  85. rectly back to disk, thus causing data loss.
  86.  
  87.  
  88. 2.  What and Where is XFree86?
  89.  
  90. XFree86 is a port of X11R6.3 that supports several versions of Intel-based
  91. Unix.  It is derived from X386 1.2, which was the X server distributed with
  92. X11R5.  This release consists of many new features and performance improvements
  93. as well as many bug fixes.  The release is available as source patches against
  94. the X Consortium X11R6 code, as well as binary distributions for many architec-
  95. tures.
  96.  
  97. XFree86/OS2 is the name of the implementation of XFree86 on OS/2 based systems.
  98.  
  99. See the Copyright Notice.
  100.  
  101. Binaries for OS/2 Warp and Merlin are available from:
  102. ftp.XFree86.org:/pub/XFree86/3.3.3/OS2
  103.  
  104. The WWW page http://borneo.gmd.de/~veit/os2/xf86os2.html will usually show more
  105. references to FTP or WWW sites to retrieve sources or binaries.
  106.  
  107. Other versions:
  108.  
  109. XFree86/OS2 will run on all dialects of Warp 3, including Warp "red spine box",
  110. Warp "blue spine box", Warp Connect, Warp Server, and Warp 4.
  111.  
  112. For Warp 3 installing fixpack level 17 or later is strongly recommended.  There
  113. have been a few reports that the installation of FP26 causes XFree86 no longer
  114. to work, but I am not sure about a real reason. Current fixpacks for Warp 3,
  115. like FP36, seem to work well also.
  116.  
  117. Warp 4 may be used with or without the recent public fixpack.
  118.  
  119. Please check in all cases a LATEST.OS2 file.
  120.  
  121. OS/2 2.11 is not supported any longer with this release, due to lack of a work-
  122. ing test environment. Consequently, OS/2 SMP 2.11 is not supported either. Warp
  123. Server SMP is supported, but SMP does not give significant advantage, other
  124. than the general speedup because of multiple processors working. OS/2 versions
  125. 1.X are definitely not supported and will never be.
  126.  
  127. It is possible to build XFree86/OS2 from the sources.  Read about this in the
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. README for XFree86 on OS/2                                                    3
  137.  
  138.  
  139.  
  140. document OS2.NOTES.
  141.  
  142.  
  143. 3.  Bug Reports for This Document
  144.  
  145. Send email to Holger.Veit@gmd.de (Holger Veit) or XFree86@XFree86.org if you
  146. have comments or suggestions about this file and we'll revise it.
  147.  
  148.  
  149. 4.  Hardware and Software Requirements
  150.  
  151. 4.1  Supported, Required, and Recommended Hardware
  152.  
  153.    o At least a 486DX33 with 16MB RAM is required. A Pentium or Pentium Pro and
  154.      more main memory is recommended. A 386 or a system with 8MB or less memory
  155.      is an insufficient configuration.
  156.  
  157.    o There are no specific requirements concerning network cards, disk types,
  158.      or CD ROM equipment; of course the more powerful, the better.
  159.  
  160.    o Depending on the packages installed, a disk space of 20-55MB on a HPFS
  161.      formatted partition (or a NFS or ext2fs partition natively allowing long
  162.      filenames) is required. XFree86/OS2 will not run on FAT partitions.
  163.  
  164.    o You need a video card that is supported by XFree86. Refer to the general
  165.      README document for a list of supported cards. Note that the sets of video
  166.      cards supported by XFree86 on one hand and OS/2 on the other hand overlap,
  167.      but do not match exactly, i.e. the fact that your card is supported by
  168.      OS/2 does not mean it works with XFree86 as well, and vice versa. XFree86
  169.      does not use the video services of the OS/2 operating system.
  170.  
  171. 4.2  Required Software
  172.  
  173.    o Any version of Warp 3 with at least fixpack 17, or Warp 4 is required
  174.  
  175.    o XFree86/OS2-3.3.3 may use a local named-pipe connection or a TCP/IP based
  176.      network connection.
  177.  
  178.        1.  Warp comes with the Internet Access Kit (IAK), which is sufficient.
  179.            Warp Connect and Warp Server come with a full version of TCP/IP
  180.            (3.0). Use of this software is preferred over IAK then.
  181.  
  182.        2.  Warp 4 comes with TCP/IP 4.0 which should also work.
  183.  
  184.        3.  There are reports that with EMX 0.9 fix 4, you can also use the new
  185.            32 bit IBM TCP/IP 4.1 product.
  186.  
  187.        4.  The old IBM TCP/IP 2.0, that comes with the IBM PMX product may be
  188.            used with Warp as well, although it is no longer supported by IBM.
  189.            Please ensure that you have the latest CSDs installed.
  190.  
  191.      Other versions of TCP/IP, such as FTP's, DEC's, or Hummingbird's TCP/IP
  192.      versions, as well as IBM TCP/IP 1.X are not supported. Nor does any net-
  193.      working support from DOS (packet drivers, winsock), Netware, or NetBIOS
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. README for XFree86 on OS/2                                                    4
  203.  
  204.  
  205.  
  206.      work, and I won't to provide support for that in the future.
  207.  
  208.    o If you want to write or port applications for XFree86, you are encouraged
  209.      to do so. You will need a complete installation of EMX/gcc 0.9C fix4 or
  210.      later for doing so. Neither the second (obsolete) implementation of gcc,
  211.      nor any commercial package, including Cset/2, VAC++, Borland C++/OS2, Wat-
  212.      com C++, Metaware C, and others, is suitable for porting, because various
  213.      parts of the X DLLs rely on certain features only present with EMX.
  214.  
  215.  
  216. 5.  Installing the System
  217.  
  218. The binary distribution is composed of a number of zip archives which are the
  219. executables, servers, fonts, libraries, include files, man pages, and config
  220. files.  The full distribution requires about 40-55MB of disk space.
  221.  
  222. All archives of this alpha version are packed with the info-zip utility, which
  223. is available under the name UNZ512X2.EXE (or a later version) from many OS/2
  224. archives. Please obtain a native OS/2 version of this unpacker.  DOS PKUNZIP
  225. does not work, because it cannot unpack long file names and extended
  226. attributes.
  227.  
  228. At this moment, the distribution covers only the ``core'' distribution which
  229. somewhat reduces the usability. Refer to WWW sites and archives listed in the
  230. XFree86/OS2 FAQ and elsewhere to obtain pre-built X clients which were ported
  231. to XFree86.
  232.  
  233. The contents of the packages are:
  234.  
  235.       REQUIRED:
  236.  
  237.                   X333base
  238.                         A special device driver and the SuperProbe program
  239.  
  240.                   X333doc
  241.                         READMEs and XFree86 specific man pages.
  242.  
  243.                   X333bin
  244.                         all of the executable X client applications and shared
  245.                         libs
  246.  
  247.                   X333fnts
  248.                         the misc and 75dpi fonts
  249.  
  250.                   emxrt
  251.                         Runtime libraries of EMX
  252.  
  253.             Choose at least one of the following to match your hardware:
  254.  
  255.                   X3338514
  256.                         the X server for IBM 8514/A and compatible boards
  257.  
  258.                   X333AGX
  259.                         the X server for AGX boards
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. README for XFree86 on OS/2                                                    5
  269.  
  270.  
  271.  
  272.                   X333Glnt
  273.                         the X server for Permedia / GLINT boards
  274.  
  275.                   X333I128
  276.                         the X server for #9 Imagination 128 boards
  277.  
  278.                   X333Ma32
  279.                         the X server for ATI Mach32 graphics boards
  280.  
  281.                   X333Ma64
  282.                         the X server for ATI Mach64 graphics boards
  283.  
  284.                   X333Ma8
  285.                         the X server for ATI Mach8 graphics boards
  286.  
  287.                   X333Mono
  288.                         the Monochrome X Server
  289.  
  290.                   X333P9K
  291.                         the X server for P9000 based boards
  292.  
  293.                   X333S3
  294.                         the X server for S3 based boards (excluding S3 ViRGE)
  295.  
  296.                   X333S3V
  297.                         the X server for S3 ViRGE based boards
  298.  
  299.                   X333SVGA
  300.                         the 8-bit pseudo-color X server for Super VGA cards
  301.  
  302.                   X333VG16
  303.                         the 4-bit pseudo-color X server for VGA & SVGA cards.
  304.  
  305.                   X333W32
  306.                         the X server for et4000w32 based boards
  307.  
  308.       OPTIONAL:
  309.  
  310.                   X333man
  311.                         pre-formatted man pages for the X11 interface and
  312.                         clients
  313.  
  314.                   X333f100
  315.                         100dpi fonts
  316.  
  317.                   X333fscl
  318.                         Speedo and Type1 fonts
  319.  
  320.                   X333fnon
  321.                         Japanese, Chinese and other fonts
  322.  
  323.                   X333fcyr
  324.                         Cyrillic fonts
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334. README for XFree86 on OS/2                                                    6
  335.  
  336.  
  337.  
  338.                   X333fsrv
  339.                         the font server with man pages.
  340.  
  341.                   X333prog
  342.                         the X11 header files and programmer's utilities for
  343.                         compiling other X applications
  344.  
  345.                   X333pex
  346.                         PEX fonts and libraries required for PEX applications
  347.  
  348. In order to save space on your disk and reduce net bandwidth, choose the soft-
  349. ware to obtain carefully. Each X server is an archive of about 1.2MB and occu-
  350. pies 3.0MB on the disk. You won't normally need more than the single Xserver
  351. tailored to your video card.
  352.  
  353. If it is your first time install, get the X333base archive before any of the
  354. other packages. This package contains a driver and a test program, which ana-
  355. lyzes your video hardware. If this program fails or reports an incompatible
  356. hardware, it makes no sense to obtain the other packages in the hope that they
  357. would magically work.
  358.  
  359.  
  360. 6.  Troubleshooting
  361.  
  362. Surprised to see this section directly in the beginning? We have put it here
  363. because chances are best here not to overlook it. This does not mean that you
  364. will necessarily encounter trouble when installing XFree86, but be warned: the
  365. following sections are IMPORTANT and neglecting one or more things out of impa-
  366. tience or sloppiness will leave you with a non-working X11 system and us with
  367. unnecessary problems.
  368.  
  369. Still, due to the incredibly large number of hardware configurations, there may
  370. be some special situations and configurations where the below description is
  371. not successful. If this happens, read - I repeat READ - the list of ``fre-
  372. quently asked questions'' (FAQ) which has meanwhile evolved to a troubleshoot-
  373. ing guide. The latest version is always at
  374. http://set.gmd.de/~veit/os2/x11os2faq.html .
  375.  
  376. Maybe - but we found you must be very creative - you find a bug. Consult the
  377. page http://set.gmd.de/~veit/os2/xf86bugs.html whether it is already known. If
  378. not, you have a case and should report it to XFree86 (xfree86@xfree86.org).
  379. Please refer to the FAQ about the information to be provided for a complete
  380. problem report.
  381.  
  382. The recommended newsgroup for setup questions is comp.os.os2.setup.misc.  I
  383. read this group, so it won't speed up the process or enforce anything if you
  384. post to other groups, or forward the report to my mail address as well or to
  385. xfree86@xfree86.org.
  386.  
  387. So, not to discourage you completely, the setup section begins:
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400. README for XFree86 on OS/2                                                    7
  401.  
  402.  
  403.  
  404. 7.  Checking Compatibility of Video Hardware
  405.  
  406. In the following, we assume that you want to install XFree86/OS2 on a disk
  407. drive with the letter Y: (which you probably don't have). Change the letter in
  408. all commands accordingly.
  409.  
  410.   1.  Obtain the package X333base and install it from the root directory of the
  411.       Y: drive, by entering the following commands:
  412.  
  413.            [C:\] Y:
  414.            [Y:\] cd \
  415.            [Y:\] unzip \path_of_package\X333base.zip
  416.  
  417.  
  418.  
  419.   2.  Edit your CONFIG.SYS file to contain the following line somewhere:
  420.  
  421.            DEVICE=Y:\XFree86\lib\xf86sup.sys
  422.  
  423.  
  424.       Of course replace ``Y:'' with the correct drive letter.
  425.  
  426.   3.  At this point, you may consider to add the variables required for
  427.       XFree86/OS2 as well, which will save you from one additional reboot.
  428.       Refer to section Adding Variables to CONFIG.SYS (section 9., page 8)
  429.       below.
  430.  
  431.   4.  After adding the device driver entry to the CONFIG.SYS file, you must
  432.       reboot to install the driver. XFree86/OS2 will not work without this
  433.       driver.
  434.  
  435.   5.  Start a full screen OS/2 CMD session and enter the following command:
  436.  
  437.            [C:\] Y:\XFree86\bin\SuperProbe
  438.  
  439.  
  440.  
  441.   6.  This command will (normally) report important information about your
  442.       video configuration, i.e. the type of chipset, the available video memory
  443.       and the RAMDAC circuit available. Please write this down or redirect the
  444.       output of ``SuperProbe'' into a file by entering:
  445.  
  446.            [C:\] Y:\XFree86\bin\SuperProbe >filename
  447.  
  448.  
  449.  
  450.   7.  SuperProbe can identify many more video cards than are supported by
  451.       XFree86. In some cases, SuperProbe unfortunately detects a wrong card,
  452.       often it claims to have seen a MCGA card which is some sort of a fall-
  453.       back. Generally, if it is approximately right, there are only few reasons
  454.       for doubts; if it is totally off (e.g. saying it has seen a ET4000, and
  455.       you have a Cirrus card), you should report a mis-detection as a bug to
  456.       the given address. In all cases, please take the few minutes and check
  457.       the accompanying README.* files to check for special precautions,
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466. README for XFree86 on OS/2                                                    8
  467.  
  468.  
  469.  
  470.       options, or features of the card.
  471.  
  472.   8.  If the README files tell you that your hardware is supported, please
  473.       obtain the rest of the software.
  474.  
  475.  
  476. 8.  Installing the packages
  477.  
  478. XFree86/OS2 assumes a directory hierarchy starting from drive:\XFree86.  This
  479. can be changed, but is strictly discouraged.
  480.  
  481.   1.  Choose a HPFS partition with sufficient free space.
  482.  
  483.   2.  For each package to install, go to the root directory of this drive, and
  484.       type:
  485.  
  486.            drive:> cd \
  487.            drive:> unzip \path_of_packages\X333xxxx.zip
  488.  
  489.   3.  You might encounter that some packages report duplicate files, e.g.  the
  490.       X server packages install corresponding README files, which are also in
  491.       the X333doc package. This is okay, the files are the same. Let unzip
  492.       replace the files.
  493.  
  494.   4.  No special sequence to unpack the files is required.
  495.  
  496.  
  497. 9.  Adding Variables to CONFIG.SYS
  498.  
  499. XFree86/OS2 requires a number of settings in the CONFIG.SYS file to work cor-
  500. rectly. Please add the following settings, and in particular take care to set
  501. forward versus backward slashes correctly:
  502.  
  503.       TERM
  504.             Set the preferred terminal type for the xterm or editor to be used.
  505.             Some programs need this setting. I have my type set to
  506.  
  507.                  SET TERM=ansi
  508.  
  509.  
  510.             \XFree86\lib\X11\etc\termcap.x11 contains a suitable termcap which
  511.             can be used in place of termcap files that come with EMX, EMACS, or
  512.             other ported software.
  513.  
  514.       TERMCAP
  515.             This variable must be set to the location where the termcap file
  516.             used for the above TERM variable is searched. My setting, for
  517.             instance, is:
  518.  
  519.                  SET TERMCAP=D:/EMX/ETC/TERMCAP.X11
  520.  
  521.  
  522.             Note that forward ``/'' is used as a directory separator.
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532. README for XFree86 on OS/2                                                    9
  533.  
  534.  
  535.  
  536.       ETC
  537.             Set to an ETC directory. Normally, this is already set to the ETC
  538.             directory of the TCP/IP code, such as
  539.  
  540.                  SET ETC=C:\TCPIP\ETC
  541.  
  542.       TMP
  543.             Set to an TMP directory. Normally, this is already set to the TMP
  544.             directory of the TCP/IP code, such as
  545.  
  546.                  SET TMP=C:\TCPIP\TMP
  547.  
  548.       HOSTNAME
  549.             Set to the internet hostname. Normally, this is already set by the
  550.             TCP/IP installation program, such as
  551.  
  552.                  SET HOSTNAME=myhost
  553.  
  554.  
  555.             With IAK, you would normally run a loopback configuration Network
  556.             configuration (section 10., page 11) and would then set this to
  557.  
  558.                  SET HOSTNAME=localhost
  559.  
  560.       USER
  561.  
  562.       LOGNAME
  563.             Set both to a username. Currently, they are there just to make some
  564.             programs happy; in the future, this variable might be set by a
  565.             login shell of a multiuser configuration. My variable, for
  566.             instance, is set to
  567.  
  568.                          SET USER=holger
  569.                          SET LOGNAME=holger
  570.  
  571.       HOME
  572.             Set this to an existing directory that is supposed to be a home
  573.             directory of a user. Some utilities place temporary and init files
  574.             here. This is also future investment for a multiuser configuration,
  575.             but must still be there. For instance, this variable might be set
  576.             to
  577.  
  578.                  SET HOME=H:\user\holger
  579.  
  580.       X11ROOT
  581.             This is one of the most important settings, it determines the root
  582.             of the XFree86 directory tree. Normally, you will set this to the
  583.             drive letter of the partition where the \XFree86 tree resides, such
  584.             as in
  585.  
  586.                  SET X11ROOT=Y:
  587.  
  588.  
  589.             You may try to move the tree to another subdirectory, e.g. to
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598. README for XFree86 on OS/2                                                   10
  599.  
  600.  
  601.  
  602.             K:\OS2\X11\XFree86... and would then have to change this to
  603.  
  604.                  SET X11ROOT=K:/OS2/X11
  605.  
  606.             , but this is discouraged, since some utilities might not accept
  607.             this.  Note the forward ``/'' as a directory separator here.
  608.  
  609.       DISPLAY
  610.             This variable may be set to the display to be used for displaying
  611.             clients. Normally you will set this variable to the same value as
  612.             the HOSTNAME variable and simply add a :0.0 after it, such as
  613.  
  614.                  SET DISPLAY=myhost:0.0
  615.  
  616.  
  617.             Read the X11 man page on the exact meaning of these postfixes and
  618.             other options.
  619.  
  620.       XSERVER
  621.             Set this to the executable name of the X server to be used. This
  622.             must be a complete path. My setting is as follows:
  623.  
  624.                  SET XSERVER=D:/XFree86/bin/XF86_Mach64.exe
  625.  
  626.       PATH
  627.             Add the binary directory for the X11 utilities to your search PATH.
  628.             This is normally the directory (adjust the letter)
  629.  
  630.                  Y:\XFree86\bin
  631.  
  632.  
  633.             It is possible to move the binaries to another directory in the
  634.             search path; for maintenance reasons and clarity of the structure,
  635.             this is not recommended, though.
  636.  
  637.       LIBPATH
  638.             Add the DLL directory for the X11 utilities to the LIBPATH.  This
  639.             is normally the directory (adjust the letter)
  640.  
  641.                  Y:\XFree86\lib
  642.  
  643.  
  644.             It is possible to move the DLLs to another directory in the library
  645.             path; for maintenance reasons and clarity of the structure, this is
  646.             not recommended, though. Note that Y:\XFree86\lib has several other
  647.             subdirectories; these may not be moved elsewhere, rather they must
  648.             stay there, because most utilities form a path to these directories
  649.             by using %X11ROOT%\XFree86\lib as a base.
  650.  
  651. The recent version of XFree86/OS2 has a REXX script named checkinstall.cmd
  652. which you can (and should) use to check whether you have entered most things
  653. correctly. This is not bullet-proof, but prevents the most obvious setup prob-
  654. lems. Also, the X server itself will do some checking and will refuse to start
  655. if something is wrong.
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664. README for XFree86 on OS/2                                                   11
  665.  
  666.  
  667.  
  668. 10.  Remarks on the Network Configuration
  669.  
  670. It is beyond the scope of this document to even give an introduction about the
  671. correct installation of the TCP/IP networking system. You must do this yourself
  672. or seek assistance elsewhere. It is only possible to say here that a PC working
  673. well in a TCP/IP based LAN network will also work with XFree86/OS2 (when all
  674. other prerequisites are matched as well).
  675.  
  676. With IAK, there is a special configuration necessary, unless you want to use
  677. XFree86/OS2 only during a hot link to your Internet provider, the so called
  678. ``localhost'' or ``loopback'' configuration. This is a local network interface
  679. which ``loops'' back to the same host. The following settings are necessary for
  680. this:
  681.  
  682.   1.  Create a file \tcpip\etc\hosts with the following content:
  683.  
  684.            127.0.0.1  localhost
  685.  
  686.   2.  Add the following line to your \tcpip\bin\tcpstart.cmd:
  687.  
  688.            ifconfig lo 127.0.0.1 up
  689.  
  690.  
  691.       If you don't have such a tcpstart.cmd file (Warp 4 calls this file
  692.       \MPTN\BIN\MPTSTART.CMD), create one, and add a line like the following to
  693.       your config.sys file: CALL=C:\OS2\CMD.EXE /Q /C C:\tcpip\bin\tcpstart.cmd
  694.       >NUL: (implying that your bootdrive is C:).
  695.  
  696.   3.  Set the HOSTNAME environment variable to localhost as described in the
  697.       last section.
  698.  
  699.   4.  Add the following line to CONFIG.SYS:
  700.  
  701.            SET USE_HOSTS_FIRST=1
  702.  
  703.   5.  After rebooting, verify that the following command works:
  704.  
  705.            [C:\] ping localhost
  706.  
  707. You don't need this ``loopback'' interface if your PC is connected to a LAN
  708. (either directly or through SLIP/PPP).
  709.  
  710. In case of a SLIP/PPP line, you have to establish this connection BEFORE you
  711. start XFree86.
  712.  
  713. The checkinstall.cmd script coming with XFree86/OS2 gives some advice on the
  714. configuration as well.
  715.  
  716. If you have problems to get this or other basic networking things running, seek
  717. assistance elsewhere.
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730. README for XFree86 on OS/2                                                   12
  731.  
  732.  
  733.  
  734. 11.  Configuring X for Your Hardware
  735.  
  736. After you have added the required settings and setup a working network, run the
  737. xf86config program to create a standard configuration file in
  738. Y:\XFree86\lib\X11\XF86Config from a windowed or full screen OS/2 text session:
  739.  
  740.      [C:\] xf86config
  741.  
  742. The xf86config program will ask a number of questions. You will need the infor-
  743. mation obtained from the SuperProbe program here. The program should be self
  744. explanatory; if you have problems to understand something though, seek assis-
  745. tance in the newsgroups.
  746.  
  747. It is possible, but strongly discouraged for the non-expert, to edit the
  748. XF86Config file with a text editor. In a few situations as described in the
  749. FAQ, however, this might even be mandatory. This file is not a hacker's area,
  750. such as the Win95 registry, but it has in common with it that you can easily
  751. cause damage.
  752.  
  753. For details about the XF86Config file format, refer to the XF86Config(4/5) man-
  754. ual page.
  755.  
  756. If you know the configuration process from Linux or other XFree86 platform, you
  757. will encounter a few differences:
  758.  
  759.    o There is no configuration for the mouse type or device. The mouse device
  760.      name is fixed to OSMOUSE, and this cannot be changed.  If you have a
  761.      three-button-mouse, install the correct OS/2 driver for it, such as
  762.  
  763.           DEVICE=D:\OS2\BOOT\PCLOGIC.SYS SERIAL=COM1
  764.           DEVICE=D:\OS2\BOOT\MOUSE.SYS TYPE=PCLOGIC$
  765.  
  766.  
  767.      for a MouseSystems compatible mouse, for instance.
  768.  
  769.    o The X server does not read the native OS/2 keyboard map, but the new XKB
  770.      server extension might already give you a correct keyboard layout, pro-
  771.      vided your language was selectable in the xf86config program. If you
  772.      encounter incorrect settings, please send a mail to XFree86@XFree86.org
  773.      describing in detail what is wrong. Even with XKB, you have the option to
  774.      replace some key settings with a xmodmap file. See the man page for
  775.      xmodmap for details (or use some available xmodmap file from Linux - they
  776.      are the same).
  777.  
  778.    o There is no support for the Wacom and Elographics input devices yet.
  779.  
  780. In most cases, an existing XF86Config file for the same XFree86 version from
  781. Linux or another platform may be used without changes. There is one prominent
  782. exception: some S3 805 based VLB cards put their video memory in odd locations.
  783. The X server can search for this memory by experimentally mapping and unmapping
  784. possible memory regions. In XFree86/OS2, the OS may run out of memory tiles
  785. during this process. If this happens, you must find out the location of the
  786. memory yourself and add it as an option
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796. README for XFree86 on OS/2                                                   13
  797.  
  798.  
  799.  
  800.           MemBase 0x12345678
  801.  
  802.  
  803. to the XF86Config file.
  804.  
  805. Once you've set up a XF86Config file, you can fine tune the video modes with
  806. the xvidtune utility.
  807.  
  808.  
  809. 12.  Running X
  810.  
  811. 16mb of memory is a recommended minimum for running the network software, X and
  812. the presentation manager in parallel.  The server, window manager and an xterm
  813. take about 4-6 Mb of memory themselves.  X will start up on a system with 8MB
  814. or less, but the performance will severely suffer from heavy disk swapping.
  815. Your mileage may vary, though, so some people might consider this still tolera-
  816. ble.
  817.  
  818. The easiest way for new users to start X windows is to type:
  819.  
  820.      [C:\] startx
  821.  
  822. .
  823.  
  824. To get out of X windows, type: ``exit'' in the console xterm.  You can cus-
  825. tomize your X by creating .xinitrc, .xserverrc, and .twmrc files in the direc-
  826. tory that the HOME environment variable points to. These files are described in
  827. the xinit and startx man pages.
  828.  
  829. By default, the systemwide xinitrc file (in Y:/XFree86/lib/X11/xinit/xini-
  830. trc.cmd) installs the rather simplistic twm window manager. You can find better
  831. window managers on the ported software page at
  832. http://set.gmd.de/~veit/os2/xf86ported.html .
  833.  
  834.  
  835. 13.  Rebuilding the XFree86 Distribution
  836.  
  837. Do you really want to rebuild XFree86/OS2 from source? Read the file OS2.Notes
  838. on details to recompile XFree86/OS2 from scratch.
  839.  
  840.  
  841. 14.  Building New X Clients
  842.  
  843. The easiest way to build a new client (X application) is to use xmkmf if an
  844. Imakefile is included in the sources.  Type ``xmkmf -a'' to create the Make-
  845. files, check the configuration if necessary and type ``xmake''. ``xmake'' is a
  846. wrapper for the GNU make program which defeats the improper SHELL setting typi-
  847. cally found in a Makefile generated from an Imakefile. Also see the XFree86/OS2
  848. FAQ for more hints about porting X clients.
  849.  
  850.  
  851. 15.  Acknowledgements
  852.  
  853. Many thanks to:
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862. README for XFree86 on OS/2                                                   14
  863.  
  864.  
  865.  
  866.    o Sebastien Marineau for his great work on getting the server code debugged
  867.  
  868.    o Eberhard Mattes for the wonderful base platform EMX which this port heav-
  869.      ily relies on
  870.  
  871.    o ME - no, no, forget this: I won't praise myself :-)
  872.  
  873.      Generated from XFree86: xc/programs/Xserver/hw/xfree86/doc/sgml/OS2.sgml,v 3.9.2.8 1998/12/29 07:54:29 hohndel Exp $
  874.  
  875.  
  876.  
  877.  
  878.  
  879.      $XConsortium: OS2.sgml /main/4 1996/03/11 10:46:06 kaleb $
  880.  
  881.  
  882.  
  883.  
  884.  
  885.  
  886.  
  887.  
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928. README for XFree86 on OS/2                                                   15
  929.  
  930.  
  931.  
  932.  
  933.  
  934.  
  935.  
  936.  
  937.  
  938.  
  939.  
  940.  
  941.  
  942.  
  943.  
  944.  
  945.  
  946.  
  947.  
  948.  
  949.  
  950.  
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.  
  998.                                    CONTENTS
  999.  
  1000.  
  1001.  
  1002. 1.  Introductory Note about the release 3.3.3 ............................... 1
  1003.  
  1004. 2.  What and Where is XFree86? .............................................. 2
  1005.  
  1006. 3.  Bug Reports for This Document ........................................... 3
  1007.  
  1008. 4.  Hardware and Software Requirements ...................................... 3
  1009.     4.1 Supported, Required, and Recommended Hardware ....................... 3
  1010.     4.2 Required Software ................................................... 3
  1011.  
  1012. 5.  Installing the System ................................................... 4
  1013.  
  1014. 6.  Troubleshooting ......................................................... 6
  1015.  
  1016. 7.  Checking Compatibility of Video Hardware ................................ 7
  1017.  
  1018. 8.  Installing the packages ................................................. 8
  1019.  
  1020. 9.  Adding Variables to CONFIG.SYS  ......................................... 8
  1021.  
  1022. 10. Remarks on the Network Configuration ................................... 11
  1023.  
  1024. 11. Configuring X for Your Hardware ........................................ 12
  1025.  
  1026. 12. Running X .............................................................. 13
  1027.  
  1028. 13. Rebuilding the XFree86 Distribution .................................... 13
  1029.  
  1030. 14. Building New X Clients ................................................. 13
  1031.  
  1032. 15. Acknowledgements ....................................................... 13
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.                                        i
  1055.  
  1056.  
  1057.