share/man/man8/tunefs.8

   1 '\" te
   2 .\"  Copyright 1989 AT&T Copyright (c) 2003, Sun Microsystems, Inc. All Rights Reserved
   3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   5 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   6 .TH TUNEFS 8 "Dec 5, 2003"
   7 .SH NAME
   8 tunefs \- tune an existing UFS file system
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fBtunefs\fR [\fB-a\fR \fImaxcontig\fR] [\fB-d\fR \fIrotdelay\fR] [\fB-e\fR \fImaxbpg\fR]
  13      [\fB-m\fR \fIminfree\fR] [\fB-o\fR space | time] \fIspecial\fR | \fIfilesystem\fR
  14 .fi
  15
  16 .SH DESCRIPTION
  17 .sp
  18 .LP
  19 \fBtunefs\fR is designed to change the dynamic parameters of a file system that
  20 affect the layout policies. When using \fBtunefs\fR with \fIfilesystem\fR,
  21 \fIfilesystem\fR must be in \fB/etc/vfstab\fR. The parameters that can be
  22 changed are indicated by the options given below.
  23 .SH OPTIONS
  24 .sp
  25 .LP
  26 The following options are supported:
  27 .sp
  28 .ne 2
  29 .na
  30 \fB\fB-a\fR \fImaxcontig\fR\fR
  31 .ad
  32 .RS 21n
  33 The maximum number of logical blocks, belonging to one file, that is allocated
  34 contiguously. The default is calculated as follows:
  35 .sp
  36 .in +2
  37 .nf
  38 \fBmaxcontig =\fR \fIdisk drive maximum transfer size / disk block size\fR
  39 .fi
  40 .in -2
  41 .sp
  42
  43 If the disk drive's maximum transfer size cannot be determined, the default
  44 value for \fBmaxcontig\fR is calculated from kernel parameters as follows:
  45 .sp
  46 If \fBmaxphys\fR is less than \fBufs_maxmaxphys\fR, which is 1 Mbyte, then
  47 \fBmaxcontig\fR is set to \fBmaxphys\fR. Otherwise, \fBmaxcontig\fR is set to
  48 \fBufs_maxmaxphys\fR.
  49 .sp
  50 You can set \fBmaxcontig\fR to any positive integer value.
  51 .sp
  52 The actual value will be the lesser of what has been specified and what the
  53 hardware supports.
  54 .RE
  55
  56 .sp
  57 .ne 2
  58 .na
  59 \fB\fB-d\fR \fIrotdelay\fR\fR
  60 .ad
  61 .RS 21n
  62 This parameter is obsolete as of the Solaris 10 release. The value is always
  63 set to \fB0\fR, regardless of the input value.
  64 .RE
  65
  66 .sp
  67 .ne 2
  68 .na
  69 \fB\fB-e\fR \fImaxbpg\fR\fR
  70 .ad
  71 .RS 21n
  72 Indicates the maximum number of contiguous logical blocks any single file can
  73 allocate from a cylinder group before it is forced to begin allocating blocks
  74 from another cylinder group. Typically this value is set to approximately one
  75 quarter of the total contiguous logical blocks in a cylinder group. The intent
  76 is to prevent any single file from using up all the blocks in a single cylinder
  77 group, thus degrading access times for all files subsequently allocated in that
  78 cylinder group.
  79 .sp
  80 The effect of this limit is to cause big files to do long seeks more frequently
  81 than if they were allowed to allocate all the blocks in a cylinder group before
  82 seeking elsewhere. For file systems with exclusively large files, this
  83 parameter should be set higher.
  84 .RE
  85
  86 .sp
  87 .ne 2
  88 .na
  89 \fB\fB-m\fR \fIminfree\fR\fR
  90 .ad
  91 .RS 21n
  92 Specifies the minimum free space threshold, or the percentage of space held
  93 back from normal users. This value can be set to \fB0\fR. However, up to a
  94 factor of three in throughput will be lost over the performance obtained at a
  95 10% threshold. \fINote:\fR If the value is raised above the current usage
  96 level, users will be unable to allocate files until enough files have been
  97 deleted to get under the higher threshold.
  98 .RE
  99
 100 .sp
 101 .ne 2
 102 .na
 103 \fB\fB-o\fR\fI space\fR\||\|\fItime\fR\fR
 104 .ad
 105 .RS 21n
 106 The file system can either be instructed to try to minimize the \fBtime\fR
 107 spent allocating blocks, or to try to minimize the \fBspace\fR fragmentation on
 108 the disk. The default is \fItime\fR.
 109 .sp
 110 Generally, you should optimize for time unless the file system is over 90%
 111 full.
 112 .RE
 113
 114 .SH SEE ALSO
 115 .sp
 116 .LP
 117 \fBmkfs_ufs\fR(8), \fBnewfs\fR(8), \fBattributes\fR(5)