From owner-freebsd-doc@FreeBSD.ORG Sat May 31 18:40:02 2008 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 626A71065677 for ; Sat, 31 May 2008 18:40:02 +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 26B628FC14 for ; Sat, 31 May 2008 18:40:02 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.14.2/8.14.2) with ESMTP id m4VIe2S4029871 for ; Sat, 31 May 2008 18:40:02 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.2/8.14.1/Submit) id m4VIe2rH029870; Sat, 31 May 2008 18:40:02 GMT (envelope-from gnats) Resent-Date: Sat, 31 May 2008 18:40:02 GMT Resent-Message-Id: <200805311840.m4VIe2rH029870@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, Sahil Tandon Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 99A0E1065673 for ; Sat, 31 May 2008 18:38:23 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21]) by mx1.freebsd.org (Postfix) with ESMTP id 6FC498FC17 for ; Sat, 31 May 2008 18:38:23 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from www.freebsd.org (localhost [127.0.0.1]) by www.freebsd.org (8.14.2/8.14.2) with ESMTP id m4VIacxS083423 for ; Sat, 31 May 2008 18:36:38 GMT (envelope-from nobody@www.freebsd.org) Received: (from nobody@localhost) by www.freebsd.org (8.14.2/8.14.1/Submit) id m4VIacGv083422; Sat, 31 May 2008 18:36:38 GMT (envelope-from nobody) Message-Id: <200805311836.m4VIacGv083422@www.freebsd.org> Date: Sat, 31 May 2008 18:36:38 GMT From: Sahil Tandon To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/124167: removed reference to .sh suffix requirement and changed script permission from 755 -> 555 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, 31 May 2008 18:40:02 -0000 >Number: 124167 >Category: docs >Synopsis: removed reference to .sh suffix requirement and changed script permission from 755 -> 555 >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: Sat May 31 18:40:01 UTC 2008 >Closed-Date: >Last-Modified: >Originator: Sahil Tandon >Release: FreeBSD 7.0 >Organization: >Environment: >Description: In the config tuning section of the Handbook, there is mention of an archaic .sh extension requirement for rc scripts. This is no longer a requirement and is thusly removed. Also, scripts in rc.d are installed with unique permissions of 555 (not 755 as noted in the Handbook); that is also corrected in the attached diff. >How-To-Repeat: >Fix: See attached diff. Patch attached with submission follows: --- doc/en_US.ISO8859-1/books/handbook/config/chapter.sgml.old 2008-05-30 18:46:33.000000000 -0400 +++ doc/en_US.ISO8859-1/books/handbook/config/chapter.sgml 2008-05-30 19:08:09.000000000 -0400 @@ -367,13 +367,11 @@ While every script must meet some minimal requirements, most of the time these requirements are &os; version - agnostic. Each script must have a .sh - extension appended to the end and every script must be - executable by the system. The latter may be achieved by using - the chmod command and setting the unique permissions - of 755. There should also be, at minimal, - an option to start the application and an - option to stop the application. + agnostic. Each script must be executable by the system; this is + typically achieved by using the chmod command and + setting the unique permissions of 555. There should + also be, at minimal, options to start and stop + the application. The simplest start up script would probably look a little bit like this one: >Release-Note: >Audit-Trail: >Unformatted: