From fb7e08ee5191252fea3670abd4d4c39651c31855 Mon Sep 17 00:00:00 2001 From: Murray Stokely Date: Wed, 11 Jul 2001 16:07:50 +0000 Subject: [PATCH] Add a section on configuring XFree86 4.x Submitted by: Christopher Chumway and Chern Lee --- .../books/handbook/x11/chapter.sgml | 213 +++++++++++++++++- 1 file changed, 212 insertions(+), 1 deletion(-) diff --git a/en_US.ISO8859-1/books/handbook/x11/chapter.sgml b/en_US.ISO8859-1/books/handbook/x11/chapter.sgml index 304a51c752..269ed9a392 100644 --- a/en_US.ISO8859-1/books/handbook/x11/chapter.sgml +++ b/en_US.ISO8859-1/books/handbook/x11/chapter.sgml @@ -1,7 +1,7 @@ @@ -1316,6 +1316,216 @@ For further configuration, refer to /usr/X11R6/lib/X11/doc/README.Config. + + XFree86 4.x Configuration + + + Introduction + + This chapter will introduce the steps necessary to install + and configure the XFree86 X Windows System under FreeBSD. + Once your server is installed and configured properly. you can + read to setup your desktop + environment. + + XFree86 4.x + XFree86 + + + + + Before You Start + + Before the user is to start configuration of XFree86-4, + the the following information will need to be known about the + target system: + + + Monitor specifications + Video Adapter chipset + Video Adapter memory + + + horizontal scan rate + vertical scan rate + + The specifications for the target system's monitor are + used by XFree86 to determine the resolution and refresh rate + to run at. These specifications can usually be obtained from + the documentation that came with your monitor or from the + manufacturer's website. There are two ranges of numbers that + are needed, the horizontal scan rate and the vertical + synchronization rate. + + The video adapter's chipset defines what driver module + XFree86 uses to talk to the graphics hardware. With most + chipsets, this can be automatically determined, but it is still + useful to know in case the automatic detection doesn't work + correctly. + + Video memory on the graphic adapter determines the + resolution and color depth the target system can run at. This + is important to know so the user knows the limitations of the + target system. + + + + + Installing XFree86 4.x software + + XFree86 4 can be installed using the FreeBSD ports system + or using &man.pkg.add.1;. If the user is building XFree86-4 + from source and has USA_RESIDENT set in + /etc/make.conf, the user may first have to + fetch Wraphelp.c if XDM-AUTHORIZATION-1 + support is desired. + + + + + Configuring XFree86 4.x + + Configuration of XFree86 4.1 is a several step process. + The first step is to build an initial configuration file with + the configure option to XFree86. As the super user, simply run: + + &prompt.root; XFree86 -configure + + This will generate a skeleton XFree86 configuration file + in the current working directory called XF86Config.new. The + XFree86 program will attempt to probe the graphics hardware on + the system and will write a configuration file to load the + proper drivers for the detected hardware on the target system. + + The next step is to test the currently existing + configuration to verify that XFree86 can work with the graphics + hardware on the target system. To preform this task, the user + needs to run: + + &prompt.root; XFree86 -xf86config XF86Config.new + + If the user is presented with a black and grey grid and an + X mouse cursor, then the configuration was successful. To exit + the test, just press ctrl, alt and backspace simultaneously. + + XFree86 4 Tuning + + Next, the user needs to tune the + XF86Config.new configuration file to their + personal taste. Open up the file in a text editor such as + &man.emacs.1; or &man.ee.1;. The first thing the user will want to + do is add the frequencies for the target system's monitor. + These are usually expressed as a horizontal and vertical + synchronization rate. These values are added to the + XF86Config.new file under the "Monitor" + section as such: + + Section "Monitor" + Identifier "Monitor0" + VendorName "Monitor Vendor" + ModelName "Monitor Model" + Horizsync 30-107 + VertRefresh 48-120 +EndSection + + The Horizsync and + VertRefresh keywords may not exist in the + user's configuration file. If they do not, they need to be + added, with the correct horizontal synchronization rate placed + after the Horizsync keyword and the vertical + synchronization rate after the VertRefresh + keyword. In the example above the target monitor's rates where + entered. + + XF86Config + + While the XF86Config.new + configuration file is still open in an editor, next the user + needs to select what the default resolution and color depth is + desired. This is defined in the Screen + section. + + Section "Screen" + Identifier "Screen0" + Device "Card0" + Monitor "Monitor0" + DefaultColorDepth 24 + SubSection "Display" + Depth 24 + Modes "1024x768" + EndSubSection +EndSection + + The DefaultColorDepth keyword describes + the color depth the user wishes to run at by default. This can + be overridden with the -bpp command line + switch to &man.XFree86.1;. The Modes keyword describes the + resolution the user wishes to run at for the given color depth. + In the example above, the default color depth is twenty four + bits per pixel. At this color depth, the accepted resolution is + one thousand twenty four pixels by seven hundred and sixty eight + pixels. + + If a user wants to run at a resolution of one thousand + twenty four pixels by seven hundred sixty eight pixels at twenty + four bits per pixel, then the user needs to add the + DefaultColorDepth keyword with the value of + twenty four, and add to the "Display" + subsection with the desired Depth the Modes keyword with the + resolution the user wishes to run at. Note that only VESA + standard modes are supported as defined by the target system's + graphics hardware. + + Finally, the user can write out the configuration file and + test it using the test mode given above. If all is well, then + the configuration file needs to be installed in a common + location where &man.XFree86.1; can source it in the future. + This is typically /etc/X11/XF86Config or + /usr/X11R6/etc/X11/XF86Config. + + &prompt.root; cp XF86Config.new /etc/X11/XF86Config + + Once the configuration file has been placed in a common + location, XFree86 can then be used through &man.xdm.1;. In + order to use &man.startx.1; the user will have to install the + X11/wrapper port. + + + + + Advanced Configuration Topics + + + Configuration with Intel i810 graphics chipsets + + Intel i810 graphic chipset + + Configuration with Intel i810 integrated chipsets + requires the agpgart AGP programming interface for XFree86 to + be able to drive the card. To enable the agpgart programming + interface, the agp.ko kernel loadable + module needs to be loaded into the kernel with + &man.kldload.8;. This can be done automatically with the + &man.loader.8;. Simply add this line to + /boot/loader.conf to have the loader load + agp.ko at boot time: + + agp_load="YES" + + Next, a device node needs to be created for the + programming interface. To create the agp device node, run + &man.MAKEDEV.8; in the /dev directory as + such: + + &prompt.root; cd /dev +&prompt.root; sh MAKEDEV agpgart + + This will allow the user to configure the graphics + hardware as any other graphics board. + + + + Using Fonts in XFree86 @@ -1873,6 +2083,7 @@ esac +