home | help
FFSINFO(8)		     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  std-
	     out.

EXAMPLES
	   ffsinfo -o /var/tmp/ffsinfo -l 1023 /dev/md0

     will dump /dev/md0 to /var/tmp/ffsinfo with all available information.

SEE ALSO
     ffs(4), dumpfs(8), fsck(8), gpart(8), growfs(8), newfs(8), tunefs(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.

FreeBSD 15.1			January 23, 2025		      FFSINFO(8)

home | help