View | Details | Raw Unified | Return to bug 34239 | Differences between
and this patch

Collapse All | Expand All

(-)/tmp/tunefs.8 (-16 / +22 lines)
Lines 37-43 Link Here
37 
.Os
 37 
.Os
38 
.Sh NAME
 38 
.Sh NAME
39 
.Nm tunefs
 39 
.Nm tunefs
40 
.Nd tune up an existing file system
 40 
.Nd tune up an existing filesystem
41 
.Sh SYNOPSIS
 41 
.Sh SYNOPSIS
42 
.Nm
 42 
.Nm
43 
.Op Fl A
 43 
.Op Fl A
Lines 52-67 Link Here
52 
.Op Fl p
 52 
.Op Fl p
53 
.Op Fl s Ar avgfpdir
 53 
.Op Fl s Ar avgfpdir
54 
.Ek
 54 
.Ek
55 
.Op Ar special | Ar filesystem
 55 
.Ar device-file | mount-point
56 
.Sh DESCRIPTION
 56 
.Sh DESCRIPTION
57 
.Nm Tunefs
 57 
.Nm Tunefs
58 
is designed to change the dynamic parameters of a file system
 58 
is designed to change the dynamic parameters of a filesystem
59 
which affect the layout policies.
 59 
which affect the layout policies.
60 
The parameters which are to be changed are indicated by the flags
 60 
.Pp
61 
given below:
 61 
.Pp
62 
The filesystem to be tuned is specified by either its device-special file,
63 
.Ar device-file ,
64 
or its mount point,
65 
.Ar mount-point
66 
(if that is in a standard entry in /etc/fstab).
67 
The parameters which are to be changed are indicated by these options:
62 
.Bl -tag -width indent
 68 
.Bl -tag -width indent
63 
.It Fl A
 69 
.It Fl A
64 
The file system has several backups of the super-block.  Specifying
 70 
The filesystem has several backups of the super-block.  Specifying
65 
this option will cause all backups to be modified as well as the
 71 
this option will cause all backups to be modified as well as the
66 
primary super-block.  This is potentially dangerous - use with caution.
 72 
primary super-block.  This is potentially dangerous - use with caution.
67 
.It Fl a Ar maxcontig
 73 
.It Fl a Ar maxcontig
Lines 92-98 Link Here
92 
The effect of this limit is to cause big files to do long seeks
 98 
The effect of this limit is to cause big files to do long seeks
93 
more frequently than if they were allowed to allocate all the blocks
 99 
more frequently than if they were allowed to allocate all the blocks
94 
in a cylinder group before seeking elsewhere.
 100 
in a cylinder group before seeking elsewhere.
95 
For file systems with exclusively large files,
 101 
For filesystems with exclusively large files,
96 
this parameter should be set higher.
 102 
this parameter should be set higher.
97 
.It Fl f Ar avgfilezsize
 103 
.It Fl f Ar avgfilezsize
98 
Specify the expected average file size.
 104 
Specify the expected average file size.
Lines 113-128 Link Here
113 
Turn on/off soft updates.
 119 
Turn on/off soft updates.
114 
An unmounted filesystem is required.
 120 
An unmounted filesystem is required.
115 
.It Fl o Ar space | time
 121 
.It Fl o Ar space | time
116 
The file system can either try to minimize the time spent
 122 
The filesystem can either try to minimize the time spent
117 
allocating blocks, or it can attempt to minimize the space
 123 
allocating blocks, or it can attempt to minimize the space
118 
fragmentation on the disk.
 124 
fragmentation on the disk.
119 
Optimization for space has much
 125 
Optimization for space has much
120 
higher overhead for file writes.
 126 
higher overhead for file writes.
121 
The kernel normally changes the preference automatically as
 127 
The kernel normally changes the preference automatically as
122 
the percent fragmentation changes on the file system.
 128 
the percent fragmentation changes on the filesystem.
123 
.It Fl p
 129 
.It Fl p
124 
Show a summary of what the current tunable settings
 130 
Show a summary of what the current tunable settings
125 
are on the selected file system.  More detailed information can be
 131 
are on the selected filesystem.  More detailed information can be
126 
obtained in the
 132 
obtained in the
127 
.Xr dumpfs 8
 133 
.Xr dumpfs 8
128 
manual page.
 134 
manual page.
Lines 133-139 Link Here
133 
If
 139 
If
134 
.Nm
 140 
.Nm
135 
.Fl n
 141 
.Fl n
136 
is run to enable/disable soft update on an unmounted file system
 142 
is run to enable/disable soft update on an unmounted filesystem
137 
after booting single-user then
 143 
after booting single-user then
138 
.Nm
 144 
.Nm
139 
will output the warning
 145 
will output the warning
Lines 167-182 Link Here
167 
.%O "(reprinted in the BSD System Manager's Manual, SMM:5)"
 173 
.%O "(reprinted in the BSD System Manager's Manual, SMM:5)"
168 
.Re
 174 
.Re
169 
.Sh BUGS
 175 
.Sh BUGS
170 
This program should work on mounted and active file systems.
 176 
This program should work on mounted and active filesystems.
171 
Because the super-block is not kept in the buffer cache,
 177 
Because the super-block is not kept in the buffer cache,
172 
the changes will only take effect if the program
 178 
the changes will only take effect if the program
173 
is run on dismounted file systems.
 179 
is run on dismounted filesystems.
174 
To change the root file system, the system must be rebooted
 180 
To change the root filesystem, the system must be rebooted
175 
after the file system is tuned.
 181 
after the filesystem is tuned.
176 
.\" Take this out and a Unix Demon will dog your steps from now until
 182 
.\" Take this out and a Unix Demon will dog your steps from now until
177 
.\" the time_t's wrap around.
 183 
.\" the time_t's wrap around.
178 
.Pp
 184 
.Pp
179 
You can tune a file system, but you can't tune a fish.
 185 
You can tune a filesystem, but you can't tune a fish.
180 
.Sh HISTORY
 186 
.Sh HISTORY
181 
The
 187 
The
182 
.Nm
 188 
.Nm

Return to bug 34239