From owner-freebsd-doc@FreeBSD.ORG Thu Aug 15 19:10:02 2013 Return-Path: Delivered-To: freebsd-doc@smarthost.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTP id 6EA20954 for ; Thu, 15 Aug 2013 19:10:02 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:1900:2254:206c::16:87]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 4D2EC2392 for ; Thu, 15 Aug 2013 19:10:02 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.7/8.14.7) with ESMTP id r7FJA2NR080747 for ; Thu, 15 Aug 2013 19:10:02 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.7/8.14.7/Submit) id r7FJA22V080746; Thu, 15 Aug 2013 19:10:02 GMT (envelope-from gnats) Resent-Date: Thu, 15 Aug 2013 19:10:02 GMT Resent-Message-Id: <201308151910.r7FJA22V080746@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, Keve Nagy Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTP id 84A6B7E7 for ; Thu, 15 Aug 2013 19:02:14 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from oldred.freebsd.org (oldred.freebsd.org [8.8.178.121]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 715E4234F for ; Thu, 15 Aug 2013 19:02:14 +0000 (UTC) Received: from oldred.freebsd.org ([127.0.1.6]) by oldred.freebsd.org (8.14.5/8.14.7) with ESMTP id r7FJ2CMl040019 for ; Thu, 15 Aug 2013 19:02:12 GMT (envelope-from nobody@oldred.freebsd.org) Received: (from nobody@localhost) by oldred.freebsd.org (8.14.5/8.14.5/Submit) id r7FJ2CFH040015; Thu, 15 Aug 2013 19:02:12 GMT (envelope-from nobody) Message-Id: <201308151902.r7FJ2CFH040015@oldred.freebsd.org> Date: Thu, 15 Aug 2013 19:02:12 GMT From: Keve Nagy To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Subject: docs/181331: Typo (missing letter) in example dhcpd config for netboot. X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 15 Aug 2013 19:10:02 -0000 >Number: 181331 >Category: docs >Synopsis: Typo (missing letter) in example dhcpd config for netboot. >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 Aug 15 19:10:00 UTC 2013 >Closed-Date: >Last-Modified: >Originator: Keve Nagy >Release: N/A >Organization: N/A >Environment: N/A >Description: There is a typo in the example configuration code for dhcpd in the netboot section of the handbook. http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/network-pxe-nfs.html Section 31.8.3. Setting up the DHCP Server, step 2, sample config line #6. option domain-name-server 192.168.35.35, 192.168.35.36 ; A letter "s" is missing from the end of the second word, making domain-name-server in singular instead of plural. The correct line should read option domain-name-servers 192.168.35.35, 192.168.35.36 ; I was trying to do some testing today, following the handbook step by step. ISC DHCPD refuses to start with the incorrectly spelt keyword in it. It does not recognize "domain-name-server", it only recognizes the plural form as "domain-name-servers". As the incorrect form is actually a proper English expression and the line without the pluralizing "s" makes perfect sense (especially when one has a single nameserver to define), it is easy to make the mistake. For the same reason, it could be very difficult for an inexperienced sysadmin or a beginner FreeBSD user to spot the problem. This should be corrected as soon as anyone with access right to the documentation source can afford the time and energy to commit the correction. >How-To-Repeat: Follow chapter 31.8.3 of the handbook to the letter and make the spelling mistake shown in the example configuration code. >Fix: Replace the line option domain-name-server 192.168.35.35, 192.168.35.36 ; with option domain-name-servers 192.168.35.35, 192.168.35.36 ; adding a pluralizing "s" to the end of keyword domain-name-serverS. >Release-Note: >Audit-Trail: >Unformatted: