FFSINFO(8)						    BSD System Manager's Manual 						FFSINFO(8)

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.

BSD
								 September 8, 2000							       BSD