x-config.html

FreeBSD操作系统的详细使用手册

href="http://www.FreeBSD.org/cgi/man.cgi?query=XFree86&sektion=1&manpath=XFree86+4.4.0"><span
 class="CITEREFENTRY"><span class="REFENTRYTITLE">XFree86</span>(1)</span></a>). The <var
class="LITERAL">Modes</var> keyword describes the resolution to run at for the given
color depth. Note that only VESA standard modes are supported as defined by the target
system's graphics hardware. In the example above, the default color depth is twenty-four
bits per pixel. At this color depth, the accepted resolution is 1024 by 768 pixels.</p>

<p>Finally, write the configuration file and test it using the test mode given above.</p>

<div class="NOTE">
<blockquote class="NOTE">
<p><b>Note:</b> One of the tools available to assist you during troubleshooting process
are the X11 log files, which contain information on each device that the X11 server
attaches to. <b class="APPLICATION">Xorg</b> log file names are in the format of <tt
class="FILENAME">/var/log/Xorg.0.log</tt> (<b class="APPLICATION"><span
class="TRADEMARK">XFree86</span></b> log file names follow the format of <tt
class="FILENAME">XFree86.0.log</tt>). The exact name of the log can vary from <tt
class="FILENAME">Xorg.0.log</tt> to <tt class="FILENAME">Xorg.8.log</tt> and so
forth.</p>
</blockquote>
</div>

<p>If all is well, the configuration file needs to be installed in a common location
where <a
href="http://www.FreeBSD.org/cgi/man.cgi?query=Xorg&sektion=1&manpath=X11R6.7.0"><span
class="CITEREFENTRY"><span class="REFENTRYTITLE">Xorg</span>(1)</span></a> (or <a
href="http://www.FreeBSD.org/cgi/man.cgi?query=XFree86&sektion=1&manpath=XFree86+4.4.0"><span
 class="CITEREFENTRY"><span class="REFENTRYTITLE">XFree86</span>(1)</span></a>) can find
it. This is typically <tt class="FILENAME">/etc/X11/xorg.conf</tt> or <tt
class="FILENAME">/usr/X11R6/etc/X11/xorg.conf</tt> (for <b class="APPLICATION"><span
class="TRADEMARK">XFree86</span></b> it is called <tt
class="FILENAME">/etc/X11/XF86Config</tt> or <tt
class="FILENAME">/usr/X11R6/etc/X11/XF86Config</tt>).</p>

<pre class="SCREEN">
<samp class="PROMPT">#</samp> <kbd
class="USERINPUT">cp xorg.conf.new /etc/X11/xorg.conf</kbd>
</pre>

<p>For <b class="APPLICATION"><span class="TRADEMARK">XFree86</span></b>:</p>

<pre class="SCREEN">
<samp class="PROMPT">#</samp> <kbd
class="USERINPUT">cp XF86Config.new /etc/X11/XF86Config</kbd>
</pre>

<p>The X11 configuration process is now complete. In order to start <b
class="APPLICATION"><span class="TRADEMARK">XFree86</span>&nbsp;4.X</b> with <a
href="http://www.FreeBSD.org/cgi/man.cgi?query=startx&sektion=1&manpath=XFree86+4.4.0"><span
 class="CITEREFENTRY"><span class="REFENTRYTITLE">startx</span>(1)</span></a>, install
the <a href="http://www.FreeBSD.org/cgi/url.cgi?ports/x11/wrapper/pkg-descr"><tt
class="FILENAME">x11/wrapper</tt></a> port. <b class="APPLICATION">Xorg</b> already
includes the wrapper code and does not require the installation of the wrapper port. The
X11 server may also be started with the use of <a
href="http://www.FreeBSD.org/cgi/man.cgi?query=xdm&sektion=1&manpath=XFree86+4.4.0"><span
class="CITEREFENTRY"><span class="REFENTRYTITLE">xdm</span>(1)</span></a>.</p>

<div class="NOTE">
<blockquote class="NOTE">
<p><b>Note:</b> There is also a graphical configuration tool, <a
href="http://www.FreeBSD.org/cgi/man.cgi?query=xorgcfg&sektion=1&manpath=X11R6.7.0"><span
class="CITEREFENTRY"><span class="REFENTRYTITLE">xorgcfg</span>(1)</span></a> (<a
href="http://www.FreeBSD.org/cgi/man.cgi?query=xf86cfg&sektion=1&manpath=XFree86+4.4.0"><span
 class="CITEREFENTRY"><span class="REFENTRYTITLE">xf86cfg</span>(1)</span></a> for <b
class="APPLICATION"><span class="TRADEMARK">XFree86</span></b>), that comes with the X11
distribution. It allows you to interactively define your configuration by choosing the
appropriate drivers and settings. This program can be invoked from the console, by typing
the command <tt class="COMMAND">xorgcfg -textmode</tt>. For more details, refer to the <a
href="http://www.FreeBSD.org/cgi/man.cgi?query=xorgcfg&sektion=1&manpath=X11R6.7.0"><span
class="CITEREFENTRY"><span class="REFENTRYTITLE">xorgcfg</span>(1)</span></a> and <a
href="http://www.FreeBSD.org/cgi/man.cgi?query=xf86cfg&sektion=1&manpath=XFree86+4.4.0"><span
 class="CITEREFENTRY"><span class="REFENTRYTITLE">xf86cfg</span>(1)</span></a> manual
pages.</p>

<p>Alternatively, there is also a tool called <a
href="http://www.FreeBSD.org/cgi/man.cgi?query=xorgconfig&sektion=1&manpath=X11R6.7.0"><span
 class="CITEREFENTRY"><span class="REFENTRYTITLE">xorgconfig</span>(1)</span></a> (<a
href="http://www.FreeBSD.org/cgi/man.cgi?query=xf86config&sektion=1&manpath=XFree86+4.4.0">
<span class="CITEREFENTRY"><span class="REFENTRYTITLE">xf86config</span>(1)</span></a>
for <b class="APPLICATION"><span class="TRADEMARK">XFree86</span></b>), this program is a
console utility that is less user friendly, but it may work in situations where the other
tools do not.</p>
</blockquote>
</div>
</div>

<div class="SECT2">
<h2 class="SECT2"><a id="AEN6440" name="AEN6440">5.4.3 Advanced Configuration
Topics</a></h2>

<div class="SECT3">
<h3 class="SECT3"><a id="AEN6442" name="AEN6442">5.4.3.1 Configuration with <span
class="TRADEMARK">Intel</span>&reg; i810 Graphics Chipsets</a></h3>

<p>Configuration with <span class="TRADEMARK">Intel</span>&reg; i810 integrated chipsets
requires the <tt class="DEVICENAME">agpgart</tt> AGP programming interface for X11 to
drive the card. The <a
href="http://www.FreeBSD.org/cgi/man.cgi?query=agp&sektion=4"><span
class="CITEREFENTRY"><span class="REFENTRYTITLE">agp</span>(4)</span></a> driver is in
the <tt class="FILENAME">GENERIC</tt> kernel since releases 4.8-RELEASE and 5.0-RELEASE.
On prior releases, you will have to add the following line:</p>

<pre class="PROGRAMLISTING">
device agp
</pre>

<p>in your kernel configuration file and rebuild a new kernel. Instead, you may want to
load the <tt class="FILENAME">agp.ko</tt> kernel module automatically with the <a
href="http://www.FreeBSD.org/cgi/man.cgi?query=loader&sektion=8"><span
class="CITEREFENTRY"><span class="REFENTRYTITLE">loader</span>(8)</span></a> at boot
time. For that, simply add this line to <tt class="FILENAME">/boot/loader.conf</tt>:</p>

