Mdoc(7)ify.

This commit is contained in:
Ruslan Ermilov 2000-12-13 11:33:19 +00:00
parent 64638f67a7
commit f33c0fddd7
Notes: svn2git 2020-12-20 02:59:44 +00:00
svn path=/head/; revision=69977
2 changed files with 62 additions and 51 deletions

View File

@ -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 .

View File

@ -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 .