Date: Fri, 19 Oct 2012 11:45:15 +0000 (UTC) From: Glen Barber <gjb@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-translations@freebsd.org Subject: svn commit: r39771 - in translations/en_US.ISO8859-1: articles/committers-guide articles/contributors articles/freebsd-update-server articles/hubs articles/mailing-list-faq articles/portbuild artic... Message-ID: <201210191145.q9JBjFwS080004@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: gjb Date: Fri Oct 19 11:45:15 2012 New Revision: 39771 URL: http://svn.freebsd.org/changeset/doc/39771 Log: Merge r39642 through r39769 from ^/head/en_US.ISO8859-1 to bring translations branch up to date. Modified: translations/en_US.ISO8859-1/articles/committers-guide/article.xml translations/en_US.ISO8859-1/articles/contributors/contrib.additional.xml translations/en_US.ISO8859-1/articles/contributors/contrib.committers.xml translations/en_US.ISO8859-1/articles/contributors/contrib.develalumni.xml translations/en_US.ISO8859-1/articles/freebsd-update-server/article.xml translations/en_US.ISO8859-1/articles/hubs/article.xml translations/en_US.ISO8859-1/articles/mailing-list-faq/Makefile translations/en_US.ISO8859-1/articles/portbuild/article.xml translations/en_US.ISO8859-1/articles/problem-reports/article.xml translations/en_US.ISO8859-1/books/arch-handbook/Makefile translations/en_US.ISO8859-1/books/bibliography/Makefile translations/en_US.ISO8859-1/books/dev-model/book.xml translations/en_US.ISO8859-1/books/developers-handbook/Makefile translations/en_US.ISO8859-1/books/developers-handbook/kerneldebug/chapter.xml translations/en_US.ISO8859-1/books/faq/Makefile translations/en_US.ISO8859-1/books/faq/book.xml translations/en_US.ISO8859-1/books/fdp-primer/Makefile translations/en_US.ISO8859-1/books/handbook/Makefile translations/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.xml translations/en_US.ISO8859-1/books/handbook/eresources/chapter.xml translations/en_US.ISO8859-1/books/handbook/l10n/chapter.xml translations/en_US.ISO8859-1/books/handbook/mirrors/chapter.xml translations/en_US.ISO8859-1/books/handbook/ports/chapter.xml translations/en_US.ISO8859-1/books/pmake/Makefile translations/en_US.ISO8859-1/books/porters-handbook/Makefile translations/en_US.ISO8859-1/books/porters-handbook/book.xml translations/en_US.ISO8859-1/flyer/Makefile translations/en_US.ISO8859-1/flyer/flyer.tex translations/en_US.ISO8859-1/htdocs/Makefile translations/en_US.ISO8859-1/htdocs/administration.xml translations/en_US.ISO8859-1/htdocs/cgi/query-pr-summary.cgi translations/en_US.ISO8859-1/htdocs/community/mailinglists.xml translations/en_US.ISO8859-1/htdocs/developers/cvs.xml translations/en_US.ISO8859-1/htdocs/docproj/translations.xml translations/en_US.ISO8859-1/htdocs/donations/index.xml translations/en_US.ISO8859-1/htdocs/donations/wantlist.xml translations/en_US.ISO8859-1/htdocs/gnome/docs/bugging.xml translations/en_US.ISO8859-1/htdocs/gnome/docs/faq2.xml translations/en_US.ISO8859-1/htdocs/gnome/gnomelogalyzer.sh translations/en_US.ISO8859-1/htdocs/index.xsl translations/en_US.ISO8859-1/htdocs/multimedia/multimedia-input.xml translations/en_US.ISO8859-1/htdocs/releases/5.3R/todo.xml translations/en_US.ISO8859-1/htdocs/releases/6.1R/todo.xml translations/en_US.ISO8859-1/htdocs/releases/9.1R/schedule.xml translations/en_US.ISO8859-1/share/xml/mailing-lists.ent translations/en_US.ISO8859-1/share/xml/release.l10n.ent (contents, props changed) translations/en_US.ISO8859-1/share/xml/teams.ent Directory Properties: translations/en_US.ISO8859-1/ (props changed) Modified: translations/en_US.ISO8859-1/articles/committers-guide/article.xml ============================================================================== --- translations/en_US.ISO8859-1/articles/committers-guide/article.xml Fri Oct 19 11:39:24 2012 (r39770) +++ translations/en_US.ISO8859-1/articles/committers-guide/article.xml Fri Oct 19 11:45:15 2012 (r39771) @@ -3491,9 +3491,9 @@ U stable/9/share/man/man4/netmap.4 from the port <filename>Makefile</filename>. It will also add an entry to the port's category <filename>Makefile</filename>. It was - written by &a.mharo; and &a.will;, and is currently maintained - by &a.garga;, so please send questions/patches about - <command>addport</command> to him.</para> + written by &a.mharo;, &a.will;, and &a.garga;. When sending + questions about this script to the &a.ports;, please also CC + &a.crees;, the current maintainer.</para> </answer> </qandaentry> @@ -3600,9 +3600,9 @@ U stable/9/share/man/man4/netmap.4 <para>Alternatively, you can use the <command>rmport</command> script, from <filename class="directory">ports/Tools/scripts</filename>. - This script has been written by &a.vd;, who is also its current - maintainer, so please send questions, patches or suggestions - about <command>rmport</command> to him.</para> + This script was written by &a.vd;. When sending + questions about this script to the &a.ports;, please also CC + &a.crees;, the current maintainer.</para> </answer> </qandaentry> </qandadiv> @@ -3660,6 +3660,12 @@ U stable/9/share/man/man4/netmap.4 one step.</para> </step> </procedure> + + <tip> + <para><command>addport</command> now detects when the port to + add has previously existed, and should handle all except + the <filename>ports/LEGAL</filename> step automatically.</para> + </tip> </answer> </qandaentry> </qandadiv> @@ -3957,7 +3963,7 @@ U stable/9/share/man/man4/netmap.4 <procedure> <step> - <para>Perform any needed repocopies. (This only applies + <para>Perform any needed moves. (This only applies to physical categories.)</para> </step> @@ -3981,12 +3987,9 @@ U stable/9/share/man/man4/netmap.4 </question> <answer> - <para>The procedure is a strict superset of the one to - repocopy individual ports (see above).</para> - <procedure> <step> - <para>Upgrade each copied port's + <para>Upgrade each moved port's <filename>Makefile</filename>. Do not connect the new category to the build yet.</para> @@ -4033,10 +4036,11 @@ U stable/9/share/man/man4/netmap.4 sh -e <replaceable>/path/to/ports</replaceable>/Tools/scripts/chkorigin.sh </command>. This will check <emphasis>every</emphasis> port in the ports tree, even those not connected to the - build, so you can run it directly after the repocopy. + build, so you can run it directly after the move + operation. Hint: do not forget to look at the <makevar>PKGORIGIN</makevar>s of any slave ports of the - ports you just repocopied!</para> + ports you just moved!</para> </step> <step> Modified: translations/en_US.ISO8859-1/articles/contributors/contrib.additional.xml ============================================================================== --- translations/en_US.ISO8859-1/articles/contributors/contrib.additional.xml Fri Oct 19 11:39:24 2012 (r39770) +++ translations/en_US.ISO8859-1/articles/contributors/contrib.additional.xml Fri Oct 19 11:45:15 2012 (r39771) @@ -1688,7 +1688,7 @@ <listitem> <para>Chris Petrik - <email>chris@officialunix.com</email></para> + <email>c.petrik.sosa@gmail.com</email></para> </listitem> <listitem> @@ -2121,6 +2121,11 @@ </listitem> <listitem> + <para>Danilo Egêa Gondolfo + <email>danilogondolfo@gmail.com</email></para> + </listitem> + + <listitem> <para>Danny Braniss <email>danny@cs.huji.ac.il</email></para> </listitem> @@ -6760,6 +6765,11 @@ </listitem> <listitem> + <para>Michael Gmelin + <email>freebsd@grem.de</email></para> + </listitem> + + <listitem> <para>Michael Hancock <email>michaelh@cet.co.jp</email></para> </listitem> Modified: translations/en_US.ISO8859-1/articles/contributors/contrib.committers.xml ============================================================================== --- translations/en_US.ISO8859-1/articles/contributors/contrib.committers.xml Fri Oct 19 11:39:24 2012 (r39770) +++ translations/en_US.ISO8859-1/articles/contributors/contrib.committers.xml Fri Oct 19 11:45:15 2012 (r39771) @@ -92,10 +92,6 @@ </listitem> <listitem> - <para>&a.dougb;</para> - </listitem> - - <listitem> <para>&a.art;</para> </listitem> Modified: translations/en_US.ISO8859-1/articles/contributors/contrib.develalumni.xml ============================================================================== --- translations/en_US.ISO8859-1/articles/contributors/contrib.develalumni.xml Fri Oct 19 11:39:24 2012 (r39770) +++ translations/en_US.ISO8859-1/articles/contributors/contrib.develalumni.xml Fri Oct 19 11:45:15 2012 (r39771) @@ -3,6 +3,10 @@ <!-- $FreeBSD$ --> <itemizedlist> <listitem> + <para>Doug Barton (2000 - 2012)</para> + </listitem> + + <listitem> <para>&a.murray; (2000 - 2012)</para> </listitem> Modified: translations/en_US.ISO8859-1/articles/freebsd-update-server/article.xml ============================================================================== --- translations/en_US.ISO8859-1/articles/freebsd-update-server/article.xml Fri Oct 19 11:39:24 2012 (r39770) +++ translations/en_US.ISO8859-1/articles/freebsd-update-server/article.xml Fri Oct 19 11:45:15 2012 (r39771) @@ -22,7 +22,7 @@ <year>2009</year> <year>2010</year> <year>2011</year> - <holder role="mailto:jhelfman@experts-exchange.com">Jason Helfman</holder> + <holder role="mailto:jgh@FreeBSD.org">Jason Helfman</holder> </copyright> <legalnotice id="trademarks" role="trademarks"> @@ -51,9 +51,7 @@ <sect1 id="acknowledgments"> <title>Acknowledgments</title> - <para>This article was originally published at <ulink - url="http://www.experts-exchange.com/OS/Unix/BSD/FreeBSD/A_1941-Build-Your-Own-FreeBSD-Update-Server.html">Experts Exchange</ulink>, - and subsequently printed at <ulink + <para>This article was subsequently printed at <ulink url="http://bsdmag.org/magazine/1021-bsd-as-a-desktop">BSD Magazine</ulink>.</para> </sect1> Modified: translations/en_US.ISO8859-1/articles/hubs/article.xml ============================================================================== --- translations/en_US.ISO8859-1/articles/hubs/article.xml Fri Oct 19 11:39:24 2012 (r39770) +++ translations/en_US.ISO8859-1/articles/hubs/article.xml Fri Oct 19 11:45:15 2012 (r39771) @@ -125,13 +125,10 @@ also affected by the types of services you want to offer. Plain FTP or HTTP services may not require a huge amount of resources. Watch out if you provide - CVSup, rsync or even AnonCVS. This can have a huge - impact on CPU and memory requirements. Especially - rsync is considered a memory hog, and CVSup does - indeed consume some CPU. For AnonCVS it might - be a nice idea to set up a memory resident file system (MFS) of at least - 300 MB, so you need to take this into account - for your memory requirements. The following + rsync. This can have a huge + impact on CPU and memory requirements as it is + considered a memory hog. + The following are just examples to give you a very rough hint. </para> <para> Modified: translations/en_US.ISO8859-1/articles/mailing-list-faq/Makefile ============================================================================== --- translations/en_US.ISO8859-1/articles/mailing-list-faq/Makefile Fri Oct 19 11:39:24 2012 (r39770) +++ translations/en_US.ISO8859-1/articles/mailing-list-faq/Makefile Fri Oct 19 11:45:15 2012 (r39771) @@ -13,11 +13,11 @@ INSTALL_ONLY_COMPRESSED?= WITH_ARTICLE_TOC?=YES # -# SRCS lists the individual SGML files that make up the document. Changes +# SRCS lists the individual XML files that make up the document. Changes # to any of these files will force a rebuild # -# SGML content +# XML content SRCS= article.xml URL_RELPREFIX?= ../../../.. Modified: translations/en_US.ISO8859-1/articles/portbuild/article.xml ============================================================================== --- translations/en_US.ISO8859-1/articles/portbuild/article.xml Fri Oct 19 11:39:24 2012 (r39770) +++ translations/en_US.ISO8859-1/articles/portbuild/article.xml Fri Oct 19 11:45:15 2012 (r39771) @@ -2737,7 +2737,8 @@ console="vidconsole,comconsole"</screen> <step> <para>Add the following to <filename>/etc/sysctl.conf</filename>:<screen> -kern.maxfiles=40000</screen> +kern.maxfiles=40000 +kern.maxfilesperproc=38000</screen> </para> </step> Modified: translations/en_US.ISO8859-1/articles/problem-reports/article.xml ============================================================================== --- translations/en_US.ISO8859-1/articles/problem-reports/article.xml Fri Oct 19 11:39:24 2012 (r39770) +++ translations/en_US.ISO8859-1/articles/problem-reports/article.xml Fri Oct 19 11:45:15 2012 (r39771) @@ -11,7 +11,6 @@ <legalnotice id="trademarks" role="trademarks"> &tm-attrib.freebsd; - &tm-attrib.cvsup; &tm-attrib.ibm; &tm-attrib.intel; &tm-attrib.sparc; @@ -89,7 +88,7 @@ course of action, and will only serve to frustrate you and the developers. Conversely, there are cases where it might be appropriate to submit a problem report about something else than - a bug—an enhancement or a feature request, for + a bug—an enhancement or a new feature, for instance.</para> <para>So how do you determine what is a bug and what is not? As a @@ -106,12 +105,6 @@ <itemizedlist> <listitem> - <para>Requests for feature enhancements. It is generally a - good idea to air these on the mailing lists before - submitting a problem report.</para> - </listitem> - - <listitem> <para>Notification of updates to externally maintained software (mainly ports, but also externally maintained base system components such as BIND or various GNU @@ -280,7 +273,7 @@ carefully study the contents of the <filename>/usr/src/UPDATING</filename> file on your system or its latest version at - <ulink url="http://www.FreeBSD.org/cgi/cvsweb.cgi/src/UPDATING"></ulink>. + <ulink url="http://svnweb.freebsd.org/base/head/UPDATING?view=log"></ulink>. (This is vital information if you are upgrading from one version to another—especially if you are upgrading to the @@ -291,10 +284,10 @@ <filename>/usr/ports/UPDATING</filename> (for individual ports) or <filename>/usr/ports/CHANGES</filename> (for changes that affect the entire Ports Collection). - <ulink url="http://www.FreeBSD.org/cgi/cvsweb.cgi/ports/UPDATING"></ulink>; + <ulink url="http://svnweb.freebsd.org/ports/head/UPDATING?view=log"></ulink>; and - <ulink url="http://www.FreeBSD.org/cgi/cvsweb.cgi/ports/CHANGES"></ulink>; - are also available via CVSweb.</para> + <ulink url="http://svnweb.freebsd.org/ports/head/CHANGES?view=log"></ulink>; + are also available via svnweb.</para> </listitem> </itemizedlist> </section> @@ -374,8 +367,8 @@ is a place to put that, see below) and on which architecture. You should include whether you are running from a release (e.g. from a CDROM or download), or from - a system maintained by &man.cvsup.1; (and, if so, how - recently you updated). If you are tracking the + a system maintained by Subversion (and, if so, + what revision number you are at). If you are tracking the &os.current; branch, that is the very first thing someone will ask, because fixes (especially for high-profile problems) tend to get committed very quickly, and @@ -587,11 +580,11 @@ <option>-c</option> or <option>-u</option> option to &man.diff.1; to create a context or unified diff (unified is preferred), and make - sure to specify the exact CVS revision numbers of the files + sure to specify the exact SVN revision numbers of the files you modified so the developers who read your report will be able to apply them easily. For problems with the kernel or the base utilities, a patch against &os.current; (the HEAD - CVS branch) is preferred since all new code should be applied + Subversion branch) is preferred since all new code should be applied and tested there first. After appropriate or substantial testing has been done, the code will be merged/migrated to the &os.stable; branch.</para> @@ -664,8 +657,8 @@ <para><emphasis>Confidential:</emphasis> This is prefilled to <literal>no</literal>. Changing it makes no sense as there is no such thing as a confidential &os; problem - report—the PR database is distributed worldwide by - <application>CVSup</application>.</para> + report—the PR database is distributed + worldwide.</para> </listitem> <listitem> @@ -923,7 +916,7 @@ </itemizedlist> <para>Here is the current list of categories (taken from - <ulink url="http://www.FreeBSD.org/cgi/cvsweb.cgi/src/gnu/usr.bin/send-pr/categories"></ulink>):</para>; + <ulink url="http://svnweb.freebsd.org/base/head/gnu/usr.bin/send-pr/categories"></ulink>):</para>; <itemizedlist> <listitem> @@ -932,11 +925,6 @@ </listitem> <listitem> - <para><literal>alpha:</literal> problems specific to the - Alpha platform.</para> - </listitem> - - <listitem> <para><literal>amd64:</literal> problems specific to the AMD64 platform.</para> </listitem> Modified: translations/en_US.ISO8859-1/books/arch-handbook/Makefile ============================================================================== --- translations/en_US.ISO8859-1/books/arch-handbook/Makefile Fri Oct 19 11:39:24 2012 (r39770) +++ translations/en_US.ISO8859-1/books/arch-handbook/Makefile Fri Oct 19 11:45:15 2012 (r39771) @@ -16,11 +16,11 @@ INSTALL_COMPRESSED?= gz INSTALL_ONLY_COMPRESSED?= # -# SRCS lists the individual SGML files that make up the document. Changes +# SRCS lists the individual XML files that make up the document. Changes # to any of these files will force a rebuild # -# SGML content +# XML content SRCS= book.xml SRCS+= boot/chapter.xml SRCS+= driverbasics/chapter.xml Modified: translations/en_US.ISO8859-1/books/bibliography/Makefile ============================================================================== --- translations/en_US.ISO8859-1/books/bibliography/Makefile Fri Oct 19 11:39:24 2012 (r39770) +++ translations/en_US.ISO8859-1/books/bibliography/Makefile Fri Oct 19 11:45:15 2012 (r39771) @@ -13,11 +13,11 @@ INSTALL_COMPRESSED?= gz INSTALL_ONLY_COMPRESSED?= # -# SRCS lists the individual SGML files that make up the document. Changes +# SRCS lists the individual XML files that make up the document. Changes # to any of these files will force a rebuild # -# SGML content +# XML content SRCS= book.xml DOC_PREFIX?= ${.CURDIR}/../../.. Modified: translations/en_US.ISO8859-1/books/dev-model/book.xml ============================================================================== --- translations/en_US.ISO8859-1/books/dev-model/book.xml Fri Oct 19 11:39:24 2012 (r39770) +++ translations/en_US.ISO8859-1/books/dev-model/book.xml Fri Oct 19 11:45:15 2012 (r39771) @@ -910,27 +910,6 @@ </para> </section> - <section id="role-internationalisation" xreflabel="Internationalisation"> - <title>Internationalisation</title> - <para> - The Internationalisation hat is responsible for coordinating - the localisation efforts of the FreeBSD kernel and userland - utilities. The translation effort are coordinated by - <xref linkend="sub-project-documentation"/>. The - Internationalisation hat should suggest and promote standards - and guidelines for writing and maintaining the software in a - fashion that makes it easier to translate. - </para> - <para> - Hat currently available. - <!-- - [TODO] - Is this still the case? - Although Ache does Localization - Andrey A. Chernov <email>ache@FreeBSD.org</email> - --> - </para> - </section> - <section id="role-postmaster" xreflabel="Postmaster"> <title>Postmaster</title> <para> @@ -946,21 +925,6 @@ </para> </section> - <section id="role-quality-assurance" xreflabel="Quality Assurance"> - <title>Quality Assurance</title> - - <para> - The responsibilities of this role are to manage the quality assurance - measures. - </para> - - <para> - Hat currently held by: - Robert Watson <email>rwatson@FreeBSD.org</email>. - </para> - - </section> - <section id="role-release-coordination" xreflabel="Release Coordination"> <title>Release Coordination</title> @@ -1232,8 +1196,7 @@ <para> Hat held by: - the Admin team <email>admin@FreeBSD.org</email>, - currently headed by Mark Murray <email>markm@FreeBSD.org</email> + the Admin team <email>admin@FreeBSD.org</email>. </para> </section> Modified: translations/en_US.ISO8859-1/books/developers-handbook/Makefile ============================================================================== --- translations/en_US.ISO8859-1/books/developers-handbook/Makefile Fri Oct 19 11:39:24 2012 (r39770) +++ translations/en_US.ISO8859-1/books/developers-handbook/Makefile Fri Oct 19 11:45:15 2012 (r39771) @@ -19,11 +19,11 @@ INSTALL_ONLY_COMPRESSED?= IMAGES_EN= sockets/layers.eps sockets/sain.eps sockets/sainfill.eps sockets/sainlsb.eps sockets/sainmsb.eps sockets/sainserv.eps sockets/serv.eps sockets/serv2.eps sockets/slayers.eps # -# SRCS lists the individual SGML files that make up the document. Changes +# SRCS lists the individual XML files that make up the document. Changes # to any of these files will force a rebuild # -# SGML content +# XML content SRCS= book.xml SRCS+= introduction/chapter.xml SRCS+= ipv6/chapter.xml Modified: translations/en_US.ISO8859-1/books/developers-handbook/kerneldebug/chapter.xml ============================================================================== --- translations/en_US.ISO8859-1/books/developers-handbook/kerneldebug/chapter.xml Fri Oct 19 11:39:24 2012 (r39770) +++ translations/en_US.ISO8859-1/books/developers-handbook/kerneldebug/chapter.xml Fri Oct 19 11:45:15 2012 (r39771) @@ -786,6 +786,254 @@ Debugger (msg=0xf01b0383 "Boot flags req stack, and do a backtrace with <command>where</command>.</para> </sect1> + <sect1 id="kerneldebug-dcons"> + <title>Kernel debugging with Dcons</title> + + <para>&man.dcons.4; is a very simple console driver that is + not directly connected with any physical devices. It just reads + and writes characters from and to a buffer in a kernel or + loader. Due to its simple nature, it is very useful for kernel + debugging, especially with a &firewire; device. Currently, &os; + provides two ways to interact with the buffer from outside of + the kernel using &man.dconschat.8;.</para> + + <sect2> + <title>Dcons over &firewire;</title> + + <para>Most &firewire; (IEEE1394) host controllers are + based on the <acronym>OHCI</acronym> specification that + supports physical access to the host memory. This means that + once the host controller is initialized, we can access the + host memory without the help of software (kernel). We can + exploit this facility for interaction with &man.dcons.4;. + &man.dcons.4; provides similar functionality as a serial + console. It emulates two serial ports, one for the console + and <acronym>DDB</acronym>, the other for + <acronym>GDB</acronym>. Because remote memory access is fully + handled by the hardware, the &man.dcons.4; buffer is + accessible even when the system crashes.</para> + + <para>&firewire; devices are not limited to those + integrated into motherboards. <acronym>PCI</acronym> cards + exist for desktops, and a cardbus interface can be purchased + for laptops.</para> + + <sect3> + <title>Enabling &firewire; and Dcons support on the target + machine</title> + + <para>To enable &firewire; and Dcons support in the kernel of + the <emphasis>target machine</emphasis>:</para> + + <itemizedlist> + <listitem> + <para>Make sure your kernel supports + <literal>dcons</literal>, <literal>dcons_crom</literal> + and <literal>firewire</literal>. + <literal>Dcons</literal> should be statically linked + with the kernel. For <literal>dcons_crom</literal> and + <literal>firewire</literal>, modules should be + OK.</para> + </listitem> + <listitem> + <para>Make sure physical <acronym>DMA</acronym> is enabled. + You may need to add + <literal>hw.firewire.phydma_enable=1</literal> to + <filename>/boot/loader.conf</filename>.</para> + </listitem> + <listitem> + <para>Add options for debugging.</para> + </listitem> + <listitem> + <para>Add <literal>dcons_gdb=1</literal> in + <filename>/boot/loader.conf</filename> if you use GDB + over &firewire;.</para> + </listitem> + <listitem> + <para>Enable <literal>dcons</literal> in + <filename>/etc/ttys</filename>.</para> + </listitem> + <listitem> + <para>Optionally, to force <literal>dcons</literal> to + be the high-level console, add + <literal>hw.firewire.dcons_crom.force_console=1</literal> + to <filename>loader.conf</filename>.</para> + </listitem> + </itemizedlist> + + <para>To enable &firewire; and Dcons support in &man.loader.8; + on i386 or amd64:</para> + + <para>Add + <literal>LOADER_FIREWIRE_SUPPORT=YES</literal> in + <filename>/etc/make.conf</filename> and rebuild + &man.loader.8;:</para> + + <screen>&prompt.root; <userinput>cd /sys/boot/i386 && make clean && make && make install</userinput></screen> + + <para>To enable &man.dcons.4; as an active low-level + console, add <literal>boot_multicons="YES"</literal> to + <filename>/boot/loader.conf</filename>.</para> + + <para>Here are a few configuration examples. A sample kernel + configuration file would contain:</para> + + <screen>device dcons +device dcons_crom +options KDB +options DDB +options GDB +options ALT_BREAK_TO_DEBUGGER</screen> + + <para>And a sample <filename>/boot/loader.conf</filename> + would contain:</para> + + <screen>dcons_crom_load="YES" +dcons_gdb=1 +boot_multicons="YES" +hw.firewire.phydma_enable=1 +hw.firewire.dcons_crom.force_console=1</screen> + + </sect3> + + <sect3> + <title>Enabling &firewire; and Dcons support on the host + machine</title> + + <para>To enable &firewire; support in the kernel on the + <emphasis>host machine</emphasis>:</para> + + <screen>&prompt.root; <userinput>kldload firewire</userinput></screen> + + <para>Find out the <acronym>EUI64</acronym> (the unique 64 + bit identifier) of the &firewire; host controller, and + use &man.fwcontrol.8; or <command>dmesg</command> to + find the <acronym>EUI64</acronym> of the target machine.</para> + + <para>Run &man.dconschat.8;, with:</para> + + <screen>&prompt.root; <userinput>dconschat -e \# -br -G 12345 -t <replaceable>00-11-22-33-44-55-66-77</replaceable></userinput></screen> + + <para>The following key combinations can be used once + &man.dconschat.8; is running:</para> + + <informaltable pgwide="1"> + <tgroup cols="2"> + <tbody> + <row> + <entry> + <keycombo action="seq"> + <keycap>~</keycap> + <keycap>.</keycap> + </keycombo> + </entry> + <entry>Disconnect</entry> + </row> + <row> + <entry> + <keycombo action="seq"> + <keycap>~</keycap> + <keycombo action="simul"> + <keycap>Ctrl</keycap> + <keycap>B</keycap> + </keycombo> + </keycombo> + </entry> + <entry>ALT BREAK</entry> + </row> + <row> + <entry> + <keycombo action="seq"> + <keycap>~</keycap> + <keycombo action="simul"> + <keycap>Ctrl</keycap> + <keycap>R</keycap> + </keycombo> + </keycombo> + </entry> + <entry>RESET target</entry> + </row> + <row> + <entry> + <keycombo action="seq"> + <keycap>~</keycap> + <keycombo action="simul"> + <keycap>Ctrl</keycap> + <keycap>Z</keycap> + </keycombo> + </keycombo> + </entry> + <entry>Suspend dconschat</entry> + </row> + </tbody> + </tgroup> + </informaltable> + + <para>Attach remote <acronym>GDB</acronym> by starting + &man.kgdb.1; with a remote debugging session:</para> + + <screen><userinput>kgdb -r :12345 kernel</userinput></screen> + + </sect3> + <sect3> + <title>Some general tips</title> + + <para>Here are some general tips:</para> + + <para>To take full advantage of the speed of &firewire;, + disable other slow console drivers:</para> + + <screen>&prompt.root; conscontrol delete ttyd0 # serial console +&prompt.root; conscontrol delete consolectl # video/keyboard</screen> + + <para>There exists a <acronym>GDB</acronym> mode for + &man.emacs.1;; this is what you will need to add to your + <filename>.emacs</filename>:</para> + + <screen><userinput>(setq gud-gdba-command-name "kgdb -a -a -a -r :12345") +(setq gdb-many-windows t) +(xterm-mouse-mode 1) +M-x gdba</userinput></screen> + + <para>And for <acronym>DDD</acronym> (<filename>devel/ddd</filename>):</para> + + <screen># remote serial protocol +LANG=C ddd --debugger kgdb -r :12345 kernel +# live core debug +LANG=C ddd --debugger kgdb kernel /dev/fwmem0.2</screen> + </sect3> + </sect2> + + <sect2> + <title>Dcons with KVM</title> + + <para>We can directly read the &man.dcons.4; buffer via + <filename>/dev/mem</filename> for live systems, and in the + core dump for crashed systems. These give you similar output + to <command>dmesg -a</command>, but the &man.dcons.4; buffer + includes more information.</para> + + <sect3> + <title>Using Dcons with KVM</title> + + <para>To use &man.dcons.4; with <acronym>KVM</acronym>:</para> + + <para>Dump a &man.dcons.4; buffer of a live system:</para> + + <screen>&prompt.root; <userinput>dconschat -1</userinput></screen> + + <para>Dump a &man.dcons.4; buffer of a crash dump:</para> + + <screen>&prompt.root; <userinput>dconschat -1 -M vmcore.XX</userinput></screen> + + <para>Live core debugging can be done via:</para> + + <screen>&prompt.root; <userinput>fwcontrol -m target_eui64</userinput> +&prompt.root; <userinput>kgdb kernel /dev/fwmem0.2</userinput></screen> + </sect3> + </sect2> + </sect1> + <sect1 id="kerneldebug-options"> <title>Glossary of Kernel Options for Debugging</title> Modified: translations/en_US.ISO8859-1/books/faq/Makefile ============================================================================== --- translations/en_US.ISO8859-1/books/faq/Makefile Fri Oct 19 11:39:24 2012 (r39770) +++ translations/en_US.ISO8859-1/books/faq/Makefile Fri Oct 19 11:45:15 2012 (r39771) @@ -16,11 +16,11 @@ INSTALL_ONLY_COMPRESSED?= WITH_BIBLIOXREF_TITLE?=YES # -# SRCS lists the individual SGML files that make up the document. Changes +# SRCS lists the individual XML files that make up the document. Changes # to any of these files will force a rebuild # -# SGML content +# XML content SRCS= book.xml URL_RELPREFIX?= ../../../.. Modified: translations/en_US.ISO8859-1/books/faq/book.xml ============================================================================== --- translations/en_US.ISO8859-1/books/faq/book.xml Fri Oct 19 11:39:24 2012 (r39770) +++ translations/en_US.ISO8859-1/books/faq/book.xml Fri Oct 19 11:45:15 2012 (r39771) @@ -62,7 +62,6 @@ &tm-attrib.3com; &tm-attrib.adobe; &tm-attrib.creative; - &tm-attrib.cvsup; &tm-attrib.ibm; &tm-attrib.ieee; &tm-attrib.intel; @@ -70,7 +69,6 @@ &tm-attrib.linux; &tm-attrib.microsoft; &tm-attrib.mips; - &tm-attrib.netscape; &tm-attrib.opengroup; &tm-attrib.oracle; &tm-attrib.sgi; @@ -1601,10 +1599,6 @@ cause this problem.</para> </listitem> </orderedlist> - - <para>There have also been reports of &netscape; causing - problems when downloading the boot floppy, so it is probably - best to use a different FTP client if you can.</para> </answer> </qandaentry> @@ -1776,7 +1770,7 @@ </question> <answer> - <para>This is classically a case of &os; and DOS or some other + <para>This is classically a case of &os; and some other OS conflicting over their ideas of disk <link linkend="geometry">geometry</link>. You will have to reinstall &os;, but obeying the instructions given above @@ -2229,7 +2223,7 @@ motherboard bugs may generate some problems.</para> <para>&os; will take advantage of HyperThreading (HTT) - support on Intel CPUs that support this feature. A kernel + support on &intel; CPUs that support this feature. A kernel with the <literal>options SMP</literal> feature enabled will automatically detect the additional logical processors.</para> @@ -2237,6 +2231,25 @@ <para>&man.smp.4; has more details.</para> </answer> </qandaentry> + + <qandaentry> + <question> + <para>What is microcode? + How do I install &intel; CPU microcode updates?</para> + </question> + + <answer> + <para>Microcode is a method of programmatically + implementating hardware level instructions. This allows + for CPU bugs to be fixed without replacing the on board chip.</para> + + <para> + Install <filename role="package">sysutils/devcpu-data</filename>, + then add:</para> + <programlisting>microcode_update_enable="YES"</programlisting> + <para>to <filename>/etc/rc.conf</filename></para> + </answer> + </qandaentry> </qandaset> </sect1> @@ -2927,22 +2940,6 @@ quit</programlisting> </qandaentry> <qandaentry> - <question id="printer-slow"> - <para>My parallel printer is ridiculously slow. What can I - do?</para> - </question> - - <answer> - <para>If the only problem is that the printer is terribly - slow, try changing your <ulink - url="&url.books.handbook;/printing-intro-setup.html#PRINTING-PARALLEL-PORT-MODE">printer port mode</ulink> - as discussed in the <ulink - url="&url.books.handbook;/printing-intro-setup.html">Printer Setup</ulink> - section of the Handbook.</para> - </answer> - </qandaentry> - - <qandaentry> <question id="signal11"> <para>Why do my programs occasionally die with <errorname>Signal 11</errorname> errors?</para> @@ -4237,6 +4234,35 @@ kern.timecounter.hardware: TSC -> i82 </qandaentry> <qandaentry> + <question id="how-do-download-ports-tree"> + <para>How do I download the Ports tree? Should I be using + SVN?</para> + </question> + + <answer> + <para>Any of the methods listed here work:</para> + + <itemizedlist> + <listitem> + <para>Use portsnap for most use cases.</para> + </listitem> + <listitem> + <para>Use SVN directly if you need custom patches + to the ports tree.</para> + </listitem> + <listitem> + <para>Use CTM if you prefer getting patches + by email (this is a rarer use case).</para> + </listitem> + </itemizedlist> + + <para>Any other method should be considered a + legacy method. If you do not already use them, + do not start.</para> + </answer> + </qandaentry> + + <qandaentry> <question id="configure-inn"> <para>How do I configure INN (Internet News) for my machine?</para> @@ -4435,14 +4461,14 @@ kern.timecounter.hardware: TSC -> i82 <qandaentry> <question id="netscape-slow-startup"> - <para>Why do <application>&netscape;</application> and + <para>Why does <application>Opera</application> take so long to start?</para> </question> <answer> <para>The usual answer is that DNS on your system is - misconfigured. Both <application>&netscape;</application> - and <application>Opera</application> perform DNS checks when + misconfigured. + <application>Opera</application> perform DNS checks when starting up. The browser will not appear on your desktop until the program either gets a response or determines that the system has no network connection.</para> @@ -4450,27 +4476,6 @@ kern.timecounter.hardware: TSC -> i82 </qandaentry> <qandaentry> - <question id="ports-base-update"> - <para>I updated parts of the Ports Collection using - <application>CVSup</application>, and now many ports fail to - build with mysterious error messages! What happened? Is - the Ports Collection broken in some major way?</para> - </question> - - <answer> - <para>If you only update parts of the Ports Collection, using - one of its <application>CVSup</application> subcollections - and not the <literal>ports-all</literal> - <application>CVSup</application> collection, you should - <emphasis>always</emphasis> update the - <literal>ports-base</literal> subcollection too! The - reasons are described <ulink - url="&url.books.handbook;/cvsup.html#CVSUP-COLLEC-PBASE-WARN">in the Handbook</ulink>. - </para> - </answer> - </qandaentry> - - <qandaentry> <question id="midi-sound-files"> <para>How do I create audio CDs from my MIDI files?</para> </question> @@ -4548,7 +4553,7 @@ kern.timecounter.hardware: TSC -> i82 <qandaentry> <question id="why-kernel-big"> - <para>Why is my kernel so big (over 10 MB)?</para> + <para>Why is my kernel so big?</para> </question> <answer> @@ -7477,21 +7482,6 @@ Key F15 A A Menu Wo </qandaentry> <qandaentry> - <question id="nfs-sun"> - <para>Why can I not NFS-mount from a &sun; box?</para> - </question> - - <answer> - <para>&sun; workstations running - &sunos; 4.<replaceable>X</replaceable> only accept - mount requests from a privileged port; try the following - command:</para> - - <screen>&prompt.root; <userinput>mount -o -P <replaceable>sunbox:/blah</replaceable> <replaceable>/mnt</replaceable></userinput></screen> - </answer> - </qandaentry> - - <qandaentry> <question id="exports-errors"> <para>Why does <command>mountd</command> keep telling me it <errorname>can't change attributes</errorname> and that I @@ -8079,7 +8069,7 @@ Key F15 A A Menu Wo installed by default. If you want <command>suidperl</command> to be built during upgrades from source, edit <filename>/etc/make.conf</filename> and add - <literal><varname>ENABLE_SUIDPERL</varname>=true</literal> + <literal><varname>OPTIONS_SET</varname>=SUIDPERL</literal> before you build <command>perl</command>.</para> </answer> </qandaentry> @@ -8975,8 +8965,8 @@ ATDT1234567</programlisting> <listitem> <para>Use a proxy. The application may support - <literal>socks5</literal> for example, or (as in the - <command>cvsup</command> case) may have a + <literal>socks5</literal> for example, or + may have a <quote>passive</quote> option that avoids ever requesting that the peer open connections back to the local machine.</para> @@ -9653,28 +9643,6 @@ hint.sio.7.irq="12"</programlisting> </qandaentry> <qandaentry> - <question id="sup-define"> - <para>What is <command>sup</command>, and how do I use - it?</para> - </question> - - <answer> - <para><ulink - url="http://www.FreeBSD.org/cgi/ports.cgi?^sup">SUP</ulink>; - stands for Software Update Protocol, and was developed by - CMU for keeping their development trees in sync. It was - used to keep remote sites in sync with the Project's central - development sources.</para> - - <para>SUP is not bandwidth friendly, and has been retired. - The current recommended method to keep your sources up to - date is <ulink - url="&url.books.handbook;/synching.html#CVSUP">CVSup</ulink> - </para> - </answer> - </qandaentry> - - <qandaentry> <question id="daemon-name"> <para>What is the cute little red guy's name?</para> </question> @@ -9919,7 +9887,7 @@ hint.sio.7.irq="12"</programlisting> <para>Five to complain about buildworld being broken;</para> <para>Thirty-one to answer that it works for them, and they - must have cvsupped at a bad time;</para> + must have updated at a bad time;</para> <para>One to post a patch for a new lightbulb to -hackers;</para> @@ -10077,20 +10045,13 @@ hint.sio.7.irq="12"</programlisting> </question> <answer> - <para>At this time, there is only one book on &os;-specific OS - internals, namely <quote>The Design and Implementation of - the &os; Operating System</quote> by Marshall Kirk McKusick - and George V. Neville-Neil, ISBN 0-201-70245-2, which - focuses on version 5.<replaceable>X</replaceable> of - &os;.</para> - - <para>Additionally, much general &unix; knowledge is directly - applicable to &os;.</para> - <para>For a list of relevant books, please check the Handbook's <ulink url="&url.books.handbook;/bibliography-osinternals.html">Operating System Internals Bibliography</ulink>. </para> + + <para>Additionally, much general &unix; knowledge is directly + applicable to &os;.</para> </answer> </qandaentry> @@ -10201,29 +10162,6 @@ hint.sio.7.irq="12"</programlisting> </qandaentry> <qandaentry> - <question id="cvsup-round-robin"> *** DIFF OUTPUT TRUNCATED AT 1000 LINES ***
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201210191145.q9JBjFwS080004>