From owner-freebsd-doc@FreeBSD.ORG Thu Feb 16 04:26:15 2012 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 B86D2106566B; Thu, 16 Feb 2012 04:26:15 +0000 (UTC) (envelope-from lists@eitanadler.com) Received: from mail-ww0-f50.google.com (mail-ww0-f50.google.com [74.125.82.50]) by mx1.freebsd.org (Postfix) with ESMTP id 1D1AA8FC08; Thu, 16 Feb 2012 04:26:14 +0000 (UTC) Received: by wgbdq11 with SMTP id dq11so1571881wgb.31 for ; Wed, 15 Feb 2012 20:26:14 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=eitanadler.com; s=0xdeadbeef; h=mime-version:in-reply-to:references:from:date:message-id:subject:to :cc:content-type; bh=FHpF1Mkg8ke0xfuK44qEPK+etGjo6I3Z7QNTLXXW7PA=; b=kD2m/e1PsZI5MdN8YYAUUZRaSwWDIGCW/mbW4m2t/EzfmgsbAzDLaLDMRFli8JwHZI oOt2IVoWhBMux8xpSqMJlbPlxFgujw7TITcfm5qhamUsC6UnovZ/whRk3I1KFBhgqCYO EiBoDvvu5UjFVS/ZqKz0W2NorEE9XluxcxQ+E= Received: by 10.180.107.99 with SMTP id hb3mr1540540wib.5.1329366374209; Wed, 15 Feb 2012 20:26:14 -0800 (PST) MIME-Version: 1.0 Received: by 10.223.15.90 with HTTP; Wed, 15 Feb 2012 20:25:44 -0800 (PST) In-Reply-To: References: <20120215040311.GB1862@glenbarber.us> <20120215213448.GA29817@hemlock.hydra> <20120215221813.GB5203@glenbarber.us> <20120216015300.GA1837@glenbarber.us> <20120216033525.GD1837@glenbarber.us> From: Eitan Adler Date: Wed, 15 Feb 2012 23:25:44 -0500 Message-ID: To: Warren Block Content-Type: text/plain; charset=UTF-8 X-Gm-Message-State: ALoCoQnQqsYAaeX/DH4aFKW7u7rKOHWViv9QMJOYYmxtndRuskGKJirVPM/yisGTcUSZYiSXjB8x Cc: freebsd-doc@freebsd.org Subject: Re: CfR: config chapter changes 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, 16 Feb 2012 04:26:15 -0000 I'm sorry about that last patch. This one should be better. Index: config/chapter.sgml =================================================================== RCS file: /home/dcvs/doc/en_US.ISO8859-1/books/handbook/config/chapter.sgml,v retrieving revision 1.251 diff -u -r1.251 chapter.sgml --- config/chapter.sgml 13 Feb 2012 04:28:35 -0000 1.251 +++ config/chapter.sgml 16 Feb 2012 04:24:13 -0000 @@ -473,13 +473,13 @@ certain times. The cron utility uses two different - types of configuration files, the system crontab and user crontabs. The - only difference between these two formats is the sixth field. In the - system crontab, the sixth field is the name of a user for the command - to run as. This gives the system crontab the ability to run commands - as any user. In a user crontab, the sixth field is the command to run, - and all commands run as the user who created the crontab; this is an - important security feature. + types of configuration files, the system crontab and user crontabs. + These formats only differ in the sixth field and later. In the + system crontab, cron will run the command as the user + specified in the sixth field. In a user crontab, all commands run as + the user who created the crontab, so the sixth field is the last field; + this is an important security feature. The final field is always + the command to run. User crontabs allow individual users to schedule tasks without the @@ -487,10 +487,11 @@ permissions of the user who owns the crontab. The root user can have a user crontab just like - any other user. This one is different from - /etc/crontab (the system crontab). Because of the - system crontab, there is usually no need to create a user crontab - for root. + any other user. The root user crontab is + separate from /etc/crontab (the system crontab). + Because the system system crontab effectively invokes the + specified commands as root there is usually no need to + create a user crontab for root. Let us take a look at the /etc/crontab file @@ -547,11 +548,8 @@ day of the week. All these fields must be numeric values, and follow the twenty-four hour clock. The who field is special, and only exists in the /etc/crontab file. - This field specifies which user the command should be run as. - When a user installs his or her crontab file, they - will not have this option. Finally, the command option is listed. - This is the last field, so naturally it should designate the command - to be executed. + This field specifies which user the command should be run + as. The last field is the command to be executed. @@ -584,8 +582,9 @@ Installing a Crontab - You must not use the procedure described here to - edit/install the system crontab. Simply use your favorite + Do not use the procedure described here to + edit and install the system crontab, + /etc/crontab. Just use your favorite editor: the cron utility will notice that the file has changed and immediately begin using the updated version. See @@ -596,7 +595,7 @@ To install a freshly written user crontab, first use your favorite editor to create a file in the proper format, and then use the - crontab utility. The most common usage + &man.crontab.1; utility. The most common usage is: &prompt.user; crontab crontab-file @@ -613,8 +612,7 @@ without the use of a template, the crontab -e option is available. This will invoke the selected editor with an empty file. When the file is saved, it will be - automatically installed by the crontab command. - + automatically installed by the crontab command. If you later want to remove your user crontab completely, use crontab with the @@ -636,7 +634,7 @@ - Using rc under &os; + Using &man.rc.8; Under &os; In 2002 &os; integrated the NetBSD rc.d system for system initialization. @@ -1674,7 +1672,7 @@ - Tuning with sysctl + Tuning with &man.sysctl.8; sysctl @@ -1944,7 +1942,7 @@ out of space and the update to fail. - More Details about Soft Updates + More Details About Soft Updates Soft Updates @@ -2390,15 +2388,36 @@ of the Handbook. - Swap on a New Hard Drive + Swap on a New or Existing Hard Drive - The best way to add swap, of course, is to use this as an - excuse to add another hard drive. You can always use another - hard drive, after all. If you can do this, go reread the - discussion of swap space - in - of the Handbook for some suggestions on how to best - arrange your swap. + Adding a new hard drive for swap gives better performance + than adding a partition on an existing drive. Setting up + partitions and hard drives is explained in + . + discusses partition layouts and swap partition size considerations. + + Use &man.swapon.8; to add a swap partition to the system. For example: + + &prompt.root; swapon/dev/ada1s1p2 + + + It is possible to use any partition not currently mounted, even + if it already contains data. Using &man.swapon.8; on a partition that + contains data will overwrite and destroy that data. + Make sure that the partition to be added as swap + is really the intended partition before running + &man.swapon.8;. + + + To automatically add this swap partition on boot, + add an entry to /etc/fstab for the + partition: + + /dev/ada1s1p1 none swap sw 0 0 + + &man.fstab.5; explains the meaning of the entries and + their format in + /etc/fstab. @@ -2878,7 +2897,7 @@ on Linux, it is likely a &os; driver problem and narrowing down which driver causes the problems will help us fix the problem. Note that the ACPI maintainers do not - usually maintain other drivers (e.g sound, + usually maintain other drivers (e.g., sound, ATA, etc.) so any work done on tracking down a driver problem should probably eventually be posted to the &a.current.name; list and mailed to the driver @@ -2898,7 +2917,7 @@ - System Hangs (temporary or permanent) + System Hangs (Temporary or Permanent) Most system hangs are a result of lost interrupts or an interrupt storm. Chipsets have a lot of problems based on how @@ -3058,7 +3077,7 @@ how to fix them: - _OS dependencies + _OS Dependencies Some AML assumes the world consists of various &windows; versions. You can tell &os; to claim it is @@ -3070,7 +3089,7 @@ - Missing Return statements + Missing Return Statements Some methods do not explicitly return a value as the standard requires. While ACPI-CA @@ -3112,8 +3131,7 @@ - Getting Debugging Output From - <acronym>ACPI</acronym> + Getting Debugging Output from <acronym>ACPI</acronym> ACPI -- Eitan Adler