From owner-freebsd-doc@FreeBSD.ORG Thu May 26 20:10: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 19D45106564A for ; Thu, 26 May 2011 20:10: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 DC7C78FC12 for ; Thu, 26 May 2011 20:10: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 p4QKA4SZ012307 for ; Thu, 26 May 2011 20:10:04 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id p4QKA420012306; Thu, 26 May 2011 20:10:04 GMT (envelope-from gnats) Resent-Date: Thu, 26 May 2011 20:10:04 GMT Resent-Message-Id: <201105262010.p4QKA420012306@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, Niclas Zeising Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id C6DDC106564A; Thu, 26 May 2011 20:09:24 +0000 (UTC) (envelope-from zeising@daemonic.se) Received: from mail.lysator.liu.se (unknown [IPv6:2001:6b0:17:f0a0::3]) by mx1.freebsd.org (Postfix) with ESMTP id 23F5D8FC13; Thu, 26 May 2011 20:09:23 +0000 (UTC) Received: from mail.lysator.liu.se (localhost [127.0.0.1]) by mail.lysator.liu.se (Postfix) with ESMTP id E465E40020; Thu, 26 May 2011 22:09:22 +0200 (CEST) Received: by mail.lysator.liu.se (Postfix, from userid 1004) id D9A5C40021; Thu, 26 May 2011 22:09:22 +0200 (CEST) Received: from mx.daemonic.se (h-90-99.A163.priv.bahnhof.se [79.136.90.99]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by mail.lysator.liu.se (Postfix) with ESMTPSA id E757A40020; Thu, 26 May 2011 22:09:21 +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 A7410119C04; Thu, 26 May 2011 22:09:21 +0200 (CEST) Received: from vincent.daemonic.se (login.daemonic.se [IPv6:2001:470:dca9:0:1::10]) by mail.daemonic.se (Postfix) with ESMTPS id 7DD7B12B2DA; Thu, 26 May 2011 22:09:21 +0200 (CEST) Received: (from zeising@localhost) by vincent.daemonic.se (8.14.4/8.14.4/Submit) id p4QK9LUg080794; Thu, 26 May 2011 22:09:21 +0200 (CEST) (envelope-from zeising) Message-Id: <201105262009.p4QK9LUg080794@vincent.daemonic.se> Date: Thu, 26 May 2011 22:09:21 +0200 (CEST) From: Niclas Zeising To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Cc: mckusick@FreeBSD.org Subject: docs/157354: [PATCH] update newfs(8) man page after changed defaults X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Niclas Zeising List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 26 May 2011 20:10:05 -0000 >Number: 157354 >Category: docs >Synopsis: [PATCH] update newfs(8) man page after changed defaults >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: update >Submitter-Id: current-users >Arrival-Date: Thu May 26 20:10:04 UTC 2011 >Closed-Date: >Last-Modified: >Originator: Niclas Zeising >Release: FreeBSD 8.2-RELEASE amd64 >Organization: >Environment: System: FreeBSD vincent.daemonic.se 8.2-RELEASE FreeBSD 8.2-RELEASE #0: Wed Apr 20 17:22:47 CEST 2011 root@vincent.daemonic.se:/usr/obj/usr/src/sys/VINCENT amd64 >Description: The default sizes for blocksize and fragment size when using newfs was recently changed. Documentation needs to be updated to reflect this. >How-To-Repeat: >Fix: Attached patch updates the manual page to mention the new defaults. --- sbin.newfs.8.diff begins here --- Index: newfs.8 =================================================================== --- newfs.8 (revision 222288) +++ newfs.8 (working copy) @@ -28,7 +28,7 @@ .\" @(#)newfs.8 8.6 (Berkeley) 5/3/95 .\" $FreeBSD$ .\" -.Dd February 22, 2011 +.Dd May 26, 2011 .Dt NEWFS 8 .Os .Sh NAME @@ -112,7 +112,7 @@ The block size of the file system, in bytes. It must be a power of 2. The -default size is 16384 bytes, and the smallest allowable size is 4096 bytes. +default size is 32768 bytes, and the smallest allowable size is 4096 bytes. The optimal block:fragment ratio is 8:1. Other ratios are possible, but are not recommended, and may produce poor results. @@ -143,7 +143,9 @@ .Ar blocksize Ns /8 and .Ar blocksize . -The default is 2048 bytes. +The default is 4096 bytes. +Having a lower size will result in poor performance with modern disks utilizing +4096 byte sectors. .It Fl g Ar avgfilesize The expected average file size for the file system. .It Fl h Ar avgfpdir @@ -279,11 +281,8 @@ .Pa ad3s1a . The .Nm -utility will use a block size of 16384 bytes, a fragment size of 2048 bytes +utility will use a block size of 32768 bytes, a fragment size of 4096 bytes and the largest possible number of blocks per cylinders group. -These values tend to produce better performance for most applications -than the historical defaults -(8192 byte block size and 1024 byte fragment size). This large fragment size may lead to much wasted space on file systems that contain many small files. .Sh SEE ALSO --- sbin.newfs.8.diff ends here --- >Release-Note: >Audit-Trail: >Unformatted: