From 5ebd985321bce2d297671b7b3ce55d49d98b0234 Mon Sep 17 00:00:00 2001 From: "Justin C. Sherrill" Date: Sat, 11 Mar 2006 04:39:33 +0000 Subject: [PATCH] Bringing chapter up to date with FreeBSD Handbook changes. There are still a number of changes; this is not yet up to date. Changelist pasted: Revision 1.169, Fri Aug 27 12:04:24 2004 UTC (18 months, 1 week ago) by blackend Branch: MAIN CVS Tags: ISBN_1-57176-328-7 Changes since 1.168: +4 -4 lines Diff to previous 1.168 (colored) - Some s/option/literal tags for consistency - A process state should not considered as an errorname, literal tags is maybe a better choice in this case. Revision 1.168, Fri Aug 20 09:40:15 2004 UTC (18 months, 2 weeks ago) by blackend Branch: MAIN Changes since 1.167: +6 -6 lines Diff to previous 1.167 (colored) - Add a non-breaking space where needed. - Reword "15+" and "5.0+" - Use right inline tags for a kernel configuration line. Revision 1.167, Wed Aug 11 21:01:42 2004 UTC (18 months, 4 weeks ago) by blackend Branch: MAIN Changes since 1.166: +4 -4 lines Diff to previous 1.166 (colored) In Virtual Hosts section: - Use of hostid tags for netmasks - Add missing literal tags Revision 1.166, Wed Aug 11 20:19:40 2004 UTC (18 months, 4 weeks ago) by blackend Branch: MAIN Changes since 1.165: +1 -1 lines Diff to previous 1.165 (colored) NetBSD is not an application. Revision 1.165, Mon Aug 9 12:58:05 2004 UTC (19 months ago) by roam Branch: MAIN Changes since 1.164: +4 -4 lines Diff to previous 1.164 (colored) Chase the change of the default value of vfs.vmiodirenable to 1: there were parts of the text that still spoke of 'turning it on' or 'keeping it off'. PR: 70005 Submitted by: Marju Ignatjeva Revision 1.164, Mon Aug 9 12:00:47 2004 UTC (19 months ago) by roam Branch: MAIN Changes since 1.163: +12 -2 lines Diff to previous 1.163 (colored) Emphasize a bit the need for an all-ones netmask on "secondary" interface addresses. PR: 68746 Reported by: Dave Duchscher Reviewed by: keramida Revision 1.163, Thu Aug 5 10:04:29 2004 UTC (19 months ago) by den Branch: MAIN Changes since 1.162: +1 -1 lines Diff to previous 1.162 (colored) Use url entities for links between docs Revision 1.162, Wed Jul 28 09:14:23 2004 UTC (19 months, 1 week ago) by murray Branch: MAIN Changes since 1.161: +4 -8 lines Diff to previous 1.161 (colored) * Remove CVSup knowledge from the pre-requisites in the chapter synopsis. I don't see anywhere in the chapter where that knowledge is required, and it is a forward reference in any case. * Use an rather than a ulink to a specific html file to refer to an earlier section of this chapter. Revision 1.161, Wed Jul 21 09:06:27 2004 UTC (19 months, 2 weeks ago) by murray Branch: MAIN Changes since 1.160: +1 -1 lines Diff to previous 1.160 (colored) Spellcheck: address, Internet, Ethernet. Found by: make spellcheck Revision 1.160, Mon Jul 12 07:04:56 2004 UTC (19 months, 4 weeks ago) by murray Branch: MAIN Changes since 1.159: +2 -1 lines Diff to previous 1.159 (colored) Wrap long lines in and sections. These flow over the page in print output, and make the user scroll in HTML output. Revision 1.159, Thu Jul 8 07:28:59 2004 UTC (20 months ago) by murray Branch: MAIN Changes since 1.158: +6 -0 lines Diff to previous 1.158 (colored) Use column width attribute to make tables more aesthetically pleasing in print output. Revision 1.158, Tue Jul 6 14:25:54 2004 UTC (20 months ago) by den Branch: MAIN Changes since 1.157: +2 -0 lines Diff to previous 1.157 (colored) Close / fix pair tags Revision 1.157, Tue Jul 6 12:06:17 2004 UTC (20 months ago) by den Branch: MAIN Changes since 1.156: +1 -1 lines Diff to previous 1.156 (colored) Use relative link to FAQ Revision 1.156, Thu Jun 17 08:33:11 2004 UTC (20 months, 3 weeks ago) by blackend Branch: MAIN Changes since 1.155: +7 -1 lines Diff to previous 1.155 (colored) In the Tuning with sysctl section: mention /etc/sysctl.conf and add a link to the sysctl.conf section (6.10.4). PR: docs/68037 Submitted by: Brad Davis Revision 1.155, Wed Jun 16 15:14:06 2004 UTC (20 months, 3 weeks ago) by trhodes Branch: MAIN Changes since 1.154: +1 -1 lines Diff to previous 1.154 (colored) It is 'device acpica' in 4.X. Noticed by: Gustaaf Wijnands --- en/books/handbook/config/chapter.sgml | 63 ++++++++++++++++++--------- 1 file changed, 43 insertions(+), 20 deletions(-) diff --git a/en/books/handbook/config/chapter.sgml b/en/books/handbook/config/chapter.sgml index 9721fca075..ce5c9d66ae 100644 --- a/en/books/handbook/config/chapter.sgml +++ b/en/books/handbook/config/chapter.sgml @@ -1,8 +1,8 @@ @@ -85,9 +85,7 @@ linkend="basics">). - Be familiar with keeping &os; sources up to date - (), and - the basics of kernel configuration/compilation + Be familiar with the basics of kernel configuration/compilation (). @@ -950,7 +948,7 @@ tun0: flags=8010<POINTOPOINT,MULTICAST> mtu 1500 is active, i.e. the carrier is detected. For dc1, we see status: no carrier. This is normal when - an ethernet cable is not plugged into the card. + an Ethernet cable is not plugged into the card. @@ -1146,8 +1144,9 @@ round-trip min/avg/max/stddev = 0.700/0.729/0.766/0.025 ms ifconfig_fxp0_alias0="inet xxx.xxx.xxx.xxx netmask xxx.xxx.xxx.xxx" - Note that alias entries must start with alias0 and proceed - upwards in order, (for example, _alias1, _alias2, and so on). + Note that alias entries must start with + alias0 and proceed upwards in order, (for example, + _alias1, _alias2, and so on). The configuration process will stop at the first missing number. @@ -1155,7 +1154,10 @@ round-trip min/avg/max/stddev = 0.700/0.729/0.766/0.025 ms fortunately quite simple. For a given interface, there must be one address which correctly represents the network's netmask. Any other addresses which fall within this network must have a - netmask of all 1s. + netmask of all 1s (expressed as either + 255.255.255.255 or + 0xffffffff). + For example, consider the case where the fxp0 interface is @@ -1166,7 +1168,15 @@ round-trip min/avg/max/stddev = 0.700/0.729/0.766/0.025 ms We want the system to appear at 10.1.1.1 through 10.1.1.5 and at 202.0.75.17 through - 202.0.75.20. + 202.0.75.20. As noted above, only the + first address in a given network range (in this case, + 10.0.1.1 and + 202.0.75.17) should have a real + netmask; all the rest (10.1.1.2 + through 10.1.1.5 and + 202.0.75.18 through + 202.0.75.20) must be configured with a + netmask of 255.255.255.255. The following entries configure the adapter correctly for this arrangement: @@ -1193,6 +1203,8 @@ round-trip min/avg/max/stddev = 0.700/0.729/0.766/0.025 ms + + /etc @@ -1261,6 +1273,8 @@ round-trip min/avg/max/stddev = 0.700/0.729/0.766/0.025 ms + + nameserver @@ -1455,7 +1469,7 @@ cron.* /var/log/cron - + <filename>sysctl.conf</filename> sysctl.conf @@ -1518,6 +1532,12 @@ kern.maxfiles: 2088 -> 5000 numbers, or booleans (a boolean being 1 for yes or a 0 for no). + If you want to set automatically some variables each time + the machine boots, add them to the + /etc/sysctl.conf file. For more information + see the &man.sysctl.conf.5; manual page and the + . + @@ -1573,18 +1593,18 @@ device_probe_and_attach: cbb0 attach returned 12 system. Most directories are small, using just a single fragment (typically 1 K) in the file system and less (typically 512 bytes) in the buffer cache. - However, when operating in the default mode the buffer + With this variable turned off (to 0), the buffer cache will only cache a fixed number of directories even if - you have a huge amount of memory. Turning on this sysctl + ou have a huge amount of memory. When turned on (to 1), this sysctl allows the buffer cache to use the VM Page Cache to cache the directories, making all the memory available for caching directories. However, the minimum in-core memory used to cache a directory is the physical page size (typically 4 K) rather than 512  - bytes. We recommend turning this option on if you are running + bytes. We recommend keeping this option on if you are running any services which manipulate large numbers of files. Such services can include web caches, large mail systems, and news - systems. Turning on this option will generally not reduce + systems. Keeping this option on will generally not reduce performance even with the wasted memory but you should experiment to find out. @@ -1931,7 +1951,7 @@ device_probe_and_attach: cbb0 attach returned 12 Network Limits - The kernel configuration + The NMBCLUSTERS kernel configuration option dictates the amount of network Mbufs available to the system. A heavily-trafficked server with a low number of Mbufs will hinder &os;'s ability. Each cluster represents @@ -1955,11 +1975,11 @@ device_probe_and_attach: cbb0 attach returned 12 For busy servers that make extensive use of the &man.sendfile.2; system call, it may be necessary to increase the number of &man.sendfile.2; buffers via the - kernel configuration option or by + NSFBUFS kernel configuration option or by setting its value in /boot/loader.conf (see &man.loader.8; for details). A common indicator that this parameter needs to be adjusted is when processes are seen - in the sfbufa state. The sysctl + in the sfbufa state. The sysctl variable kern.ipc.nsfbufs is a read-only glimpse at the kernel configured variable. This parameter nominally scales with kern.maxusers, @@ -2014,7 +2034,7 @@ device_probe_and_attach: cbb0 attach returned 12 The TCP Bandwidth Delay Product Limiting is similar to - TCP/Vegas in &netbsd;. + TCP/Vegas in NetBSD. &netbsd; @@ -2594,7 +2614,8 @@ device_probe_and_attach: cbb0 attach returned 12 is usually manifested by kernel console messages like this: - ACPI-1287: *** Error: Method execution failed [\\_SB_.PCI0.LPC0.FIGD._STA] (Node 0xc3f6d160), AE_NOT_FOUND + ACPI-1287: *** Error: Method execution failed [\\_SB_.PCI0.LPC0.FIGD._STA] \\ +(Node 0xc3f6d160), AE_NOT_FOUND Often, you can resolve these problems by updating your BIOS to the latest revision. Most console @@ -2656,6 +2677,7 @@ device_probe_and_attach: cbb0 attach returned 12 =Windows 2001 in /boot/loader.conf or other similar strings you find in the ASL. + Missing Return statements @@ -2697,6 +2719,7 @@ acpi_dsdt_name="/boot/DSDT.aml" Be sure to copy your DSDT.aml to the /boot directory. + Getting Debugging Output From -- 2.41.0