From f33c0fddd7c14313436d08bc7e8bf82808d867cf Mon Sep 17 00:00:00 2001 From: Ruslan Ermilov Date: Wed, 13 Dec 2000 11:33:19 +0000 Subject: [PATCH] Mdoc(7)ify. --- sbin/ffsinfo/ffsinfo.8 | 82 +++++++++++++++++++++++++----------------- sbin/growfs/growfs.8 | 31 +++++++--------- 2 files changed, 62 insertions(+), 51 deletions(-) diff --git a/sbin/ffsinfo/ffsinfo.8 b/sbin/ffsinfo/ffsinfo.8 index 7c35857cf154..081213c4fa1e 100644 --- a/sbin/ffsinfo/ffsinfo.8 +++ b/sbin/ffsinfo/ffsinfo.8 @@ -39,14 +39,14 @@ .\" .Dd September 8, 2000 .Dt FSINFO 8 -.Os BSD 4.4 +.Os .Sh NAME .Nm ffsinfo .Nd dump all meta information of an existing ufs file system .Sh SYNOPSIS -.Nm ffsinfo +.Nm .Op Fl L -.Op Fl g Ar cylinder group +.Op Fl g Ar cylinder_group .Op Fl i Ar inode .Op Fl l Ar level .Op Fl o Ar outfile @@ -63,34 +63,53 @@ Also expect the output file to be rather large. Up to 2 percent of the size of the specified filesystem is not uncommon. .Pp The following options are available: -.\".Pp .Bl -tag -width indent .It Fl L Specifying this option skips the tests of the disklabel. This is done automatically, if the specified filename to dump is a plain file. -.It Fl g Ar cylinder group -This restricts the dump to infomation about this cylinder group only. -Here 0 means the first cylinder group and -1 the last one. +.It Fl g Ar cylinder_group +This restricts the dump to information about this cylinder group only. +Here +.Ar 0 +means the first cylinder group and +.Ar -1 +the last one. .It Fl i Ar inode -This restrictes the dump to infomation about this particular inode only. -Here the minimum acceptable inode is 2. +This restricts the dump to information about this particular inode only. +Here the minimum acceptable inode is +.Ar 2 . If this option is omitted but a cylinder group is defined then only inodes within that cylinder group are dumped. .It Fl l Ar level The level of detail which will be dumped. -This value defaults to 255 and is the bitwise and of the following table: -.Bd -literal -offset left -0x001 - initial superblock -0x002 - superblock copys in each cylindergroup -0x004 - cylinder group summary in initial cylinder group -0x008 - cylinder group information -0x010 - inode allocation bitmap -0x020 - fragment allocation bitmap -0x040 - cluster maps and summary -0x080 - rotational layout tables -0x100 - inode information -0x200 - indirect block dump -.Ed +This value defaults to +.Ar 255 +and is the +.Dq bitwise or +of the following table: +.Pp +.Bl -hang -width indent -compact +.It Ar 0x001 +initial superblock +.It Ar 0x002 +superblock copies in each cylinder group +.It Ar 0x004 +cylinder group summary in initial cylinder group +.It Ar 0x008 +cylinder group information +.It Ar 0x010 +inode allocation bitmap +.It Ar 0x020 +fragment allocation bitmap +.It Ar 0x040 +cluster maps and summary +.It Ar 0x080 +rotational layout tables +.It Ar 0x100 +inode information +.It Ar 0x200 +indirect block dump +.El .It Fl o Ar outfile This allows to change the output filename where the dump is written to. The current default is @@ -111,27 +130,24 @@ Do not try dumping a mounted file system, your system may panic and you will not be able to use the file system any longer. .Pp Also snapshots are handled like plain files. -They should get a their own level to provide for independent control of the +They should get their own level to provide for independent control of the amount of what gets dumped. It probably also makes sense to some extend to dump the snapshot as a filesystem. .Sh SEE ALSO -.Xr vinum 8 , .Xr disklabel 8 , +.Xr dumpfs 8 , .Xr fsck 8 , +.Xr growfs 8 , .Xr newfs 8 , .Xr tunefs 8 , -.Xr growfs 8 , -.Xr dumpfs 8 -.\".Rs -.\".Re +.Xr vinum 8 .Sh AUTHORS -.An Christoph Herrmann Aq chm@FreeBSD.ORG -.An Thomas-Henning von Kamptz Aq tomsoft@FreeBSD.ORG +.An Christoph Herrmann Aq chm@FreeBSD.org +.An Thomas-Henning von Kamptz Aq tomsoft@FreeBSD.org .An The GROWFS team Aq growfs@Tomsoft.COM .Sh HISTORY The .Nm -command appeared first in -.Bx Free -5.0 +command first appeared in +.Fx 5.0 . diff --git a/sbin/growfs/growfs.8 b/sbin/growfs/growfs.8 index 2893d1e5e5ad..a9e78f77fc41 100644 --- a/sbin/growfs/growfs.8 +++ b/sbin/growfs/growfs.8 @@ -39,12 +39,12 @@ .\" .Dd September 8, 2000 .Dt GROWFS 8 -.Os BSD 4.4 +.Os .Sh NAME .Nm growfs .Nd grow size of an existing ufs file system .Sh SYNOPSIS -.Nm growfs +.Nm .Op Fl Ny .Op Fl s Ar size .Ar special @@ -75,13 +75,12 @@ Use for other changes. .Pp The following options are available: -.\".Pp .Bl -tag -width indent .It Fl N Cause the new file system parameters to be printed out without actually growing the file system. .It Fl y -.Dq Expert mode +.Dq Expert mode . Normally .Nm will ask you, if you took a backup of your data before and will do some tests @@ -89,7 +88,7 @@ if .Ar special is currently mounted or if there are any active snapshots on the filesystem specified. -This will be supressed. +This will be suppressed. So use this option with great care! .It Fl s Ar size The @@ -111,7 +110,7 @@ up to 2GB if there is enough space in .Pa /dev/vinum/testvol . .Sh BUGS In some cases on -.Bx Free +.Fx 3.x it is possible, that .Nm did not recognize exactly, if the file system is mounted or not and @@ -129,7 +128,7 @@ Almost everything works perfect with this relocated structure except the .Xr fsck 8 utility. There is a patch available for -.Xr fsck 8 ) . +.Xr fsck 8 . For growing above certain limits it is essential to have some free blocks available in the first cylinder group. To avoid the relocation of that structure it is currently recommended to use @@ -142,24 +141,20 @@ in the CYLINDER SUMMARY (internal cs) of the CYLINDER GROUP has enough blocks. As a rule of thumb for default filesystem parameters a block is needed for every 2 GB of total filesystem size. -.Pp .Sh SEE ALSO -.Xr vinum 8 , .Xr disklabel 8 , +.Xr dumpfs 8 , +.Xr ffsinfo 8 , .Xr fsck 8 , .Xr newfs 8 , .Xr tunefs 8 , -.Xr dumpfs 8 , -.Xr ffsinfo 8 -.\".Rs -.\".Re +.Xr vinum 8 .Sh AUTHORS -.An Christoph Herrmann Aq chm@FreeBSD.ORG -.An Thomas-Henning von Kamptz Aq tomsoft@FreeBSD.ORG +.An Christoph Herrmann Aq chm@FreeBSD.org +.An Thomas-Henning von Kamptz Aq tomsoft@FreeBSD.org .An The GROWFS team Aq growfs@Tomsoft.COM .Sh HISTORY The .Nm -command first appeared first in -.Bx Free -5.0. +command first appeared in +.Fx 5.0 .