Module Name: src
Committed By: riz
Date: Mon Dec 20 00:49:23 UTC 2010
Modified Files:
src/sbin/resize_ffs: resize_ffs.8
Log Message:
Revert previous - inadvertant commit to wrong repository.
To generate a diff of this commit:
cvs rdiff -u -r1.8 -r1.9 src/sbin/resize_ffs/resize_ffs.8
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/sbin/resize_ffs/resize_ffs.8
diff -u src/sbin/resize_ffs/resize_ffs.8:1.8 src/sbin/resize_ffs/resize_ffs.8:1.9
--- src/sbin/resize_ffs/resize_ffs.8:1.8 Mon Dec 20 00:44:53 2010
+++ src/sbin/resize_ffs/resize_ffs.8 Mon Dec 20 00:49:23 2010
@@ -1,4 +1,4 @@
-.\" $NetBSD: resize_ffs.8,v 1.8 2010/12/20 00:44:53 riz Exp $
+.\" $NetBSD: resize_ffs.8,v 1.9 2010/12/20 00:49:23 riz Exp $
.\"
.\" As its sole author, I explicitly place this man page in the public
.\" domain. Anyone may use it in any way for any purpose (though I would
@@ -9,12 +9,12 @@
.\" X Against HTML [email protected]
.\" / \ Email! 7D C8 61 52 5D E7 2D 39 4E F1 31 3E E8 B3 27 4B
.\"
-.Dd December 18, 2010
+.Dd October 30, 2010
.Dt RESIZE_FFS 8
.Os
.Sh NAME
.Nm resize_ffs
-.Nd resize a file system on disk or in a file
+.Nd resize an on-disk file system
.Sh SYNOPSIS
.Nm
.Op Fl y
@@ -24,7 +24,7 @@
.Nm
resizes a file system on disk.
.Ar file-system-raw-device
-is the name of the raw disk device or file where the file system resides;
+is the name of the raw disk device where the file system resides;
(Sectors are almost always 512 bytes, and
.Nm
can both grow and shrink file systems.
@@ -66,6 +66,10 @@
.Nm .
.El
.Sh WARNING
+.Nm
+should still be considered experimental.
+It still needs to be validated with a rigorous regression test
+suite.
.Em Interrupting
.Nm
.Em "may leave your file system in an inconsistent state and require a"
@@ -84,7 +88,16 @@
It's probably wise to
.Xr fsck 8
the file system before and after, just to be safe.
-You should be aware that just because
+.\" Remove this when (if) fsck gets fixed.
+.Pp
+There is a bug somewhere in
+.Xr fsck 8 ;
+it does not check certain data structures enough.
+A past version of this program had a bug that produced corrupted
+rotation layout summary tables, which would panic the kernel.
+This bug is believed fixed, and there are currently no
+known bugs in the program.
+However, you should be aware that just because
.Xr fsck 8
is happy with the file system does not mean it is intact.
.Sh EXIT STATUS
@@ -120,6 +133,9 @@
.Sx WARNING
section above.
.Sh BUGS
+Has not been tested and probably won't work on opposite-endian file
+systems.
+.Pp
Can fail to shrink a file system when there actually is enough space,
because it does not distinguish between a block allocated as a block
and a block fully occupied by two or more frags.
@@ -130,4 +146,4 @@
Has no intelligence whatever when it comes to allocating blocks to copy
data into when shrinking.
.Pp
-Doesn't shrink FFSv2 file systems.
+Doesn't work with FFSv2 file systems.
