NAME
ffsinfo - dump all meta information of an existing ufs file system
SYNOPSIS
ffsinfo [-g cylinder_group] [-i inode] [-l level] [-o outfile] special |
file
DESCRIPTION
The ffsinfo utility extends the dumpfs(8) utility.
The output is appended to the file outfile. Also expect the output file
to be rather large. Up to 2 percent of the size of the specified file
system is not uncommon.
The following options are available:
-g cylinder_group
This restricts the dump to information about this cylinder group
only. Here 0 means the first cylinder group and -1 the last one.
-i inode
This restricts the dump to information about this particular
inode only. Here the minimum acceptable inode is 2. If this
option is omitted but a cylinder group is defined then only
inodes within that cylinder group are dumped.
-l level
The level of detail which will be dumped. This value defaults to
255 and is the “bitwise or” of the following table:
0x001 initial superblock
0x002 superblock copies in each cylinder group
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
0x100 inode information
0x200 indirect block dump
-o outfile
This sets the output filename where the dump is written to, and
must be specified. If - is provided, output will be sent to
stdout.
EXAMPLES
ffsinfo -o /var/tmp/ffsinfo -l 1023 /dev/vinum/testvol
will dump /dev/vinum/testvol to /var/tmp/ffsinfo with all available
information.
SEE ALSO
disklabel(8), dumpfs(8), fsck(8), growfs(8), newfs(8), tunefs(8),
vinum(8)
HISTORY
The ffsinfo utility first appeared in FreeBSD 4.4.
AUTHORS
Christoph Herrmann 〈chm@FreeBSD.org〉
Thomas-Henning von Kamptz 〈tomsoft@FreeBSD.org〉
The GROWFS team 〈growfs@Tomsoft.COM〉
BUGS
Snapshots are handled like plain files. 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 file
system.