Bug 204929 - fs_optim and fs_minfree default value is 10% in man fs(5),while newfs(8),tunefs(8) is 8%
Summary: fs_optim and fs_minfree default value is 10% in man fs(5),while newfs(8),tune...
Status: Closed FIXED
Alias: None
Product: Documentation
Classification: Unclassified
Component: Books & Articles (show other bugs)
Version: Latest
Hardware: amd64 Any
: --- Affects Some People
Assignee: freebsd-doc (Nobody)
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2015-12-01 07:51 UTC by Jov
Modified: 2016-04-27 15:52 UTC (History)
1 user (show)

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Jov 2015-12-01 07:51:31 UTC
this from fs(5):
The fs_minfree element gives the minimum acceptable percentage of file
     system blocks that may be free.  If the freelist drops below this level
     only the super-user may continue to allocate blocks.  The fs_minfree ele‐
     ment may be set to 0 if no reserve of free blocks is deemed necessary,
     however severe performance degradations will be observed if the file sys‐
     tem is run at greater than 90% full; thus the default value of fs_minfree
     is 10%.

The element fs_optim specifies whether the file system should try to min‐
     imize the time spent allocating blocks, or if it should attempt to mini‐
     mize the space fragmentation on the disk.  If the value of fs_minfree
     (see above) is less than 10%, then the file system defaults to optimizing
     for space to avoid running out of full sized blocks.  If the value of
     minfree is greater than or equal to 10%, fragmentation is unlikely to be
     problematical, and the file system defaults to optimizing for time.


this from newfs(8):
     -m free-space
             The percentage of space reserved from normal users; the minimum
             free space threshold.  The default value used is defined by
             MINFREE from <ufs/ffs/fs.h>, currently 8%.  See tunefs(8) for
             more details on how to set this option.

-o optimization
             (space or time).  The file system can either be instructed to try
             to minimize the time spent allocating blocks, or to try to mini‐
             mize the space fragmentation on the disk.  If the value of min‐
             free (see above) is less than 8%, the default is to optimize for
             space; if the value of minfree is greater than or equal to 8%,
             the default is to optimize for time.  See tunefs(8) for more
             details on how to set this option.

this from tunefs:
     -m minfree
             Specify the percentage of space held back from normal users; the
             minimum free space threshold.  The default value used is 8%.
             Note that lowering the threshold can adversely affect perfor‐
             mance:
     
             ·   Settings of 5% and less force space optimization to always be
                 used which will greatly increase the overhead for file
                 writes.
             
             ·   The file system's ability to avoid fragmentation will be
                 reduced when the total free space, including the reserve,
                 drops below 15%.  As free space approaches zero, throughput
                 can degrade by up to a factor of three over the performance
                 obtained at a 10% threshold.
             
             If the value is raised above the current usage level, users will
             be unable to allocate files until enough files have been deleted
             to get under the higher threshold.
Comment 1 Jov 2015-12-01 07:53:02 UTC
from the tunefs -p,the 8% is correct:

root@:~ # tunefs -p /dev/da0p2
tunefs: POSIX.1e ACLs: (-a)                                disabled
tunefs: NFSv4 ACLs: (-N)                                   disabled
tunefs: MAC multilabel: (-l)                               disabled
tunefs: soft updates: (-n)                                 enabled
tunefs: soft update journaling: (-j)                       enabled
tunefs: gjournal: (-J)                                     disabled
tunefs: trim: (-t)                                         disabled
tunefs: maximum blocks per file in a cylinder group: (-e)  4096
tunefs: average file size: (-f)                            16384
tunefs: average number of files in a directory: (-s)       64
tunefs: minimum percentage of free space: (-m)             8%
tunefs: space to hold for metadata blocks: (-k)            6408
tunefs: optimization preference: (-o)                      time
tunefs: volume label: (-L)
Comment 2 commit-hook freebsd_committer freebsd_triage 2016-04-23 20:46:39 UTC
A commit references this bug:

Author: bcr
Date: Sat Apr 23 20:45:52 UTC 2016
New revision: 298522
URL: https://svnweb.freebsd.org/changeset/base/298522

Log:
  The default value of MINFREE is defined to be 8% in
  ufs/ffs/fs.h and not 10%.  The newfs(8) and tunefs(8)
  man pages had this change already, but fs(5) did not.
  This change makes it consistent again.

  Bump Dd.

  PR:             204929
  Submitted by:   amutu@amutu.com
  MFC after:      3 days
  Sponsored by:   Essen Linuxhotel Hackathon 2016

Changes:
  head/share/man/man5/fs.5
Comment 3 commit-hook freebsd_committer freebsd_triage 2016-04-27 15:49:23 UTC
A commit references this bug:

Author: bcr
Date: Wed Apr 27 15:48:47 UTC 2016
New revision: 298705
URL: https://svnweb.freebsd.org/changeset/base/298705

Log:
  MFC r298522:

  The default value of MINFREE is defined to be 8% in
  ufs/ffs/fs.h and not 10%.  The newfs(8) and tunefs(8)
  man pages had this change already, but fs(5) did not.
  This change makes it consistent again.

  Bump Dd.

  PR:             204929
  Submitted by:   amutu@amutu.com
  Sponsored by:   Essen Linuxhotel Hackathon 2016

Changes:
_U  stable/10/
  stable/10/share/man/man5/fs.5
Comment 4 Benedict Reuschling freebsd_committer freebsd_triage 2016-04-27 15:52:21 UTC
MFC is done. Thanks for sending in the bug report. PR closed.