1.\" Copyright (c) 2000 Christoph Herrmann, Thomas-Henning von Kamptz 2.\" Copyright (c) 1980, 1989, 1993 The Regents of the University of California. 3.\" All rights reserved. 4.\" 5.\" This code is derived from software contributed to Berkeley by 6.\" Christoph Herrmann and Thomas-Henning von Kamptz, Munich and Frankfurt. 7.\" 8.\" Redistribution and use in source and binary forms, with or without 9.\" modification, are permitted provided that the following conditions 10.\" are met: 11.\" 1. Redistributions of source code must retain the above copyright 12.\" notice, this list of conditions and the following disclaimer. 13.\" 2. Redistributions in binary form must reproduce the above copyright 14.\" notice, this list of conditions and the following disclaimer in the 15.\" documentation and/or other materials provided with the distribution. 16.\" 3. All advertising materials mentioning features or use of this software 17.\" must display the following acknowledgment: 18.\" This product includes software developed by the University of 19.\" California, Berkeley and its contributors, as well as Christoph 20.\" Herrmann and Thomas-Henning von Kamptz. 21.\" 4. Neither the name of the University nor the names of its contributors 22.\" may be used to endorse or promote products derived from this software 23.\" without specific prior written permission. 24.\" 25.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND 26.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 27.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 28.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 29.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 30.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 31.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 32.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 33.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 34.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 35.\" SUCH DAMAGE. 36.\" 37.\" $TSHeader: src/sbin/ffsinfo/ffsinfo.8,v 1.3 2000/12/12 19:30:55 tomsoft Exp $ 38.\" $FreeBSD$ 39.\" 40.Dd September 8, 2000 41.Dt FSINFO 8 42.Os 43.Sh NAME 44.Nm ffsinfo 45.Nd "dump all meta information of an existing ufs file system 46.Sh SYNOPSIS 47.Nm 48.Op Fl L 49.Op Fl g Ar cylinder_group 50.Op Fl i Ar inode 51.Op Fl l Ar level 52.Op Fl o Ar outfile 53.Ar special | file 54.Sh DESCRIPTION 55The 56.Nm 57utility extends the 58.Xr dumpfs 8 59utility. 60.Pp 61The output is generated into the file 62.Pa outfile . 63Also expect the output file to be rather large. 64Up to 2 percent of the size of the specified filesystem is not uncommon. 65.Pp 66The following options are available: 67.Bl -tag -width indent 68.It Fl L 69Specifying this option skips the tests of the disklabel. 70This is done automatically, if the specified filename to dump is a plain file. 71.It Fl g Ar cylinder_group 72This restricts the dump to information about this cylinder group only. 73Here 74.Ar 0 75means the first cylinder group and 76.Ar -1 77the last one. 78.It Fl i Ar inode 79This restricts the dump to information about this particular inode only. 80Here the minimum acceptable inode is 81.Ar 2 . 82If this option is omitted but a cylinder group is defined then only inodes 83within that cylinder group are dumped. 84.It Fl l Ar level 85The level of detail which will be dumped. 86This value defaults to 87.Ar 255 88and is the 89.Dq bitwise or 90of the following table: 91.Pp 92.Bl -hang -width indent -compact 93.It Ar 0x001 94initial superblock 95.It Ar 0x002 96superblock copies in each cylinder group 97.It Ar 0x004 98cylinder group summary in initial cylinder group 99.It Ar 0x008 100cylinder group information 101.It Ar 0x010 102inode allocation bitmap 103.It Ar 0x020 104fragment allocation bitmap 105.It Ar 0x040 106cluster maps and summary 107.It Ar 0x080 108rotational layout tables 109.It Ar 0x100 110inode information 111.It Ar 0x200 112indirect block dump 113.El 114.It Fl o Ar outfile 115This allows to change the output filename where the dump is written to. 116The current default is 117.Pa /var/tmp/ffsinfo . 118If - is provided, output will be sent to stdout. 119.El 120.Sh EXAMPLES 121.Dl ffsinfo -l 1023 /dev/vinum/testvol 122.Pp 123will dump 124.Pa /dev/vinum/testvol 125with all available information. 126.Sh BUGS 127Currently 128.Nm 129can only dump unmounted file systems. 130Do not try dumping a mounted file system, your system may panic and you will 131not be able to use the file system any longer. 132.Pp 133Also snapshots are handled like plain files. 134They should get their own level to provide for independent control of the 135amount of what gets dumped. 136It probably also makes sense to some extend to dump the snapshot as a 137filesystem. 138.Sh SEE ALSO 139.Xr disklabel 8 , 140.Xr dumpfs 8 , 141.Xr fsck 8 , 142.Xr growfs 8 , 143.Xr newfs 8 , 144.Xr tunefs 8 , 145.Xr vinum 8 146.Sh AUTHORS 147.An Christoph Herrmann Aq chm@FreeBSD.org 148.An Thomas-Henning von Kamptz Aq tomsoft@FreeBSD.org 149.An The GROWFS team Aq growfs@Tomsoft.COM 150.Sh HISTORY 151The 152.Nm 153utility first appeared in 154.Fx 4.4 . 155