<pre class="PROGRAMLISTING">
agp_load="YES"
</pre>

<p>Next, if you are running FreeBSD&nbsp;4.X or earlier, a device node needs to be
created for the programming interface. To create the AGP device node, run <a
href="http://www.FreeBSD.org/cgi/man.cgi?query=MAKEDEV&sektion=8"><span
class="CITEREFENTRY"><span class="REFENTRYTITLE">MAKEDEV</span>(8)</span></a> in the <tt
class="FILENAME">/dev</tt> directory:</p>

<pre class="SCREEN">
<samp class="PROMPT">#</samp> <kbd class="USERINPUT">cd /dev</kbd>
<samp class="PROMPT">#</samp> <kbd class="USERINPUT">sh MAKEDEV agpgart</kbd>
</pre>

<div class="NOTE">
<blockquote class="NOTE">
<p><b>Note:</b> FreeBSD&nbsp;5.X or later will use <a
href="http://www.FreeBSD.org/cgi/man.cgi?query=devfs&sektion=5&manpath=FreeBSD+6-current">
<span class="CITEREFENTRY"><span class="REFENTRYTITLE">devfs</span>(5)</span></a> to
allocate device nodes transparently, therefore the <a
href="http://www.FreeBSD.org/cgi/man.cgi?query=MAKEDEV&sektion=8"><span
class="CITEREFENTRY"><span class="REFENTRYTITLE">MAKEDEV</span>(8)</span></a> step is not
required.</p>
</blockquote>
</div>

<p>This will allow configuration of the hardware as any other graphics board. Note on
systems without the <a
href="http://www.FreeBSD.org/cgi/man.cgi?query=agp&sektion=4"><span
class="CITEREFENTRY"><span class="REFENTRYTITLE">agp</span>(4)</span></a> driver compiled
in the kernel, trying to load the module with <a
href="http://www.FreeBSD.org/cgi/man.cgi?query=kldload&sektion=8"><span
class="CITEREFENTRY"><span class="REFENTRYTITLE">kldload</span>(8)</span></a> will not
work. This driver has to be in the kernel at boot time through being compiled in or using
<tt class="FILENAME">/boot/loader.conf</tt>.</p>

<p>If you are using <b class="APPLICATION"><span
class="TRADEMARK">XFree86</span>&nbsp;4.1.0</b> (or later) and messages about unresolved
symbols like <var class="LITERAL">fbPictureInit</var> appear, try adding the following
line after <var class="LITERAL">Driver "i810"</var> in the X11 configuration file:</p>

<pre class="PROGRAMLISTING">
Option "NoDDC"
</pre>
</div>
</div>
</div>

<div class="NAVFOOTER">
<hr align="LEFT" width="100%" />
<table summary="Footer navigation table" width="100%" border="0" cellpadding="0"
cellspacing="0">
<tr>
<td width="33%" align="left" valign="top"><a href="x-install.html"
accesskey="P">Prev</a></td>
<td width="34%" align="center" valign="top"><a href="index.html"
accesskey="H">Home</a></td>
<td width="33%" align="right" valign="top"><a href="x-fonts.html"
accesskey="N">Next</a></td>
</tr>

<tr>
<td width="33%" align="left" valign="top">Installing X11</td>
<td width="34%" align="center" valign="top"><a href="x11.html" accesskey="U">Up</a></td>
<td width="33%" align="right" valign="top">Using Fonts in X11</td>
</tr>
</table>
</div>

<p align="center"><small>This, and other documents, can be downloaded from <a
href="ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/">ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/</a>.</small></p>

<p align="center"><small>For questions about FreeBSD, read the <a
href="http://www.FreeBSD.org/docs.html">documentation</a> before contacting &#60;<a
href="mailto:[e-mail]">[e-mail]</a>&#62;.<br />
For questions about this documentation, e-mail &#60;<a
href="mailto:[e-mail]">[e-mail]</a>&#62;.</small></p>
</body>
</html>