README for XFree86 3.1.2 on BSD/OS 2.0 <author>Hans Nasten <date>24 July 1995 <toc> <bf>THIS DOCUMENT IS OUT OF DATE</bf> <sect> What and Where is XFree86? XFree86 3.1.2 is a port of X11R6 that supports several versions of Intel-based Unix. It is derived from X386 1.2, which was the X server distributed with X11R5. This release consists of many new features and performance improvements as well as many bug fixes. The release is available as source patches against the X Consortium X11R6 code, as well as binary distributions for many architectures. The sources for XFree86 are available by anonymous ftp from: <htmlurl name="ftp://ftp.XFree86.org/pub/XFree86/current" url="ftp://ftp.XFree86.org/pub/XFree86/current"> Binaries for BSD/OS 2.0 will be available from: <htmlurl name="ftp://ftp.XFree86.org/pub/XFree86/current/binaries/Bsdi" url="ftp://ftp.XFree86.org/pub/XFree86/current/binaries/Bsdi"> If you're running a earlier version of BSD/OS, you'll have to build the distribution from source. Building the distribution on BSD/386 1.1 and 1.0 is untested, but believed to work correctly. If you run into trouble building on a earlier release, please let us know so that we can correct any incompatibilities. If you've done it and want to share your binaries, please let the Bsdi mailing list know. The binaries are built using gcc 2.6.3 as distributed with BSD/OS 2.0. If you build the distribution from source using a gcc compiler built using the generic gcc source code, you may run into problems using the binaries on a 386/486 not equipped with a math coprocessor. <sect>Bug Reports for This Document Send email to <it>nasten@@Everyware.SE</it> (Hans Nasten) or <it>XFree86@@XFree86.org</it> if you have comments or suggestions about this file and we'll revise it. <sect>Installing the Binaries The binary distribution is composed of a number of gzipped tar archives which contains the executables, servers, fonts, libraries, include files, man pages, config files, and the server link kit. All tar archives should be extracted as root with <tt>/</tt> as the default directory. The full distribution takes over 40MB of disk space. The file names are converted to be compatible with CD-rom conventions. Note that many clients were moved from the X11R6 distribution to the `contrib' area. However, they are still distributed with the XFree86 binary distribution. The contents of the archives are: <descrip> <tag>REQUIRED:</tag> <descrip> <tag/X312doc.tgz/ READMEs and XFree86 specific man pages. <tag/X312bin.tgz/ all of the executable X client applications. <tag/X312fnts.tgz/ all fonts except the cyrillic fonts <tag/X312lib.tgz/ data files needed at runtime </descrip> <tag>Choose at least one of the following to match your hardware:</tag> <descrip> <tag/X312SVGA.tgz/ the 8-bit pseudo-color X server for Super VGA cards <tag/X312VG16.tgz/ the 4-bit pseudo-color X server for VGA & SVGA cards. <tag/X312Mono.tgz/ the Monochrome X Server <tag/X3128514.tgz/ the X server for IBM 8514/A and compatible boards <tag/X312AGX.tgz/ the X server for AGX boards <tag/X312Ma8.tgz/ the X server for ATI Mach8 boards <tag/X312Ma32.tgz/ the X server for ATI Mach32 boards <tag/X312Ma64.tgz/ the X server for ATI Mach64 boards <tag/X312P9K.tgz/ the X server for P9000 based boards <tag/X312S3.tgz/ the X server for S3 based boards </descrip> <tag/OPTIONAL:</tag> <descrip> <tag/X312fsrv.tgz/ the font server with man pages. <tag/X312cfnt.tgz/ cyrillic fonts <tag/X312prog.tgz/ the <tt>include/X11</tt> header files and static libraries needed only for compiling other X applications <tag/X312man.tgz/ all man pages <tag/X312link.tgz/ the server reconfiguration kit. </descrip> </descrip> If this is your first time, then you should be able to safely install all of the packages. As a minimal install, you'll need doc, bin, fonts lib and one X server. To unpack and install the archives: <enum> <item>create some destination directory in which you'd like the X distribution to live. <tt>/usr/X11R6</tt> is recommended, but if that partition is full (as it is on my machine), then just create an alternate directory, and sym-link <tt>/usr/X11R6</tt> to this place. ie, on my machine, I do the following: <verb> % cd /usr/local % mkdir X11R6 % ln -s /usr/local/X11R6 /usr/X11R6 </verb> <item>You must be logged in as root to unpack the archives and use a `<tt>umask</tt>' value of 022. Typing `<tt>umask 022</tt>' sets it. Caution: If you do not extract the files as user `<tt>root</tt>' with the correct umask you may not be able to run XFree86 3.1.2. The X server needs special permissions that are only granted to the root user. You must also cd to <tt>/</tt> before extracting the archives. <item>Create a symbolic link in <tt>/usr/X11R6/bin</tt> named `X' that points to the server that matches your video card: See the XF86_* man pages for hardware details. For example, if you have an ET4000 based SVGA card: <verb> cd /usr/X11R6/bin rm -f X ln -s XF86_SVGA X </verb> </enum> <bf>Note:</bf> you don't need to uncompress the fonts files in <tt>lib/X11/fonts</tt>. If you want to uncompress them anyway, don't forget to run `<tt>mkfontdir</tt>' in each directory after that. <sect>Installing Xdm, the display manager The display manager makes your PC look like an X terminal. That is, it presents you with a login screen that runs under X. To start the display manager, log in as root on the console and type `<tt>xdm -nodaemon</tt>'. You can start xdm automatically on bootup by disabling the console getty and adding the following code to <tt>/etc/rc.local</tt>: <verb> if [ -x /usr/X11R6/bin/xdm ]; then echo -n ' xdm'; /usr/X11R6/bin/xdm fi </verb> To disable the console getty, change `<tt>on</tt>' to `<tt>off</tt>' in the console entry in <tt>/etc/ttys</tt>: <verb> console "/usr/libexec/getty std.9600" ibmpc3 off secure </verb> <sect>Configuring X for Your Hardware The <tt>XF86Config</tt> file tells the X server what kind of monitor, video card and mouse you have. You must create it to tell the server what specific hardware you have. XFree86 3.1 and later releases uses a new configuration file format. Consult the <tt>XF86Config</tt> man page and the general <tt>INSTALL</tt> file for instructions. If you have a <tt>Xconfig</tt> file for XFree86 2.x, use reconfig to translate part of it into the new format: <verb> # reconfig <Xconfig >XF86Config </verb> and complete the rest according to the <tt>XF86Config</tt> man page and the <tt>XF86Config.sample</tt> file as a template. In order to protect your hardware from damage, the server will no longer read <tt>XF86Config</tt> files from a user's home directory, but requires that it be in <tt>/etc/XF86Config</tt>, <tt>/usr/X11R6/lib/X11/XF86Config.hostname</tt> or <tt>/usr/X11R6/lib/X11/XF86Config</tt>. You'll need info on your hardware: <itemize> <item>Your mouse type, baud rate and its /dev entry. <item>The video card's chipset (e.g. ET4000, S3, etc). <item>Your monitor's sync frequencies. </itemize> The easiest way to find which device your mouse is plugged into is to use `<tt>cat</tt>' or `<tt>kermit</tt>' to look at the output of the mouse. Connect to it and just make sure that it generates output when the mouse is moved or clicked: <verb> % cat < /dev/tty00 </verb> If you can't find the right mouse device then use `<tt>dmesg|grep com</tt>' to get a list of devices that were detected upon booting: <verb> % dmesg|grep com com0 at isa0 iobase 0x3f8 irq 4 </verb> <tt>com0</tt> is the hardware port used for <tt>/dev/tty00</tt> and <tt>com1</tt> is <tt>/dev/tty01</tt>. If you plan to fine tune the screen size or position on your monitor you'll need the specs for sync frequencies from your monitor's manual. <sect>Running X 8mb of memory is a recommended minimum for running X. The server, window manager and an xterm take about 4 Mb of memory themselves. On a 4Mb system that would leave nothing left over for the kernel and other applications like <tt>gcc</tt> that expect a few meg free. The easiest way for new users to start X windows is to type `<tt>xinit >& xinit.log</tt>'. Error messages are lost unless you redirect them because the server takes over the screen. To get out of X windows, type `<tt>exit</tt>' in the console xterm. You can customize your X by creating <tt>.xinitrc</tt>, <tt>.xserverrc</tt>, and <tt>.twmrc</tt> files in your home directory as described in the xinit and startx man pages. <sect>Rebuilding the XFree86 Distribution The server link kit allows you to rebuild just the X server with a minimum amount of disk space. Just unpack it, make the appropriate changes to the site.def, type `<tt>./mkmf</tt>' and `<tt>make</tt>' to link the server. See <tt>/usr/X11R6/lib/Server/README</tt> for more info. See <tt>/usr/X11R6/lib/X11/etc/INSTALL</tt> for instructions on unbundling and building the source distribution. You will need about 250Mb free for the sources, objects and binaries during the build. You should configure the distribution by editing <tt>xc/config/cf/xf86site.def</tt> before compiling. To compile the sources, invoke <verb> make World </verb> in the xc directory. <sect>Building New X Clients The easiest way to build a new client (X application) is to use <tt>xmkmf</tt> if an Imakefile is included in the sources. Type `<tt>xmkmf</tt>' to create the Makefiles, check the configuration if necessary and type `<tt>make</tt>'. Whenever you install additional man pages you should update <tt>whatis.db</tt> by running `<tt>makewhatis /usr/X11R6/man</tt>'. To avoid the `<tt>Virtual memory exhausted</tt>' message from <tt>cc</tt> while compiling, increase the data and stack size limits (in <tt>csh</tt> type `<tt>limit datasize 32M</tt>' and `<tt>limit stacksize 16M</tt>'). Note: Starting with XFree86 2.1, the symbol ``<tt>__386BSD__</tt>'' no longer gets defined or via the X config files for *BSD systems. When porting clients to *BSD systems, make use of the symbol ``<tt>BSD</tt>'' for code which is truly BSD-specific. The value of the symbol can be used to distinguish different BSD releases. For example, code specific to the Net-2 and later releases can use: <verb> #if (BSD >= 199103) </verb> To ensure that this symbol is correctly defined, include <tt><sys/param.h></tt> in the source that requires it. Note that the symbol <bf/CSRG_BASED/ is defined for *BSD systems in XFree86 3.1.1 and later. This should be used to protect the inclusion of <tt><sys/param.h></tt>. For code that really is specific to a particular i386 BSD port, use <tt>__FreeBSD__</tt> for FreeBSD, <tt>__NetBSD__</tt> for NetBSD, <tt>__OpenBSD__</tt> for OpenBSD, <tt>__386BSD__</tt> for 386BSD, and <tt>__bsdi__</tt> for BSD/OS. <sect>Linear access to the frame buffer using BSD/386 1.1 The stock BSD/386 1.1 kernel has problems when trying to mmap the frame buffer as a linear ( unbanked ) memory area in high memory. This patch removes the check in <tt>/sys/i386/isa/vga.c</tt> that disables mmapping the frame buffer in linear mode. Please consult the BSD/386 1.1 release notes for instructions on how to build a new kernel. This patch is not needed on BSD/OS 2.0. <itemize> <item> save the patch below in a separate file. <item> cd to <tt>/sys/i386/isa</tt>. <item> apply the patch with ``<tt>patch -p <</tt><it>the_separate_patch_file</it>'' <item> rebuild and install the new kernel. <item> reboot. </itemize> <tt>vga.c</tt> patch: <verb> *** vga.c.orig Sun Dec 19 09:35:01 1993 --- vga.c Mon Oct 24 01:38:44 1994 *************** *** 159,165 **** #if 0 if (off + NBPG > vgap->vga_mem_size) return (-1); ! #else if (off + NBPG > IOM_END) return (-1); #endif --- 159,165 ---- #if 0 if (off + NBPG > vgap->vga_mem_size) return (-1); ! /*#else*/ if (off + NBPG > IOM_END) return (-1); #endif </verb> <verb> $XFree86: xc/programs/Xserver/hw/xfree86/doc/sgml/Bsdi.sgml,v 3.22 1997/12/05 22:01:35 hohndel Exp $ $XConsortium: Bsdi.sgml /main/8 1996/10/27 11:05:51 kaleb $ </verb> </article> @ 1.1 log @Initial revision @ text @@ 1.1.1.1 log @Initial import of XFree86 4.x @ text @@ 1.1.1.2 log @Import of XFree86 4.0.3 @ text @d318 1 a318 1 $XFree86: xc/programs/Xserver/hw/xfree86/doc/sgml/Bsdi.sgml,v 3.21 1997/01/25 04:19:19 dawes Exp $ @ 1.1.1.3 log @Import of XFree86 4.1.0. @ text @d318 1 a318 1 $XFree86: xc/programs/Xserver/hw/xfree86/doc/sgml/Bsdi.sgml,v 3.22 1997/12/05 22:01:35 hohndel Exp $ @