Lines Matching +full:a +full:- +full:display
1 .\" SPDX-License-Identifier: CDDL-1.0
8 .\" A full copy of the text of the CDDL should have accompanied this
9 .\" source. A copy of the CDDL is also available via the Internet at
24 .Nd display ZFS storage pool debugging and consistency information
29 .Op Fl I Ar inflight-I/O-ops
35 .Op Ar poolname Ns Op / Ns Ar dataset Ns | Ns Ar objset-ID
42 .Ar poolname Ns Op Ar / Ns Ar dataset Ns | Ns Ar objset-ID
49 .Ar poolname Ns Ar / Ns Ar objset-ID
50 .Op Ar backup-flags
53 .Op Fl A
58 .Op Fl A
81 .Op Fl A
95 utility displays information about a ZFS pool useful for debugging and performs
97 It is a not a general purpose tool and options
100 It is not a
104 The output of this command in general reflects the on-disk structure of a ZFS
106 The precise output of most invocations is not documented, a knowledge of ZFS
115 characters, it is interpreted as a pool name.
129 Display options:
130 .Bl -tag -width Ds
131 .It Fl b , -block-stats
132 Display statistics regarding the number, size
135 .It Fl B , -backup
136 Generate a backup stream, similar to
143 argument is a string of one or more of the letters
150 .Xr zfs-send 8 .
151 .It Fl c , -checksum
158 .It Fl C , -config
159 Display information about the configuration.
160 If specified with no other options, instead display information about the cache
163 To specify the cache file to display, see
166 If specified multiple times, and a pool name is also specified display both the
167 cached configuration and the on-disk configuration.
170 also display the configuration that would be used were the pool to be imported.
171 .It Fl d , -datasets
172 Display information about datasets.
178 .Ar poolname Ns Op / Ns Ar dataset Ns | Ns Ar objset-ID
180 .Ar dataset Ns | Ns Ar objset-ID
181 as a string (dataset name) or a number (objset ID) when
186 If object IDs or object ID ranges are specified, display information about
189 An object ID range is specified in terms of a colon-separated tuple of
200 value of -1 specifies a range with no upper bound.
203 field optionally specifies a set of flags, described below, that control
206 A minus sign
207 .Pq -
210 .Ar A
212 For example, the range 0:-1:A-d will dump all object types except for
215 .Bl -tag -compact -width Ds
216 .It Sy A
226 .It Sy -
229 .It Fl D , -dedup-stats
230 Display deduplication statistics, including the deduplication ratio
239 Display a histogram of deduplication statistics, showing the allocated
245 Display the statistics independently for each deduplication table.
250 .It Fl E , -embedded-block-pointer Ns = Ns Ar word0 : Ns Ar word1 Ns :…: Ns Ar word15
251 Decode and display block from an embedded block pointer specified by the
254 .It Fl h , -history
255 Display pool history similar to
258 .It Fl i , -intent-logs
259 Display information about intent log
262 If specified multiple times, display counts of each intent log transaction type.
263 .It Fl k , -checkpointed-state
266 .It Fl l , -label Ns = Ns Ar device
271 The presence of L2ARC header is indicated by a specific
278 In addition display label space usage stats.
279 If a valid L2ARC header was found
280 also display the properties of log blocks used for restoring L2ARC contents
283 Display every configuration, unique or not.
284 If a valid L2ARC header was found
285 also display the properties of log entries in log blocks used for restoring
294 option is also specified, also display the uberblocks on this device.
296 .It Fl L , -disable-leak-tracking
300 verifies that all non-free blocks are referenced, which can be very expensive.
301 .It Fl m , -metaslabs
302 Display the offset, spacemap, free space of each metaslab, all the log
305 Also display information about the on-disk free space histogram associated with
308 Display the maximum contiguous free space, the in-core free space histogram, and
311 Display every spacemap record.
312 .It Fl M , -metaslab-groups
313 Display all "normal" vdev metaslab group information - per-vdev metaslab count,
317 "Special" vdevs are added to -M's normal output.
318 Also display information about the maximum contiguous free space and the
321 Display every spacemap record.
326 .Op Ar dataset Ns | Ns Ar objset-ID
328 .Op Ar poolname Ns Op / Ns Ar dataset Ns | Ns Ar objset-ID
329 as a numeric objset ID.
330 .It Fl O , -object-lookups Ns = Ns Ar dataset path
335 and display its metadata and indirect blocks.
343 .It Fl r , -copy-object Ns = Ns Ar dataset path destination
357 .Fl R , -read-block Ns = Ns Ar poolname vdev : Ns Ar offset : Ns Oo Ar lsize Ns / Oc Ns Ar psize Ns…
359 Read and display a block from the specified device.
360 By default the block is displayed as a hex dump, but see the description of the
364 The block is specified in terms of a colon-separated tuple
373 .Pq a set of flags, described below .
375 .Bl -tag -compact -width "b offset"
379 Calculate and display checksums
396 .It Fl s , -io-stats
400 Display operation counts, bandwidth, and error counts of I/O to the pool from
402 .It Fl S , -simulate-dedup
403 Simulate the effects of deduplication, constructing a DDT and then display
406 .It Fl T , -brt-stats
407 Display block reference table (BRT) statistics, including the size of uniques
408 blocks cloned, the space saving as a result of cloning, and the saving ratio.
410 Display the per-vdev BRT statistics, including total references.
412 Display histograms of per-vdev BRT refcounts.
415 .It Fl u , -uberblock
416 Display the current uberblock.
420 .Bl -tag -width Ds
421 .It Fl A , -ignore-assertions
428 .It Fl e , -exported Ns = Ns Oo Fl p Ar path Oc Ns …
434 .It Fl x , -dump-blocks Ns = Ns Ar dumpdir
445 .It Fl F , -automatic-rewind
448 .It Fl G , -dump-debug-msg
451 zfs_dbgmsg is a buffer used by ZFS to dump advanced debug information.
452 .It Fl I , -inflight Ns = Ns Ar inflight-I/O-ops
458 .It Fl K , -key Ns = Ns Ar key
476 .It Fl o , -option Ns = Ns Ar var Ns = Ns Ar value Ns …
478 The value must be an unsigned 32-bit integer.
479 Currently only little-endian systems are supported to avoid accidentally setting
480 the high 32 bits of 64-bit variables.
481 .It Fl P , -parseable
486 .It Fl t , -txg Ns = Ns Ar transaction
492 options for a means to see the available uberblocks and their associated
494 .It Fl U , -cachefile Ns = Ns Ar cachefile
495 Use a cache file other than
497 .It Fl v , -verbose
500 .It Fl V , -verbatim
502 This mimics the behavior of the kernel when loading a pool from a cachefile.
505 .It Fl X , -extreme-rewind
511 .It Fl Y , -all-reconstruction
515 .It Fl y , -livelist
523 Specifying a display option more than once enables verbosity for only that
530 .Ss Example 1 : No Display the configuration of imported pool Ar rpool
531 .Bd -literal
539 .Ss Example 2 : No Display basic dataset information about Ar rpool
540 .Bd -literal
547 .Ss Example 3 : No Display basic information about object 0 in Ar rpool/export/home
548 .Bd -literal
556 .Ss Example 4 : No Display the predicted effect of enabling deduplication on Ar rpool
557 .Bd -literal
564 ------ ------ ----- ----- ----- ------ ----- ----- -----