From owner-freebsd-doc@FreeBSD.ORG Sun Aug 28 10:13:23 2011 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 92A451065670; Sun, 28 Aug 2011 10:13:23 +0000 (UTC) (envelope-from brueffer@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 6A1EA8FC14; Sun, 28 Aug 2011 10:13:23 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id p7SADN7a024483; Sun, 28 Aug 2011 10:13:23 GMT (envelope-from brueffer@freefall.freebsd.org) Received: (from brueffer@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id p7SADN5i024467; Sun, 28 Aug 2011 12:13:23 +0200 (CEST) (envelope-from brueffer) Date: Sun, 28 Aug 2011 12:13:23 +0200 (CEST) Message-Id: <201108281013.p7SADN5i024467@freefall.freebsd.org> To: tedm@mittelstaedt.us, brueffer@FreeBSD.org, freebsd-doc@FreeBSD.org, brueffer@FreeBSD.org From: brueffer@FreeBSD.org Cc: Subject: Re: docs/157778: Broken doc link regarding Atheros products X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 28 Aug 2011 10:13:23 -0000 Synopsis: Broken doc link regarding Atheros products State-Changed-From-To: open->patched State-Changed-By: brueffer State-Changed-When: Sun Aug 28 12:10:39 CEST 2011 State-Changed-Why: You're right, the link is broken. However, the link you provided only lists the different chipsets that exist, not the cards built upon those chipsets. I don't think that's particulary helpful, so I just went ahead and removed the broken link. I hope that works for you. Thanks! Responsible-Changed-From-To: freebsd-doc->brueffer Responsible-Changed-By: brueffer Responsible-Changed-When: Sun Aug 28 12:10:39 CEST 2011 Responsible-Changed-Why: MFC reminder. http://www.freebsd.org/cgi/query-pr.cgi?pr=157778 From owner-freebsd-doc@FreeBSD.ORG Sun Aug 28 22:40:17 2011 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 081701065689 for ; Sun, 28 Aug 2011 22:40:17 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id A3C238FC0C for ; Sun, 28 Aug 2011 22:40:11 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id p7SMeBui063341 for ; Sun, 28 Aug 2011 22:40:11 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id p7SMeBZI063340; Sun, 28 Aug 2011 22:40:11 GMT (envelope-from gnats) Resent-Date: Sun, 28 Aug 2011 22:40:11 GMT Resent-Message-Id: <201108282240.p7SMeBZI063340@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Warren Block Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 22364106564A for ; Sun, 28 Aug 2011 22:30:59 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from red.freebsd.org (red.freebsd.org [IPv6:2001:4f8:fff6::22]) by mx1.freebsd.org (Postfix) with ESMTP id 133EC8FC12 for ; Sun, 28 Aug 2011 22:30:59 +0000 (UTC) Received: from red.freebsd.org (localhost [127.0.0.1]) by red.freebsd.org (8.14.4/8.14.4) with ESMTP id p7SMUwvi052522 for ; Sun, 28 Aug 2011 22:30:58 GMT (envelope-from nobody@red.freebsd.org) Received: (from nobody@localhost) by red.freebsd.org (8.14.4/8.14.4/Submit) id p7SMUweb052521; Sun, 28 Aug 2011 22:30:58 GMT (envelope-from nobody) Message-Id: <201108282230.p7SMUweb052521@red.freebsd.org> Date: Sun, 28 Aug 2011 22:30:58 GMT From: Warren Block To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/160267: [patch] wlan.4 has incorrect apostrophe X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 28 Aug 2011 22:40:17 -0000 >Number: 160267 >Category: docs >Synopsis: [patch] wlan.4 has incorrect apostrophe >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Sun Aug 28 22:40:11 UTC 2011 >Closed-Date: >Last-Modified: >Originator: Warren Block >Release: 8-STABLE >Organization: >Environment: FreeBSD lightning 8.2-STABLE FreeBSD 8.2-STABLE #0: Fri Aug 26 13:17:14 MDT 2011 root@lightning:/usr/obj/usr/src/sys/LIGHTNING i386 >Description: >From wlan(4): "wlan defines several mechanisms by which plugin modules may be used to extend its' functionality." Possessive "its" does not have an apostrophe. >How-To-Repeat: man 4 wlan | less -pits\' >Fix: Apply patch. Patch attached with submission follows: --- share/man/man4/wlan.4.orig 2011-08-28 16:15:20.000000000 -0600 +++ share/man/man4/wlan.4 2011-08-28 16:20:51.000000000 -0600 @@ -121,7 +121,7 @@ .Pp .Nm defines several mechanisms by which plugin modules may -be used to extend its' functionality. +be used to extend its functionality. Cryptographic support such as WEP, TKIP, and AES-CCMP are implemented as standalone modules (if not statically configured into a system) that register with >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Mon Aug 29 00:40:04 2011 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 598281065675 for ; Mon, 29 Aug 2011 00:40:04 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 2FB428FC17 for ; Mon, 29 Aug 2011 00:40:04 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id p7T0e4or076162 for ; Mon, 29 Aug 2011 00:40:04 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id p7T0e48u076161; Mon, 29 Aug 2011 00:40:04 GMT (envelope-from gnats) Resent-Date: Mon, 29 Aug 2011 00:40:04 GMT Resent-Message-Id: <201108290040.p7T0e48u076161@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Warren Block Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 32A64106566B for ; Mon, 29 Aug 2011 00:38:45 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from red.freebsd.org (red.freebsd.org [IPv6:2001:4f8:fff6::22]) by mx1.freebsd.org (Postfix) with ESMTP id 21DEB8FC14 for ; Mon, 29 Aug 2011 00:38:44 +0000 (UTC) Received: from red.freebsd.org (localhost [127.0.0.1]) by red.freebsd.org (8.14.4/8.14.4) with ESMTP id p7T0cixM077925 for ; Mon, 29 Aug 2011 00:38:44 GMT (envelope-from nobody@red.freebsd.org) Received: (from nobody@localhost) by red.freebsd.org (8.14.4/8.14.4/Submit) id p7T0ciSk077924; Mon, 29 Aug 2011 00:38:44 GMT (envelope-from nobody) Message-Id: <201108290038.p7T0ciSk077924@red.freebsd.org> Date: Mon, 29 Aug 2011 00:38:44 GMT From: Warren Block To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/160269: [patch] Handbook wireless section: sand off some rough edges X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 29 Aug 2011 00:40:04 -0000 >Number: 160269 >Category: docs >Synopsis: [patch] Handbook wireless section: sand off some rough edges >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Mon Aug 29 00:40:03 UTC 2011 >Closed-Date: >Last-Modified: >Originator: Warren Block >Release: 8-STABLE >Organization: >Environment: FreeBSD lightning 8.2-STABLE FreeBSD 8.2-STABLE #0: Fri Aug 26 13:17:14 MDT 2011 root@lightning:/usr/obj/usr/src/sys/LIGHTNING i386 >Description: Fix some wording and punctuation in the advanced networking/wireless section of the Handbook. >How-To-Repeat: Read the later parts of the wireless section. >Fix: Apply patch. Patch attached with submission follows: --- en_US.ISO8859-1/books/handbook/advanced-networking/chapter.sgml.orig 2011-08-28 17:57:28.000000000 -0600 +++ en_US.ISO8859-1/books/handbook/advanced-networking/chapter.sgml 2011-08-28 18:35:33.000000000 -0600 @@ -1225,7 +1225,7 @@ the 802.1X authentication protocol and uses one of several ciphers instead of WEP for data integrity. The only cipher required by WPA is TKIP (Temporary Key Integrity - Protocol) which is a cipher that extends the basic RC4 + Protocol). TKIP is a cipher that extends the basic RC4 cipher used by WEP by adding integrity checking, tamper detection, and measures for responding to any detected intrusions. TKIP is designed to work on legacy hardware @@ -1243,7 +1243,7 @@ station and the access point using a pre-shared secret. The former is commonly termed WPA Enterprise with the latter known as WPA Personal. Since most people will not - set up a RADIUS backend server for wireless network, + set up a RADIUS backend server for their wireless network, WPA-PSK is by far the most commonly encountered configuration for WPA. @@ -1258,7 +1258,7 @@ WPA-PSK - WPA-PSK also known as WPA-Personal is based on a + WPA-PSK, also known as WPA-Personal, is based on a pre-shared key (PSK) generated from a given password and that will be used as the master key in the wireless network. This means every wireless user will share the @@ -1289,7 +1289,7 @@ wlans_ath0="wlan0" ifconfig_wlan0="WPA DHCP" - Then, we can bring up the interface: + Then we can bring up the interface: &prompt.root; /etc/rc.d/netif start Starting wpa_supplicant. @@ -1342,16 +1342,16 @@ wme burst roaming MANUAL - If the /etc/rc.conf is set up + If /etc/rc.conf is set up with the line ifconfig_wlan0="DHCP" - then it is no need to run the - dhclient command manually, + then it is not necessary to run the + dhclient command manually. dhclient will be launched after wpa_supplicant plumbs the keys. - In the case where the use of DHCP is not possible, + If DHCP is not possible or desired, you can set a static IP address after wpa_supplicant has authenticated the station: @@ -1370,7 +1370,7 @@ wme burst roaming MANUAL When DHCP is not used, you also have to manually set - up the default gateway and the nameserver: + the default gateway and the nameserver: &prompt.root; route add default your_default_router &prompt.root; echo "nameserver your_DNS_server" >> /etc/resolv.conf @@ -1380,16 +1380,16 @@ WPA with EAP-TLS The second way to use WPA is with an 802.1X backend - authentication server, in this case WPA is called - WPA-Enterprise to make difference with the less secure - WPA-Personal with its pre-shared key. The - authentication in WPA-Enterprise is based on EAP + authentication server. In this case WPA is called + WPA-Enterprise to differentiate it from the less secure + WPA-Personal with its pre-shared key. + Authentication in WPA-Enterprise is based on EAP (Extensible Authentication Protocol). EAP does not come with an encryption method, it was decided to embed EAP inside an encrypted tunnel. Many - types of EAP authentication methods have been designed, - the most common methods are EAP-TLS, EAP-TTLS and + types of EAP authentication methods have been designed. + The most common methods are EAP-TLS, EAP-TTLS and EAP-PEAP. EAP-TLS (EAP with Transport Layer Security) is a @@ -1555,7 +1555,7 @@ The ca_cert field indicates the pathname of the CA certificate file. This file - is needed to verify the server certificat. + is needed to verify the server certificate. @@ -1599,10 +1599,10 @@ PEAP (Protected EAP) has been designed as an alternative to EAP-TTLS. There are two types of PEAP - methods, the most common one is PEAPv0/EAP-MSCHAPv2. In + methods; the most common one is PEAPv0/EAP-MSCHAPv2. In the rest of this document, we will use the PEAP term to refer to that EAP method. PEAP is the most used EAP - standard after EAP-TLS, in other words if you have a + standard after EAP-TLS. In other words, if you have a network with mixed OSes, PEAP should be the most supported standard after EAP-TLS. @@ -1610,9 +1610,9 @@ certificate to authenticate clients by creating an encrypted TLS tunnel between the client and the authentication server, which protects the ensuing - exchange of authentication information. In term of + exchange of authentication information. In terms of security the difference between EAP-TTLS and PEAP is - that PEAP authentication broadcasts the username in + that PEAP authentication broadcasts the username in the clear, only the password is sent in the encrypted TLS tunnel. EAP-TTLS will use the TLS tunnel for both username and password. @@ -1661,7 +1661,7 @@ first phase of the authentication (the TLS tunnel). According to the authentication server used, you will have to specify a specific label - for the authentication. Most of time, the label + for the authentication. Most of the time, the label will be client EAP encryption which is set by using peaplabel=0. More information can be found in the @@ -1682,7 +1682,7 @@ wlans_ath0="wlan0" ifconfig_wlan0="WPA DHCP" - Then, we can bring up the interface: + Then we can bring up the interface: &prompt.root; /etc/rc.d/netif start Starting wpa_supplicant. @@ -1709,7 +1709,7 @@ WEP (Wired Equivalent Privacy) is part of the original 802.11 standard. There is no authentication mechanism, - only a weak form of access control, and it is easily to be + only a weak form of access control, and it is easily cracked. WEP can be set up with @@ -1724,18 +1724,18 @@ The weptxkey means which WEP key will be used in the transmission. Here we used the third key. This must match the setting in the access - point. If you do not have any idea of what is the key - used by the access point, you should try to use + point. If you do not have any idea of which key is + used by the access point, try 1 (i.e., the first key) for this value. - The wepkey means setting the - selected WEP key. It should in the format - index:key, if the index is - not given, key 1 is set. That is - to say we need to set the index if we use keys other + The wepkey selects one of the + WEP keys. It should be in the format + index:key. Key + 1 is used by default; the index + only needs to be set if we use a key other than the first key. @@ -1746,7 +1746,7 @@ - You are encouraged to read &man.ifconfig.8; manual + You are encouraged to read the &man.ifconfig.8; manual page for further information. The wpa_supplicant facility also @@ -1777,7 +1777,7 @@ IBSS mode, also called ad-hoc mode, is designed for point to point connections. For example, to establish an ad-hoc network between the machine A and the machine - B we will just need to choose two IP addresses + B, we will just need to choose two IP addresses and a SSID. On the box A: @@ -1822,7 +1822,7 @@ protmode CTS wme burst Both A and B are now - ready to exchange informations. + ready to exchange information. @@ -1839,19 +1839,19 @@ Before configuring your &os; machine as an AP, the kernel must be configured with the appropriate wireless networking support for your wireless card. You also have to - add the support for the security protocols you intend to + add support for the security protocols you intend to use. For more details, see . The use of the NDIS driver wrapper and the &windows; - drivers do not allow currently the AP operation. Only + drivers do not currently allow AP operation. Only native &os; wireless drivers support AP mode. - Once the wireless networking support is loaded, you can + Once wireless networking support is loaded, you can check if your wireless device supports the host-based access - point mode (also know as hostap mode): + point mode (also known as hostap mode): &prompt.root; ifconfig wlan0 create wlandev ath0 &prompt.root; ifconfig wlan0 list caps @@ -1861,8 +1861,8 @@ This output displays the card capabilities; the HOSTAP word confirms this wireless card can act as an Access Point. Various supported ciphers are - also mentioned: WEP, TKIP, AES, etc., these informations - are important to know what security protocols could be set + also mentioned: WEP, TKIP, AES, etc., this information + is important to know what security protocols could be set on the Access Point. The wireless device can only be put into hostap mode @@ -1877,7 +1877,7 @@ &prompt.root; ifconfig wlan0 create wlandev ath0 wlanmode hostap &prompt.root; ifconfig wlan0 inet 192.168.0.1 netmask 255.255.255.0 ssid freebsdap mode 11g channel 1 - Use again ifconfig to see the status + Use ifconfig again to see the status of the wlan0 interface: &prompt.root; ifconfig wlan0 @@ -2150,7 +2150,7 @@ On &os;, it is possible to combine two or even more network interfaces together in a failover fashion, that is, to use the most preferred and available connection from a - group of network interfaces, and have the operating system to + group of network interfaces, and have the operating system switch automatically when the link state changes. We will cover link aggregation and failover in >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Mon Aug 29 01:30:15 2011 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id D6483106564A for ; Mon, 29 Aug 2011 01:30:15 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id BAEF08FC08 for ; Mon, 29 Aug 2011 01:30:15 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id p7T1UFRg020452 for ; Mon, 29 Aug 2011 01:30:15 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id p7T1UFLj020449; Mon, 29 Aug 2011 01:30:15 GMT (envelope-from gnats) Date: Mon, 29 Aug 2011 01:30:15 GMT Message-Id: <201108290130.p7T1UFLj020449@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Garrett Cooper Cc: Subject: Re: docs/160269: [patch] Handbook wireless section: sand off some rough edges X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Garrett Cooper List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 29 Aug 2011 01:30:15 -0000 The following reply was made to PR docs/160269; it has been noted by GNATS. From: Garrett Cooper To: Warren Block Cc: freebsd-gnats-submit@freebsd.org Subject: Re: docs/160269: [patch] Handbook wireless section: sand off some rough edges Date: Sun, 28 Aug 2011 18:03:28 -0700 On Sun, Aug 28, 2011 at 5:38 PM, Warren Block wrote: > >>Number: =A0 =A0 =A0 =A0 160269 >>Category: =A0 =A0 =A0 docs >>Synopsis: =A0 =A0 =A0 [patch] Handbook wireless section: sand off some ro= ugh edges >>Confidential: =A0 no >>Severity: =A0 =A0 =A0 non-critical >>Priority: =A0 =A0 =A0 low >>Responsible: =A0 =A0freebsd-doc >>State: =A0 =A0 =A0 =A0 =A0open >>Quarter: >>Keywords: >>Date-Required: >>Class: =A0 =A0 =A0 =A0 =A0doc-bug >>Submitter-Id: =A0 current-users >>Arrival-Date: =A0 Mon Aug 29 00:40:03 UTC 2011 >>Closed-Date: >>Last-Modified: >>Originator: =A0 =A0 Warren Block >>Release: =A0 =A0 =A0 =A08-STABLE >>Organization: >>Environment: > FreeBSD lightning 8.2-STABLE FreeBSD 8.2-STABLE #0: Fri Aug 26 13:17:14 M= DT 2011 =A0 =A0 root@lightning:/usr/obj/usr/src/sys/LIGHTNING =A0i386 >>Description: > Fix some wording and punctuation in the advanced networking/wireless sect= ion of the Handbook. >>How-To-Repeat: > Read the later parts of the wireless section. >>Fix: > Apply patch. > > Patch attached with submission follows: > > --- en_US.ISO8859-1/books/handbook/advanced-networking/chapter.sgml.orig = =A0 =A0 =A0 =A02011-08-28 17:57:28.000000000 -0600 > +++ en_US.ISO8859-1/books/handbook/advanced-networking/chapter.sgml =A0 = =A0 2011-08-28 18:35:33.000000000 -0600 > @@ -1225,7 +1225,7 @@ > =A0 =A0 =A0 =A0 =A0 =A0the 802.1X authentication protocol and uses one of= several > =A0 =A0 =A0 =A0 =A0 =A0ciphers instead of WEP for data integrity. =A0The = only > =A0 =A0 =A0 =A0 =A0 =A0cipher required by WPA is TKIP (Temporary Key Inte= grity > - =A0 =A0 =A0 =A0 =A0 Protocol) which is a cipher that extends the basic = RC4 > + =A0 =A0 =A0 =A0 =A0 Protocol). =A0TKIP is a cipher that extends the bas= ic RC4 > =A0 =A0 =A0 =A0 =A0 =A0cipher used by WEP by adding integrity checking, t= amper > =A0 =A0 =A0 =A0 =A0 =A0detection, and measures for responding to any dete= cted > =A0 =A0 =A0 =A0 =A0 =A0intrusions. =A0TKIP is designed to work on legacy = hardware > @@ -1243,7 +1243,7 @@ > =A0 =A0 =A0 =A0 =A0 =A0station and the access point using a pre-shared se= cret. > =A0 =A0 =A0 =A0 =A0 =A0The former is commonly termed WPA Enterprise with = the > =A0 =A0 =A0 =A0 =A0 =A0latter known as WPA Personal. =A0Since most people= will not > - =A0 =A0 =A0 =A0 =A0 set up a RADIUS backend server for wireless network= , > + =A0 =A0 =A0 =A0 =A0 set up a RADIUS backend server for their wireless n= etwork, > =A0 =A0 =A0 =A0 =A0 =A0WPA-PSK is by far the most commonly encountered > =A0 =A0 =A0 =A0 =A0 =A0configuration for WPA. > > @@ -1258,7 +1258,7 @@ > =A0 =A0 =A0 =A0 =A0 > =A0 =A0 =A0 =A0 =A0 =A0WPA-PSK > > - =A0 =A0 =A0 =A0 =A0 WPA-PSK also known as WPA-Personal is based o= n a > + =A0 =A0 =A0 =A0 =A0 WPA-PSK, also known as WPA-Personal, is based= on a > =A0 =A0 =A0 =A0 =A0 =A0 =A0pre-shared key (PSK) generated from a given pa= ssword and > =A0 =A0 =A0 =A0 =A0 =A0 =A0that will be used as the master key in the wir= eless > =A0 =A0 =A0 =A0 =A0 =A0 =A0network. =A0This means every wireless user wil= l share the > @@ -1289,7 +1289,7 @@ > =A0 =A0 =A0 =A0 =A0 =A0wlans_ath0=3D"wlan0" > =A0ifconfig_wlan0=3D"WPA DHCP" > > - =A0 =A0 =A0 =A0 =A0 Then, we can bring up the interface: > + =A0 =A0 =A0 =A0 =A0 Then we can bring up the interface: > > =A0 =A0 =A0 =A0 =A0 =A0&prompt.root; /etc/rc= .d/netif start > =A0Starting wpa_supplicant. > @@ -1342,16 +1342,16 @@ > =A0 =A0 =A0 wme burst roaming MANUAL > > =A0 =A0 =A0 =A0 =A0 =A0 > - =A0 =A0 =A0 =A0 =A0 =A0 If the /etc/rc.conf = is set up > + =A0 =A0 =A0 =A0 =A0 =A0 If /etc/rc.conf is s= et up > =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0with the line ifconfig_wlan0=3D"D= HCP" > - =A0 =A0 =A0 =A0 =A0 =A0 =A0 then it is no need to run the > - =A0 =A0 =A0 =A0 =A0 =A0 =A0 dhclient command manuall= y, > + =A0 =A0 =A0 =A0 =A0 =A0 =A0 then it is not necessary to run the > + =A0 =A0 =A0 =A0 =A0 =A0 =A0 dhclient command manuall= y. This isn't entirely true. You can specify other options like "SYNCDHCP", "ssid DHCP", etc, and it will achieve what's described below. Manual execution of dhclient in general should be discouraged for most users. > =A0 =A0 =A0 =A0 =A0 =A0EAP does not come with an encryption method,= it was > =A0 =A0 =A0 =A0 =A0 =A0 =A0decided to embed EAP inside an encrypted tunne= l. =A0Many > - =A0 =A0 =A0 =A0 =A0 =A0 types of EAP authentication methods have been d= esigned, > - =A0 =A0 =A0 =A0 =A0 =A0 the most common methods are EAP-TLS, EAP-TTLS a= nd > + =A0 =A0 =A0 =A0 =A0 =A0 types of EAP authentication methods have been d= esigned. > + =A0 =A0 =A0 =A0 =A0 =A0 The most common methods are EAP-TLS, EAP-TTLS a= nd > =A0 =A0 =A0 =A0 =A0 =A0 =A0EAP-PEAP. Maybe it should say something like "There are many EAP authentication methods: the most common ones are EAP-TLS, EAP-TTLS, and EAP-PEAP" ? > =A0 =A0 =A0 =A0 =A0 =A0EAP-TLS (EAP with Transport Layer Security) = is a > @@ -1555,7 +1555,7 @@ > =A0 =A0 =A0 =A0 =A0 =A0 =A0 > =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0The ca_cert field= indicates > =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0the pathname of the CA certificate fil= e. =A0This file > - =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 is needed to verify the server certific= at. > + =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 is needed to verify the server certific= ate. > =A0 =A0 =A0 =A0 =A0 =A0 =A0 > > =A0 =A0 =A0 =A0 =A0 =A0 =A0 > @@ -1599,10 +1599,10 @@ > > =A0 =A0 =A0 =A0 =A0 =A0PEAP (Protected EAP) has been designed as an > =A0 =A0 =A0 =A0 =A0 =A0 =A0alternative to EAP-TTLS. =A0There are two type= s of PEAP > - =A0 =A0 =A0 =A0 =A0 =A0 methods, the most common one is PEAPv0/EAP-MSCH= APv2. =A0In > + =A0 =A0 =A0 =A0 =A0 =A0 methods; the most common one is PEAPv0/EAP-MSCH= APv2. =A0In That could be a colon instead. > =A0 =A0 =A0 =A0 =A0 =A0 =A0the rest of this document, we will use the PEA= P term to > =A0 =A0 =A0 =A0 =A0 =A0 =A0refer to that EAP method. =A0PEAP is the most = used EAP > - =A0 =A0 =A0 =A0 =A0 =A0 standard after EAP-TLS, in other words if you h= ave a > + =A0 =A0 =A0 =A0 =A0 =A0 standard after EAP-TLS. =A0In other words, if y= ou have a This could be a semicolon. > =A0 =A0 =A0 =A0 =A0 =A0 =A0network with mixed OSes, PEAP should be the mo= st > =A0 =A0 =A0 =A0 =A0 =A0 =A0supported standard after EAP-TLS. > > @@ -1610,9 +1610,9 @@ > =A0 =A0 =A0 =A0 =A0 =A0 =A0certificate to authenticate clients by creatin= g an > =A0 =A0 =A0 =A0 =A0 =A0 =A0encrypted TLS tunnel between the client and th= e > =A0 =A0 =A0 =A0 =A0 =A0 =A0authentication server, which protects the ensu= ing > - =A0 =A0 =A0 =A0 =A0 =A0 exchange of authentication information. =A0In t= erm of > + =A0 =A0 =A0 =A0 =A0 =A0 exchange of authentication information. =A0In t= erms of > =A0 =A0 =A0 =A0 =A0 =A0 =A0security the difference between EAP-TTLS and P= EAP is > - =A0 =A0 =A0 =A0 =A0 =A0 that PEAP authentication broadcasts the usernam= e in > + =A0 =A0 =A0 =A0 =A0 =A0 that PEAP authentication broadcasts the usernam= e in the > =A0 =A0 =A0 =A0 =A0 =A0 =A0clear, only the password is sent in the encryp= ted TLS > =A0 =A0 =A0 =A0 =A0 =A0 =A0tunnel. This sentence is extremely wordy. The rest of the changes are good incremental improvements to the existing doc :). Thanks! -Garrett From owner-freebsd-doc@FreeBSD.ORG Mon Aug 29 02:16:02 2011 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 26DAB106566B; Mon, 29 Aug 2011 02:16:02 +0000 (UTC) (envelope-from kaduk@mit.edu) Received: from dmz-mailsec-scanner-4.mit.edu (DMZ-MAILSEC-SCANNER-4.MIT.EDU [18.9.25.15]) by mx1.freebsd.org (Postfix) with ESMTP id B94FA8FC0C; Mon, 29 Aug 2011 02:16:01 +0000 (UTC) X-AuditID: 1209190f-b7b44ae000000a24-f4-4e5af5c514d4 Received: from mailhub-auth-1.mit.edu ( [18.9.21.35]) by dmz-mailsec-scanner-4.mit.edu (Symantec Messaging Gateway) with SMTP id 5B.FE.02596.5C5FA5E4; Sun, 28 Aug 2011 22:13:25 -0400 (EDT) Received: from outgoing.mit.edu (OUTGOING-AUTH.MIT.EDU [18.7.22.103]) by mailhub-auth-1.mit.edu (8.13.8/8.9.2) with ESMTP id p7T2Frst025632; Sun, 28 Aug 2011 22:15:54 -0400 Received: from multics.mit.edu (MULTICS.MIT.EDU [18.187.1.73]) (authenticated bits=56) (User authenticated as kaduk@ATHENA.MIT.EDU) by outgoing.mit.edu (8.13.6/8.12.4) with ESMTP id p7T2FpNn015610 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Sun, 28 Aug 2011 22:15:53 -0400 (EDT) Received: (from kaduk@localhost) by multics.mit.edu (8.12.9.20060308) id p7T2FoCR007042; Sun, 28 Aug 2011 22:15:50 -0400 (EDT) Date: Sun, 28 Aug 2011 22:15:50 -0400 (EDT) From: Benjamin Kaduk To: Warren Block In-Reply-To: <201108290038.p7T0ciSk077924@red.freebsd.org> Message-ID: References: <201108290038.p7T0ciSk077924@red.freebsd.org> User-Agent: Alpine 1.10 (GSO 962 2008-03-14) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; format=flowed; charset=US-ASCII X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFnrHIsWRmVeSWpSXmKPExsUixCmqrHv0a5SfQccrYYtTZ7pYLVqerGa3 +HXKw4HZY8an+SweRzoeMQYwRXHZpKTmZJalFunbJXBlHG08z1bwULbiyvx9bA2M58W6GDk5 JARMJGbdn8gIYYtJXLi3nq2LkYtDSGAfo8Th140sIAkhgQ2MEvM2ikMkDjBJdF38wArhNDBK nF9/gw2kikVAW+L7t3msIDabgIrEzDcbgeIcHCICqhJ7z1iDhJkFbCX2THjCDGILC0RIPN4y gQmkhFPASuL1Bx8Qk1fAQeL/pzCItZYS1y9vBjtBVEBHYvX+KWA2r4CgxMmZT1ggJlpK/Fv7 i3UCo+AsJKlZSFILGJlWMcqm5Fbp5iZm5hSnJusWJyfm5aUW6Zro5WaW6KWmlG5iBAerJP8O xm8HlQ4xCnAwKvHwFtRG+QmxJpYVV+YeYpTkYFIS5e0GhroQX1J+SmVGYnFGfFFpTmrxIUYJ DmYlEd6+SUA53pTEyqrUonyYlDQHi5I4b+MOBz8hgfTEktTs1NSC1CKYrAwHh5IEL9s3oEbB otT01Iq0zJwShDQTByfIcB6g4UdAFvMWFyTmFmemQ+RPMSpKifPeAUkIgCQySvPgemHJ5BWj ONArwrzMICt4gIkIrvsV0GAmoMEqjuEgg0sSEVJSDYwa5yqYA+LZZTj+S91uy94Y4mU5v7jV 9EErv7ajhvt3k1d/pvlz1BTnvxEzM/fxfblTTWTaupPvNXa5N+Y83vN5QvzMtGs3rqjd3HZi ztLHyWd3dUyP3+/adSJ1R9Rbq5D28o6/Tx5e5V4t8bsy3S797qar33Wep780z/A+mrZpglNs 4ddnPGlKLMUZiYZazEXFiQCAR6lgAQMAAA== Cc: freebsd-doc@freebsd.org, freebsd-gnats-submit@freebsd.org Subject: Re: docs/160269: [patch] Handbook wireless section: sand off some rough edges X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 29 Aug 2011 02:16:02 -0000 With all due respect to Garrett [but not his mail client's handling of whitespace], On Mon, 29 Aug 2011, Warren Block wrote: > > --- en_US.ISO8859-1/books/handbook/advanced-networking/chapter.sgml.orig 2011-08-28 17:57:28.000000000 -0600 > +++ en_US.ISO8859-1/books/handbook/advanced-networking/chapter.sgml 2011-08-28 18:35:33.000000000 -0600 > @@ -1380,16 +1380,16 @@ > WPA with EAP-TLS > > The second way to use WPA is with an 802.1X backend > - authentication server, in this case WPA is called > - WPA-Enterprise to make difference with the less secure > - WPA-Personal with its pre-shared key. The > - authentication in WPA-Enterprise is based on EAP > + authentication server. In this case WPA is called > + WPA-Enterprise to differentiate it from the less secure > + WPA-Personal with its pre-shared key. > + Authentication in WPA-Enterprise is based on EAP > (Extensible Authentication Protocol). This doesn't feel quite right; I would use "is based on the Extensible Authentication Protocol (EAP)." > > EAP does not come with an encryption method, it was > decided to embed EAP inside an encrypted tunnel. Many > - types of EAP authentication methods have been designed, > - the most common methods are EAP-TLS, EAP-TTLS and > + types of EAP authentication methods have been designed. > + The most common methods are EAP-TLS, EAP-TTLS and > EAP-PEAP. > > EAP-TLS (EAP with Transport Layer Security) is a > @@ -1610,9 +1610,9 @@ > certificate to authenticate clients by creating an > encrypted TLS tunnel between the client and the > authentication server, which protects the ensuing > - exchange of authentication information. In term of > + exchange of authentication information. In terms of > security the difference between EAP-TTLS and PEAP is > - that PEAP authentication broadcasts the username in > + that PEAP authentication broadcasts the username in the > clear, only the password is sent in the encrypted TLS > tunnel. EAP-TTLS will use the TLS tunnel for both As Garrett mentions, this sentence is getting pretty long. I would put a comma after "security", and a linking word before "only the password is sent ...". Maybe "meaning", or "so that". > username and password. > @@ -1661,7 +1661,7 @@ > first phase of the authentication (the TLS > tunnel). According to the authentication server > used, you will have to specify a specific label > - for the authentication. Most of time, the label > + for the authentication. Most of the time, the label I think the "the" in "the authentication" is not needed. > will be client EAP encryption which > is set by using peaplabel=0. > More information can be found in the > @@ -1861,8 +1861,8 @@ > This output displays the card capabilities; the > HOSTAP word confirms this wireless card > can act as an Access Point. Various supported ciphers are > - also mentioned: WEP, TKIP, AES, etc., these informations > - are important to know what security protocols could be set > + also mentioned: WEP, TKIP, AES, etc., this information I would change this comma to a full stop. (Maybe a semicolon, but it would be a bit odd to have colon and semicolon in such proximity.) Thanks for assembling all these fixes into a patch! -Ben Kaduk > + is important to know what security protocols could be set > on the Access Point. > > The wireless device can only be put into hostap mode From owner-freebsd-doc@FreeBSD.ORG Mon Aug 29 02:20:12 2011 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id AC7B3106564A for ; Mon, 29 Aug 2011 02:20:12 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 9C4A48FC14 for ; Mon, 29 Aug 2011 02:20:12 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id p7T2KCBN066774 for ; Mon, 29 Aug 2011 02:20:12 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id p7T2KCDX066773; Mon, 29 Aug 2011 02:20:12 GMT (envelope-from gnats) Date: Mon, 29 Aug 2011 02:20:12 GMT Message-Id: <201108290220.p7T2KCDX066773@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Benjamin Kaduk Cc: Subject: Re: docs/160269: [patch] Handbook wireless section: sand off some rough edges X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Benjamin Kaduk List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 29 Aug 2011 02:20:12 -0000 The following reply was made to PR docs/160269; it has been noted by GNATS. From: Benjamin Kaduk To: Warren Block Cc: freebsd-gnats-submit@freebsd.org, freebsd-doc@freebsd.org Subject: Re: docs/160269: [patch] Handbook wireless section: sand off some rough edges Date: Sun, 28 Aug 2011 22:15:50 -0400 (EDT) With all due respect to Garrett [but not his mail client's handling of whitespace], On Mon, 29 Aug 2011, Warren Block wrote: > > --- en_US.ISO8859-1/books/handbook/advanced-networking/chapter.sgml.orig 2011-08-28 17:57:28.000000000 -0600 > +++ en_US.ISO8859-1/books/handbook/advanced-networking/chapter.sgml 2011-08-28 18:35:33.000000000 -0600 > @@ -1380,16 +1380,16 @@ > WPA with EAP-TLS > > The second way to use WPA is with an 802.1X backend > - authentication server, in this case WPA is called > - WPA-Enterprise to make difference with the less secure > - WPA-Personal with its pre-shared key. The > - authentication in WPA-Enterprise is based on EAP > + authentication server. In this case WPA is called > + WPA-Enterprise to differentiate it from the less secure > + WPA-Personal with its pre-shared key. > + Authentication in WPA-Enterprise is based on EAP > (Extensible Authentication Protocol). This doesn't feel quite right; I would use "is based on the Extensible Authentication Protocol (EAP)." > > EAP does not come with an encryption method, it was > decided to embed EAP inside an encrypted tunnel. Many > - types of EAP authentication methods have been designed, > - the most common methods are EAP-TLS, EAP-TTLS and > + types of EAP authentication methods have been designed. > + The most common methods are EAP-TLS, EAP-TTLS and > EAP-PEAP. > > EAP-TLS (EAP with Transport Layer Security) is a > @@ -1610,9 +1610,9 @@ > certificate to authenticate clients by creating an > encrypted TLS tunnel between the client and the > authentication server, which protects the ensuing > - exchange of authentication information. In term of > + exchange of authentication information. In terms of > security the difference between EAP-TTLS and PEAP is > - that PEAP authentication broadcasts the username in > + that PEAP authentication broadcasts the username in the > clear, only the password is sent in the encrypted TLS > tunnel. EAP-TTLS will use the TLS tunnel for both As Garrett mentions, this sentence is getting pretty long. I would put a comma after "security", and a linking word before "only the password is sent ...". Maybe "meaning", or "so that". > username and password. > @@ -1661,7 +1661,7 @@ > first phase of the authentication (the TLS > tunnel). According to the authentication server > used, you will have to specify a specific label > - for the authentication. Most of time, the label > + for the authentication. Most of the time, the label I think the "the" in "the authentication" is not needed. > will be client EAP encryption which > is set by using peaplabel=0. > More information can be found in the > @@ -1861,8 +1861,8 @@ > This output displays the card capabilities; the > HOSTAP word confirms this wireless card > can act as an Access Point. Various supported ciphers are > - also mentioned: WEP, TKIP, AES, etc., these informations > - are important to know what security protocols could be set > + also mentioned: WEP, TKIP, AES, etc., this information I would change this comma to a full stop. (Maybe a semicolon, but it would be a bit odd to have colon and semicolon in such proximity.) Thanks for assembling all these fixes into a patch! -Ben Kaduk > + is important to know what security protocols could be set > on the Access Point. > > The wireless device can only be put into hostap mode From owner-freebsd-doc@FreeBSD.ORG Mon Aug 29 04:12:30 2011 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id E94D1106566C for ; Mon, 29 Aug 2011 04:12:30 +0000 (UTC) (envelope-from wblock@wonkity.com) Received: from wonkity.com (wonkity.com [67.158.26.137]) by mx1.freebsd.org (Postfix) with ESMTP id 6DC528FC15 for ; Mon, 29 Aug 2011 04:12:30 +0000 (UTC) Received: from wonkity.com (localhost [127.0.0.1]) by wonkity.com (8.14.5/8.14.5) with ESMTP id p7T4CTp6039995; Sun, 28 Aug 2011 22:12:29 -0600 (MDT) (envelope-from wblock@wonkity.com) Received: from localhost (wblock@localhost) by wonkity.com (8.14.5/8.14.5/Submit) with ESMTP id p7T4CT04039992; Sun, 28 Aug 2011 22:12:29 -0600 (MDT) (envelope-from wblock@wonkity.com) Date: Sun, 28 Aug 2011 22:12:29 -0600 (MDT) From: Warren Block To: Garrett Cooper In-Reply-To: <201108290130.p7T1UFLj020449@freefall.freebsd.org> Message-ID: References: <201108290130.p7T1UFLj020449@freefall.freebsd.org> User-Agent: Alpine 2.00 (BSF 1167 2008-08-23) MIME-Version: 1.0 Content-Type: MULTIPART/MIXED; BOUNDARY="-902635197-1141510348-1314591149=:39681" X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.2.7 (wonkity.com [127.0.0.1]); Sun, 28 Aug 2011 22:12:29 -0600 (MDT) Cc: freebsd-doc@freebsd.org Subject: Re: docs/160269: [patch] Handbook wireless section: sand off some rough edges X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 29 Aug 2011 04:12:31 -0000 This message is in MIME format. The first part should be readable text, while the remaining parts are likely unreadable without MIME-aware tools. ---902635197-1141510348-1314591149=:39681 Content-Type: TEXT/PLAIN; format=flowed; charset=US-ASCII On Mon, 29 Aug 2011, Garrett Cooper wrote: > The following reply was made to PR docs/160269; it has been noted by GNATS. > > From: Garrett Cooper > > > > > > - If the /etc/rc.conf is set up > > + If /etc/rc.conf is set up > > with the line ifconfig_wlan0="DHCP" > > - then it is no need to run the > > - dhclient command manually, > > + then it is not necessary to run the > > + dhclient command manually. > > This isn't entirely true. You can specify other options like > "SYNCDHCP", "ssid DHCP", etc, and it will achieve what's > described below. Manual execution of dhclient in general should be > discouraged for most users. Changes made; I also found "plumbs the keys" to make my brain hurt. > > EAP does not come with an encryption method, it was > > decided to embed EAP inside an encrypted tunnel. Many > > -types of EAP authentication methods have been designed, > > -the most common methods are EAP-TLS, EAP-TTLS and > > +types of EAP authentication methods have been designed. > > +The most common methods are EAP-TLS, EAP-TTLS and > > EAP-PEAP. > > Maybe it should say something like "There are many EAP authentication > methods: the most common ones are EAP-TLS, EAP-TTLS, and EAP-PEAP" ? Done, but slightly differently. The preceding sentence also had problems. > > EAP-TLS (EAP with Transport Layer Security) is a > > @@ -1555,7 +1555,7 @@ > > 0 > > The ca_cert field indicates > > the pathname of the CA certificate file. This file > > -is needed to verify the server certificat. > > +is needed to verify the server certificate. > > > > > > > > @@ -1599,10 +1599,10 @@ > > > > PEAP (Protected EAP) has been designed as an > > alternative to EAP-TTLS. There are two types of PEAP > > -methods, the most common one is PEAPv0/EAP-MSCHAPv2. In > > +methods; the most common one is PEAPv0/EAP-MSCHAPv2. In > > That could be a colon instead. The alternate type is never mentioned, so it's pointless to say that there are two. Instead, let's just say PEAPv0/EAP-MSCHAPv2 is the most common. This is actually an aside in the paragraph, so let's move it to a just before the paragraph. > This sentence is extremely wordy. Yes, and poorly organized. Better with the rewrite. > The rest of the changes are good incremental improvements to the > existing doc :). Thanks! Second version of the patch attached, which I think addresses both these and Mr. Kaduk's comments. Also removed one pointless "simply". ---902635197-1141510348-1314591149=:39681 Content-Type: TEXT/PLAIN; charset=US-ASCII; name=patch-handbook-wireless-2.diff.txt Content-Transfer-Encoding: BASE64 Content-ID: Content-Description: Content-Disposition: attachment; filename=patch-handbook-wireless-2.diff.txt LS0tIGVuX1VTLklTTzg4NTktMS9ib29rcy9oYW5kYm9vay9hZHZhbmNlZC1u ZXR3b3JraW5nL2NoYXB0ZXIuc2dtbC5vcmlnCTIwMTEtMDgtMjggMTc6NTc6 MjguMDAwMDAwMDAwIC0wNjAwDQorKysgZW5fVVMuSVNPODg1OS0xL2Jvb2tz L2hhbmRib29rL2FkdmFuY2VkLW5ldHdvcmtpbmcvY2hhcHRlci5zZ21sCTIw MTEtMDgtMjggMjI6MDc6MjQuMDAwMDAwMDAwIC0wNjAwDQpAQCAtMTE2NCw3 ICsxMTY0LDcgQEANCiAJICAgICAgYXV0aGVudGljYXRpb24gcGFyYW1ldGVy cywgeW91IHdpbGwgaGF2ZSB0byBnZXQgYW4gSVANCiAJICAgICAgYWRkcmVz cyB0byBjb21tdW5pY2F0ZS4gIE1vc3Qgb2YgdGltZSB5b3Ugd2lsbCBvYnRh aW4NCiAJICAgICAgeW91ciB3aXJlbGVzcyBJUCBhZGRyZXNzIHZpYSBESENQ LiAgVG8gYWNoaWV2ZSB0aGF0LA0KLQkgICAgICBzaW1wbHkgZWRpdCA8Zmls ZW5hbWU+L2V0Yy9yYy5jb25mPC9maWxlbmFtZT4gYW5kIGFkZA0KKwkgICAg ICBlZGl0IDxmaWxlbmFtZT4vZXRjL3JjLmNvbmY8L2ZpbGVuYW1lPiBhbmQg YWRkDQogCSAgICAgIDxsaXRlcmFsPkRIQ1A8L2xpdGVyYWw+IHRvIHRoZSBj b25maWd1cmF0aW9uIGZvciB5b3VyDQogCSAgICAgIGRldmljZSBhcyBzaG93 biBpbiB2YXJpb3VzIGV4YW1wbGVzIGFib3ZlOjwvcGFyYT4NCiANCkBAIC0x MjI1LDcgKzEyMjUsNyBAQA0KIAkgICAgdGhlIDgwMi4xWCBhdXRoZW50aWNh dGlvbiBwcm90b2NvbCBhbmQgdXNlcyBvbmUgb2Ygc2V2ZXJhbA0KIAkgICAg Y2lwaGVycyBpbnN0ZWFkIG9mIFdFUCBmb3IgZGF0YSBpbnRlZ3JpdHkuICBU aGUgb25seQ0KIAkgICAgY2lwaGVyIHJlcXVpcmVkIGJ5IFdQQSBpcyBUS0lQ IChUZW1wb3JhcnkgS2V5IEludGVncml0eQ0KLQkgICAgUHJvdG9jb2wpIHdo aWNoIGlzIGEgY2lwaGVyIHRoYXQgZXh0ZW5kcyB0aGUgYmFzaWMgUkM0DQor CSAgICBQcm90b2NvbCkuICBUS0lQIGlzIGEgY2lwaGVyIHRoYXQgZXh0ZW5k cyB0aGUgYmFzaWMgUkM0DQogCSAgICBjaXBoZXIgdXNlZCBieSBXRVAgYnkg YWRkaW5nIGludGVncml0eSBjaGVja2luZywgdGFtcGVyDQogCSAgICBkZXRl Y3Rpb24sIGFuZCBtZWFzdXJlcyBmb3IgcmVzcG9uZGluZyB0byBhbnkgZGV0 ZWN0ZWQNCiAJICAgIGludHJ1c2lvbnMuICBUS0lQIGlzIGRlc2lnbmVkIHRv IHdvcmsgb24gbGVnYWN5IGhhcmR3YXJlDQpAQCAtMTI0Myw3ICsxMjQzLDcg QEANCiAJICAgIHN0YXRpb24gYW5kIHRoZSBhY2Nlc3MgcG9pbnQgdXNpbmcg YSBwcmUtc2hhcmVkIHNlY3JldC4NCiAJICAgIFRoZSBmb3JtZXIgaXMgY29t bW9ubHkgdGVybWVkIFdQQSBFbnRlcnByaXNlIHdpdGggdGhlDQogCSAgICBs YXR0ZXIga25vd24gYXMgV1BBIFBlcnNvbmFsLiAgU2luY2UgbW9zdCBwZW9w bGUgd2lsbCBub3QNCi0JICAgIHNldCB1cCBhIFJBRElVUyBiYWNrZW5kIHNl cnZlciBmb3Igd2lyZWxlc3MgbmV0d29yaywNCisJICAgIHNldCB1cCBhIFJB RElVUyBiYWNrZW5kIHNlcnZlciBmb3IgdGhlaXIgd2lyZWxlc3MgbmV0d29y aywNCiAJICAgIFdQQS1QU0sgaXMgYnkgZmFyIHRoZSBtb3N0IGNvbW1vbmx5 IGVuY291bnRlcmVkDQogCSAgICBjb25maWd1cmF0aW9uIGZvciBXUEEuPC9w YXJhPg0KIA0KQEAgLTEyNTgsNyArMTI1OCw3IEBADQogCSAgPHNlY3Q1IGlk PSJuZXR3b3JrLXdpcmVsZXNzLXdwYS13cGEtcHNrIj4NCiAJICAgIDx0aXRs ZT5XUEEtUFNLPC90aXRsZT4NCiANCi0JICAgIDxwYXJhPldQQS1QU0sgYWxz byBrbm93biBhcyBXUEEtUGVyc29uYWwgaXMgYmFzZWQgb24gYQ0KKwkgICAg PHBhcmE+V1BBLVBTSywgYWxzbyBrbm93biBhcyBXUEEtUGVyc29uYWwsIGlz IGJhc2VkIG9uIGENCiAJICAgICAgcHJlLXNoYXJlZCBrZXkgKFBTSykgZ2Vu ZXJhdGVkIGZyb20gYSBnaXZlbiBwYXNzd29yZCBhbmQNCiAJICAgICAgdGhh dCB3aWxsIGJlIHVzZWQgYXMgdGhlIG1hc3RlciBrZXkgaW4gdGhlIHdpcmVs ZXNzDQogCSAgICAgIG5ldHdvcmsuICBUaGlzIG1lYW5zIGV2ZXJ5IHdpcmVs ZXNzIHVzZXIgd2lsbCBzaGFyZSB0aGUNCkBAIC0xMjg5LDcgKzEyODksNyBA QA0KIAkgICAgPHByb2dyYW1saXN0aW5nPndsYW5zX2F0aDA9IndsYW4wIg0K IGlmY29uZmlnX3dsYW4wPSJXUEEgREhDUCI8L3Byb2dyYW1saXN0aW5nPg0K IA0KLQkgICAgPHBhcmE+VGhlbiwgd2UgY2FuIGJyaW5nIHVwIHRoZSBpbnRl cmZhY2U6PC9wYXJhPg0KKwkgICAgPHBhcmE+VGhlbiB3ZSBjYW4gYnJpbmcg dXAgdGhlIGludGVyZmFjZTo8L3BhcmE+DQogDQogCSAgICA8c2NyZWVuPiZw cm9tcHQucm9vdDsgPHVzZXJpbnB1dD48ZmlsZW5hbWU+L2V0Yy9yYy5kL25l dGlmPC9maWxlbmFtZT4gc3RhcnQ8L3VzZXJpbnB1dD4NCiBTdGFydGluZyB3 cGFfc3VwcGxpY2FudC4NCkBAIC0xMzQyLDE2ICsxMzQyLDE2IEBADQogICAg ICAgd21lIGJ1cnN0IHJvYW1pbmcgTUFOVUFMPC9zY3JlZW4+DQogDQogCSAg ICA8bm90ZT4NCi0JICAgICAgPHBhcmE+SWYgdGhlIDxmaWxlbmFtZT4vZXRj L3JjLmNvbmY8L2ZpbGVuYW1lPiBpcyBzZXQgdXANCi0JCXdpdGggdGhlIGxp bmUgPGxpdGVyYWw+aWZjb25maWdfd2xhbjA9IkRIQ1AiPC9saXRlcmFsPg0K LQkJdGhlbiBpdCBpcyBubyBuZWVkIHRvIHJ1biB0aGUNCi0JCTxjb21tYW5k PmRoY2xpZW50PC9jb21tYW5kPiBjb21tYW5kIG1hbnVhbGx5LA0KLQkJPGNv bW1hbmQ+ZGhjbGllbnQ8L2NvbW1hbmQ+IHdpbGwgYmUgbGF1bmNoZWQgYWZ0 ZXINCi0JCTxjb21tYW5kPndwYV9zdXBwbGljYW50PC9jb21tYW5kPiBwbHVt YnMgdGhlDQotCQlrZXlzLjwvcGFyYT4NCisJICAgICAgPHBhcmE+SWYgPGZp bGVuYW1lPi9ldGMvcmMuY29uZjwvZmlsZW5hbWU+IGhhcyBhbg0KKwkgICAg ICAgIDxsaXRlcmFsPmlmY29uZmlnX3dsYW4wPC9saXRlcmFsPiBlbnRyeSB3 aXRoIHRoZQ0KKwkJPGxpdGVyYWw+REhDUDwvbGl0ZXJhbD4gc3RyaW5nIChs aWtlDQorCQk8bGl0ZXJhbD5pZmNvbmZpZ193bGFuMD0iREhDUCI8L2xpdGVy YWw+KSwNCisJCTxjb21tYW5kPmRoY2xpZW50PC9jb21tYW5kPiB3aWxsIGJl IGxhdW5jaGVkDQorCQlhdXRvbWF0aWNhbGx5IGFmdGVyIDxjb21tYW5kPndw YV9zdXBwbGljYW50PC9jb21tYW5kPg0KKwkJYXNzb2NpYXRlcyB3aXRoIHRo ZSBhY2Nlc3MgcG9pbnQuPC9wYXJhPg0KIAkgICAgPC9ub3RlPg0KIA0KLQkg ICAgPHBhcmE+SW4gdGhlIGNhc2Ugd2hlcmUgdGhlIHVzZSBvZiBESENQIGlz IG5vdCBwb3NzaWJsZSwNCisJICAgIDxwYXJhPklmIERIQ1AgaXMgbm90IHBv c3NpYmxlIG9yIGRlc2lyZWQsDQogCSAgICAgIHlvdSBjYW4gc2V0IGEgc3Rh dGljIElQIGFkZHJlc3MgYWZ0ZXINCiAJICAgICAgPGNvbW1hbmQ+d3BhX3N1 cHBsaWNhbnQ8L2NvbW1hbmQ+IGhhcyBhdXRoZW50aWNhdGVkIHRoZQ0KIAkg ICAgICBzdGF0aW9uOjwvcGFyYT4NCkBAIC0xMzcwLDcgKzEzNzAsNyBAQA0K ICAgICAgIHdtZSBidXJzdCByb2FtaW5nIE1BTlVBTDwvc2NyZWVuPg0KIA0K IAkgICAgPHBhcmE+V2hlbiBESENQIGlzIG5vdCB1c2VkLCB5b3UgYWxzbyBo YXZlIHRvIG1hbnVhbGx5IHNldA0KLQkgICAgICB1cCB0aGUgZGVmYXVsdCBn YXRld2F5IGFuZCB0aGUgbmFtZXNlcnZlcjo8L3BhcmE+DQorCSAgICAgIHRo ZSBkZWZhdWx0IGdhdGV3YXkgYW5kIHRoZSBuYW1lc2VydmVyOjwvcGFyYT4N CiANCiAJICAgIDxzY3JlZW4+JnByb21wdC5yb290OyA8dXNlcmlucHV0PnJv dXRlIGFkZCBkZWZhdWx0IDxyZXBsYWNlYWJsZT55b3VyX2RlZmF1bHRfcm91 dGVyPC9yZXBsYWNlYWJsZT48L3VzZXJpbnB1dD4NCiAmcHJvbXB0LnJvb3Q7 IDx1c2VyaW5wdXQ+ZWNobyAibmFtZXNlcnZlciA8cmVwbGFjZWFibGU+eW91 cl9ETlNfc2VydmVyPC9yZXBsYWNlYWJsZT4iICZndDsmZ3Q7IC9ldGMvcmVz b2x2LmNvbmY8L3VzZXJpbnB1dD48L3NjcmVlbj4NCkBAIC0xMzgwLDE3ICsx MzgwLDE3IEBADQogCSAgICA8dGl0bGU+V1BBIHdpdGggRUFQLVRMUzwvdGl0 bGU+DQogDQogCSAgICA8cGFyYT5UaGUgc2Vjb25kIHdheSB0byB1c2UgV1BB IGlzIHdpdGggYW4gODAyLjFYIGJhY2tlbmQNCi0JICAgICAgYXV0aGVudGlj YXRpb24gc2VydmVyLCBpbiB0aGlzIGNhc2UgV1BBIGlzIGNhbGxlZA0KLQkg ICAgICBXUEEtRW50ZXJwcmlzZSB0byBtYWtlIGRpZmZlcmVuY2Ugd2l0aCB0 aGUgbGVzcyBzZWN1cmUNCi0JICAgICAgV1BBLVBlcnNvbmFsIHdpdGggaXRz IHByZS1zaGFyZWQga2V5LiAgVGhlDQotCSAgICAgIGF1dGhlbnRpY2F0aW9u IGluIFdQQS1FbnRlcnByaXNlIGlzIGJhc2VkIG9uIEVBUA0KLQkgICAgICAo RXh0ZW5zaWJsZSBBdXRoZW50aWNhdGlvbiBQcm90b2NvbCkuPC9wYXJhPg0K LQ0KLQkgICAgPHBhcmE+RUFQIGRvZXMgbm90IGNvbWUgd2l0aCBhbiBlbmNy eXB0aW9uIG1ldGhvZCwgaXQgd2FzDQotCSAgICAgIGRlY2lkZWQgdG8gZW1i ZWQgRUFQIGluc2lkZSBhbiBlbmNyeXB0ZWQgdHVubmVsLiAgTWFueQ0KLQkg ICAgICB0eXBlcyBvZiBFQVAgYXV0aGVudGljYXRpb24gbWV0aG9kcyBoYXZl IGJlZW4gZGVzaWduZWQsDQotCSAgICAgIHRoZSBtb3N0IGNvbW1vbiBtZXRo b2RzIGFyZSBFQVAtVExTLCBFQVAtVFRMUyBhbmQNCi0JICAgICAgRUFQLVBF QVAuPC9wYXJhPg0KKwkgICAgICBhdXRoZW50aWNhdGlvbiBzZXJ2ZXIuICBJ biB0aGlzIGNhc2UgV1BBIGlzIGNhbGxlZA0KKwkgICAgICBXUEEtRW50ZXJw cmlzZSB0byBkaWZmZXJlbnRpYXRlIGl0IGZyb20gdGhlIGxlc3Mgc2VjdXJl DQorCSAgICAgIFdQQS1QZXJzb25hbCB3aXRoIGl0cyBwcmUtc2hhcmVkIGtl eS4NCisJICAgICAgQXV0aGVudGljYXRpb24gaW4gV1BBLUVudGVycHJpc2Ug aXMgYmFzZWQgb24gdGhlDQorCSAgICAgIEV4dGVuc2libGUgQXV0aGVudGlj YXRpb24gUHJvdG9jb2wgKEVBUCkuPC9wYXJhPg0KKw0KKwkgICAgPHBhcmE+ RUFQIGRvZXMgbm90IGNvbWUgd2l0aCBhbiBlbmNyeXB0aW9uIG1ldGhvZC4N CisJICAgICAgSW5zdGVhZCwgaXQgd2FzIGRlY2lkZWQgdG8gZW1iZWQgRUFQ IGluc2lkZSBhbiBlbmNyeXB0ZWQNCisJICAgICAgdHVubmVsLiAgVGhlcmUg YXJlIG1hbnkgRUFQIGF1dGhlbnRpY2F0aW9uIG1ldGhvZHMsIGJ1dA0KKwkg ICAgICBFQVAtVExTLCBFQVAtVFRMUywgYW5kIEVBUC1QRUFQIGFyZSB0aGUg bW9zdA0KKwkgICAgICBjb21tb24uPC9wYXJhPg0KIA0KIAkgICAgPHBhcmE+ RUFQLVRMUyAoRUFQIHdpdGggVHJhbnNwb3J0IExheWVyIFNlY3VyaXR5KSBp cyBhDQogCSAgICAgIHZlcnkgd2VsbC1zdXBwb3J0ZWQgYXV0aGVudGljYXRp b24gcHJvdG9jb2wgaW4gdGhlDQpAQCAtMTU1NSw3ICsxNTU1LDcgQEANCiAJ ICAgICAgPGNhbGxvdXQgYXJlYXJlZnM9ImNvLXR0bHMtY2FjZXJ0Ij4NCiAJ CTxwYXJhPlRoZSA8bGl0ZXJhbD5jYV9jZXJ0PC9saXRlcmFsPiBmaWVsZCBp bmRpY2F0ZXMNCiAJCSAgdGhlIHBhdGhuYW1lIG9mIHRoZSBDQSBjZXJ0aWZp Y2F0ZSBmaWxlLiAgVGhpcyBmaWxlDQotCQkgIGlzIG5lZWRlZCB0byB2ZXJp ZnkgdGhlIHNlcnZlciBjZXJ0aWZpY2F0LjwvcGFyYT4NCisJCSAgaXMgbmVl ZGVkIHRvIHZlcmlmeSB0aGUgc2VydmVyIGNlcnRpZmljYXRlLjwvcGFyYT4N CiAJICAgICAgPC9jYWxsb3V0Pg0KIA0KIAkgICAgICA8Y2FsbG91dCBhcmVh cmVmcz0iY28tdHRscy1waGEyIj4NCkBAIC0xNTk3LDIzICsxNTk3LDI2IEBA DQogCSAgPHNlY3Q1IGlkPSJuZXR3b3JrLXdpcmVsZXNzLXdwYS1lYXAtcGVh cCI+DQogCSAgICA8dGl0bGU+V1BBIHdpdGggRUFQLVBFQVA8L3RpdGxlPg0K IA0KKwkgICAgPG5vdGU+DQorCSAgICAgIDxwYXJhPlBFQVB2MC9FQVAtTVND SEFQdjIgaXMgdGhlIG1vc3QgY29tbW9uIFBFQVAgbWV0aG9kLg0KKwkgICAg ICAgIEluIHRoZSByZXN0IG9mIHRoaXMgZG9jdW1lbnQsIHdlIHdpbGwgdXNl IHRoZSBQRUFQIHRlcm0NCisJICAgICAgICB0byByZWZlciB0byB0aGF0IG1l dGhvZC48L3BhcmE+DQorCSAgICA8L25vdGU+DQorCSAgICANCiAJICAgIDxw YXJhPlBFQVAgKFByb3RlY3RlZCBFQVApIGhhcyBiZWVuIGRlc2lnbmVkIGFz IGFuDQotCSAgICAgIGFsdGVybmF0aXZlIHRvIEVBUC1UVExTLiAgVGhlcmUg YXJlIHR3byB0eXBlcyBvZiBQRUFQDQotCSAgICAgIG1ldGhvZHMsIHRoZSBt b3N0IGNvbW1vbiBvbmUgaXMgUEVBUHYwL0VBUC1NU0NIQVB2Mi4gIEluDQot CSAgICAgIHRoZSByZXN0IG9mIHRoaXMgZG9jdW1lbnQsIHdlIHdpbGwgdXNl IHRoZSBQRUFQIHRlcm0gdG8NCi0JICAgICAgcmVmZXIgdG8gdGhhdCBFQVAg bWV0aG9kLiAgUEVBUCBpcyB0aGUgbW9zdCB1c2VkIEVBUA0KLQkgICAgICBz dGFuZGFyZCBhZnRlciBFQVAtVExTLCBpbiBvdGhlciB3b3JkcyBpZiB5b3Ug aGF2ZSBhDQotCSAgICAgIG5ldHdvcmsgd2l0aCBtaXhlZCBPU2VzLCBQRUFQ IHNob3VsZCBiZSB0aGUgbW9zdA0KLQkgICAgICBzdXBwb3J0ZWQgc3RhbmRh cmQgYWZ0ZXIgRUFQLVRMUy48L3BhcmE+DQorCSAgICAgIGFsdGVybmF0aXZl IHRvIEVBUC1UVExTLCBhbmQgaXMgdGhlIG1vc3QgdXNlZCBFQVANCisJICAg ICAgc3RhbmRhcmQgYWZ0ZXIgRUFQLVRMUy4gIEluIG90aGVyIHdvcmRzLCBp ZiB5b3UgaGF2ZSBhDQorCSAgICAgIG5ldHdvcmsgd2l0aCBtaXhlZCBPU2Vz LCBQRUFQIHNob3VsZCBiZSB0aGUNCisJICAgICAgbW9zdCBzdXBwb3J0ZWQg c3RhbmRhcmQgYWZ0ZXIgRUFQLVRMUy48L3BhcmE+DQogDQogCSAgICA8cGFy YT5QRUFQIGlzIHNpbWlsYXIgdG8gRUFQLVRUTFM6IGl0IHVzZXMgYSBzZXJ2 ZXItc2lkZQ0KIAkgICAgICBjZXJ0aWZpY2F0ZSB0byBhdXRoZW50aWNhdGUg Y2xpZW50cyBieSBjcmVhdGluZyBhbg0KIAkgICAgICBlbmNyeXB0ZWQgVExT IHR1bm5lbCBiZXR3ZWVuIHRoZSBjbGllbnQgYW5kIHRoZQ0KIAkgICAgICBh dXRoZW50aWNhdGlvbiBzZXJ2ZXIsIHdoaWNoIHByb3RlY3RzIHRoZSBlbnN1 aW5nDQotCSAgICAgIGV4Y2hhbmdlIG9mIGF1dGhlbnRpY2F0aW9uIGluZm9y bWF0aW9uLiAgSW4gdGVybSBvZg0KLQkgICAgICBzZWN1cml0eSB0aGUgZGlm ZmVyZW5jZSBiZXR3ZWVuIEVBUC1UVExTIGFuZCBQRUFQIGlzDQotCSAgICAg IHRoYXQgUEVBUCBhdXRoZW50aWNhdGlvbiBicm9hZGNhc3RzIHRoZSB1c2Vy bmFtZSBpbg0KLQkgICAgICBjbGVhciwgb25seSB0aGUgcGFzc3dvcmQgaXMg c2VudCBpbiB0aGUgZW5jcnlwdGVkIFRMUw0KKwkgICAgICBleGNoYW5nZSBv ZiBhdXRoZW50aWNhdGlvbiBpbmZvcm1hdGlvbi4gIEluIHRlcm1zIG9mDQor CSAgICAgIHNlY3VyaXR5LCB0aGUgZGlmZmVyZW5jZSBiZXR3ZWVuIEVBUC1U VExTIGFuZCBQRUFQIGlzDQorCSAgICAgIHRoYXQgUEVBUCBhdXRoZW50aWNh dGlvbiBicm9hZGNhc3RzIHRoZSB1c2VybmFtZSBpbiB0aGUNCisJICAgICAg Y2xlYXIsIHdpdGggb25seSB0aGUgcGFzc3dvcmQgc2VudCBpbiB0aGUgZW5j cnlwdGVkIFRMUw0KIAkgICAgICB0dW5uZWwuICBFQVAtVFRMUyB3aWxsIHVz ZSB0aGUgVExTIHR1bm5lbCBmb3IgYm90aA0KIAkgICAgICB1c2VybmFtZSBh bmQgcGFzc3dvcmQuPC9wYXJhPg0KIA0KQEAgLTE2NTgsMTAgKzE2NjEsMTAg QEANCiANCiAJICAgICAgPGNhbGxvdXQgYXJlYXJlZnM9ImNvLXBlYXAtcGhh MSI+DQogCQk8cGFyYT5UaGlzIGZpZWxkIGNvbnRhaW5zIHRoZSBwYXJhbWV0 ZXJzIGZvciB0aGUNCi0JCSAgZmlyc3QgcGhhc2Ugb2YgdGhlIGF1dGhlbnRp Y2F0aW9uICh0aGUgVExTDQorCQkgIGZpcnN0IHBoYXNlIG9mIGF1dGhlbnRp Y2F0aW9uICh0aGUgVExTDQogCQkgIHR1bm5lbCkuICBBY2NvcmRpbmcgdG8g dGhlIGF1dGhlbnRpY2F0aW9uIHNlcnZlcg0KIAkJICB1c2VkLCB5b3Ugd2ls bCBoYXZlIHRvIHNwZWNpZnkgYSBzcGVjaWZpYyBsYWJlbA0KLQkJICBmb3Ig dGhlIGF1dGhlbnRpY2F0aW9uLiAgTW9zdCBvZiB0aW1lLCB0aGUgbGFiZWwN CisJCSAgZm9yIGF1dGhlbnRpY2F0aW9uLiAgTW9zdCBvZiB0aGUgdGltZSwg dGhlIGxhYmVsDQogCQkgIHdpbGwgYmUgPHF1b3RlPmNsaWVudCBFQVAgZW5j cnlwdGlvbjwvcXVvdGU+IHdoaWNoDQogCQkgIGlzIHNldCBieSB1c2luZyA8 bGl0ZXJhbD5wZWFwbGFiZWw9MDwvbGl0ZXJhbD4uDQogCQkgIE1vcmUgaW5m b3JtYXRpb24gY2FuIGJlIGZvdW5kIGluIHRoZQ0KQEAgLTE2ODIsNyArMTY4 NSw3IEBADQogCSAgICA8cHJvZ3JhbWxpc3Rpbmc+d2xhbnNfYXRoMD0id2xh bjAiDQogaWZjb25maWdfd2xhbjA9IldQQSBESENQIjwvcHJvZ3JhbWxpc3Rp bmc+DQogDQotCSAgICA8cGFyYT5UaGVuLCB3ZSBjYW4gYnJpbmcgdXAgdGhl IGludGVyZmFjZTo8L3BhcmE+DQorCSAgICA8cGFyYT5UaGVuIHdlIGNhbiBi cmluZyB1cCB0aGUgaW50ZXJmYWNlOjwvcGFyYT4NCiANCiAJICAgIDxzY3Jl ZW4+JnByb21wdC5yb290OyA8dXNlcmlucHV0Pi9ldGMvcmMuZC9uZXRpZiBz dGFydDwvdXNlcmlucHV0Pg0KIFN0YXJ0aW5nIHdwYV9zdXBwbGljYW50Lg0K QEAgLTE3MDksNyArMTcxMiw3IEBADQogDQogCSAgPHBhcmE+V0VQIChXaXJl ZCBFcXVpdmFsZW50IFByaXZhY3kpIGlzIHBhcnQgb2YgdGhlIG9yaWdpbmFs DQogCSAgICA4MDIuMTEgc3RhbmRhcmQuICBUaGVyZSBpcyBubyBhdXRoZW50 aWNhdGlvbiBtZWNoYW5pc20sDQotCSAgICBvbmx5IGEgd2VhayBmb3JtIG9m IGFjY2VzcyBjb250cm9sLCBhbmQgaXQgaXMgZWFzaWx5IHRvIGJlDQorCSAg ICBvbmx5IGEgd2VhayBmb3JtIG9mIGFjY2VzcyBjb250cm9sLCBhbmQgaXQg aXMgZWFzaWx5DQogCSAgICBjcmFja2VkLjwvcGFyYT4NCiANCiAJICA8cGFy YT5XRVAgY2FuIGJlIHNldCB1cCB3aXRoDQpAQCAtMTcyNCwxOCArMTcyNywx OCBAQA0KIAkgICAgICA8cGFyYT5UaGUgPGxpdGVyYWw+d2VwdHhrZXk8L2xp dGVyYWw+IG1lYW5zIHdoaWNoIFdFUA0KIAkJa2V5IHdpbGwgYmUgdXNlZCBp biB0aGUgdHJhbnNtaXNzaW9uLiAgSGVyZSB3ZSB1c2VkIHRoZQ0KIAkJdGhp cmQga2V5LiAgVGhpcyBtdXN0IG1hdGNoIHRoZSBzZXR0aW5nIGluIHRoZSBh Y2Nlc3MNCi0JCXBvaW50LiAgSWYgeW91IGRvIG5vdCBoYXZlIGFueSBpZGVh IG9mIHdoYXQgaXMgdGhlIGtleQ0KLQkJdXNlZCBieSB0aGUgYWNjZXNzIHBv aW50LCB5b3Ugc2hvdWxkIHRyeSB0byB1c2UNCisJCXBvaW50LiAgSWYgeW91 IGRvIG5vdCBoYXZlIGFueSBpZGVhIG9mIHdoaWNoIGtleSBpcw0KKwkJdXNl ZCBieSB0aGUgYWNjZXNzIHBvaW50LCB0cnkNCiAJCTxsaXRlcmFsPjE8L2xp dGVyYWw+IChpLmUuLCB0aGUgZmlyc3Qga2V5KSBmb3IgdGhpcw0KIAkJdmFs dWUuPC9wYXJhPg0KIAkgICAgPC9saXN0aXRlbT4NCiANCiAJICAgIDxsaXN0 aXRlbT4NCi0JICAgICAgPHBhcmE+VGhlIDxsaXRlcmFsPndlcGtleTwvbGl0 ZXJhbD4gbWVhbnMgc2V0dGluZyB0aGUNCi0JCXNlbGVjdGVkIFdFUCBrZXku ICBJdCBzaG91bGQgaW4gdGhlIGZvcm1hdA0KLQkJPHJlcGxhY2VhYmxlPmlu ZGV4OmtleTwvcmVwbGFjZWFibGU+LCBpZiB0aGUgaW5kZXggaXMNCi0JCW5v dCBnaXZlbiwga2V5IDxsaXRlcmFsPjE8L2xpdGVyYWw+IGlzIHNldC4gIFRo YXQgaXMNCi0JCXRvIHNheSB3ZSBuZWVkIHRvIHNldCB0aGUgaW5kZXggaWYg d2UgdXNlIGtleXMgb3RoZXINCisJICAgICAgPHBhcmE+VGhlIDxsaXRlcmFs PndlcGtleTwvbGl0ZXJhbD4gc2VsZWN0cyBvbmUgb2YgdGhlDQorCQlXRVAg a2V5cy4gIEl0IHNob3VsZCBiZSBpbiB0aGUgZm9ybWF0DQorCQk8cmVwbGFj ZWFibGU+aW5kZXg6a2V5PC9yZXBsYWNlYWJsZT4uICBLZXkNCisJCTxsaXRl cmFsPjE8L2xpdGVyYWw+IGlzIHVzZWQgYnkgZGVmYXVsdDsgdGhlIGluZGV4 DQorCQlvbmx5IG5lZWRzIHRvIGJlIHNldCBpZiB3ZSB1c2UgYSBrZXkgb3Ro ZXINCiAJCXRoYW4gdGhlIGZpcnN0IGtleS48L3BhcmE+DQogDQogCSAgICAg IDxub3RlPg0KQEAgLTE3NDYsNyArMTc0OSw3IEBADQogCSAgICA8L2xpc3Rp dGVtPg0KIAkgIDwvaXRlbWl6ZWRsaXN0Pg0KIA0KLQkgIDxwYXJhPllvdSBh cmUgZW5jb3VyYWdlZCB0byByZWFkICZtYW4uaWZjb25maWcuODsgbWFudWFs DQorCSAgPHBhcmE+WW91IGFyZSBlbmNvdXJhZ2VkIHRvIHJlYWQgdGhlICZt YW4uaWZjb25maWcuODsgbWFudWFsDQogCSAgICBwYWdlIGZvciBmdXJ0aGVy IGluZm9ybWF0aW9uLjwvcGFyYT4NCiANCiAJICA8cGFyYT5UaGUgPGNvbW1h bmQ+d3BhX3N1cHBsaWNhbnQ8L2NvbW1hbmQ+IGZhY2lsaXR5IGFsc28NCkBA IC0xNzc3LDcgKzE3ODAsNyBAQA0KICAgICAgIDxwYXJhPklCU1MgbW9kZSwg YWxzbyBjYWxsZWQgYWQtaG9jIG1vZGUsIGlzIGRlc2lnbmVkIGZvciBwb2lu dA0KIAl0byBwb2ludCBjb25uZWN0aW9ucy4gIEZvciBleGFtcGxlLCB0byBl c3RhYmxpc2ggYW4gYWQtaG9jDQogCW5ldHdvcmsgYmV0d2VlbiB0aGUgbWFj aGluZSA8aG9zdGlkPkE8L2hvc3RpZD4gYW5kIHRoZSBtYWNoaW5lDQotCTxo b3N0aWQ+QjwvaG9zdGlkPiB3ZSB3aWxsIGp1c3QgbmVlZCB0byBjaG9vc2Ug dHdvIElQIGFkZHJlc3Nlcw0KKwk8aG9zdGlkPkI8L2hvc3RpZD4sIHdlIHdp bGwganVzdCBuZWVkIHRvIGNob29zZSB0d28gSVAgYWRkcmVzc2VzDQogCWFu ZCBhIFNTSUQuPC9wYXJhPg0KIA0KICAgICAgIDxwYXJhPk9uIHRoZSBib3gg PGhvc3RpZD5BPC9ob3N0aWQ+OjwvcGFyYT4NCkBAIC0xODIyLDcgKzE4MjUs NyBAQA0KIAkgIHByb3Rtb2RlIENUUyB3bWUgYnVyc3Q8L3NjcmVlbj4NCiAN CiAJICA8cGFyYT5Cb3RoIDxob3N0aWQ+QTwvaG9zdGlkPiBhbmQgPGhvc3Rp ZD5CPC9ob3N0aWQ+IGFyZSBub3cNCi0JICAgIHJlYWR5IHRvIGV4Y2hhbmdl IGluZm9ybWF0aW9ucy48L3BhcmE+DQorCSAgICByZWFkeSB0byBleGNoYW5n ZSBpbmZvcm1hdGlvbi48L3BhcmE+DQogICAgIDwvc2VjdDI+DQogDQogICAg IDxzZWN0MiBpZD0ibmV0d29yay13aXJlbGVzcy1hcCI+DQpAQCAtMTgzOSwx OSArMTg0MiwxOSBAQA0KIAk8cGFyYT5CZWZvcmUgY29uZmlndXJpbmcgeW91 ciAmb3M7IG1hY2hpbmUgYXMgYW4gQVAsIHRoZQ0KIAkgIGtlcm5lbCBtdXN0 IGJlIGNvbmZpZ3VyZWQgd2l0aCB0aGUgYXBwcm9wcmlhdGUgd2lyZWxlc3MN CiAJICBuZXR3b3JraW5nIHN1cHBvcnQgZm9yIHlvdXIgd2lyZWxlc3MgY2Fy ZC4gIFlvdSBhbHNvIGhhdmUgdG8NCi0JICBhZGQgdGhlIHN1cHBvcnQgZm9y IHRoZSBzZWN1cml0eSBwcm90b2NvbHMgeW91IGludGVuZCB0bw0KKwkgIGFk ZCBzdXBwb3J0IGZvciB0aGUgc2VjdXJpdHkgcHJvdG9jb2xzIHlvdSBpbnRl bmQgdG8NCiAJICB1c2UuICBGb3IgbW9yZSBkZXRhaWxzLCBzZWUgPHhyZWYN CiAJICBsaW5rZW5kPSJuZXR3b3JrLXdpcmVsZXNzLWJhc2ljIj4uPC9wYXJh Pg0KIA0KIAk8bm90ZT4NCiAJICA8cGFyYT5UaGUgdXNlIG9mIHRoZSBORElT IGRyaXZlciB3cmFwcGVyIGFuZCB0aGUgJndpbmRvd3M7DQotCSAgICBkcml2 ZXJzIGRvIG5vdCBhbGxvdyBjdXJyZW50bHkgdGhlIEFQIG9wZXJhdGlvbi4g IE9ubHkNCisJICAgIGRyaXZlcnMgZG8gbm90IGN1cnJlbnRseSBhbGxvdyBB UCBvcGVyYXRpb24uICBPbmx5DQogCSAgICBuYXRpdmUgJm9zOyB3aXJlbGVz cyBkcml2ZXJzIHN1cHBvcnQgQVAgbW9kZS48L3BhcmE+DQogCTwvbm90ZT4N CiANCi0JPHBhcmE+T25jZSB0aGUgd2lyZWxlc3MgbmV0d29ya2luZyBzdXBw b3J0IGlzIGxvYWRlZCwgeW91IGNhbg0KKwk8cGFyYT5PbmNlIHdpcmVsZXNz IG5ldHdvcmtpbmcgc3VwcG9ydCBpcyBsb2FkZWQsIHlvdSBjYW4NCiAJICBj aGVjayBpZiB5b3VyIHdpcmVsZXNzIGRldmljZSBzdXBwb3J0cyB0aGUgaG9z dC1iYXNlZCBhY2Nlc3MNCi0JICBwb2ludCBtb2RlIChhbHNvIGtub3cgYXMg aG9zdGFwIG1vZGUpOjwvcGFyYT4NCisJICBwb2ludCBtb2RlIChhbHNvIGtu b3duIGFzIGhvc3RhcCBtb2RlKTo8L3BhcmE+DQogDQogCTxzY3JlZW4+JnBy b21wdC5yb290OyA8dXNlcmlucHV0PmlmY29uZmlnIDxyZXBsYWNlYWJsZT53 bGFuMDwvcmVwbGFjZWFibGU+IGNyZWF0ZSB3bGFuZGV2IDxyZXBsYWNlYWJs ZT5hdGgwPC9yZXBsYWNlYWJsZT48L3VzZXJpbnB1dD4NCiAmcHJvbXB0LnJv b3Q7IDx1c2VyaW5wdXQ+aWZjb25maWcgPHJlcGxhY2VhYmxlPndsYW4wPC9y ZXBsYWNlYWJsZT4gbGlzdCBjYXBzPC91c2VyaW5wdXQ+DQpAQCAtMTg2MSw4 ICsxODY0LDggQEANCiAJPHBhcmE+VGhpcyBvdXRwdXQgZGlzcGxheXMgdGhl IGNhcmQgY2FwYWJpbGl0aWVzOyB0aGUNCiAJICA8bGl0ZXJhbD5IT1NUQVA8 L2xpdGVyYWw+IHdvcmQgY29uZmlybXMgdGhpcyB3aXJlbGVzcyBjYXJkDQog CSAgY2FuIGFjdCBhcyBhbiBBY2Nlc3MgUG9pbnQuICBWYXJpb3VzIHN1cHBv cnRlZCBjaXBoZXJzIGFyZQ0KLQkgIGFsc28gbWVudGlvbmVkOiBXRVAsIFRL SVAsIEFFUywgZXRjLiwgdGhlc2UgaW5mb3JtYXRpb25zDQotCSAgYXJlIGlt cG9ydGFudCB0byBrbm93IHdoYXQgc2VjdXJpdHkgcHJvdG9jb2xzIGNvdWxk IGJlIHNldA0KKwkgIGFsc28gbWVudGlvbmVkOiBXRVAsIFRLSVAsIEFFUywg ZXRjLiAgVGhpcyBpbmZvcm1hdGlvbg0KKwkgIGlzIGltcG9ydGFudCB0byBr bm93IHdoYXQgc2VjdXJpdHkgcHJvdG9jb2xzIGNhbiBiZSB1c2VkDQogCSAg b24gdGhlIEFjY2VzcyBQb2ludC48L3BhcmE+DQogDQogCTxwYXJhPlRoZSB3 aXJlbGVzcyBkZXZpY2UgY2FuIG9ubHkgYmUgcHV0IGludG8gaG9zdGFwIG1v ZGUNCkBAIC0xODc3LDcgKzE4ODAsNyBAQA0KIAk8c2NyZWVuPiZwcm9tcHQu cm9vdDsgPHVzZXJpbnB1dD5pZmNvbmZpZyA8cmVwbGFjZWFibGU+d2xhbjA8 L3JlcGxhY2VhYmxlPiBjcmVhdGUgd2xhbmRldiA8cmVwbGFjZWFibGU+YXRo MDwvcmVwbGFjZWFibGU+IHdsYW5tb2RlIGhvc3RhcDwvdXNlcmlucHV0Pg0K ICZwcm9tcHQucm9vdDsgPHVzZXJpbnB1dD5pZmNvbmZpZyA8cmVwbGFjZWFi bGU+d2xhbjA8L3JlcGxhY2VhYmxlPiBpbmV0IDxyZXBsYWNlYWJsZT4xOTIu MTY4LjAuMTwvcmVwbGFjZWFibGU+IG5ldG1hc2sgPHJlcGxhY2VhYmxlPjI1 NS4yNTUuMjU1LjA8L3JlcGxhY2VhYmxlPiBzc2lkIDxyZXBsYWNlYWJsZT5m cmVlYnNkYXA8L3JlcGxhY2VhYmxlPiBtb2RlIDExZyBjaGFubmVsIDE8L3Vz ZXJpbnB1dD48L3NjcmVlbj4NCiANCi0JPHBhcmE+VXNlIGFnYWluIDxjb21t YW5kPmlmY29uZmlnPC9jb21tYW5kPiB0byBzZWUgdGhlIHN0YXR1cw0KKwk8 cGFyYT5Vc2UgPGNvbW1hbmQ+aWZjb25maWc8L2NvbW1hbmQ+IGFnYWluIHRv IHNlZSB0aGUgc3RhdHVzDQogCSAgb2YgdGhlIDxkZXZpY2VuYW1lPndsYW4w PC9kZXZpY2VuYW1lPiBpbnRlcmZhY2U6PC9wYXJhPg0KIA0KIAk8c2NyZWVu PiZwcm9tcHQucm9vdDsgPHVzZXJpbnB1dD5pZmNvbmZpZyA8cmVwbGFjZWFi bGU+d2xhbjA8L3JlcGxhY2VhYmxlPjwvdXNlcmlucHV0Pg0KQEAgLTIxNTAs NyArMjE1Myw3IEBADQogICAgICAgPHBhcmE+T24gJm9zOywgaXQgaXMgcG9z c2libGUgdG8gY29tYmluZSB0d28gb3IgZXZlbiBtb3JlIG5ldHdvcmsNCiAJ aW50ZXJmYWNlcyB0b2dldGhlciBpbiBhIDxxdW90ZT5mYWlsb3ZlcjwvcXVv dGU+IGZhc2hpb24sIHRoYXQNCiAJaXMsIHRvIHVzZSB0aGUgbW9zdCBwcmVm ZXJyZWQgYW5kIGF2YWlsYWJsZSBjb25uZWN0aW9uIGZyb20gYQ0KLQlncm91 cCBvZiBuZXR3b3JrIGludGVyZmFjZXMsIGFuZCBoYXZlIHRoZSBvcGVyYXRp bmcgc3lzdGVtIHRvDQorCWdyb3VwIG9mIG5ldHdvcmsgaW50ZXJmYWNlcywg YW5kIGhhdmUgdGhlIG9wZXJhdGluZyBzeXN0ZW0NCiAJc3dpdGNoIGF1dG9t YXRpY2FsbHkgd2hlbiB0aGUgbGluayBzdGF0ZSBjaGFuZ2VzLjwvcGFyYT4N CiANCiAgICAgICA8cGFyYT5XZSB3aWxsIGNvdmVyIGxpbmsgYWdncmVnYXRp b24gYW5kIGZhaWxvdmVyIGluIDx4cmVmIGxpbmtlbmQ9Im5ldHdvcmstYWdn cmVnYXRpb24iPg0K ---902635197-1141510348-1314591149=:39681-- From owner-freebsd-doc@FreeBSD.ORG Mon Aug 29 11:06:08 2011 Return-Path: Delivered-To: freebsd-doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id D5E411065672 for ; Mon, 29 Aug 2011 11:06:08 +0000 (UTC) (envelope-from owner-bugmaster@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id C499E8FC19 for ; Mon, 29 Aug 2011 11:06:08 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id p7TB685i088472 for ; Mon, 29 Aug 2011 11:06:08 GMT (envelope-from owner-bugmaster@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id p7TB68wA088470 for freebsd-doc@FreeBSD.org; Mon, 29 Aug 2011 11:06:08 GMT (envelope-from owner-bugmaster@FreeBSD.org) Date: Mon, 29 Aug 2011 11:06:08 GMT Message-Id: <201108291106.p7TB68wA088470@freefall.freebsd.org> X-Authentication-Warning: freefall.freebsd.org: gnats set sender to owner-bugmaster@FreeBSD.org using -f From: FreeBSD bugmaster To: FreeBSD doc list Cc: Subject: Current unassigned doc problem reports X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 29 Aug 2011 11:06:08 -0000 (Note: an HTML version of this report is available at http://www.freebsd.org/cgi/query-pr-summary.cgi?category=doc .) The following is a listing of current problems submitted by FreeBSD users. These represent problem reports covering all versions including experimental development code and obsolete releases. S Tracker Resp. Description -------------------------------------------------------------------------------- o docs/160269 doc [patch] Handbook wireless section: sand off some rough o docs/160267 doc [patch] wlan.4 has incorrect apostrophe o docs/159948 doc [patch] grammar updates to ata.4 o docs/159898 doc [patch] libusb.3 whitespace, markup, grammar fixes o docs/159897 doc [handbook] [patch] improve HAST section of Handbook f docs/159870 doc [PATCH] PR handling guidelines still reference freebsd o docs/159854 doc [patch] grammar updates for carp.4 o docs/159551 doc [patch] ports(7) makes no mention of LOCALBASE o docs/159374 doc [handbook] Difficulty following guide on configuring l o docs/159307 doc [patch] lpd smm chapter unconditionally installed o docs/159298 doc [handbook] document Konqueror with Webkit support to i o docs/158813 doc [patch] grammar updates for jme(4) o docs/158388 doc Incorrect documentation of LOCAL_SCRIPT in release(7) o docs/158387 doc The tree(3) man should mention the RB_FOREACH_SAFE() A o docs/158378 doc cpio/bsdcpio(1) man page does not document -0 and --nu o docs/157908 doc [handbook] Description of post-install should include o docs/157698 doc [patch] gpart(8) man page contains old/incorrect size o docs/157453 doc [patch] document 16-fib cap in setfib.2 o docs/157452 doc [patch] grammar and style nits in ipfw.8 o docs/157337 doc [handbook] [patch] Indentation changes to network serv o docs/157316 doc [patch] update devstat(9) man page o docs/157234 doc [patch] nullfs(5): //proc/curproc/file returns "unknow o docs/157049 doc FreeBSD Handbook: Chapter 14 (Security) Inaccuracy o docs/156955 doc bug in share/man/man2/setsockopt.2 a docs/156920 doc isspecial(3) is not helpful o docs/156868 doc [patch] Typos and grammar in Spanish translation of ar o docs/156815 doc chmod(1): manpage should describe that chmod kicks +t o docs/156689 doc stf(4) output-only documentation gives bad configurati f docs/156187 doc [handbook] [patch] Add bsnmpd to handbook o docs/156081 doc troff falls with troff.core with UTF-8 man with incorr o docs/155989 doc [patch] Fix offset in boot.config(5) o docs/155982 doc [handbook] reaper of the dead: remove reference to flo o docs/155773 doc dialog(1): dialog manpages not updated o docs/155149 doc [patch] don't encourage using xorg.conf outside of PRE o docs/154838 doc update cvs-tags information on releng_* to reflect sup o docs/154502 doc xdm authorization failure when used with E17 window ma o docs/153958 doc ksu man-page documented, but not installed o docs/153738 doc [patch] Docuement requirement to alter some sysctls wh a docs/153012 doc [patch] iostat(8) requires an argument to -c option o docs/151752 doc pw.conf(5) doesn't define format for file clearly o docs/151367 doc [patch] Update for puc.4 man page o docs/150991 doc [patch] Install upgtfw using pkg_add as advised in upg o docs/150917 doc [patch] icmp.4, wrong description of icmplim and icmpl o docs/150877 doc ambiguity in newsyslog(8) man page about zfs with comp o docs/150365 doc [make.conf] [patch] remove BDECFLAGS from make.conf(5) o docs/150255 doc dtrace description should mention makeoptions DEBUG=-g o docs/150219 doc zfs(8) manual page misses jail/unjail o docs/149574 doc [patch] update mi_switch(9) man page o docs/149522 doc Russian network article: incorrect translation about n o docs/149051 doc [request] No document for clang or clang++ o docs/149047 doc [patch] tcsh(1) bears no mention of brace expansion in o docs/148987 doc [patch] {MD[245]|SHA_|SHA1_|SHA256_}{End|File|FileChun o docs/148984 doc [handbook] Mistake in section 16.15.4 of the handbook o docs/148680 doc [sysctl][patch] Document some sys/kern sysctls o docs/148071 doc Failover mode between wired and wireless interfaces o docs/147995 doc elf.5 man page has has missing reference o docs/146958 doc bad link to "XaQti XMAC II datasheet" in sk(4) manual o docs/146521 doc [handbook] Update IPv6 system handbook section to ment o docs/145719 doc [patch] 7.3 relnotes erroneously describes new getpage o docs/145699 doc hexdump(1) mutes all format qualifier output following o docs/145644 doc Add artical about creating manpage from scratch o docs/145069 doc Dialup firewalling with FreeBSD article out dated. o docs/145067 doc Remove all reference to floppy installs o docs/145066 doc Update for new uart dev names for serial port. s docs/144818 doc all mailinglist archives dated 19970101 contain traili o docs/144630 doc [patch] domainname(1) manpage contains old information o docs/144537 doc Missing _mdconfig_list and _mdconfig2_list explanation o docs/144515 doc [handbook] Expand handbook Table of contents o docs/144488 doc share/examples/etc/make.conf: contains dangerous examp o docs/144408 doc [patch] update makefs(8) (remove device option) o docs/143850 doc procfs(5) manpage for status > controlling terminal is o docs/143416 doc [handbook] IPFW handbook page issues o docs/143408 doc man filedesc(9) is missing o docs/142168 doc [patch] ld(1): ldd(1) not mentioned in ld(1) manpage o docs/141032 doc misleading documentation for rtadvd.conf(5) raflags se s docs/140847 doc [request] add documentation on ECMP and new route args o docs/140457 doc [patch] Grammar fix for isspace(3) o docs/140444 doc [patch] New Traditional Chinese translation of custom- o docs/140375 doc [UPDATE] Updated zh_TW.Big5/articles/nanobsd o docs/139336 doc [request] ZFS documentation suggestion o docs/139165 doc gssapi.3 man page out of sync with between crypto and o docs/139018 doc translation of submitting.sgml from docproj/submitting o docs/138845 doc Exceeding kern.ipc.maxpipekva refers to tuning(7) whic o docs/138663 doc system(3) man page confuses users about "return value o docs/138485 doc bpf(4) and ip(4) man pages missing important corner ca o docs/136712 doc [handbook] [patch] draft new section on gmirror per pa o docs/136666 doc [handbook] Configure serial port for remote kernel deb o docs/136035 doc ftpchroot(5) omits an important option o docs/135516 doc [patch] pax(1) manual not mentioning chflags unawarene o docs/135475 doc [patch] jot(1) manpage and behaviour differ o docs/134123 doc The RUNQUEUE(9) man page is out of date o docs/132839 doc [patch] Fix example script in ldap-auth article o docs/132718 doc [handbook] Information about adding a new mirror is ou o docs/132260 doc dhcpd(8) pid not stored in documented location o docs/132190 doc EPERM explanation for send(2), sendto(2), and sendmsg( o docs/131918 doc [patch] Fixes for the BPF(4) man page o docs/131626 doc [patch] dump(8) "recommended" cache option confusing o docs/130238 doc nfs.lockd man page doesn't mention NFSLOCKD option or o docs/129671 doc New TCP chapter for Developer's Handbook (from rwatson o docs/129464 doc using packages system o docs/129095 doc ipfw(8): Can not check that packet originating/destine s docs/128356 doc [request] add Firefox plugin for FreeBSD manual pages o docs/127908 doc [patch] readdir(3) error documentation s docs/127844 doc Example code skeleton_capture_n.c in meteor(4) manpage o docs/126590 doc [patch] Write routine called forever in Sample Echo Ps o docs/126484 doc libc function res-zonscut2 is not documented o docs/125921 doc lpd(8) talks about blocks in minfree while it is KB in f docs/122052 doc minor update on handbook section 20.7.1 o docs/121952 doc Handbook chapter on Network Address Translation wrong o docs/121585 doc [handbook] Wrong multicast specification s docs/121541 doc [request] no man pages for wlan_scan_ap o docs/121312 doc RELNOTES_LANG breaks release if not en_US.ISO8859-1 o docs/121173 doc [patch] mq_getattr(2): mq_flags mistakenly described a s docs/120917 doc [request]: Man pages mising for thr_xxx syscalls o docs/120539 doc Inconsistent ipfw's man page o docs/120125 doc [patch] Installing FreeBSD 7.0 via serial console and o docs/120024 doc resolver(5) and hosts(5) need updated for IPv6 o docs/119545 doc books/arch-handbook/usb/chapter.sgml formatting o docs/118902 doc [patch] wrong signatures in d2i_RSAPublicKey man pages o docs/118214 doc close(2) error returns incomplete o docs/118020 doc ipfilter(4): man pages query for man 4 ipfilter return o docs/116116 doc mktemp (3) re/move note o docs/116080 doc PREFIX is documented, but not the more important LOCAL p docs/115065 doc [patch] sync ps.1 with p_flag and keywords o docs/114371 doc [patch] [ip6] rtadvd.con(5) should show how to adverti o docs/114139 doc mbuf(9) has misleading comments on M_DONTWAIT and M_TR o docs/113194 doc [patch] [request] crontab.5: handling of day-in-month o docs/112804 doc groff(1) command should be called to explicitly use "p o docs/112682 doc Handbook GEOM_GPT explanation does not provide accurat o docs/111425 doc Missing chunks of text in historical manpages o docs/111265 doc [request] Clarify how to set common shell variables o docs/111147 doc hostapd.conf is not documented o docs/110999 doc carp(4) should document unsupported interface types o docs/110692 doc wi(4) man page doesn't say WPA is not supported o docs/110376 doc [patch] add some more explanations for the iwi/ipw fir o docs/110253 doc [patch] rtprio(1): remove processing starvation commen o docs/110062 doc [patch] mount_nfs(8) fails to mention a failure condit p docs/110061 doc [patch] tuning(7) missing reference to vfs.read_max o docs/109981 doc No manual entry for post-grohtml o docs/109977 doc No manual entry for ksu o docs/109973 doc No manual entry for c++filt o docs/109972 doc No manual entry for zless/bzless f docs/109226 doc [request] No manual entry for sntp o docs/109201 doc [request]: manual for callbootd a docs/108980 doc list of missing man pages o docs/106135 doc [request] articles/vinum needs to be updated o docs/105608 doc fdc(4) debugging description staled o docs/104879 doc Howto: Listen to IMA ADPCM .wav files on FreeBSD box o docs/102719 doc [patch] ng_bpf(4) example leads to unneeded promiscuos o docs/100196 doc man login.conf does explain not "unlimited" o docs/99506 doc FreeBSD Handbook addition: IPv6 Server Settings o docs/98974 doc Missing tunables in loader(8) manpage o docs/98115 doc Missing parts after rendering handbook to RTF format o docs/96207 doc Comments of a sockaddr_un structure could confuse one o docs/94625 doc [patch] growfs man page -- document "panic: not enough o docs/92626 doc jail manpage should mention disabling some periodic sc o docs/91506 doc ndis(4) man page should be more specific about support o docs/91149 doc read(2) can return EINVAL for unaligned access to bloc o docs/88512 doc [patch] mount_ext2fs(8) man page has no details on lar o docs/87936 doc Handbook chapter on NIS/YP lacks good information on a o docs/87857 doc ifconfig(8) wireless options order matters o docs/85128 doc [patch] loader.conf(5) autoboot_delay incompletly desc o docs/84956 doc [patch] intro(5) manpage doesn't mention API coverage o docs/84932 doc new document: printing with an Epson ALC-3000N on Free o docs/84670 doc [patch] tput(1) manpage missing ENVIRONMENT section wi o docs/84317 doc fdp-primer doesn't show class=USERNAME distinctively o docs/84271 doc [patch] compress(1) doesn't warn about nasty link hand o docs/83820 doc getino(3) manpage not installed o docs/81611 doc [patch] natd runs with -same_ports by default o docs/78480 doc Networked printer setup unnecessarily complex in handb o docs/61605 doc [request] Improve documentation for i386 disk geometry o docs/61301 doc [patch] Manpage patch for aue(4) to enable HomePNA fun o docs/59835 doc ipfw(8) man page does not warn about accepted but mean o docs/59477 doc Outdated Info Documents at http://docs.freebsd.org/inf o docs/59044 doc [patch] doc.docbook.mk does not properly handle a sour s docs/54752 doc bus_dma explained in ISA section in Handbook: should b o docs/53751 doc bus_dma(9) incorrectly documents BUS_DMA_ALLOCNOW o docs/53596 doc Updates to mt(1) manual page o docs/53271 doc bus_dma(9) fails to document alignment restrictions o docs/51480 doc Multiple undefined references in the FreeBSD manual pa o docs/50211 doc [patch] doc.docbook.mk: fix textfile creation o docs/48101 doc [patch] Add documentation on the fixit disk o docs/43823 doc [patch] update to environ(7) manpage o docs/41089 doc pax(1) -B option does not mention interaction with -z o docs/40423 doc Keyboard(4)'s definition of parameters to GETFKEY/SETF o docs/38982 doc [patch] developers-handbook/Jail fix o docs/38556 doc EPS file of beastie, as addition to existing examples s docs/35678 doc docproj Makefiles for web are broken for paths with sp s docs/33589 doc [patch] to doc.docbook.mk to post process .tex files. a docs/30008 doc [patch] French softupdates document should be translat o docs/27605 doc [patch] Cross-document references () o docs/26286 doc *printf(3) etc should gain format string warnings o docs/24786 doc missing FILES descriptions in sa(4) s docs/20028 doc ASCII docs should reflect tags in the sourc 194 problems total. From owner-freebsd-doc@FreeBSD.ORG Mon Aug 29 16:50:06 2011 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id D7DBE106564A for ; Mon, 29 Aug 2011 16:50:06 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id AD4EC8FC18 for ; Mon, 29 Aug 2011 16:50:06 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id p7TGo6Uf007973 for ; Mon, 29 Aug 2011 16:50:06 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id p7TGo6PX007972; Mon, 29 Aug 2011 16:50:06 GMT (envelope-from gnats) Resent-Date: Mon, 29 Aug 2011 16:50:06 GMT Resent-Message-Id: <201108291650.p7TGo6PX007972@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Isabell Long Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 61F47106564A for ; Mon, 29 Aug 2011 16:46:42 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from red.freebsd.org (red.freebsd.org [IPv6:2001:4f8:fff6::22]) by mx1.freebsd.org (Postfix) with ESMTP id 378D28FC1D for ; Mon, 29 Aug 2011 16:46:42 +0000 (UTC) Received: from red.freebsd.org (localhost [127.0.0.1]) by red.freebsd.org (8.14.4/8.14.4) with ESMTP id p7TGkfAV084026 for ; Mon, 29 Aug 2011 16:46:41 GMT (envelope-from nobody@red.freebsd.org) Received: (from nobody@localhost) by red.freebsd.org (8.14.4/8.14.4/Submit) id p7TGkf7q084025; Mon, 29 Aug 2011 16:46:41 GMT (envelope-from nobody) Message-Id: <201108291646.p7TGkf7q084025@red.freebsd.org> Date: Mon, 29 Aug 2011 16:46:41 GMT From: Isabell Long To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/160284: [patch] Inconsistent spacing between colons in French translation of Dtrace Handbook chapter. X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 29 Aug 2011 16:50:07 -0000 >Number: 160284 >Category: docs >Synopsis: [patch] Inconsistent spacing between colons in French translation of Dtrace Handbook chapter. >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Mon Aug 29 16:50:06 UTC 2011 >Closed-Date: >Last-Modified: >Originator: Isabell Long >Release: >Organization: >Environment: >Description: I was just reading through the recently committed French translation of the Dtrace Handbook chapter and noticed a few punctuation inconsistencies that I hadn't picked up on when I proofread my translation. Sometimes, there is no space before a colon, but at other times there is. For other French translations, convention seems to be no space before a colon. The attached patch fixes these inconsistencies for this document. >How-To-Repeat: >Fix: See attached patch. Patch attached with submission follows: Index: chapter.sgml =================================================================== RCS file: /home/isabell/freebsd/doc-cvs/doc/fr_FR.ISO8859-1/books/handbook/dtrace/chapter.sgml,v retrieving revision 1.1 diff -u -r1.1 chapter.sgml --- chapter.sgml 13 Jun 2011 16:22:06 -0000 1.1 +++ chapter.sgml 29 Aug 2011 16:41:46 -0000 @@ -190,7 +190,7 @@ Les utilisateurs de l'architecture AMD64 devraient ajouter la ligne suivante à leur fichier de configuration de - noyau : + noyau: options KDTRACE_FRAME @@ -251,7 +251,7 @@ Le système devrait maintenant supporter &dtrace;. Pour afficher toutes les sondes, l'administrateur peut - maintenant executer la commande : + maintenant executer la commande: &prompt.root; dtrace -l | more @@ -267,7 +267,7 @@ des informations systèmes. Il y a des scripts pour vérifier les fichiers ouvertes, la mémoire, l'usage du CPU et beaucoup plus. Il faut - extraire les scripts avec la commande suivante : + extraire les scripts avec la commande suivante: &prompt.root; gunzip -c DTracetoolkit* | tar xvf - >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Mon Aug 29 17:00:28 2011 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 5F03A106568B for ; Mon, 29 Aug 2011 17:00:28 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 3463C8FC17 for ; Mon, 29 Aug 2011 17:00:28 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id p7TH0SmX016461 for ; Mon, 29 Aug 2011 17:00:28 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id p7TH0SU8016460; Mon, 29 Aug 2011 17:00:28 GMT (envelope-from gnats) Date: Mon, 29 Aug 2011 17:00:28 GMT Message-Id: <201108291700.p7TH0SU8016460@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Chris Rees Cc: Subject: Re: docs/160284: [patch] Inconsistent spacing between colons in French translation of Dtrace Handbook chapter. X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Chris Rees List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 29 Aug 2011 17:00:28 -0000 The following reply was made to PR docs/160284; it has been noted by GNATS. From: Chris Rees To: Isabell Long Cc: bug-followup@freebsd.org Subject: Re: docs/160284: [patch] Inconsistent spacing between colons in French translation of Dtrace Handbook chapter. Date: Mon, 29 Aug 2011 17:56:12 +0100 I may be incorrect here, but IIRC aren't "les deux-points" space padded in French? As in, you've corrected the correct versions? Chris From owner-freebsd-doc@FreeBSD.ORG Mon Aug 29 17:40:13 2011 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 8A017106564A for ; Mon, 29 Aug 2011 17:40:13 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 793958FC16 for ; Mon, 29 Aug 2011 17:40:13 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id p7THeD6u054044 for ; Mon, 29 Aug 2011 17:40:13 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id p7THeDOv054043; Mon, 29 Aug 2011 17:40:13 GMT (envelope-from gnats) Date: Mon, 29 Aug 2011 17:40:13 GMT Message-Id: <201108291740.p7THeDOv054043@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Isabell Long Cc: Subject: Re: docs/160284: [patch] Inconsistent spacing between colons in French translation of Dtrace Handbook chapter. X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Isabell Long List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 29 Aug 2011 17:40:13 -0000 The following reply was made to PR docs/160284; it has been noted by GNATS. From: Isabell Long To: Chris Rees Cc: bug-followup@freebsd.org Subject: Re: docs/160284: [patch] Inconsistent spacing between colons in French translation of Dtrace Handbook chapter. Date: Mon, 29 Aug 2011 18:05:45 +0100 (BST) Hi, On Mon, 29 Aug 2011, Chris Rees wrote: > I may be incorrect here, but IIRC aren't "les deux-points" space > padded in French? As in, you've corrected the correct versions? I thought so too, but it seems from translations of other chapters and some edits to this chapter after I sent it to be committed, that convention is not to put spaces before them. I just removed the three spaces that had not been removed previously, but pretty obviously should have been. :-) Isabell. From owner-freebsd-doc@FreeBSD.ORG Mon Aug 29 19:50:07 2011 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 83B99106564A for ; Mon, 29 Aug 2011 19:50:07 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 6EE608FC13 for ; Mon, 29 Aug 2011 19:50:07 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id p7TJo74b072270 for ; Mon, 29 Aug 2011 19:50:07 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id p7TJo7BO072269; Mon, 29 Aug 2011 19:50:07 GMT (envelope-from gnats) Date: Mon, 29 Aug 2011 19:50:07 GMT Message-Id: <201108291950.p7TJo7BO072269@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Marc Fonvieille Cc: Subject: Re: docs/160284: [patch] Inconsistent spacing between colons in French translation of Dtrace Handbook chapter. X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Marc Fonvieille List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 29 Aug 2011 19:50:07 -0000 The following reply was made to PR docs/160284; it has been noted by GNATS. From: Marc Fonvieille To: Isabell Long Cc: bug-followup@freebsd.org Subject: Re: docs/160284: [patch] Inconsistent spacing between colons in French translation of Dtrace Handbook chapter. Date: Mon, 29 Aug 2011 21:45:18 +0200 On Mon, Aug 29, 2011 at 05:40:13PM +0000, Isabell Long wrote: > The following reply was made to PR docs/160284; it has been noted by GNATS. > > From: Isabell Long > To: Chris Rees > Cc: bug-followup@freebsd.org > Subject: Re: docs/160284: [patch] Inconsistent spacing between colons in > French translation of Dtrace Handbook chapter. > Date: Mon, 29 Aug 2011 18:05:45 +0100 (BST) > > Hi, > > On Mon, 29 Aug 2011, Chris Rees wrote: > > > I may be incorrect here, but IIRC aren't "les deux-points" space > > padded in French? As in, you've corrected the correct versions? > > I thought so too, but it seems from translations of other chapters and > some edits to this chapter after I sent it to be committed, that > convention is not to put spaces before them. I just removed the three > spaces that had not been removed previously, but pretty obviously should > have been. :-) > The spaces (non-breaking space for a colon) should be added during the conversion from SGML to the final format (if the stylesheet is correct, etc.) and should not be present in the source code. In french there are many different spaces, it'd be very painful/difficult to add them in the source code, it's the stylesheet job. The same principle is used when you type a LaTeX document: you don't have to worry about spaces if you added \usepackage[frenchb]{babel} for example. I missed these spaces before the check-in. Regarding the rendering of the French, last time I really looked at it there was issues but it was about 10 years ago... and no time to go further. -- Marc From owner-freebsd-doc@FreeBSD.ORG Tue Aug 30 01:53:18 2011 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id ED2821065673; Tue, 30 Aug 2011 01:53:18 +0000 (UTC) (envelope-from kaduk@mit.edu) Received: from dmz-mailsec-scanner-1.mit.edu (DMZ-MAILSEC-SCANNER-1.MIT.EDU [18.9.25.12]) by mx1.freebsd.org (Postfix) with ESMTP id 8B5A08FC15; Tue, 30 Aug 2011 01:53:17 +0000 (UTC) X-AuditID: 1209190c-b7bdeae000000a26-ef-4e5c425466d1 Received: from mailhub-auth-3.mit.edu ( [18.9.21.43]) by dmz-mailsec-scanner-1.mit.edu (Symantec Messaging Gateway) with SMTP id F0.7E.02598.4524C5E4; Mon, 29 Aug 2011 21:52:20 -0400 (EDT) Received: from outgoing.mit.edu (OUTGOING-AUTH.MIT.EDU [18.7.22.103]) by mailhub-auth-3.mit.edu (8.13.8/8.9.2) with ESMTP id p7U1rG8S019089; Mon, 29 Aug 2011 21:53:16 -0400 Received: from multics.mit.edu (MULTICS.MIT.EDU [18.187.1.73]) (authenticated bits=56) (User authenticated as kaduk@ATHENA.MIT.EDU) by outgoing.mit.edu (8.13.6/8.12.4) with ESMTP id p7U1rESG010208 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Mon, 29 Aug 2011 21:53:15 -0400 (EDT) Received: (from kaduk@localhost) by multics.mit.edu (8.12.9.20060308) id p7U1rDOg023943; Mon, 29 Aug 2011 21:53:13 -0400 (EDT) Date: Mon, 29 Aug 2011 21:53:13 -0400 (EDT) From: Benjamin Kaduk To: Warren Block In-Reply-To: Message-ID: References: <201108290130.p7T1UFLj020449@freefall.freebsd.org> User-Agent: Alpine 1.10 (GSO 962 2008-03-14) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; format=flowed; charset=US-ASCII X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFmpmleLIzCtJLcpLzFFi42IR4hTV1g1xivEz2PRBw2Lj5ONsFqfOdLFa /DrlYbH++zJGBxaPGZ/ms3jsnHWX3eNIxyPGAOYoLpuU1JzMstQifbsEroy/j+oLzCv+z/rF 3MCo2cXIySEhYCJx5/oSVghbTOLCvfVsXYxcHEIC+xglzh2czgThbGCUaHy+kR2kSkjgAJPE /n9CEIkGRoldU5+AJVgEtCUOb97LBGKzCahIzHyzEWgUB4eIgKrE3jPWIGFmgWSJn9tbWUBs YYEIia2zf4O1cgrYSaye2gZ2Ba+Ag8S9v4eYIHYVSGy8OhWsXlRAR2L1/iksEDWCEidnPmGB mGkp8W/tL9YJjIKzkKRmIUktYGRaxSibklulm5uYmVOcmqxbnJyYl5dapGuol5tZopeaUrqJ ERy+kjw7GN8cVDrEKMDBqMTD+/lctJ8Qa2JZcWXuIUZJDiYlUd67jjF+QnxJ+SmVGYnFGfFF pTmpxYcYJTiYlUR4b6gB5XhTEiurUovyYVLSHCxK4rwHdzj4CQmkJ5akZqemFqQWwWRlODiU JHjvgQwVLEpNT61Iy8wpQUgzcXCCDOcBGQ5Sw1tckJhbnJkOkT/FqMux+crnY4xCLHn5ealS 4rwvQIoEQIoySvPg5sDSzitGcaC3hHklgElIiAeYsuAmvQJawgS05JJhNMiSkkSElFQD4wKh 4nP6D898Y9nGa8h+ISM6/5G3zut1L0JLTnLkcEwyY38w88TpaRe/OjqvFlvrFVuW1fuoclrN gqziLyeNwtf01Vx9tO5BqASzZ9fXmkTt3r3MC9ufMC6ftjpP6s6nLJWVdfP5erynnG0szff8 tyjo77/T695cmLnx8z91zx1rQkMCTa7VMSmxFGckGmoxFxUnAgDdU1YjFgMAAA== Cc: freebsd-doc@freebsd.org, bug-followup@freebsd.org Subject: Re: docs/160269: [patch] Handbook wireless section: sand off some rough edges X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 30 Aug 2011 01:53:19 -0000 Looks good; thanks for doing the follow-up! -Ben From owner-freebsd-doc@FreeBSD.ORG Tue Aug 30 02:00:29 2011 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 04A2C106566B for ; Tue, 30 Aug 2011 02:00:29 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id CFABE8FC19 for ; Tue, 30 Aug 2011 02:00:28 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id p7U20Sso016044 for ; Tue, 30 Aug 2011 02:00:28 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id p7U20SiT016043; Tue, 30 Aug 2011 02:00:28 GMT (envelope-from gnats) Date: Tue, 30 Aug 2011 02:00:28 GMT Message-Id: <201108300200.p7U20SiT016043@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Benjamin Kaduk Cc: Subject: Re: docs/160269: [patch] Handbook wireless section: sand off some rough edges X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Benjamin Kaduk List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 30 Aug 2011 02:00:29 -0000 The following reply was made to PR docs/160269; it has been noted by GNATS. From: Benjamin Kaduk To: Warren Block Cc: Garrett Cooper , freebsd-doc@freebsd.org, bug-followup@freebsd.org Subject: Re: docs/160269: [patch] Handbook wireless section: sand off some rough edges Date: Mon, 29 Aug 2011 21:53:13 -0400 (EDT) Looks good; thanks for doing the follow-up! -Ben From owner-freebsd-doc@FreeBSD.ORG Tue Aug 30 05:50:12 2011 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 3DCDD106564A; Tue, 30 Aug 2011 05:50:12 +0000 (UTC) (envelope-from crodr001@gmail.com) Received: from mail-bw0-f54.google.com (mail-bw0-f54.google.com [209.85.214.54]) by mx1.freebsd.org (Postfix) with ESMTP id 692938FC1C; Tue, 30 Aug 2011 05:50:10 +0000 (UTC) Received: by bkat8 with SMTP id t8so6441398bka.13 for ; Mon, 29 Aug 2011 22:50:10 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=mime-version:sender:date:x-google-sender-auth:message-id:subject :from:to:cc:content-type; bh=QJ+2zEops58uf0NJE0ziojh86d/tve4OC03orjsZhgE=; b=u9NCUC6zSPhW1mLDe1WKIJUT05IBMnqLVOJs5tExyJUbsAeOICn0A7s0ClkAoI5CbX LgnUnCsL0F4o09cLsMvZSMtqSqisVXCREX+p/3QsUKOxAJZ0/1TsZQIG+bE8eL8817PY 3MRxvGJS7dzPvdrbVwEOhOehI85vl5hnC6F4E= MIME-Version: 1.0 Received: by 10.204.6.201 with SMTP id a9mr2486342bka.335.1314681553298; Mon, 29 Aug 2011 22:19:13 -0700 (PDT) Sender: crodr001@gmail.com Received: by 10.204.49.144 with HTTP; Mon, 29 Aug 2011 22:19:13 -0700 (PDT) Date: Mon, 29 Aug 2011 22:19:13 -0700 X-Google-Sender-Auth: azRujpTwa4kiZmXrrcxgg8lgyuc Message-ID: From: Craig Rodrigues To: freebsd-doc@freebsd.org Content-Type: text/plain; charset=ISO-8859-1 Cc: kan@FreeBSD.org, rmacklem@Freebsd.org, alfred@FreeBSD.org Subject: PXE Booting with an NFS root file system X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 30 Aug 2011 05:50:12 -0000 Hi, A few years ago, I needed to set up a PXE boot with NFS root file system for FreeBSD. I found the FreeBSD docs for setting this up scattered all over the place, and it took me a while to figure everything out how to set up all the individual pieces, debug it, and get things working. I captured my notes in this text file: http://people.freebsd.org/~rodrigc/pxe/freebsd-pxe.txt I would like to contribute this back to the FreeBSD Documentation project as a new section of the FreeBSD Handbook. This is my first attempt at SGML Docbook: http://people.freebsd.org/~rodrigc/doc/doc/en_US.ISO8859-1/books/handbook/network-pxe-nfs.html and the patch is here: http://people.freebsd.org/~rodrigc/nfs-pxe.diff.txt Can I get some feedback on this? If it is OK, can I commit it? I don't normally commit to src/doc. Thanks. -- Craig Rodrigues rodrigc@crodrigues.org From owner-freebsd-doc@FreeBSD.ORG Tue Aug 30 06:19:15 2011 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 5FEA9106564A; Tue, 30 Aug 2011 06:19:15 +0000 (UTC) (envelope-from yanegomi@gmail.com) Received: from mail-yi0-f54.google.com (mail-yi0-f54.google.com [209.85.218.54]) by mx1.freebsd.org (Postfix) with ESMTP id E85778FC08; Tue, 30 Aug 2011 06:19:14 +0000 (UTC) Received: by yib19 with SMTP id 19so4925389yib.13 for ; Mon, 29 Aug 2011 23:19:14 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=date:from:to:cc:subject:in-reply-to:message-id:references :user-agent:mime-version:content-type; bh=924M4aekzq0erLu9i6WV3cBQd8GJlv3LaNJtq8xIKHk=; b=RaQxeHuK54+HiOTkqhmJh3Dblu9RRWiRR/S9SV12e12aL1XT+PBhyPvoe/7tfu0dzK K0WSt9T/2LWHwRFpmCTpSuvqNCuRqQVck/JS5D5fIzrGYFgSjCBMGmpQTrfP9xOYjW34 6PcgDjYW2rNp/i7mET81zugHzWUQVS0nykUGQ= Received: by 10.43.134.69 with SMTP id ib5mr5168720icc.284.1314684736344; Mon, 29 Aug 2011 23:12:16 -0700 (PDT) Received: from c-24-6-49-154.hsd1.ca.comcast.net (c-24-6-49-154.hsd1.ca.comcast.net [24.6.49.154]) by mx.google.com with ESMTPS id m21sm2998924ibf.42.2011.08.29.23.12.14 (version=TLSv1/SSLv3 cipher=OTHER); Mon, 29 Aug 2011 23:12:15 -0700 (PDT) Date: Mon, 29 Aug 2011 23:12:13 -0700 (PDT) From: Garrett Cooper To: Craig Rodrigues In-Reply-To: Message-ID: References: User-Agent: Alpine 2.00 (BSF 1167 2008-08-23) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed Cc: kan@freebsd.org, rmacklem@freebsd.org, freebsd-doc@freebsd.org, alfred@freebsd.org Subject: Re: PXE Booting with an NFS root file system X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 30 Aug 2011 06:19:15 -0000 On Mon, 29 Aug 2011, Garrett Cooper wrote: > On Mon, 29 Aug 2011, Craig Rodrigues wrote: > >> Hi, >> >> A few years ago, I needed to set up a PXE boot with NFS root file >> system for FreeBSD. I found >> the FreeBSD docs for setting this up scattered all over the place, and it >> took me a while to figure everything out how to set up >> all the individual pieces, debug it, and get things working. >> >> I captured my notes in this text file: >> >> http://people.freebsd.org/~rodrigc/pxe/freebsd-pxe.txt >> >> I would like to contribute this back to the FreeBSD Documentation project >> as >> a new section of the FreeBSD Handbook. This is my first attempt >> at SGML Docbook: >> >> http://people.freebsd.org/~rodrigc/doc/doc/en_US.ISO8859-1/books/handbook/network-pxe-nfs.html >> >> and the patch is here: >> >> http://people.freebsd.org/~rodrigc/nfs-pxe.diff.txt >> >> >> Can I get some feedback on this? If it is OK, can I commit it? I >> don't normally commit to src/doc. > > A lot of this document could point to other documentation, in particular: > > - http://www.freebsd.org/doc/handbook/boot.html > - http://www.freebsd.org/doc/handbook/makeworld.htmlC > - http://www.freebsd.org/doc/handbook/network-inetd.html > - http://www.freebsd.org/doc/handbook/network-dhcp.html > > 31.8.1: > > 5. Assuming that inetd.conf is vanilla, all you need to do is uncomment > the line with '^#tftp' in it. > > 9. mergemaster does some magic that make distribution doesn't. > > 31.8.3: > > 1. isc-dhcp30-server is no longer available in ports / as a package. It > should be isc-dhcp31-server, isc-dhcp41-server, or isc-dhcp42-server. > > 31.8.4: > > - Should suggest that users read loader(8). Poking through the handbook some more, this might be a good home for the doc: http://www.freebsd.org/doc/handbook/network-diskless.html . Cheers, -Garrett From owner-freebsd-doc@FreeBSD.ORG Tue Aug 30 06:30:59 2011 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 467CF106564A; Tue, 30 Aug 2011 06:30:59 +0000 (UTC) (envelope-from yanegomi@gmail.com) Received: from mail-gx0-f182.google.com (mail-gx0-f182.google.com [209.85.161.182]) by mx1.freebsd.org (Postfix) with ESMTP id D00918FC0A; Tue, 30 Aug 2011 06:30:58 +0000 (UTC) Received: by gxk28 with SMTP id 28so6493880gxk.13 for ; Mon, 29 Aug 2011 23:30:58 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=date:from:to:cc:subject:in-reply-to:message-id:references :user-agent:mime-version:content-type; bh=hyZgi2pzpYWzodDyQNdqevjkD7zA1Pw6d/GEonbet7Y=; b=oFhZBjbA4XyiJfnc54+rLjZFnDJj7+xuoY3drcsAVZ8nm2Tv8/huBvzgIis3oDw/j/ ST96QQxZ0om0ZcFH7RREGQ3oGAWUuBM8hHgJUacJT/NYQ/FHOfTrQtxgQc9pcMT14zsn iMoSqUaCRy3/PDt6OWAXdtPAEb6U1ENqi5xEk= Received: by 10.42.115.202 with SMTP id l10mr5779992icq.375.1314684516922; Mon, 29 Aug 2011 23:08:36 -0700 (PDT) Received: from c-24-6-49-154.hsd1.ca.comcast.net (c-24-6-49-154.hsd1.ca.comcast.net [24.6.49.154]) by mx.google.com with ESMTPS id a18sm2999898iba.3.2011.08.29.23.08.34 (version=TLSv1/SSLv3 cipher=OTHER); Mon, 29 Aug 2011 23:08:35 -0700 (PDT) Date: Mon, 29 Aug 2011 23:08:27 -0700 (PDT) From: Garrett Cooper To: Craig Rodrigues In-Reply-To: Message-ID: References: User-Agent: Alpine 2.00 (BSF 1167 2008-08-23) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed Cc: kan@freebsd.org, rmacklem@freebsd.org, freebsd-doc@freebsd.org, alfred@freebsd.org Subject: Re: PXE Booting with an NFS root file system X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 30 Aug 2011 06:30:59 -0000 On Mon, 29 Aug 2011, Craig Rodrigues wrote: > Hi, > > A few years ago, I needed to set up a PXE boot with NFS root file > system for FreeBSD. I found > the FreeBSD docs for setting this up scattered all over the place, and it > took me a while to figure everything out how to set up > all the individual pieces, debug it, and get things working. > > I captured my notes in this text file: > > http://people.freebsd.org/~rodrigc/pxe/freebsd-pxe.txt > > I would like to contribute this back to the FreeBSD Documentation project as > a new section of the FreeBSD Handbook. This is my first attempt > at SGML Docbook: > > http://people.freebsd.org/~rodrigc/doc/doc/en_US.ISO8859-1/books/handbook/network-pxe-nfs.html > > and the patch is here: > > http://people.freebsd.org/~rodrigc/nfs-pxe.diff.txt > > > Can I get some feedback on this? If it is OK, can I commit it? I > don't normally commit to src/doc. A lot of this document could point to other documentation, in particular: - http://www.freebsd.org/doc/handbook/boot.html - http://www.freebsd.org/doc/handbook/makeworld.htmlC - http://www.freebsd.org/doc/handbook/network-inetd.html - http://www.freebsd.org/doc/handbook/network-dhcp.html 31.8.1: 5. Assuming that inetd.conf is vanilla, all you need to do is uncomment the line with '^#tftp' in it. 9. mergemaster does some magic that make distribution doesn't. 31.8.3: 1. isc-dhcp30-server is no longer available in ports / as a package. It should be isc-dhcp31-server, isc-dhcp41-server, or isc-dhcp42-server. 31.8.4: - Should suggest that users read loader(8). Thanks! -Garrett From owner-freebsd-doc@FreeBSD.ORG Tue Aug 30 08:25:12 2011 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 208C11065745; Tue, 30 Aug 2011 08:25:12 +0000 (UTC) (envelope-from crodr001@gmail.com) Received: from mail-bw0-f54.google.com (mail-bw0-f54.google.com [209.85.214.54]) by mx1.freebsd.org (Postfix) with ESMTP id 228968FC12; Tue, 30 Aug 2011 08:25:10 +0000 (UTC) Received: by bkat8 with SMTP id t8so6565219bka.13 for ; Tue, 30 Aug 2011 01:25:10 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=mime-version:sender:in-reply-to:references:date :x-google-sender-auth:message-id:subject:from:to:cc:content-type :content-transfer-encoding; bh=v/auU4q+P55ZgOKsuvxY783SvwI1dAMoiAdoUbetOuk=; b=cyQvqdlMiaYGmWUPYv9p02sU9VkMZux/81RqsD1L2JAZgCE8TSCVkxsDAEd8l1IeOY qhr99uVjg8YuHcCq6mojfOycdOx3BxUAeATd8VtF/KS5mntZWvqb+zkVFFbpjuAGprFI Dt6hFAiuKH1L+lMTFL7cKZiMfvSDeYyNIc9vo= MIME-Version: 1.0 Received: by 10.204.136.194 with SMTP id s2mr939668bkt.23.1314692709887; Tue, 30 Aug 2011 01:25:09 -0700 (PDT) Sender: crodr001@gmail.com Received: by 10.204.49.144 with HTTP; Tue, 30 Aug 2011 01:25:09 -0700 (PDT) In-Reply-To: References: Date: Tue, 30 Aug 2011 01:25:09 -0700 X-Google-Sender-Auth: oI8SXfnxfvym7CSQ8n7HQ3r3igk Message-ID: From: Craig Rodrigues To: Garrett Cooper Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: quoted-printable Cc: kan@freebsd.org, rmacklem@freebsd.org, freebsd-doc@freebsd.org, alfred@freebsd.org Subject: Re: PXE Booting with an NFS root file system X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 30 Aug 2011 08:25:12 -0000 Hi, Thanks, I have incorporated most of your feedback and have updated the page= : http://people.freebsd.org/~rodrigc/doc/doc/en_US.ISO8859-1/books/handbook/n= etwork-pxe-nfs.html and patch: http://people.freebsd.org/~rodrigc/pxe/freebsd-pxe.txt I originally thought about modifying the existing : http://www.freebsd.org/doc/handbook/network-diskless.html page, but decided to make a separate one, that could be easily hyperlinked = to. The network-diskless.html page is good, but I found that it has too much general information on diskless booting, and covers many topics, such as Etherboot. Having a separate page dedicated to PXE + NFS root make the information easier to find and hyperlink to is useful. I hope to help people doing bringup/board work with FreeBSD, where this kind of information is handy. -- Craig Rodrigues rodrigc@crodrigues.org On Mon, Aug 29, 2011 at 11:08 PM, Garrett Cooper wrote= : > > A lot of this document could point to other documentation, in particular: > > - http://www.freebsd.org/doc/handbook/boot.html > - http://www.freebsd.org/doc/handbook/makeworld.htmlC > - http://www.freebsd.org/doc/handbook/network-inetd.html > - http://www.freebsd.org/doc/handbook/network-dhcp.html > > 31.8.1: > > 5. Assuming that inetd.conf is vanilla, all you need to do is uncomment > =A0 the line with '^#tftp' in it. > > 9. mergemaster does some magic that make distribution doesn't. > > 31.8.3: > > 1. isc-dhcp30-server is no longer available in ports / as a package. It > =A0 should be isc-dhcp31-server, isc-dhcp41-server, or isc-dhcp42-server. > > 31.8.4: > > - Should suggest that users read loader(8). > > Thanks! > -Garrett > --=20 Craig Rodrigues rodrigc@crodrigues.org From owner-freebsd-doc@FreeBSD.ORG Tue Aug 30 14:41:20 2011 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 1A37F1065674; Tue, 30 Aug 2011 14:41:20 +0000 (UTC) (envelope-from wblock@wonkity.com) Received: from wonkity.com (wonkity.com [67.158.26.137]) by mx1.freebsd.org (Postfix) with ESMTP id C9D2F8FC1D; Tue, 30 Aug 2011 14:41:19 +0000 (UTC) Received: from wonkity.com (localhost [127.0.0.1]) by wonkity.com (8.14.5/8.14.5) with ESMTP id p7UEf9OZ047083; Tue, 30 Aug 2011 08:41:09 -0600 (MDT) (envelope-from wblock@wonkity.com) Received: from localhost (wblock@localhost) by wonkity.com (8.14.5/8.14.5/Submit) with ESMTP id p7UEf9ep047080; Tue, 30 Aug 2011 08:41:09 -0600 (MDT) (envelope-from wblock@wonkity.com) Date: Tue, 30 Aug 2011 08:41:09 -0600 (MDT) From: Warren Block To: Craig Rodrigues In-Reply-To: Message-ID: References: User-Agent: Alpine 2.00 (BSF 1167 2008-08-23) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.2.7 (wonkity.com [127.0.0.1]); Tue, 30 Aug 2011 08:41:09 -0600 (MDT) Cc: kan@freebsd.org, rmacklem@freebsd.org, freebsd-doc@freebsd.org, alfred@freebsd.org Subject: Re: PXE Booting with an NFS root file system X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 30 Aug 2011 14:41:20 -0000 On Mon, 29 Aug 2011, Craig Rodrigues wrote: > http://people.freebsd.org/~rodrigc/doc/doc/en_US.ISO8859-1/books/handbook/network-pxe-nfs.html > > and the patch is here: > > http://people.freebsd.org/~rodrigc/nfs-pxe.diff.txt > > > Can I get some feedback on this? Overall, looks quite good. A few minor suggestions: 31.8.1 "5. Enable inetd" Use &man.inetd.8; instead of plain "inetd". Might be needed for other commands, or at least the first mention of them. "11. Replace "myhost.mydomain.com" with the hostname" Use myhost.example.com, maybe also use it in the programlisting. "14. Customize the ${NFSROOTDIR} in a chroot environment by" Can be read three ways: 1. "Customize the ${NFSROOTDIR}-in-a-chroot-environment by" 2. "Customize the ${NFSROOTDIR}-in-a-chroot's environment by" 3. "Customize the ${NFSROOTDIR} by using a chroot environment" Some rearrangement of that sentence could help. Thanks! From owner-freebsd-doc@FreeBSD.ORG Wed Aug 31 16:04:21 2011 Return-Path: Delivered-To: doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id C7782106566C for ; Wed, 31 Aug 2011 16:04:21 +0000 (UTC) (envelope-from simon@nitro.dk) Received: from emx.nitro.dk (emx.nitro.dk [IPv6:2a01:4f8:120:7384::102]) by mx1.freebsd.org (Postfix) with ESMTP id 8A25A8FC1B for ; Wed, 31 Aug 2011 16:04:21 +0000 (UTC) Received: from mailscan.leto.nitro.dk (mailscan.leto.nitro.dk [127.0.1.4]) by emx.nitro.dk (Postfix) with ESMTP id EC26DD5A04; Wed, 31 Aug 2011 16:04:20 +0000 (UTC) Received: from emx.nitro.dk ([127.0.1.2]) by mailscan.leto.nitro.dk (mailscan.leto.nitro.dk [127.0.1.4]) (amavisd-new, port 10024) with LMTP id v85B525kEqxs; Wed, 31 Aug 2011 16:04:19 +0000 (UTC) Received: from [192.168.4.21] (4304ds2-vlb.1.fullrate.dk [90.184.171.166]) (using TLSv1 with cipher AES128-SHA (128/128 bits)) (No client certificate requested) by emx.nitro.dk (Postfix) with ESMTPSA id 1925AD59FE; Wed, 31 Aug 2011 16:04:19 +0000 (UTC) Mime-Version: 1.0 (Apple Message framework v1244.3) Content-Type: text/plain; charset=iso-8859-1 From: "Simon L. B. Nielsen" In-Reply-To: <4E4FC2C8.60106@uiowa.edu> Date: Wed, 31 Aug 2011 18:04:18 +0200 Content-Transfer-Encoding: quoted-printable Message-Id: <9193A24C-CEA2-4CF9-B8B3-4D7402C1843F@nitro.dk> References: <4E4FC2C8.60106@uiowa.edu> To: Scott Allendorf X-Mailer: Apple Mail (2.1244.3) Cc: doc@freebsd.org Subject: Re: Docs on FTP site? X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 31 Aug 2011 16:04:21 -0000 On 20 Aug 2011, at 16:20, Scott Allendorf wrote: > The formatted docs located in the /pub/FreeBSD/doc/en directory at = ftp.freebsd.org have not been updated since mid-April. Is this = intentional or has a cron job gotten stuck somewhere? This is my bad and unintentional - sort of. The server which built it = was rather old and got decommissioned with the intend of moving the = build to our new web server... and then I forgot again. I will try to = get it fixed soon. --=20 Simon L. B. Nielsen Hat: FreeBSD.org admins team From owner-freebsd-doc@FreeBSD.ORG Wed Aug 31 18:40:05 2011 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 8BABB1065672 for ; Wed, 31 Aug 2011 18:40:05 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 6392A8FC17 for ; Wed, 31 Aug 2011 18:40:05 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id p7VIe51H049570 for ; Wed, 31 Aug 2011 18:40:05 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id p7VIe5Mc049569; Wed, 31 Aug 2011 18:40:05 GMT (envelope-from gnats) Resent-Date: Wed, 31 Aug 2011 18:40:05 GMT Resent-Message-Id: <201108311840.p7VIe5Mc049569@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, David Wolfskill Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 0CCEB1065672 for ; Wed, 31 Aug 2011 18:32:15 +0000 (UTC) (envelope-from david@catwhisker.org) Received: from albert.catwhisker.org (m209-73.dsl.rawbw.com [198.144.209.73]) by mx1.freebsd.org (Postfix) with ESMTP id C63ED8FC16 for ; Wed, 31 Aug 2011 18:32:14 +0000 (UTC) Received: from albert.catwhisker.org (localhost [127.0.0.1]) by albert.catwhisker.org (8.14.5/8.14.5) with ESMTP id p7VHv1et028967 for ; Wed, 31 Aug 2011 10:57:01 -0700 (PDT) (envelope-from david@albert.catwhisker.org) Received: (from david@localhost) by albert.catwhisker.org (8.14.5/8.14.5/Submit) id p7VHv1DT028966; Wed, 31 Aug 2011 10:57:01 -0700 (PDT) (envelope-from david) Message-Id: <201108311757.p7VHv1DT028966@albert.catwhisker.org> Date: Wed, 31 Aug 2011 10:57:01 -0700 (PDT) From: David Wolfskill To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Cc: Subject: docs/160343: Remove references to (defunct) freebsd-libh list X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: David Wolfskill List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 31 Aug 2011 18:40:05 -0000 >Number: 160343 >Category: docs >Synopsis: Remove references to (defunct) freebsd-libh list >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: update >Submitter-Id: current-users >Arrival-Date: Wed Aug 31 18:40:04 UTC 2011 >Closed-Date: >Last-Modified: >Originator: David Wolfskill >Release: FreeBSD 8.2-STABLE i386 >Organization: Wolfskill & Dowling Residence >Environment: System: FreeBSD albert.catwhisker.org 8.2-STABLE FreeBSD 8.2-STABLE #360 r225228: Sun Aug 28 04:12:41 PDT 2011 root@freebeast.catwhisker.org:/common/S1/obj/usr/src/sys/ALBERT i386 >Description: The page at refers the reader to the freebsd-libh mailing list. That list has been defunct for some time, and I have just removed it from Mailman. >How-To-Repeat: n/a >Fix: Index: en_US.ISO8859-1/books/handbook/eresources/chapter.sgml =================================================================== RCS file: /cvs/freebsd/doc/en_US.ISO8859-1/books/handbook/eresources/chapter.sgml,v retrieving revision 1.209 diff -u -r1.209 chapter.sgml --- en_US.ISO8859-1/books/handbook/eresources/chapter.sgml 23 Jul 2011 21:39:12 -0000 1.209 +++ en_US.ISO8859-1/books/handbook/eresources/chapter.sgml 31 Aug 2011 17:49:41 -0000 @@ -365,12 +365,6 @@ - &a.libh.name; - The second generation installation and package - system - - - &a.mips.name; Porting FreeBSD to &mips; Index: en_US.ISO8859-1/share/sgml/mailing-lists.ent =================================================================== RCS file: /cvs/freebsd/doc/en_US.ISO8859-1/share/sgml/mailing-lists.ent,v retrieving revision 1.80 diff -u -r1.80 mailing-lists.ent --- en_US.ISO8859-1/share/sgml/mailing-lists.ent 23 Jul 2011 21:39:12 -0000 1.80 +++ en_US.ISO8859-1/share/sgml/mailing-lists.ent 31 Aug 2011 17:49:56 -0000 @@ -267,10 +267,6 @@ FreeBSD LFS porting mailing list"> freebsd-lfs"> - -FreeBSD libh installation and packaging system mailing list"> -freebsd-libh"> - FreeBSD MIPS porting mailing list"> freebsd-mips"> >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Wed Aug 31 18:53:09 2011 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 9BD4C1065672; Wed, 31 Aug 2011 18:53:09 +0000 (UTC) (envelope-from jkois@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 748DC8FC08; Wed, 31 Aug 2011 18:53:09 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id p7VIr92d066356; Wed, 31 Aug 2011 18:53:09 GMT (envelope-from jkois@freefall.freebsd.org) Received: (from jkois@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id p7VIr977066352; Wed, 31 Aug 2011 18:53:09 GMT (envelope-from jkois) Date: Wed, 31 Aug 2011 18:53:09 GMT Message-Id: <201108311853.p7VIr977066352@freefall.freebsd.org> To: jkois@FreeBSD.org, freebsd-doc@FreeBSD.org, jkois@FreeBSD.org From: jkois@FreeBSD.org Cc: Subject: Re: docs/160343: Remove references to (defunct) freebsd-libh list X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 31 Aug 2011 18:53:09 -0000 Synopsis: Remove references to (defunct) freebsd-libh list Responsible-Changed-From-To: freebsd-doc->jkois Responsible-Changed-By: jkois Responsible-Changed-When: Wed Aug 31 18:52:43 UTC 2011 Responsible-Changed-Why: Take this one. http://www.freebsd.org/cgi/query-pr.cgi?pr=160343 From owner-freebsd-doc@FreeBSD.ORG Wed Aug 31 21:32:02 2011 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 9EC34106566B; Wed, 31 Aug 2011 21:32:02 +0000 (UTC) (envelope-from crodr001@gmail.com) Received: from mail-bw0-f54.google.com (mail-bw0-f54.google.com [209.85.214.54]) by mx1.freebsd.org (Postfix) with ESMTP id A49BA8FC08; Wed, 31 Aug 2011 21:32:01 +0000 (UTC) Received: by bkat8 with SMTP id t8so1728705bka.13 for ; Wed, 31 Aug 2011 14:32:00 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=mime-version:sender:in-reply-to:references:date :x-google-sender-auth:message-id:subject:from:to:cc:content-type :content-transfer-encoding; bh=BZS+uXCroe5hLTcvWtY79XM96UQrg2WegOzFEWkS5/c=; b=Mw4X9cUOA6yx+eF+7mQvVBY28b4CeBRJSBLGs6lKcnzAP7n6eHtpVPsaveuc6zmQFY Jf+Z1vpGiplNdhreWCBcP5p8mLw1qhLUEwyqMwVTu0h9LyXGzcWgBEnAYVu5sow3MRMF SC5i90amXGitTk8VJW9INyQ+ilwzHka2cfgtI= MIME-Version: 1.0 Received: by 10.204.157.133 with SMTP id b5mr553123bkx.127.1314826319881; Wed, 31 Aug 2011 14:31:59 -0700 (PDT) Sender: crodr001@gmail.com Received: by 10.204.58.196 with HTTP; Wed, 31 Aug 2011 14:31:59 -0700 (PDT) In-Reply-To: References: Date: Wed, 31 Aug 2011 14:31:59 -0700 X-Google-Sender-Auth: pEnW72sRky9u6_DtAf7lsh4x2Bo Message-ID: From: Craig Rodrigues To: Warren Block Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: quoted-printable Cc: kan@freebsd.org, rmacklem@freebsd.org, freebsd-doc@freebsd.org, alfred@freebsd.org Subject: Re: PXE Booting with an NFS root file system X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 31 Aug 2011 21:32:02 -0000 On Tue, Aug 30, 2011 at 7:41 AM, Warren Block wrote: > > Overall, looks quite good. =A0A few minor suggestions: > > 31.8.1 > > =A0"5. Enable inetd" > =A0 =A0 =A0Use &man.inetd.8; instead of plain "inetd". =A0Might be needed= for > =A0 =A0 =A0other commands, or at least the first mention of them. > > =A0"11. Replace "myhost.mydomain.com" with the hostname" > =A0 =A0 =A0Use myhost.example.com, maybe also = use > =A0 =A0 =A0it in the programlisting. > > =A0"14. Customize the ${NFSROOTDIR} in a chroot environment by" > =A0 =A0 =A0Can be read three ways: > =A0 =A0 =A0 1. "Customize the ${NFSROOTDIR}-in-a-chroot-environment by" > =A0 =A0 =A0 2. "Customize the ${NFSROOTDIR}-in-a-chroot's environment by" > =A0 =A0 =A0 3. "Customize the ${NFSROOTDIR} by using a chroot environment= " > > =A0 =A0 =A0 Some rearrangement of that sentence could help. > > Thanks! > Hi, Thanks. I have incorporated your feedback and updated the page: http://people.freebsd.org/~rodrigc/doc/doc/en_US.ISO8859-1/books/handbook/n= etwork-pxe-nfs.html and the patch is here: http://people.freebsd.org/~rodrigc/nfs-pxe.diff.txt --=20 Craig Rodrigues rodrigc@crodrigues.org From owner-freebsd-doc@FreeBSD.ORG Thu Sep 1 08:40:57 2011 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id BB61C1065672; Thu, 1 Sep 2011 08:40:57 +0000 (UTC) (envelope-from crees@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 746D68FC18; Thu, 1 Sep 2011 08:40:57 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id p818evRa066494; Thu, 1 Sep 2011 08:40:57 GMT (envelope-from crees@freefall.freebsd.org) Received: (from crees@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id p818evSH066482; Thu, 1 Sep 2011 08:40:57 GMT (envelope-from crees) Date: Thu, 1 Sep 2011 08:40:57 GMT Message-Id: <201109010840.p818evSH066482@freefall.freebsd.org> To: crees@freebsd.org, crees@FreeBSD.org, freebsd-doc@FreeBSD.org From: crees@FreeBSD.org Cc: Subject: Re: docs/159870: [PATCH] PR handling guidelines still reference freebsd-openoffice mailing list X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 01 Sep 2011 08:40:57 -0000 Synopsis: [PATCH] PR handling guidelines still reference freebsd-openoffice mailing list State-Changed-From-To: feedback->open State-Changed-By: crees State-Changed-When: Thu Sep 1 08:40:56 UTC 2011 State-Changed-Why: Jason has clarified. http://www.freebsd.org/cgi/query-pr.cgi?pr=159870 From owner-freebsd-doc@FreeBSD.ORG Thu Sep 1 16:20:10 2011 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 148D61065674; Thu, 1 Sep 2011 16:20:10 +0000 (UTC) (envelope-from ryusuke@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 396578FC1A; Thu, 1 Sep 2011 16:20:07 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id p81GK7gb089551; Thu, 1 Sep 2011 16:20:07 GMT (envelope-from ryusuke@freefall.freebsd.org) Received: (from ryusuke@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id p81GK7hI089547; Thu, 1 Sep 2011 16:20:07 GMT (envelope-from ryusuke) Date: Thu, 1 Sep 2011 16:20:07 GMT Message-Id: <201109011620.p81GK7hI089547@freefall.freebsd.org> To: ryusuke@FreeBSD.org, freebsd-doc@FreeBSD.org, ryusuke@FreeBSD.org From: ryusuke@FreeBSD.org Cc: Subject: Re: docs/159870: [PATCH] PR handling guidelines still reference freebsd-openoffice mailing list X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 01 Sep 2011 16:20:10 -0000 Synopsis: [PATCH] PR handling guidelines still reference freebsd-openoffice mailing list Responsible-Changed-From-To: freebsd-doc->ryusuke Responsible-Changed-By: ryusuke Responsible-Changed-When: Thu Sep 1 16:18:45 UTC 2011 Responsible-Changed-Why: I'll take this. http://www.freebsd.org/cgi/query-pr.cgi?pr=159870 From owner-freebsd-doc@FreeBSD.ORG Thu Sep 1 16:40:07 2011 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id E66021065670 for ; Thu, 1 Sep 2011 16:40:07 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id A4F6B8FC0C for ; Thu, 1 Sep 2011 16:40:07 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id p81Ge7aw009300 for ; Thu, 1 Sep 2011 16:40:07 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id p81Ge7ad009299; Thu, 1 Sep 2011 16:40:07 GMT (envelope-from gnats) Resent-Date: Thu, 1 Sep 2011 16:40:07 GMT Resent-Message-Id: <201109011640.p81Ge7ad009299@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Eitan Adler Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id B6B57106566C for ; Thu, 1 Sep 2011 16:31:15 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from red.freebsd.org (red.freebsd.org [IPv6:2001:4f8:fff6::22]) by mx1.freebsd.org (Postfix) with ESMTP id A74778FC1B for ; Thu, 1 Sep 2011 16:31:15 +0000 (UTC) Received: from red.freebsd.org (localhost [127.0.0.1]) by red.freebsd.org (8.14.4/8.14.4) with ESMTP id p81GVFdb095646 for ; Thu, 1 Sep 2011 16:31:15 GMT (envelope-from nobody@red.freebsd.org) Received: (from nobody@localhost) by red.freebsd.org (8.14.4/8.14.4/Submit) id p81GVFj6095645; Thu, 1 Sep 2011 16:31:15 GMT (envelope-from nobody) Message-Id: <201109011631.p81GVFj6095645@red.freebsd.org> Date: Thu, 1 Sep 2011 16:31:15 GMT From: Eitan Adler To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/160369: [patch] update sample simple makefile with new conventions X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 01 Sep 2011 16:40:08 -0000 >Number: 160369 >Category: docs >Synopsis: [patch] update sample simple makefile with new conventions >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Thu Sep 01 16:40:07 UTC 2011 >Closed-Date: >Last-Modified: >Originator: Eitan Adler >Release: >Organization: >Environment: >Description: I was told by sahil@ and bapt@ that we will now be ISO 8601:2004 form for new ports. Additionally, add a license to the sample makefile. >How-To-Repeat: >Fix: Index: book.sgml =================================================================== RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/porters-handbook/book.sgml,v retrieving revision 1.1115 diff -u -r1.1115 book.sgml --- book.sgml 15 Aug 2011 06:06:40 -0000 1.1115 +++ book.sgml 1 Sep 2011 16:28:39 -0000 @@ -120,7 +120,7 @@ like this: # New ports collection makefile for: oneko -# Date created: 5 December 1994 +# Date created: 1994-12-5 # Whom: asami # # $FreeBSD$ @@ -134,6 +134,8 @@ MAINTAINER= asami@FreeBSD.org COMMENT= A cat chasing a mouse all over the screen +LICENSE= MIT + MAN1= oneko.1 MANCOMPRESSED= yes USE_IMAKE= yes >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Thu Sep 1 16:46:10 2011 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 42E3F106566B; Thu, 1 Sep 2011 16:46:10 +0000 (UTC) (envelope-from eadler@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 1B60E8FC0C; Thu, 1 Sep 2011 16:46:10 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id p81Gk9X7018009; Thu, 1 Sep 2011 16:46:09 GMT (envelope-from eadler@freefall.freebsd.org) Received: (from eadler@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id p81Gk95p018005; Thu, 1 Sep 2011 16:46:09 GMT (envelope-from eadler) Date: Thu, 1 Sep 2011 16:46:09 GMT Message-Id: <201109011646.p81Gk95p018005@freefall.freebsd.org> To: eadler@FreeBSD.org, freebsd-doc@FreeBSD.org, gjb@FreeBSD.org From: eadler@FreeBSD.org Cc: Subject: Re: docs/160369: [patch] update sample simple makefile with new conventions X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 01 Sep 2011 16:46:10 -0000 Synopsis: [patch] update sample simple makefile with new conventions Responsible-Changed-From-To: freebsd-doc->gjb Responsible-Changed-By: eadler Responsible-Changed-When: Thu Sep 1 16:46:09 UTC 2011 Responsible-Changed-Why: You know you want it http://www.freebsd.org/cgi/query-pr.cgi?pr=160369 From owner-freebsd-doc@FreeBSD.ORG Fri Sep 2 11:42:09 2011 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 13A1210657A4 for ; Fri, 2 Sep 2011 11:42:09 +0000 (UTC) (envelope-from radiomlodychbandytow@o2.pl) Received: from moh2-ve3.go2.pl (moh2-ve3.go2.pl [193.17.41.208]) by mx1.freebsd.org (Postfix) with ESMTP id C95688FC0C for ; Fri, 2 Sep 2011 11:42:08 +0000 (UTC) Received: from moh2-ve3.go2.pl (unknown [10.0.0.208]) by moh2-ve3.go2.pl (Postfix) with ESMTP id 3C8884804C for ; Fri, 2 Sep 2011 13:21:23 +0200 (CEST) Received: from unknown (unknown [10.0.0.74]) by moh2-ve3.go2.pl (Postfix) with SMTP for ; Fri, 2 Sep 2011 13:21:23 +0200 (CEST) Received: from host892524678.com-promis.3s.pl [89.25.246.78] by poczta.o2.pl with ESMTP id rvvKSK; Fri, 02 Sep 2011 13:21:23 +0200 Message-ID: <4E60BC31.5000206@o2.pl> Date: Fri, 02 Sep 2011 13:21:21 +0200 From: =?UTF-8?B?UmFkaW8gbcWCb2R5Y2ggYmFuZHl0w7N3?= User-Agent: Mozilla/5.0 (Windows NT 5.2; WOW64; rv:6.0.1) Gecko/20110830 Thunderbird/6.0.1 MIME-Version: 1.0 To: freebsd-doc@freebsd.org Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 8bit X-O2-Trust: 2, 62 X-O2-SPF: neutral Subject: Outdated stuff in Devs' Handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 02 Sep 2011 11:42:09 -0000 First, http://www.freebsd.org/doc/en_US.ISO8859-1/books/developers-handbook/emacs.html It starts with "Unfortunately, UNIX® systems do not come with the kind of everything-you-ever-wanted-and-lots-more-you-did-not-in-one-gigantic-package integrated development environments that other systems have.", after which is a reference to a statement that notes its outdated, but nevertheless the line clearly deserves removal. Then "Also, you will need a fair amount of memory to run it--I would recommend 8MB in text mode and 16MB in X as the bare minimum to get reasonable performance." It's just funny. -- Twoje radio From owner-freebsd-doc@FreeBSD.ORG Fri Sep 2 11:42:32 2011 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 7F6DD106564A for ; Fri, 2 Sep 2011 11:42:32 +0000 (UTC) (envelope-from radiomlodychbandytow@o2.pl) Received: from moh1-ve2.go2.pl (moh1-ve2.go2.pl [193.17.41.132]) by mx1.freebsd.org (Postfix) with ESMTP id 419B68FC1D for ; Fri, 2 Sep 2011 11:42:32 +0000 (UTC) Received: from moh1-ve2.go2.pl (unknown [10.0.0.132]) by moh1-ve2.go2.pl (Postfix) with ESMTP id DF5C61065D66 for ; Fri, 2 Sep 2011 13:24:18 +0200 (CEST) Received: from unknown (unknown [10.0.0.108]) by moh1-ve2.go2.pl (Postfix) with SMTP for ; Fri, 2 Sep 2011 13:24:18 +0200 (CEST) Received: from host892524678.com-promis.3s.pl [89.25.246.78] by poczta.o2.pl with ESMTP id nxCGjM; Fri, 02 Sep 2011 13:24:49 +0200 Message-ID: <4E60BCE0.6070804@o2.pl> Date: Fri, 02 Sep 2011 13:24:16 +0200 From: =?UTF-8?B?UmFkaW8gbcWCb2R5Y2ggYmFuZHl0w7N3?= User-Agent: Mozilla/5.0 (Windows NT 5.2; WOW64; rv:6.0.1) Gecko/20110830 Thunderbird/6.0.1 MIME-Version: 1.0 To: freebsd-doc@freebsd.org Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit X-O2-Trust: 2, 62 X-O2-SPF: neutral Subject: Minor tweak to the page on submitting docs updates X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 02 Sep 2011 11:42:32 -0000 http://www.freebsd.org/docproj/submitting.html "Then post a message to the FreeBSD-doc mailing list, with a brief outline of the documentation and the pointer to its location, and solicit feedback." It would be nice to add an URL to FreeBSD-doc. It would make it easier for noobs like me who don't know where to look for FreeBSD mailing lists. -- Twoje radio From owner-freebsd-doc@FreeBSD.ORG Fri Sep 2 13:04:44 2011 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id BC108106566C for ; Fri, 2 Sep 2011 13:04:44 +0000 (UTC) (envelope-from gjb@FreeBSD.org) Received: from glenbarber.us (onyx.glenbarber.us [199.48.134.227]) by mx1.freebsd.org (Postfix) with SMTP id 6DFB58FC1E for ; Fri, 2 Sep 2011 13:04:44 +0000 (UTC) Received: (qmail 48436 invoked by uid 0); 2 Sep 2011 09:04:43 -0400 Received: from unknown (HELO schism.local) (gjb@75.146.225.65) by 0 with SMTP; 2 Sep 2011 09:04:43 -0400 Message-ID: <4E60D46A.3050200@FreeBSD.org> Date: Fri, 02 Sep 2011 09:04:42 -0400 From: Glen Barber User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.6; rv:6.0.1) Gecko/20110830 Thunderbird/6.0.1 MIME-Version: 1.0 To: =?UTF-8?B?UmFkaW8gbcWCb2R5Y2ggYmFuZHl0w7N3?= References: <4E60BC31.5000206@o2.pl> In-Reply-To: <4E60BC31.5000206@o2.pl> X-Enigmail-Version: 1.3.1 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Cc: freebsd-doc@freebsd.org Subject: Re: Outdated stuff in Devs' Handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 02 Sep 2011 13:04:44 -0000 On 9/2/11 7:21 AM, Radio młodych bandytów wrote: > First, > http://www.freebsd.org/doc/en_US.ISO8859-1/books/developers-handbook/emacs.html > > It starts with "Unfortunately, UNIX® systems do not come with the kind > of > everything-you-ever-wanted-and-lots-more-you-did-not-in-one-gigantic-package > integrated development environments that other systems have.", after > which is a reference to a statement that notes its outdated, but > nevertheless the line clearly deserves removal. > Agreed. > Then "Also, you will need a fair amount of memory to run it--I would > recommend 8MB in text mode and 16MB in X as the bare minimum to get > reasonable performance." > It's just funny. > That's why it's called Emacs - Eight megabytes and constantly swapping. :-) Nonetheless, this does need to be updated. Thanks for the report. -- Glen Barber | gjb@FreeBSD.org FreeBSD Documentation Project From owner-freebsd-doc@FreeBSD.ORG Fri Sep 2 13:09:34 2011 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id C5CC91065676 for ; Fri, 2 Sep 2011 13:09:34 +0000 (UTC) (envelope-from gjb@FreeBSD.org) Received: from glenbarber.us (onyx.glenbarber.us [199.48.134.227]) by mx1.freebsd.org (Postfix) with SMTP id 7894B8FC15 for ; Fri, 2 Sep 2011 13:09:34 +0000 (UTC) Received: (qmail 49161 invoked by uid 0); 2 Sep 2011 09:09:33 -0400 Received: from unknown (HELO schism.local) (gjb@75.146.225.65) by 0 with SMTP; 2 Sep 2011 09:09:33 -0400 Message-ID: <4E60D58D.70802@FreeBSD.org> Date: Fri, 02 Sep 2011 09:09:33 -0400 From: Glen Barber User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.6; rv:6.0.1) Gecko/20110830 Thunderbird/6.0.1 MIME-Version: 1.0 To: =?UTF-8?B?UmFkaW8gbcWCb2R5Y2ggYmFuZHl0w7N3?= References: <4E60BCE0.6070804@o2.pl> In-Reply-To: <4E60BCE0.6070804@o2.pl> X-Enigmail-Version: 1.3.1 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Cc: freebsd-doc@freebsd.org Subject: Re: Minor tweak to the page on submitting docs updates X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 02 Sep 2011 13:09:34 -0000 On 9/2/11 7:24 AM, Radio młodych bandytów wrote: > http://www.freebsd.org/docproj/submitting.html > > "Then post a message to the FreeBSD-doc mailing list, with a brief > outline of the documentation and the pointer to its location, and > solicit feedback." > > It would be nice to add an URL to FreeBSD-doc. It would make it easier > for noobs like me who don't know where to look for FreeBSD mailing lists. > This could also us a link to the FreeBSD Documentation Primer here: http://www.freebsd.org/doc/en/books/fdp-primer/ If you're interested, maybe you'd like to have a crack at submitting a patch to the SGML? Another thing I think should be done here is updating the method for obtaining the source. crees@ SGML-ified prior documentation for the Porter's Handbook [1]; I think similar documentation here would be useful. [1] - http://www.freebsd.org/doc/en/books/porters-handbook/port-upgrading.html#CVS-DIFF -- Glen Barber | gjb@FreeBSD.org FreeBSD Documentation Project From owner-freebsd-doc@FreeBSD.ORG Fri Sep 2 13:34:03 2011 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id EC310106566B for ; Fri, 2 Sep 2011 13:34:03 +0000 (UTC) (envelope-from radiomlodychbandytow@o2.pl) Received: from moh1-ve1.go2.pl (moh1-ve1.go2.pl [193.17.41.131]) by mx1.freebsd.org (Postfix) with ESMTP id AC1DD8FC12 for ; Fri, 2 Sep 2011 13:34:03 +0000 (UTC) Received: from moh1-ve1.go2.pl (unknown [10.0.0.131]) by moh1-ve1.go2.pl (Postfix) with ESMTP id 9471C91C117 for ; Fri, 2 Sep 2011 15:34:00 +0200 (CEST) Received: from unknown (unknown [10.0.0.42]) by moh1-ve1.go2.pl (Postfix) with SMTP for ; Fri, 2 Sep 2011 15:34:00 +0200 (CEST) Received: from host892524678.com-promis.3s.pl [89.25.246.78] by poczta.o2.pl with ESMTP id pfKjWX; Fri, 02 Sep 2011 15:33:59 +0200 Message-ID: <4E60DB45.2010406@o2.pl> Date: Fri, 02 Sep 2011 15:33:57 +0200 From: =?UTF-8?B?UmFkaW8gbcWCb2R5Y2ggYmFuZHl0w7N3?= User-Agent: Mozilla/5.0 (Windows NT 5.2; WOW64; rv:6.0.1) Gecko/20110830 Thunderbird/6.0.1 MIME-Version: 1.0 To: Glen Barber References: <4E60BCE0.6070804@o2.pl> <4E60D58D.70802@FreeBSD.org> In-Reply-To: <4E60D58D.70802@FreeBSD.org> Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit X-O2-Trust: 2, 63 X-O2-SPF: neutral Cc: freebsd-doc@freebsd.org Subject: Re: Minor tweak to the page on submitting docs updates X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 02 Sep 2011 13:34:04 -0000 On 2011-09-02 15:09, Glen Barber wrote: > If you're interested, maybe you'd like to have a crack at submitting a > patch to the SGML? Sorry, being new to FreeBSD (and *nix in general) I have enough things to learn. -- Twoje radio From owner-freebsd-doc@FreeBSD.ORG Fri Sep 2 13:36:03 2011 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 7AA9A106566C for ; Fri, 2 Sep 2011 13:36:03 +0000 (UTC) (envelope-from gjb@FreeBSD.org) Received: from glenbarber.us (onyx.glenbarber.us [199.48.134.227]) by mx1.freebsd.org (Postfix) with SMTP id 2BD6F8FC13 for ; Fri, 2 Sep 2011 13:36:02 +0000 (UTC) Received: (qmail 50183 invoked by uid 0); 2 Sep 2011 09:36:02 -0400 Received: from unknown (HELO schism.local) (gjb@75.146.225.65) by 0 with SMTP; 2 Sep 2011 09:36:02 -0400 Message-ID: <4E60DBC1.9040602@FreeBSD.org> Date: Fri, 02 Sep 2011 09:36:01 -0400 From: Glen Barber User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.6; rv:6.0.1) Gecko/20110830 Thunderbird/6.0.1 MIME-Version: 1.0 To: =?UTF-8?B?UmFkaW8gbcWCb2R5Y2ggYmFuZHl0w7N3?= References: <4E60BCE0.6070804@o2.pl> <4E60D58D.70802@FreeBSD.org> <4E60DB45.2010406@o2.pl> In-Reply-To: <4E60DB45.2010406@o2.pl> X-Enigmail-Version: 1.3.1 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Cc: freebsd-doc@freebsd.org Subject: Re: Minor tweak to the page on submitting docs updates X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 02 Sep 2011 13:36:03 -0000 On 9/2/11 9:33 AM, Radio młodych bandytów wrote: > On 2011-09-02 15:09, Glen Barber wrote: >> If you're interested, maybe you'd like to have a crack at submitting a >> patch to the SGML? > Sorry, being new to FreeBSD (and *nix in general) I have enough things > to learn. > No problem. :-) (And welcome to FreeBSD, too!) -- Glen Barber | gjb@FreeBSD.org FreeBSD Documentation Project From owner-freebsd-doc@FreeBSD.ORG Fri Sep 2 15:30:15 2011 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 8CEE4106564A for ; Fri, 2 Sep 2011 15:30:15 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 503BC8FC1C for ; Fri, 2 Sep 2011 15:30:15 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id p82FUFNu009030 for ; Fri, 2 Sep 2011 15:30:15 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id p82FUFFa009024; Fri, 2 Sep 2011 15:30:15 GMT (envelope-from gnats) Resent-Date: Fri, 2 Sep 2011 15:30:15 GMT Resent-Message-Id: <201109021530.p82FUFFa009024@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Adam VandeMore Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 092F110656D4 for ; Fri, 2 Sep 2011 15:27:29 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from red.freebsd.org (red.freebsd.org [IPv6:2001:4f8:fff6::22]) by mx1.freebsd.org (Postfix) with ESMTP id ED3A38FC0A for ; Fri, 2 Sep 2011 15:27:28 +0000 (UTC) Received: from red.freebsd.org (localhost [127.0.0.1]) by red.freebsd.org (8.14.4/8.14.4) with ESMTP id p82FRSaX007827 for ; Fri, 2 Sep 2011 15:27:28 GMT (envelope-from nobody@red.freebsd.org) Received: (from nobody@localhost) by red.freebsd.org (8.14.4/8.14.4/Submit) id p82FRSbw007826; Fri, 2 Sep 2011 15:27:28 GMT (envelope-from nobody) Message-Id: <201109021527.p82FRSbw007826@red.freebsd.org> Date: Fri, 2 Sep 2011 15:27:28 GMT From: Adam VandeMore To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/160399: Man page for re(4) missing jumbo frames info X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 02 Sep 2011 15:30:15 -0000 >Number: 160399 >Category: docs >Synopsis: Man page for re(4) missing jumbo frames info >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: update >Submitter-Id: current-users >Arrival-Date: Fri Sep 02 15:30:14 UTC 2011 >Closed-Date: >Last-Modified: >Originator: Adam VandeMore >Release: FreeBSD STABLE 8 >Organization: >Environment: FreeBSD galacticdominator.com 8.2-STABLE FreeBSD 8.2-STABLE #0: Fri Jul 8 06:22:29 UTC 2011 root@:/usr/obj/usr/src/sys/GENERIC amd64 >Description: share/man/man4/re.4 doesn't accurately reflect all the realtek nics which work with jumbo frames. For example, my nic is: re0@pci0:3:0:0: class=0x020000 card=0x75811462 chip=0x816810ec rev=0x03 hdr=0x00 vendor = 'Realtek Semiconductor' device = 'Gigabit Ethernet NIC(NDIS 6.0) (RTL8168/8111/8111c)' class = network subclass = ethernet Which works perfectly well with these settings: re0: flags=8943 metric 0 mtu 6000 options=3898 ether 00:24:21:e3:e7:50 inet 192.168.25.10 netmask 0xffffff00 broadcast 192.168.25.255 media: Ethernet autoselect (1000baseT ) status: active This wasn't always the case since when I first got this system jumbo frames and FreeBSD didn't work. http://lists.freebsd.org/pipermail/freebsd-net/2010-June/025506.html The missing functionality appears to have been added since then. >How-To-Repeat: View the re(4) man page vs what the re driver is capable of. >Fix: >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Fri Sep 2 18:38:36 2011 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id A4D48106564A; Fri, 2 Sep 2011 18:38:36 +0000 (UTC) (envelope-from brueffer@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 7B5218FC15; Fri, 2 Sep 2011 18:38:36 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id p82IcaTF084180; Fri, 2 Sep 2011 18:38:36 GMT (envelope-from brueffer@freefall.freebsd.org) Received: (from brueffer@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id p82IcaHd084176; Fri, 2 Sep 2011 20:38:36 +0200 (CEST) (envelope-from brueffer) Date: Fri, 2 Sep 2011 20:38:36 +0200 (CEST) Message-Id: <201109021838.p82IcaHd084176@freefall.freebsd.org> To: wblock@wonkity.com, brueffer@FreeBSD.org, freebsd-doc@FreeBSD.org, brueffer@FreeBSD.org From: brueffer@FreeBSD.org Cc: Subject: Re: docs/160267: [patch] wlan.4 has incorrect apostrophe X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 02 Sep 2011 18:38:36 -0000 Synopsis: [patch] wlan.4 has incorrect apostrophe State-Changed-From-To: open->patched State-Changed-By: brueffer State-Changed-When: Fri Sep 2 20:37:55 CEST 2011 State-Changed-Why: Committed, MFC pending. Thanks! Responsible-Changed-From-To: freebsd-doc->brueffer Responsible-Changed-By: brueffer Responsible-Changed-When: Fri Sep 2 20:37:55 CEST 2011 Responsible-Changed-Why: MFC reminder. http://www.freebsd.org/cgi/query-pr.cgi?pr=160267 From owner-freebsd-doc@FreeBSD.ORG Fri Sep 2 18:53:27 2011 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 2471F1065674; Fri, 2 Sep 2011 18:53:27 +0000 (UTC) (envelope-from brueffer@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id EFF2C8FC12; Fri, 2 Sep 2011 18:53:26 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id p82IrQZX001188; Fri, 2 Sep 2011 18:53:26 GMT (envelope-from brueffer@freefall.freebsd.org) Received: (from brueffer@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id p82IrQBS001184; Fri, 2 Sep 2011 20:53:26 +0200 (CEST) (envelope-from brueffer) Date: Fri, 2 Sep 2011 20:53:26 +0200 (CEST) Message-Id: <201109021853.p82IrQBS001184@freefall.freebsd.org> To: kaduk@mit.edu, brueffer@FreeBSD.org, freebsd-doc@FreeBSD.org, brueffer@FreeBSD.org From: brueffer@FreeBSD.org Cc: Subject: Re: docs/159948: [patch] grammar updates to ata.4 X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 02 Sep 2011 18:53:27 -0000 Synopsis: [patch] grammar updates to ata.4 State-Changed-From-To: open->closed State-Changed-By: brueffer State-Changed-When: Fri Sep 2 20:52:35 CEST 2011 State-Changed-Why: Committed together with some more markup fixes. Thanks! Responsible-Changed-From-To: freebsd-doc->brueffer Responsible-Changed-By: brueffer Responsible-Changed-When: Fri Sep 2 20:52:35 CEST 2011 Responsible-Changed-Why: Committed together with some more markup fixes. Thanks! http://www.freebsd.org/cgi/query-pr.cgi?pr=159948 From owner-freebsd-doc@FreeBSD.ORG Fri Sep 2 19:30:13 2011 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 10365106568F for ; Fri, 2 Sep 2011 19:30:13 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id C73538FC16 for ; Fri, 2 Sep 2011 19:30:12 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id p82JUCNE028463 for ; Fri, 2 Sep 2011 19:30:12 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id p82JUC02028462; Fri, 2 Sep 2011 19:30:12 GMT (envelope-from gnats) Resent-Date: Fri, 2 Sep 2011 19:30:12 GMT Resent-Message-Id: <201109021930.p82JUC02028462@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Eitan Adler Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id B8DF21065670 for ; Fri, 2 Sep 2011 19:21:55 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from red.freebsd.org (red.freebsd.org [IPv6:2001:4f8:fff6::22]) by mx1.freebsd.org (Postfix) with ESMTP id A8CE28FC08 for ; Fri, 2 Sep 2011 19:21:55 +0000 (UTC) Received: from red.freebsd.org (localhost [127.0.0.1]) by red.freebsd.org (8.14.4/8.14.4) with ESMTP id p82JLtnF026948 for ; Fri, 2 Sep 2011 19:21:55 GMT (envelope-from nobody@red.freebsd.org) Received: (from nobody@localhost) by red.freebsd.org (8.14.4/8.14.4/Submit) id p82JLtOH026947; Fri, 2 Sep 2011 19:21:55 GMT (envelope-from nobody) Message-Id: <201109021921.p82JLtOH026947@red.freebsd.org> Date: Fri, 2 Sep 2011 19:21:55 GMT From: Eitan Adler To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/160405: [patch] add a perk for developers, they deserve more X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 02 Sep 2011 19:30:13 -0000 >Number: 160405 >Category: docs >Synopsis: [patch] add a perk for developers, they deserve more >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: change-request >Submitter-Id: current-users >Arrival-Date: Fri Sep 02 19:30:12 UTC 2011 >Closed-Date: >Last-Modified: >Originator: Eitan Adler >Release: >Organization: >Environment: >Description: Developers do too much work to be recognized in some way. >How-To-Repeat: Read the mailing lists, watch IRC >Fix: Index: article.sgml =================================================================== RCS file: /home/ncvs/doc/en_US.ISO8859-1/articles/committers-guide/article.sgml,v retrieving revision 1.302 diff -u -r1.302 article.sgml --- article.sgml 1 Aug 2011 06:51:56 -0000 1.302 +++ article.sgml 2 Sep 2011 19:17:31 -0000 @@ -3328,6 +3328,17 @@ countries outside the USA. + + + Freenode IRC Cloaks + + + &os; developers may request a cloaked hostmask be + created for their account on the IRC network Freenode of the form + freebsd/developer/freefall name + or freebsd/developer/NickServ name. + + >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Fri Sep 2 19:36:50 2011 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 6A6E11065670; Fri, 2 Sep 2011 19:36:50 +0000 (UTC) (envelope-from gjb@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 42B6D8FC18; Fri, 2 Sep 2011 19:36:50 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id p82JaoSn039121; Fri, 2 Sep 2011 19:36:50 GMT (envelope-from gjb@freefall.freebsd.org) Received: (from gjb@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id p82JaoXU039117; Fri, 2 Sep 2011 19:36:50 GMT (envelope-from gjb) Date: Fri, 2 Sep 2011 19:36:50 GMT Message-Id: <201109021936.p82JaoXU039117@freefall.freebsd.org> To: gjb@FreeBSD.org, freebsd-doc@FreeBSD.org, gjb@FreeBSD.org From: gjb@FreeBSD.org Cc: Subject: Re: docs/160405: [patch] add a perk for developers, they deserve more X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 02 Sep 2011 19:36:50 -0000 Synopsis: [patch] add a perk for developers, they deserve more Responsible-Changed-From-To: freebsd-doc->gjb Responsible-Changed-By: gjb Responsible-Changed-When: Fri Sep 2 19:36:35 UTC 2011 Responsible-Changed-Why: I'll take it. http://www.freebsd.org/cgi/query-pr.cgi?pr=160405 From owner-freebsd-doc@FreeBSD.ORG Fri Sep 2 21:15:50 2011 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id D12BE106566C; Fri, 2 Sep 2011 21:15:50 +0000 (UTC) (envelope-from niclas.zeising@gmail.com) Received: from mail.lysator.liu.se (mail.lysator.liu.se [IPv6:2001:6b0:17:f0a0::3]) by mx1.freebsd.org (Postfix) with ESMTP id 5BB978FC0A; Fri, 2 Sep 2011 21:15:50 +0000 (UTC) Received: from mail.lysator.liu.se (localhost [127.0.0.1]) by mail.lysator.liu.se (Postfix) with ESMTP id CFC5D4000F; Fri, 2 Sep 2011 23:15:48 +0200 (CEST) Received: by mail.lysator.liu.se (Postfix, from userid 1004) id C44C24002E; Fri, 2 Sep 2011 23:15:48 +0200 (CEST) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on bernadotte.lysator.liu.se X-Spam-Level: X-Spam-Status: No, score=0.0 required=5.0 tests=AWL,FREEMAIL_FROM autolearn=disabled version=3.3.1 X-Spam-Score: 0.0 Received: from mx.daemonic.se (mx.daemonic.se [IPv6:2001:470:dca9:0:1::3]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by mail.lysator.liu.se (Postfix) with ESMTPSA id 7EABA4000F; Fri, 2 Sep 2011 23:15:47 +0200 (CEST) Received: from mail.daemonic.se (mail.daemonic.se [IPv6:2001:470:dca9:0:1::4]) by mx.daemonic.se (Postfix) with ESMTPS id BC6FF119C04; Fri, 2 Sep 2011 23:15:46 +0200 (CEST) Received: from [10.32.0.4] (vivi.daemonic.se [10.32.0.4]) by mail.daemonic.se (Postfix) with ESMTPSA id 620E812B0A0; Fri, 2 Sep 2011 23:15:46 +0200 (CEST) Message-ID: <4E61476B.9060907@gmail.com> Date: Fri, 02 Sep 2011 23:15:23 +0200 From: Niclas Zeising User-Agent: Mutt/1.5.21 MIME-Version: 1.0 To: Glen Barber References: <4E60BC31.5000206@o2.pl> <4E60D46A.3050200@FreeBSD.org> In-Reply-To: <4E60D46A.3050200@FreeBSD.org> Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-Virus-Scanned: ClamAV using ClamSMTP Cc: freebsd-doc@freebsd.org, =?UTF-8?B?UmFkaW8gbcWCb2R5Y2ggYmFuZHl0w7N3?= Subject: Re: Outdated stuff in Devs' Handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 02 Sep 2011 21:15:50 -0000 On 2011-09-02 15:04, Glen Barber wrote: > On 9/2/11 7:21 AM, Radio młodych bandytów wrote: >> First, >> http://www.freebsd.org/doc/en_US.ISO8859-1/books/developers-handbook/emacs.html >> >> It starts with "Unfortunately, UNIX® systems do not come with the kind >> of >> everything-you-ever-wanted-and-lots-more-you-did-not-in-one-gigantic-package >> integrated development environments that other systems have.", after >> which is a reference to a statement that notes its outdated, but >> nevertheless the line clearly deserves removal. >> > > Agreed. > >> Then "Also, you will need a fair amount of memory to run it--I would >> recommend 8MB in text mode and 16MB in X as the bare minimum to get >> reasonable performance." >> It's just funny. >> > > That's why it's called Emacs - Eight megabytes and constantly swapping. > :-) Nonetheless, this does need to be updated. Thanks for the report. > You mean emacs now needs 8GB of memory? ;) -- Niclas From owner-freebsd-doc@FreeBSD.ORG Fri Sep 2 21:22:51 2011 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 9C4941065672; Fri, 2 Sep 2011 21:22:51 +0000 (UTC) (envelope-from crodr001@gmail.com) Received: from mail-bw0-f54.google.com (mail-bw0-f54.google.com [209.85.214.54]) by mx1.freebsd.org (Postfix) with ESMTP id A05EA8FC12; Fri, 2 Sep 2011 21:22:50 +0000 (UTC) Received: by bkat8 with SMTP id t8so4168753bka.13 for ; Fri, 02 Sep 2011 14:22:49 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=mime-version:sender:in-reply-to:references:date :x-google-sender-auth:message-id:subject:from:to:cc:content-type; bh=bKGeQ/4wLQzBypxN9EMiYpe0IK1cYBhWUhMN2UG+W9E=; b=r7nHkm+csoPCXzIRU7iKbSkQruTtLjjIEgu+3XMvx3M6q78cN/eag95VYh7kEosFZS 8+Sqm2qMJ/gKNs6lHm3vaXA6wuX+dooSCJSWpOtcfpzd9SAgCPhqBnov2FebalbD33UE Oz16ubbCRxHSJ24/C4By0DZ1yRCuS2mwXwfSE= MIME-Version: 1.0 Received: by 10.204.149.82 with SMTP id s18mr812572bkv.387.1314998567690; Fri, 02 Sep 2011 14:22:47 -0700 (PDT) Sender: crodr001@gmail.com Received: by 10.204.58.196 with HTTP; Fri, 2 Sep 2011 14:22:47 -0700 (PDT) In-Reply-To: References: Date: Fri, 2 Sep 2011 14:22:47 -0700 X-Google-Sender-Auth: SFq3GvNXPGq6yb8Pz0GsmUm00Yc Message-ID: From: Craig Rodrigues To: freebsd-doc@freebsd.org Content-Type: text/plain; charset=ISO-8859-1 Cc: kan@freebsd.org, rmacklem@freebsd.org, alfred@freebsd.org Subject: Re: PXE Booting with an NFS root file system X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 02 Sep 2011 21:22:51 -0000 Hi, I have incorporated more feedback from Glen Barber and Ryusuke Suzuki. I have updated the page: http://people.freebsd.org/~rodrigc/doc/doc/en_US.ISO8859-1/books/handbook/network-pxe-nfs.html and patch: http://people.freebsd.org/~rodrigc/nfs-pxe.diff.txt Please review. -- Craig Rodrigues rodrigc@crodrigues.org From owner-freebsd-doc@FreeBSD.ORG Sat Sep 3 00:08:16 2011 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 593A91065678 for ; Sat, 3 Sep 2011 00:08:16 +0000 (UTC) (envelope-from gjb@FreeBSD.org) Received: from glenbarber.us (onyx.glenbarber.us [199.48.134.227]) by mx1.freebsd.org (Postfix) with SMTP id 013398FC1D for ; Sat, 3 Sep 2011 00:08:15 +0000 (UTC) Received: (qmail 73156 invoked by uid 1001); 2 Sep 2011 20:08:15 -0400 Date: Fri, 2 Sep 2011 20:08:15 -0400 From: Glen Barber To: Craig Rodrigues Message-ID: <20110903000815.GA72769@glenbarber.us> References: MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: User-Agent: Mutt/1.5.21 (2010-09-15) Cc: kan@freebsd.org, rmacklem@freebsd.org, freebsd-doc@freebsd.org, alfred@freebsd.org Subject: Re: PXE Booting with an NFS root file system X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 03 Sep 2011 00:08:16 -0000 Craig Rodrigues wrote: > Hi, > > I have incorporated more feedback from Glen Barber and Ryusuke Suzuki. > Hi Craig, Comments are in-line (not many): Index: en_US.ISO8859-1/books/handbook/advanced-networking/chapter.sgml =================================================================== RCS file: /home/dcvs/doc/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.sgml,v retrieving revision 1.436 diff -u -r1.436 chapter.sgml --- en_US.ISO8859-1/books/handbook/advanced-networking/chapter.sgml 18 Feb 2011 18:10:36 -0000 1.436 +++ en_US.ISO8859-1/books/handbook/advanced-networking/chapter.sgml 2 Sep 2011 21:19:42 -0000 @@ -33,6 +33,10 @@ + How to set up network PXE booting with an NFS root file system. + + + How to set up network address translation. @@ -4171,6 +4175,304 @@ + + + + + Craig + Rodrigues + +
rodrigc@FreeBSD.org
+ + Written by + + + + PXE Booting with an NFS root file system + + The &intel; Preboot eXecution Environment (PXE) + allows booting the operating system over the network. + PXE support is usually provided in the + BIOS of modern motherboards, where + it can be enabled in the BIOS settings + which enable booting from the network. A fully functioning + PXE setup also requires properly configured + DHCP and TFTP servers. + + When the host computer boots, it receives information over + DHCP about where to obtain the initial boot + loader via TFTP. After the host computer receives this information, + it downloads the boot loader via TFTP, and then + executes the boot loader. This is documented section 2.2.1 of the + Preboot Execution Environment (PXE) Specification. + In &os;, the boot loader retrieved during the PXE + process is /boot/pxeboot. After + /boot/pxeboot executes, the &os; kernel is + loaded, and the rest of the &os; bootup sequence proceeds. + Refer to The FreeBSD Booting Process I think FreeBSD can be replaced by &os; here... + of the &os; Handbook. + + The pxeboot implementation in &os; was + written by &a.ps; and &a.jhb;. It is documented in the + &man.pxeboot.8; man page written by &a.dwhite;, and in the + FreeBSD Jumpstart Guide ... and here. + written by &a.alfred;. + + + Setting Up the <command>chroot</command> Environment for the NFS Root File system + + + + Choose a directory which will have a &os; installation + which will be NFS mountable. For example, a directory such + as /b/tftpboot/FreeBSD/install can be used. + + &prompt.root; export NFSROOTDIR=/b/tftpboot/FreeBSD/install +&prompt.root; mkdir -p ${NFSROOTDIR} + + + + Enable the NFS server by following the instructions in + the Configuring + NFS section of the &os; Handbook. + + + + Export the directory via NFS by adding the following to + /etc/exports: + + /b -ro -alldirs + + + + Restart the NFS server: + + &prompt.root; /etc/rc.d/nfsd restart + + + + Enable &man.inetd.8; by following the steps outlined in + . + + + + Add the following line to + /etc/inetd.conf: + + tftp dgram udp wait root /usr/libexec/tftpd tftpd -l -s /b/tftpboot + + + + Restart inetd: + + &prompt.root; /etc/rc.d/inetd restart + + + + Rebuild the &os; kernel and userland (see + Rebuilding "world" + in the &os; Handbook.) + + &prompt.root; cd /usr/src +&prompt.root; make buildworld +&prompt.root; make buildkernel + + + + Install &os; into the directory mounted over + NFS. + + +&prompt.root; make installworld DESTDIR=${NFSROOTDIR} +&prompt.root; make installkernel DESTDIR=${NFSROOTDIR} +&prompt.root; make distribution DESTDIR=${NFSROOTDIR} + + + + + Test that the TFTP server works and + can download the boot loader which will be obtained via PXE: + + +&prompt.root; tftp localhost +tftp> get FreeBSD/install/boot/pxeboot +Received 264951 bytes in 0.1 seconds + + + + + Edit ${NFSROOTDIR}/etc/fstab and create an entry + to mount the root file system over NFS: + + +# Device Mountpoint FSType Options Dump Pass +myhost.example.com:/b/tftpboot/FreeBSD/install / nfs ro 0 0 + + + Replace myhost.example.com + with the hostname or IP address of your NFS + server. In this example, the root file system is mounted + "read-only" in order to prevent NFS + clients from potentially deleting the contents of the root + file system. + + + + &prompt.root; chroot ${NFSROOTDIR} +&prompt.root; passwd + + + + Enable ssh root logins in + ${NFSROOTDIR}/etc/ssh/sshd_config There is a missing "." after . + + + + Customize the ${NFSROOTDIR} by using &man.chroot.8;. In the + chroot environment, the ${NFSROOTDIR} can be + customized by doing things like adding packages with + pkg_add, editing the password file with + &man.vipw.8;, editing &man.amd.conf.5; maps for automounting, + etc. For example: + + +&prompt.root; chroot ${NFSROOTDIR} +&prompt.root; pkg_add -r bash + + + + + + Configuring Memory File Systems used by <filename>/etc/rc.initdiskless</filename> + + If you boot from an NFS root volume, + /etc/rc + detects that you booted over NFS and runs + /etc/rc.initdiskless. + Read this script to understand what is going on. We need to make + /etc and /var memory backed + file systems because these directories need to be writable, but + the NFS root directory is read-only. + + +&prompt.root; chroot ${NFSROOTDIR} +&prompt.root; mkdir -p conf/base +&prompt.root; tar -c -v -f conf/base/etc.cpio.gz --format cpio --gzip etc +&prompt.root; tar -c -v -f conf/base/var.cpio.gz --format cpio --gzip var + + When system boots, memory file systems for + /etc and /var + will be created and mounted, and the contents of the + cpio.gz files will be copied into them. + + + + Setting up the DHCP Server + + PXE requires a TFTP server and a + DHCP server to be set up. The + DHCP server does not necessarily need + to be the same machine as the TFTP server, + but it needs to be accessible in your network. + + + + Install the DHCP server by following + the instructions documented at + Installing and Configuring a DHCP Server + in the &os; Handbook. Make sure that /etc/rc.conf + and /usr/local/etc/dhcpd.conf + are correctly configured. + + + + In /usr/local/etc/dhcpd.conf, configure + the next-server, filename, + and option root-path settings, + to specify your TFTP server IP address, + the path to /boot/pxeboot in + TFTP, and the path to NFS + root file system. Here is a sample dhcpd.conf + setup: + + +subnet 192.168.0.0 netmask 255.255.255.0 { + range 192.168.0.2 192.168.0.3 ; + option subnet-mask 255.255.255.0 ; + option routers 192.168.0.1 ; + option broadcast-address 192.168.0.255 ; + option domain-name-server 192.168.35.35, 192.168.35.36 ; + option domain-name "example.com"; + + # IP address of TFTP server + next-server 192.168.0.1 ; + + # path of boot loader obtained + # via tftp + filename "FreeBSD/install/boot/pxeboot" ; + + # pxeboot boot loader will try to NFS mount this directory for root FS + option root-path "192.168.0.1:/b/tftpboot/FreeBSD/intall/" ; + +} + + + + + Configuring the PXE client and Debugging Connection Problems + + + When the client machine boots up, enter the + BIOS configuration menu. Configure the + BIOS to boot from the network. If all your + previous configuration steps are correct, then everything should + "just work". + + + + Use the net/wireshark + port to debug the DHCP and TFTP + network traffic to look for any problems. There is a missing after "problems." + + + + Make sure that the pxeboot file can + be retrieved by TFTP. On your + TFTP server, look in + /var/log/xferlog to ensure that the + pxeboot file is being retrieved from + the correct location. To test the configuration from + dhcpd.conf above: + + &prompt.root; tftp 192.168.0.1 +tftp> get FreeBSD/install/boot/pxeboot +Received 264951 bytes in 0.1 seconds + + + + Make sure that the root file system can be mounted + via NFS. To test configuration from + dhcpd.conf above: + + &prompt.root; mount -t nfs 192.168.0.1:/b/tftpboot/FreeBSD/install /mnt + + + + Read the code in src/sys/boot/i386/libi386/pxe.c + to understand how the pxeboot loader sets + variables like boot.nfsroot.server and + boot.nfsroot.path. These variables are then + used in the NFS diskless root mount code in + src/sys/nfsclient/nfs_diskless.c. + + + + Read &man.pxeboot.8; and &man.loader.8;. + + + + + ISDN I think the rest looks good. Nice work! Glen -- Glen Barber | gjb@FreeBSD.org FreeBSD Documentation Project From owner-freebsd-doc@FreeBSD.ORG Sat Sep 3 00:35:00 2011 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id CB631106566C for ; Sat, 3 Sep 2011 00:35:00 +0000 (UTC) (envelope-from wblock@wonkity.com) Received: from wonkity.com (wonkity.com [67.158.26.137]) by mx1.freebsd.org (Postfix) with ESMTP id 82DA78FC08 for ; Sat, 3 Sep 2011 00:35:00 +0000 (UTC) Received: from wonkity.com (localhost [127.0.0.1]) by wonkity.com (8.14.5/8.14.5) with ESMTP id p830YqKJ002301; Fri, 2 Sep 2011 18:34:52 -0600 (MDT) (envelope-from wblock@wonkity.com) Received: from localhost (wblock@localhost) by wonkity.com (8.14.5/8.14.5/Submit) with ESMTP id p830YqPU002298; Fri, 2 Sep 2011 18:34:52 -0600 (MDT) (envelope-from wblock@wonkity.com) Date: Fri, 2 Sep 2011 18:34:52 -0600 (MDT) From: Warren Block To: Craig Rodrigues In-Reply-To: Message-ID: References: User-Agent: Alpine 2.00 (BSF 1167 2008-08-23) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.2.7 (wonkity.com [127.0.0.1]); Fri, 02 Sep 2011 18:34:53 -0600 (MDT) Cc: freebsd-doc@freebsd.org Subject: Re: PXE Booting with an NFS root file system X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 03 Sep 2011 00:35:00 -0000 On Fri, 2 Sep 2011, Craig Rodrigues wrote: > I have updated the page: > > http://people.freebsd.org/~rodrigc/doc/doc/en_US.ISO8859-1/books/handbook/network-pxe-nfs.html > > Please review. Looks good! A note about TFTP's problems with files larger than 32M could be a good addition to the memory file system section. A mention and referral to the BUGS section of tftp(1) ought to be enough. From owner-freebsd-doc@FreeBSD.ORG Sat Sep 3 00:39:18 2011 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 7A846106566C for ; Sat, 3 Sep 2011 00:39:18 +0000 (UTC) (envelope-from yanegomi@gmail.com) Received: from mail-pz0-f45.google.com (mail-pz0-f45.google.com [209.85.210.45]) by mx1.freebsd.org (Postfix) with ESMTP id 4D16F8FC16 for ; Sat, 3 Sep 2011 00:39:18 +0000 (UTC) Received: by pzk33 with SMTP id 33so10796878pzk.18 for ; Fri, 02 Sep 2011 17:39:17 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=date:from:to:cc:subject:in-reply-to:message-id:references :user-agent:mime-version:content-type; bh=a/iUgGD+lCwMT7MCdJrz4lnRpffJnhALUAj10E/0Exk=; b=NoWrxoNLLYcTx6VTmRsst0ZA+Rg83ShNsFWVlf38cRSkEbB75wpUnj5geNkNLJLPBL loV9BG1276n7bGQMxlGuD4pyRci1YPKEfRnfmtjOnwff3hVxOc7ZkZEdmc4CVzRwkxrJ IH0huk1P9PsiGJ09eurzGRJ/cpJ+wX+4cQoS0= Received: by 10.68.60.164 with SMTP id i4mr2780156pbr.401.1315010357695; Fri, 02 Sep 2011 17:39:17 -0700 (PDT) Received: from c-24-6-49-154.hsd1.ca.comcast.net (c-24-6-49-154.hsd1.ca.comcast.net. [24.6.49.154]) by mx.google.com with ESMTPS id u2sm1871812pbq.9.2011.09.02.17.39.16 (version=TLSv1/SSLv3 cipher=OTHER); Fri, 02 Sep 2011 17:39:16 -0700 (PDT) Date: Fri, 2 Sep 2011 17:39:15 -0700 (PDT) From: Garrett Cooper To: Warren Block In-Reply-To: Message-ID: References: User-Agent: Alpine 2.00 (BSF 1167 2008-08-23) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed Cc: freebsd-doc@freebsd.org Subject: Re: PXE Booting with an NFS root file system X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 03 Sep 2011 00:39:18 -0000 On Fri, 2 Sep 2011, Warren Block wrote: > On Fri, 2 Sep 2011, Craig Rodrigues wrote: > >> I have updated the page: >> >> http://people.freebsd.org/~rodrigc/doc/doc/en_US.ISO8859-1/books/handbook/network-pxe-nfs.html >> >> Please review. > > Looks good! A note about TFTP's problems with files larger than 32M could be > a good addition to the memory file system section. A mention and referral to > the BUGS section of tftp(1) ought to be enough. This is no longer an issue on FreeBSD at least after edwin's changes were integrated in to tftpd (included in 8.2-RELEASE/9.x+?). Thanks, -Garrett From owner-freebsd-doc@FreeBSD.ORG Sat Sep 3 00:58:58 2011 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 9414C106567C for ; Sat, 3 Sep 2011 00:58:58 +0000 (UTC) (envelope-from crodr001@gmail.com) Received: from mail-bw0-f54.google.com (mail-bw0-f54.google.com [209.85.214.54]) by mx1.freebsd.org (Postfix) with ESMTP id 1F6DB8FC14 for ; Sat, 3 Sep 2011 00:58:57 +0000 (UTC) Received: by bkat8 with SMTP id t8so4278107bka.13 for ; Fri, 02 Sep 2011 17:58:57 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=mime-version:sender:in-reply-to:references:date :x-google-sender-auth:message-id:subject:from:to:cc:content-type; bh=IHae9GPzi0nkNZHTAXjWhyqWE/hBXZaq1V9UccekFog=; b=iLy8uyEEY046RI+T94JymZ6FCC5hZgNvARelrYlAIeJFZHtxpTPpgzoZDJFcWRBrLb Sp71SkjvBudub2B6x9Ta1qZClEjs6wTfD42FZaNFLaWV5whiKrJzNwewNp5f/menrFv+ SnE133lNbu7kCYKsklmakuxOuPB1ScemDy18A= MIME-Version: 1.0 Received: by 10.204.149.82 with SMTP id s18mr877496bkv.387.1315011536998; Fri, 02 Sep 2011 17:58:56 -0700 (PDT) Sender: crodr001@gmail.com Received: by 10.204.58.196 with HTTP; Fri, 2 Sep 2011 17:58:56 -0700 (PDT) In-Reply-To: References: Date: Fri, 2 Sep 2011 17:58:56 -0700 X-Google-Sender-Auth: Yl9jyeF_xjBKRIoBQjYWRijU4EE Message-ID: From: Craig Rodrigues To: Garrett Cooper Content-Type: text/plain; charset=ISO-8859-1 Cc: freebsd-doc@freebsd.org Subject: Re: PXE Booting with an NFS root file system X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 03 Sep 2011 00:58:58 -0000 On Fri, Sep 2, 2011 at 5:39 PM, Garrett Cooper wrote: > > This is no longer an issue on FreeBSD at least after edwin's changes were > integrated in to tftpd (included in 8.2-RELEASE/9.x+?). > Thanks, > -Garrett > True. However, these instructions are applicable to even FreeBSD 4.x, so is still worth noting. edwin's TFTP implementation has been merged to 7.x also. -- Craig Rodrigues rodrigc@crodrigues.org From owner-freebsd-doc@FreeBSD.ORG Sat Sep 3 01:02:07 2011 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id A0B631065673 for ; Sat, 3 Sep 2011 01:02:07 +0000 (UTC) (envelope-from gjb@FreeBSD.org) Received: from glenbarber.us (onyx.glenbarber.us [199.48.134.227]) by mx1.freebsd.org (Postfix) with SMTP id 6079D8FC08 for ; Sat, 3 Sep 2011 01:02:07 +0000 (UTC) Received: (qmail 75165 invoked by uid 0); 2 Sep 2011 21:02:06 -0400 Received: from unknown (HELO schism.local) (gjb@76.124.49.145) by 0 with SMTP; 2 Sep 2011 21:02:06 -0400 Message-ID: <4E617C86.30107@FreeBSD.org> Date: Fri, 02 Sep 2011 21:01:58 -0400 From: Glen Barber User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.6; rv:6.0.1) Gecko/20110830 Thunderbird/6.0.1 MIME-Version: 1.0 To: Craig Rodrigues References: In-Reply-To: X-Enigmail-Version: 1.3.1 Content-Type: multipart/signed; micalg=pgp-sha256; protocol="application/pgp-signature"; boundary="------------enig15A69ECF750A2D1566E0CDFC" Cc: freebsd-doc@freebsd.org Subject: Re: PXE Booting with an NFS root file system X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 03 Sep 2011 01:02:07 -0000 This is an OpenPGP/MIME signed message (RFC 2440 and 3156) --------------enig15A69ECF750A2D1566E0CDFC Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: quoted-printable On 9/2/11 8:58 PM, Craig Rodrigues wrote: > On Fri, Sep 2, 2011 at 5:39 PM, Garrett Cooper wro= te: >> >> This is no longer an issue on FreeBSD at least after edwin's changes w= ere >> integrated in to tftpd (included in 8.2-RELEASE/9.x+?). >> Thanks, >> -Garrett >> >=20 > True. However, these instructions are applicable to even FreeBSD 4.x, > so is still worth noting. > edwin's TFTP implementation has been merged to 7.x also. >=20 I think we'll get few complaints if we don't worry about 4.x support. :-)= --=20 Glen Barber | gjb@FreeBSD.org FreeBSD Documentation Project --------------enig15A69ECF750A2D1566E0CDFC Content-Type: application/pgp-signature; name="signature.asc" Content-Description: OpenPGP digital signature Content-Disposition: attachment; filename="signature.asc" -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.11 (Darwin) iQEcBAEBCAAGBQJOYXyNAAoJEFJPDDeguUajJeMIAJuvnOV5jG/zRnZw2jXzm3uh U+PYP2DDnAITEPGIe6lqqzW1P4+RZdF2l0waOMcx8OIdkltnvsjxSnWE3DlSSPkY zaMOLRpTKfKv8qnfQwc+mteThvNDlx/fnOZjyl7RdXzItACEdu7C2/TZ1DzQk+Tf PYzQrTo24m4ZOm8FRChQhuanE2YaL8GZGvwADlHdrpo97puG9KO+xh9JXpY3el0P uP8c3HcfU1W+eZg55mZqhWLXESUwHBA0fWL77ZXWlN5nK0vZ/zl4k2UY/d1eT5hM ApCusdyF1UPPG4xtdlYB5qbuUbJWKX1aEPzvIY38ddeRMJLGTrvFfwnrWuwpkVM= =eWk7 -----END PGP SIGNATURE----- --------------enig15A69ECF750A2D1566E0CDFC-- From owner-freebsd-doc@FreeBSD.ORG Sat Sep 3 03:12:28 2011 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id BFE74106566C for ; Sat, 3 Sep 2011 03:12:28 +0000 (UTC) (envelope-from manek@ghur.net) Received: from mail11c.verio-web.com (mail11c.verio-web.com [204.202.242.55]) by mx1.freebsd.org (Postfix) with ESMTP id 60DE78FC12 for ; Sat, 3 Sep 2011 03:12:27 +0000 (UTC) Received: from mx112.stngva01.us.mxservers.net (198.173.112.18) by mail11c.verio-web.com (RS ver 1.0.95vs) with SMTP id 1-0257707946 for ; Fri, 2 Sep 2011 22:45:46 -0400 (EDT) Received: from unknown [161.58.148.99] (EHLO mmm1129.verio-web.com) by va1-mx112.stngva01.us.mxservers.net (mxl_mta-3.1.0-05) with ESMTP id ad4916e4.2784865184.1221141.00-002.va1-mx112.stngva01.us.mxservers.net (envelope-from ); Fri, 02 Sep 2011 22:45:46 -0400 (EDT) Received: (qmail 1265 invoked from network); 3 Sep 2011 02:45:45 -0000 Received: from unknown (HELO Redemption) (manek@71.116.64.195) by with ESMTPA; 3 Sep 2011 02:45:45 -0000 From: "Sameer R. Manek" To: Date: Fri, 2 Sep 2011 19:45:44 -0700 Message-ID: <000f01cc69e3$947f5fd0$bd7e1f70$@ghur.net> MIME-Version: 1.0 X-Mailer: Microsoft Outlook 14.0 Thread-Index: Acxp4YqyxX8B+Ou4TKSu7/7eAqFygA== Content-Language: en-us X-Spam: [F=0.2000000000; S=0.200(2010122901); MH=0.500(2011090224)] X-MAIL-FROM: X-SOURCE-IP: [161.58.148.99] X-SF-Loop: 1 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Content-Filtered-By: Mailman/MimeDel 2.1.5 Subject: sound support X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 03 Sep 2011 03:12:28 -0000 Hello Documentation team. http://www.freebsd.org/doc/handbook/sound-setup.html seems to be a little out of date, since it's focused on the expectation that a creative labs card has been installed, which doesn't reflect the reality that a majority of motherboards come with a building audio chipset. Perhaps a mention of device snd_hda might be worthy of inclusion? Based on: http://lists.freebsd.org/pipermail/freebsd-multimedia/2006-September/004720. html Here's my suggested inclusion High Definition Audio for Intel HDA and compatible audio chipsets Many current systems can use a driver based on the works of Ariff Abdullah & Stephane E. Potvin's HDA driver. To use the driver as a kernel module # kldload snd_hda From owner-freebsd-doc@FreeBSD.ORG Sat Sep 3 03:49:59 2011 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 79EA2106566C for ; Sat, 3 Sep 2011 03:49:59 +0000 (UTC) (envelope-from gjb@FreeBSD.org) Received: from glenbarber.us (onyx.glenbarber.us [199.48.134.227]) by mx1.freebsd.org (Postfix) with SMTP id 2CC1F8FC08 for ; Sat, 3 Sep 2011 03:49:59 +0000 (UTC) Received: (qmail 81400 invoked by uid 0); 2 Sep 2011 23:49:58 -0400 Received: from unknown (HELO schism.local) (gjb@76.124.49.145) by 0 with SMTP; 2 Sep 2011 23:49:58 -0400 Message-ID: <4E61A3E5.3030504@FreeBSD.org> Date: Fri, 02 Sep 2011 23:49:57 -0400 From: Glen Barber User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.6; rv:6.0.1) Gecko/20110830 Thunderbird/6.0.1 MIME-Version: 1.0 To: "Sameer R. Manek" References: <000f01cc69e3$947f5fd0$bd7e1f70$@ghur.net> In-Reply-To: <000f01cc69e3$947f5fd0$bd7e1f70$@ghur.net> X-Enigmail-Version: 1.3.1 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit Cc: freebsd-doc@freebsd.org Subject: Re: sound support X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 03 Sep 2011 03:49:59 -0000 On 9/2/11 10:45 PM, Sameer R. Manek wrote: > Hello Documentation team. > > Hi Sameer, > > http://www.freebsd.org/doc/handbook/sound-setup.html > > seems to be a little out of date, since it's focused on the expectation that > a creative labs card has been installed, which doesn't reflect the reality > that a majority of motherboards come with a building audio chipset. > > Perhaps a mention of device snd_hda might be worthy of inclusion? Based on: > > http://lists.freebsd.org/pipermail/freebsd-multimedia/2006-September/004720. > html > > > Here's my suggested inclusion > > High Definition Audio for Intel HDA and compatible audio chipsets > > Many current systems can use a driver based on the works of Ariff Abdullah & > Stephane E. Potvin's HDA driver. > > To use the driver as a kernel module > > # kldload snd_hda > As I understand it right now, snd_hda is part of the GENERIC kernel for the upcoming 9.0-RELEASE. As such, I don't think we'll even need to include any additional information to enable the sound drivers unless they've been explicitly excluded from the kernel. This seems like another section of the Handbook that may need some heavy lifting to get it current with the latest upcoming release. Thanks for the report! -- Glen Barber | gjb@FreeBSD.org FreeBSD Documentation Project From owner-freebsd-doc@FreeBSD.ORG Sat Sep 3 17:29:20 2011 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 8C94E1065676 for ; Sat, 3 Sep 2011 17:29:20 +0000 (UTC) (envelope-from radiomlodychbandytow@o2.pl) Received: from moh1-ve1.go2.pl (moh1-ve1.go2.pl [193.17.41.131]) by mx1.freebsd.org (Postfix) with ESMTP id 4EFF48FC13 for ; Sat, 3 Sep 2011 17:29:20 +0000 (UTC) Received: from moh1-ve1.go2.pl (unknown [10.0.0.131]) by moh1-ve1.go2.pl (Postfix) with ESMTP id C13E4940157 for ; Sat, 3 Sep 2011 19:29:15 +0200 (CEST) Received: from unknown (unknown [10.0.0.42]) by moh1-ve1.go2.pl (Postfix) with SMTP for ; Sat, 3 Sep 2011 19:29:15 +0200 (CEST) Received: from dns-failure [89.25.246.78] by poczta.o2.pl with ESMTP id KfUCWf; Sat, 03 Sep 2011 19:29:15 +0200 Message-ID: <4E6263E3.9030401@o2.pl> Date: Sat, 03 Sep 2011 19:29:07 +0200 From: =?UTF-8?B?UmFkaW8gbcWCb2R5Y2ggYmFuZHl0w7N3?= User-Agent: Mozilla/5.0 (Windows NT 5.2; WOW64; rv:6.0.1) Gecko/20110830 Thunderbird/6.0.1 MIME-Version: 1.0 To: freebsd-doc@freebsd.org Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit X-O2-Trust: 2, 63 X-O2-SPF: neutral Subject: FreeBSD Handbook, Permissions lacks info about ACL X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 03 Sep 2011 17:29:20 -0000 http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/permissions.html There's no word about ACL. I think it should be at least mentioned. -- Twoje radio From owner-freebsd-doc@FreeBSD.ORG Sat Sep 3 22:38:21 2011 Return-Path: Delivered-To: doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id EF2B8106564A for ; Sat, 3 Sep 2011 22:38:21 +0000 (UTC) (envelope-from mike@skew.org) Received: from chilled.skew.org (chilled.skew.org [70.90.116.205]) by mx1.freebsd.org (Postfix) with ESMTP id C40518FC12 for ; Sat, 3 Sep 2011 22:38:21 +0000 (UTC) Received: from chilled.skew.org (localhost [127.0.0.1]) by chilled.skew.org (8.14.3/8.14.3) with ESMTP id p83MGW9c049529 for ; Sat, 3 Sep 2011 16:16:33 -0600 (MDT) (envelope-from mike@chilled.skew.org) Received: (from mike@localhost) by chilled.skew.org (8.14.3/8.14.3/Submit) id p83MGWR9049528 for doc@freebsd.org; Sat, 3 Sep 2011 16:16:32 -0600 (MDT) (envelope-from mike) From: Mike Brown Message-Id: <201109032216.p83MGWR9049528@chilled.skew.org> To: doc@freebsd.org Date: Sat, 3 Sep 2011 16:16:32 -0600 (MDT) X-Whoa: whoa. X-Mailer: ELM [version 2.4ME+ PL124d (25)] MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Content-Type: text/plain; charset="UTF-8" Cc: Subject: FreeBSD Handbook sec. 26.2 (freebsd-update) missing info X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 03 Sep 2011 22:38:22 -0000 Hello, Section 26.2 of the FreeBSD Handbook[1] says "The latest version of freebsd-update may be installed by downloading the tar and gzip'd package from the above URL and installed with the following commands:" However, there's no URL above this. There's a link to the man page, and a link to the http://www.FreeBSD.org/releases/ page, but neither of those has freebsd-update-upgrade.tgz on them. This should be fixed. Also, the phrase "For all current releases, downloading the latest version is not required" maybe should be moved up before the download instructions so that it comes before the implication that the download is necessary. And I'm not really clear on whether I need it. I have 8.0-STABLE, last updated a while ago (not long after the 2009-12-03 security update to the utility). Is this a "current release" that means I don't need to update the utility? Let me know. Thanks! [1] at