docs/157354: [PATCH] update newfs(8) man page after changed defaults

[Niclas Zeising]

>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 at 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: