History log of /freebsd-10.0-release/sbin/tunefs/tunefs.8
Revision Date Author Comments
(<<< Hide modified files)
(Show modified files >>>)
# 259065 07-Dec-2013 gjb

- Copy stable/10 (r259064) to releng/10.0 as part of the
10.0-RELEASE cycle.
- Update __FreeBSD_version [1]
- Set branch name to -RC1

[1] 10.0-CURRENT __FreeBSD_version value ended at '55', so
start releng/10.0 at '100' so the branch is started with
a value ending in zero.

Approved by: re (implicit)
Sponsored by: The FreeBSD Foundation

# 256281 10-Oct-2013 gjb

Copy head (r256279) to stable/10 as part of the 10.0-RELEASE cycle.

Approved by: re (implicit)
Sponsored by: The FreeBSD Foundation


# 248623 22-Mar-2013 mckusick

The purpose of this change to the FFS layout policy is to reduce the
running time for a full fsck. It also reduces the random access time
for large files and speeds the traversal time for directory tree walks.

The key idea is to reserve a small area in each cylinder group
immediately following the inode blocks for the use of metadata,
specifically indirect blocks and directory contents. The new policy
is to preferentially place metadata in the metadata area and
everything else in the blocks that follow the metadata area.

The size of this area can be set when creating a filesystem using
newfs(8) or changed in an existing filesystem using tunefs(8).
Both utilities use the `-k held-for-metadata-blocks' option to
specify the amount of space to be held for metadata blocks in each
cylinder group. By default, newfs(8) sets this area to half of
minfree (typically 4% of the data area).

This work was inspired by a paper presented at Usenix's FAST '13:
www.usenix.org/conference/fast13/ffsck-fast-file-system-checker

Details of this implementation appears in the April 2013 of ;login:
www.usenix.org/publications/login/april-2013-volume-38-number-2.
A copy of the April 2013 ;login: paper can also be downloaded
from: www.mckusick.com/publications/faster_fsck.pdf.

Reviewed by: kib
Tested by: Peter Holm
MFC after: 4 weeks


# 223430 22-Jun-2011 trasz

Advertise growfs(8) a little better.


# 221659 08-May-2011 gavin

We now have multiple filesystems (UFS, ZFS, ...), so for tools that only
operate on one type of filesystem, mention this.
While here, capitalise the use of "UFS" in growfs.8 to match other uses of
the term in other man pages.

MFC after: 1 week


# 216798 29-Dec-2010 kib

Add support for FS_TRIM to user-mode UFS utilities.

Reviewed by: mckusick, pjd, pho
Tested by: pho
MFC after: 1 month


# 207141 24-Apr-2010 jeff

- Merge soft-updates journaling from projects/suj/head into head. This
brings in support for an optional intent log which eliminates the need
for background fsck on unclean shutdown.

Sponsored by: iXsystems, Yahoo!, and Juniper.
With help from: McKusick and Peter Holm


# 200796 21-Dec-2009 trasz

Implement NFSv4 ACL support for UFS.

Reviewed by: rwatson


# 198316 21-Oct-2009 remko

The tunefs utility does not work on active filesystems.

PR: docs/139705
Submitted by: Warren Block <wblock at wonkity dot com>
Approved by: imp (mentor, implicit)


# 191656 29-Apr-2009 trasz

Slightly improve gjournal documentation.

Reviewed by: pjd


# 172305 23-Sep-2007 maxim

o s/filesystem/file system/g.

Pointed out by: ru
Approved by: re (bmah)
MFC after: 3 days


# 171813 12-Aug-2007 maxim

o You have to reboot the system after tuning softupdates on the root
filesystem on to make SU work.

Approved by: re (hrs)
MFC after: 1 week


# 163842 31-Oct-2006 pjd

Add -J flag to both newfs(8) and tunefs(8) which allows to enable gjournal
support.
I left -j flag for UFS journal implementation which we may gain at some
point.

Sponsored by: home.pl


# 141846 13-Feb-2005 ru

Expand *n't contractions.


# 140415 18-Jan-2005 ru

Sort sections.


# 128073 09-Apr-2004 markm

Remove advertising clause from University of California Regent's license,
per letter dated July 22, 1999.

Approved by: core, imp


# 116507 17-Jun-2003 brueffer

Remove another reference to ffsinfo.8


# 116499 17-Jun-2003 brueffer

Remove references to ffsinfo(8) for now. It was disconnected from
the build almost a year ago.


# 111287 22-Feb-2003 ru

Sort options.


# 110174 01-Feb-2003 gordon

Bring in support for volume labels to the filesystem utilities.

Reviewed by: mckusick


# 105156 15-Oct-2002 rwatson

Correct some of the style problems in this file:

I introduced a style problem when I sorted 'a' before 'A'; our
preferred order sorts 'A' first. Correct.

Use .Cm instead of .Ar.

Submitted by: bde


# 105120 14-Oct-2002 rwatson

Introduce -a [enable|disable] and -l [enable|disable] flags to the tunefs
command, permitting it to set FS_ACLS and FS_MULTILABEL administrative
flags on UFS file systems.

Obtained from: TrustedBSD Project
Sponsored by: DARPA, Network Associates Laboratories


# 103005 06-Sep-2002 phk

Remove the -a maxcontig option, the kernel doesn't inspect fs_maxcontig
anymore.

Sponsored by: DARPA & NAI Labs.


# 102464 26-Aug-2002 trhodes

Fix some 'SYNOPSIS' and 'usage' messages.


# 102231 21-Aug-2002 trhodes

s/filesystem/file system/g as discussed on -developers


# 101802 13-Aug-2002 ru

mdoc(7) police: laundry.


# 99503 06-Jul-2002 charnier

The .Nm utility.


# 98551 21-Jun-2002 bde

Don't say that an umounted filesystem is required for -n. An unmounted
filesystem is no more or less required for -n than for any other option.
The previous commit clarified the actual requirement.


# 98542 21-Jun-2002 mckusick

This commit adds basic support for the UFS2 filesystem. The UFS2
filesystem expands the inode to 256 bytes to make space for 64-bit
block pointers. It also adds a file-creation time field, an ability
to use jumbo blocks per inode to allow extent like pointer density,
and space for extended attributes (up to twice the filesystem block
size worth of attributes, e.g., on a 16K filesystem, there is space
for 32K of attributes). UFS2 fully supports and runs existing UFS1
filesystems. New filesystems built using newfs can be built in either
UFS1 or UFS2 format using the -O option. In this commit UFS1 is
the default format, so if you want to build UFS2 format filesystems,
you must specify -O 2. This default will be changed to UFS2 when
UFS2 proves itself to be stable. In this commit the boot code for
reading UFS2 filesystems is not compiled (see /sys/boot/common/ufsread.c)
as there is insufficient space in the boot block. Once the size of the
boot block is increased, this code can be defined.

Things to note: the definition of SBSIZE has changed to SBLOCKSIZE.
The header file <ufs/ufs/dinode.h> must be included before
<ufs/ffs/fs.h> so as to get the definitions of ufs2_daddr_t and
ufs_lbn_t.

Still TODO:
Verify that the first level bootstraps work for all the architectures.
Convert the utility ffsinfo to understand UFS2 and test growfs.
Add support for the extended attribute storage. Update soft updates
to ensure integrity of extended attribute storage. Switch the
current extended attribute interfaces to use the extended attribute
storage. Add the extent like functionality (framework is there,
but is currently never used).

Sponsored by: DARPA & NAI Labs.
Reviewed by: Poul-Henning Kamp <phk@freebsd.org>


# 97478 29-May-2002 ru

mdoc(7) police: markup nits.


# 96119 06-May-2002 trhodes

'file system' > filesystem
add FILES section.

PR: 34239
Submitted by: Gary W. Swearingen <swear@blarg.net>


# 94818 16-Apr-2002 keramida

Expand the reserved space section. Explain how the amount of reserved
space can affect performance.

Submitted by: David Schultz <dschultz@uclink.Berkeley.EDU>


# 88990 07-Jan-2002 dd

tunefs no longer outputs a warning if one tries to set soft-updates on
an unmounted filesystem.

PR: 32266
Submitted by: Maxim Konovalov <maxim@macomnet.ru>


# 79530 10-Jul-2001 ru

mdoc(7) police: removed HISTORY info from the .Os call.


# 75379 10-Apr-2001 nik

Add information about the new options to newfs and tunefs which set the
expected average file size and number of files per directory. Could do
with some fleshing out.


# 69829 10-Dec-2000 charnier

The tunefs code assumed that the last argument was the device specification.
We need to parse the arguments first, then open the device (if
specified) and then apply the changes. This change will disallow the
(undocumented) use of multiple instances of the same argument on the
same command line for the sack of a better error message.

Other changes are:
1) the softupdates (-n) now issue a warning about remaining unchanged
2) the usage and man page is changed to specify "space | time" instead of
"optimization preference".

PR: bin/23335
Submitted by:Mark Peek <mark@whistle.com>


# 69314 28-Nov-2000 charnier

Remove .Op when arg is required (special | filesystem). Document that at
least one flag is required and check this in the code. Make use of getopt(3).
Generalyze printing `... remains unchanged ...'.


# 68960 20-Nov-2000 ru

mdoc(7) police: use the new features of the Nm macro.


# 57668 01-Mar-2000 sheldonh

Remove single-space hard sentence breaks. These degrade the quality
of the typeset output, tend to make diffs harder to read and provide
bad examples for new-comers to mdoc.


# 55560 07-Jan-2000 phantom

Document a waring that tunefs(8) emits when enabling/disabling
soft updates on an unmounted filesystem.

PR: docs/15657
Submitted by: Mark Ovens <mark@ukug.uk.FreeBSD.org>


# 50476 27-Aug-1999 peter

$Id$ -> $FreeBSD$


# 42619 13-Jan-1999 des

Sort options alphabetically.


# 38040 03-Aug-1998 charnier

Document -n (soft-update) flag.
Add rcsid, remove unused #includes. Sync usage() and SYNOPSIS.


# 34266 08-Mar-1998 julian

Reviewed by: dyson@freebsd.org (john Dyson), dg@root.com (david greenman)
Submitted by: Kirk McKusick (mcKusick@mckusick.com)
Obtained from: WHistle development tree


# 13922 05-Feb-1996 mpp

Correct some man page cross references and some file
locations.


# 10035 12-Aug-1995 peter

Add (apparently) Larry McVoy's warning....


# 9315 25-Jun-1995 joerg

When tuneing filesystems with tunefs, it is not obvious what the current
parameters are. You can use dumpfs, but that's not obvious which settings
are tuneable, and is far from clear to the non-guru (it's like using a
hexdump of a tar archive to get a table-of-contents).

There is also an undocumented option in the man page that can be dangerous.
Suppose your disk driver decides to scramble all writes while you tell
tunefs to update all backup superblocks.

This suggested change adds a '-p' (print) switch to bring it in
line with some SVR4 systems.

(Slightly changed by me, mostly for optics. - joerg)

Submitted by: peter@haywire.dialix.com


# 7065 15-Mar-1995 dg

Changed manual page to conform to the reality in FreeBSD.


# 1559 26-May-1994 rgrimes

This commit was generated by cvs2svn to compensate for changes in r1558,
which included commits to RCS files with non-trunk default branches.


# 1558 26-May-1994 rgrimes

BSD 4.4 Lite sbin Sources

Note: XNSrouted and routed NOT imported here, they shall be imported with
usr.sbin.