| zdb.8 (235701) | zdb.8 (243674) |
|---|---|
| 1'\" te 2.\" Copyright (c) 2012, Martin Matuska <mm@FreeBSD.org>. 3.\" All Rights Reserved. 4.\" 5.\" This file and its contents are supplied under the terms of the 6.\" Common Development and Distribution License ("CDDL"), version 1.0. 7.\" You may only use this file in accordance with the terms of version 8.\" 1.0 of the CDDL. 9.\" 10.\" A full copy of the text of the CDDL should have accompanied this 11.\" source. A copy of the CDDL is also available via the Internet at 12.\" http://www.illumos.org/license/CDDL. 13.\" 14.\" 15.\" Copyright 2012, Richard Lowe. 16.\" Copyright (c) 2012, Marcelo Araujo <araujo@FreeBSD.org>. 17.\" All Rights Reserved. 18.\" | 1'\" te 2.\" Copyright (c) 2012, Martin Matuska <mm@FreeBSD.org>. 3.\" All Rights Reserved. 4.\" 5.\" This file and its contents are supplied under the terms of the 6.\" Common Development and Distribution License ("CDDL"), version 1.0. 7.\" You may only use this file in accordance with the terms of version 8.\" 1.0 of the CDDL. 9.\" 10.\" A full copy of the text of the CDDL should have accompanied this 11.\" source. A copy of the CDDL is also available via the Internet at 12.\" http://www.illumos.org/license/CDDL. 13.\" 14.\" 15.\" Copyright 2012, Richard Lowe. 16.\" Copyright (c) 2012, Marcelo Araujo <araujo@FreeBSD.org>. 17.\" All Rights Reserved. 18.\" |
| 19.\" $FreeBSD: stable/9/cddl/contrib/opensolaris/cmd/zdb/zdb.8 235701 2012-05-20 22:21:59Z mm $ | 19.\" $FreeBSD: stable/9/cddl/contrib/opensolaris/cmd/zdb/zdb.8 243674 2012-11-29 14:05:04Z mm $ |
| 20.\" 21.Dd May 10, 2012 22.Dt ZDB 8 23.Os 24.Sh NAME 25.Nm zdb 26.Nd Display zpool debugging and consistency information 27.Sh SYNOPSIS --- 60 unchanged lines hidden (view full) --- 88Verify the checksum of all metadata blocks while printing block statistics 89(see 90.Fl b Ns ). 91.Pp 92If specified multiple times, verify the checksums of all blocks. 93.It Fl C 94Display information about the configuration. If specified with no other 95options, instead display information about the cache file | 20.\" 21.Dd May 10, 2012 22.Dt ZDB 8 23.Os 24.Sh NAME 25.Nm zdb 26.Nd Display zpool debugging and consistency information 27.Sh SYNOPSIS --- 60 unchanged lines hidden (view full) --- 88Verify the checksum of all metadata blocks while printing block statistics 89(see 90.Fl b Ns ). 91.Pp 92If specified multiple times, verify the checksums of all blocks. 93.It Fl C 94Display information about the configuration. If specified with no other 95options, instead display information about the cache file |
| 96.Ns ( Pa /etc/zfs/zpool.cache Ns ). | 96.Po Pa /etc/zfs/zpool.cache Pc . |
| 97To specify the cache file to display, see 98.Fl U 99.Pp 100If specified multiple times, and a pool name is also specified display both 101the cached configuration and the on-disk configuration. 102If specified multiple times with | 97To specify the cache file to display, see 98.Fl U 99.Pp 100If specified multiple times, and a pool name is also specified display both 101the cached configuration and the on-disk configuration. 102If specified multiple times with |
| 103.FL e | 103.Fl e |
| 104also display the configuration that would be used were the pool to be 105imported. 106.It Fl d 107Display information about datasets. Specified once, displays basic dataset 108information: ID, create transaction, size, and object count. 109.Pp 110If specified multiple times provides greater and greater verbosity. 111.Pp --- 18 unchanged lines hidden (view full) --- 130.It Fl l Ar device 131Display the vdev labels from the specified device. 132If the 133.Fl u 134option is also specified, also display the uberblocks on this device. 135.It Fl L 136Disable leak tracing and the loading of space maps. 137By default, | 104also display the configuration that would be used were the pool to be 105imported. 106.It Fl d 107Display information about datasets. Specified once, displays basic dataset 108information: ID, create transaction, size, and object count. 109.Pp 110If specified multiple times provides greater and greater verbosity. 111.Pp --- 18 unchanged lines hidden (view full) --- 130.It Fl l Ar device 131Display the vdev labels from the specified device. 132If the 133.Fl u 134option is also specified, also display the uberblocks on this device. 135.It Fl L 136Disable leak tracing and the loading of space maps. 137By default, |
| 138.Nm | 138.Nm |
| 139verifies that all non-free blocks are referenced, which can be very expensive. 140.It Fl m 141Display the offset, spacemap, and free space of each metaslab. 142When specified twice, also display information about the maximum contiguous 143free space and the percentage of free space in each space map. 144When specified three times display every spacemap record. 145.It Xo 146.Fl R Ar poolname --- 101 unchanged lines hidden (view full) --- 248 name: 'rpool' 249 ... 250.Ed 251.It Sy Example 2 Display basic dataset information about 'rpool' 252.Bd -literal -offset 2n 253.Li # Ic zdb -d rpool 254Dataset mos [META], ID 0, cr_txg 4, 26.9M, 1051 objects 255Dataset rpool/swap [ZVOL], ID 59, cr_txg 356, 486M, 2 objects | 139verifies that all non-free blocks are referenced, which can be very expensive. 140.It Fl m 141Display the offset, spacemap, and free space of each metaslab. 142When specified twice, also display information about the maximum contiguous 143free space and the percentage of free space in each space map. 144When specified three times display every spacemap record. 145.It Xo 146.Fl R Ar poolname --- 101 unchanged lines hidden (view full) --- 248 name: 'rpool' 249 ... 250.Ed 251.It Sy Example 2 Display basic dataset information about 'rpool' 252.Bd -literal -offset 2n 253.Li # Ic zdb -d rpool 254Dataset mos [META], ID 0, cr_txg 4, 26.9M, 1051 objects 255Dataset rpool/swap [ZVOL], ID 59, cr_txg 356, 486M, 2 objects |
| 256... | 256 ... |
| 257.Ed 258.It Xo Sy Example 3 Display basic information about object 0 in 259.Sy 'rpool/export/home' 260.Xc 261.Bd -literal -offset 2n 262.Li # Ic zdb -d rpool/export/home 0 263Dataset rpool/export/home [ZPL], ID 137, cr_txg 1546, 32K, 8 objects 264 265 Object lvl iblk dblk dsize lsize %full type 266 0 7 16K 16K 15.0K 16K 25.00 DMU dnode 267.Ed 268.It Xo Sy Example 4 Display the predicted effect of enabling deduplication on 269.Sy 'rpool' 270.Xc 271.Bd -literal -offset 2n 272.Li # Ic zdb -S rpool 273Simulated DDT histogram: 274 | 257.Ed 258.It Xo Sy Example 3 Display basic information about object 0 in 259.Sy 'rpool/export/home' 260.Xc 261.Bd -literal -offset 2n 262.Li # Ic zdb -d rpool/export/home 0 263Dataset rpool/export/home [ZPL], ID 137, cr_txg 1546, 32K, 8 objects 264 265 Object lvl iblk dblk dsize lsize %full type 266 0 7 16K 16K 15.0K 16K 25.00 DMU dnode 267.Ed 268.It Xo Sy Example 4 Display the predicted effect of enabling deduplication on 269.Sy 'rpool' 270.Xc 271.Bd -literal -offset 2n 272.Li # Ic zdb -S rpool 273Simulated DDT histogram: 274 |
| 275bucket allocated referenced | 275bucket allocated referenced |
| 276______ ______________________________ ______________________________ 277refcnt blocks LSIZE PSIZE DSIZE blocks LSIZE PSIZE DSIZE 278------ ------ ----- ----- ----- ------ ----- ----- ----- 279 1 694K 27.1G 15.0G 15.0G 694K 27.1G 15.0G 15.0G 280 2 35.0K 1.33G 699M 699M 74.7K 2.79G 1.45G 1.45G 281 ... 282dedup = 1.11, compress = 1.80, copies = 1.00, dedup * compress / copies = 2.00 283.Ed --- 23 unchanged lines hidden --- | 276______ ______________________________ ______________________________ 277refcnt blocks LSIZE PSIZE DSIZE blocks LSIZE PSIZE DSIZE 278------ ------ ----- ----- ----- ------ ----- ----- ----- 279 1 694K 27.1G 15.0G 15.0G 694K 27.1G 15.0G 15.0G 280 2 35.0K 1.33G 699M 699M 74.7K 2.79G 1.45G 1.45G 281 ... 282dedup = 1.11, compress = 1.80, copies = 1.00, dedup * compress / copies = 2.00 283.Ed --- 23 unchanged lines hidden --- |