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 filesystem" 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 119.Fl 120is provided, output will be sent to stdout. 121.El 122.Sh EXAMPLES 123.Dl ffsinfo -l 1023 /dev/vinum/testvol 124.Pp 125will dump 126.Pa /dev/vinum/testvol 127with all available information. 128.Sh BUGS 129Currently 130.Nm 131can only dump unmounted filesystems. 132Do not try dumping a mounted filesystem, your system may panic and you will 133not be able to use the filesystem any longer. 134.Pp 135Also snapshots are handled like plain files. 136They should get their own level to provide for independent control of the 137amount of what gets dumped. 138It probably also makes sense to some extend to dump the snapshot as a 139filesystem. 140.Sh SEE ALSO 141.Xr disklabel 8 , 142.Xr dumpfs 8 , 143.Xr fsck 8 , 144.Xr growfs 8 , 145.Xr newfs 8 , 146.Xr tunefs 8 , 147.Xr vinum 8 148.Sh AUTHORS 149.An Christoph Herrmann Aq chm@FreeBSD.org 150.An Thomas-Henning von Kamptz Aq tomsoft@FreeBSD.org 151.An The GROWFS team Aq growfs@Tomsoft.COM 152.Sh HISTORY 153The 154.Nm 155utility first appeared in 156.Fx 4.4 . 157