sys/contrib/openzfs/man/man5/zfs-events.5

   1 '\" te
   2 .\" Copyright (c) 2013 by Turbo Fredriksson <turbo@bayour.com>. All rights reserved.
   3 .\" Portions Copyright 2018 by Richard Elling
   4 .\" The contents of this file are subject to the terms of the Common Development
   5 .\" and Distribution License (the "License").  You may not use this file except
   6 .\" in compliance with the License. You can obtain a copy of the license at
   7 .\" usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.
   8 .\"
   9 .\" See the License for the specific language governing permissions and
  10 .\" limitations under the License. When distributing Covered Code, include this
  11 .\" CDDL HEADER in each file and include the License file at
  12 .\" usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this
  13 .\" CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your
  14 .\" own identifying information:
  15 .\" Portions Copyright [yyyy] [name of copyright owner]
  16 .TH ZFS-EVENTS 5 "Aug 24, 2020" OpenZFS
  17 .SH NAME
  18 zfs\-events \- Events created by the ZFS filesystem.
  19 .SH DESCRIPTION
  20 .sp
  21 .LP
  22 Description of the different events generated by the ZFS stack.
  23 .sp
  24 Most of these don't have any description. The events generated by ZFS
  25 have never been publicly documented.  What is here is intended as a
  26 starting point to provide documentation for all possible events.
  27 .sp
  28 To view all events created since the loading of the ZFS infrastructure
  29 (i.e, "the module"), run
  30 .P
  31 .nf
  32 \fBzpool events\fR
  33 .fi
  34 .P
  35 to get a short list, and
  36 .P
  37 .nf
  38 \fBzpool events -v\fR
  39 .fi
  40 .P
  41 to get a full detail of the events and what information
  42 is available about it.
  43 .sp
  44 This man page lists the different subclasses that are issued
  45 in the case of an event. The full event name would be
  46 \fIereport.fs.zfs.SUBCLASS\fR, but we only list the last
  47 part here.
  48
  49 .SS "EVENTS (SUBCLASS)"
  50 .sp
  51 .LP
  52
  53 .sp
  54 .ne 2
  55 .na
  56 \fBchecksum\fR
  57 .ad
  58 .RS 12n
  59 Issued when a checksum error has been detected.
  60 .RE
  61
  62 .sp
  63 .ne 2
  64 .na
  65 \fBio\fR
  66 .ad
  67 .RS 12n
  68 Issued when there is an I/O error in a vdev in the pool.
  69 .RE
  70
  71 .sp
  72 .ne 2
  73 .na
  74 \fBdata\fR
  75 .ad
  76 .RS 12n
  77 Issued when there have been data errors in the pool.
  78 .RE
  79
  80 .sp
  81 .ne 2
  82 .na
  83 \fBdeadman\fR
  84 .ad
  85 .RS 12n
  86 Issued when an I/O is determined to be "hung", this can be caused by lost
  87 completion events due to flaky hardware or drivers.  See the
  88 \fBzfs_deadman_failmode\fR module option description for additional
  89 information regarding "hung" I/O detection and configuration.
  90 .RE
  91
  92 .sp
  93 .ne 2
  94 .na
  95 \fBdelay\fR
  96 .ad
  97 .RS 12n
  98 Issued when a completed I/O exceeds the maximum allowed time specified
  99 by the \fBzio_slow_io_ms\fR module option.  This can be an indicator of
 100 problems with the underlying storage device.  The number of delay events is
 101 ratelimited by the \fBzfs_slow_io_events_per_second\fR module parameter.
 102 .RE
 103
 104 .sp
 105 .ne 2
 106 .na
 107 \fBconfig.sync\fR
 108 .ad
 109 .RS 12n
 110 Issued every time a vdev change have been done to the pool.
 111 .RE
 112
 113 .sp
 114 .ne 2
 115 .na
 116 \fBzpool\fR
 117 .ad
 118 .RS 12n
 119 Issued when a pool cannot be imported.
 120 .RE
 121
 122 .sp
 123 .ne 2
 124 .na
 125 \fBzpool.destroy\fR
 126 .ad
 127 .RS 12n
 128 Issued when a pool is destroyed.
 129 .RE
 130
 131 .sp
 132 .ne 2
 133 .na
 134 \fBzpool.export\fR
 135 .ad
 136 .RS 12n
 137 Issued when a pool is exported.
 138 .RE
 139
 140 .sp
 141 .ne 2
 142 .na
 143 \fBzpool.import\fR
 144 .ad
 145 .RS 12n
 146 Issued when a pool is imported.
 147 .RE
 148
 149 .sp
 150 .ne 2
 151 .na
 152 \fBzpool.reguid\fR
 153 .ad
 154 .RS 12n
 155 Issued when a REGUID (new unique identifier for the pool have been regenerated) have been detected.
 156 .RE
 157
 158 .sp
 159 .ne 2
 160 .na
 161 \fBvdev.unknown\fR
 162 .ad
 163 .RS 12n
 164 Issued when the vdev is unknown. Such as trying to clear device
 165 errors on a vdev that have failed/been kicked from the system/pool
 166 and is no longer available.
 167 .RE
 168
 169 .sp
 170 .ne 2
 171 .na
 172 \fBvdev.open_failed\fR
 173 .ad
 174 .RS 12n
 175 Issued when a vdev could not be opened (because it didn't exist for example).
 176 .RE
 177
 178 .sp
 179 .ne 2
 180 .na
 181 \fBvdev.corrupt_data\fR
 182 .ad
 183 .RS 12n
 184 Issued when corrupt data have been detected on a vdev.
 185 .RE
 186
 187 .sp
 188 .ne 2
 189 .na
 190 \fBvdev.no_replicas\fR
 191 .ad
 192 .RS 12n
 193 Issued when there are no more replicas to sustain the pool.
 194 This would lead to the pool being \fIDEGRADED\fR.
 195 .RE
 196
 197 .sp
 198 .ne 2
 199 .na
 200 \fBvdev.bad_guid_sum\fR
 201 .ad
 202 .RS 12n
 203 Issued when a missing device in the pool have been detected.
 204 .RE
 205
 206 .sp
 207 .ne 2
 208 .na
 209 \fBvdev.too_small\fR
 210 .ad
 211 .RS 12n
 212 Issued when the system (kernel) have removed a device, and ZFS
 213 notices that the device isn't there any more. This is usually
 214 followed by a \fBprobe_failure\fR event.
 215 .RE
 216
 217 .sp
 218 .ne 2
 219 .na
 220 \fBvdev.bad_label\fR
 221 .ad
 222 .RS 12n
 223 Issued when the label is OK but invalid.
 224 .RE
 225
 226 .sp
 227 .ne 2
 228 .na
 229 \fBvdev.bad_ashift\fR
 230 .ad
 231 .RS 12n
 232 Issued when the ashift alignment requirement has increased.
 233 .RE
 234
 235 .sp
 236 .ne 2
 237 .na
 238 \fBvdev.remove\fR
 239 .ad
 240 .RS 12n
 241 Issued when a vdev is detached from a mirror (or a spare detached from a
 242 vdev where it have been used to replace a failed drive - only works if
 243 the original drive have been readded).
 244 .RE
 245
 246 .sp
 247 .ne 2
 248 .na
 249 \fBvdev.clear\fR
 250 .ad
 251 .RS 12n
 252 Issued when clearing device errors in a pool. Such as running \fBzpool clear\fR
 253 on a device in the pool.
 254 .RE
 255
 256 .sp
 257 .ne 2
 258 .na
 259 \fBvdev.check\fR
 260 .ad
 261 .RS 12n
 262 Issued when a check to see if a given vdev could be opened is started.
 263 .RE
 264
 265 .sp
 266 .ne 2
 267 .na
 268 \fBvdev.spare\fR
 269 .ad
 270 .RS 12n
 271 Issued when a spare have kicked in to replace a failed device.
 272 .RE
 273
 274 .sp
 275 .ne 2
 276 .na
 277 \fBvdev.autoexpand\fR
 278 .ad
 279 .RS 12n
 280 Issued when a vdev can be automatically expanded.
 281 .RE
 282
 283 .sp
 284 .ne 2
 285 .na
 286 \fBio_failure\fR
 287 .ad
 288 .RS 12n
 289 Issued when there is an I/O failure in a vdev in the pool.
 290 .RE
 291
 292 .sp
 293 .ne 2
 294 .na
 295 \fBprobe_failure\fR
 296 .ad
 297 .RS 12n
 298 Issued when a probe fails on a vdev. This would occur if a vdev
 299 have been kicked from the system outside of ZFS (such as the kernel
 300 have removed the device).
 301 .RE
 302
 303 .sp
 304 .ne 2
 305 .na
 306 \fBlog_replay\fR
 307 .ad
 308 .RS 12n
 309 Issued when the intent log cannot be replayed.  The can occur in the case
 310 of a missing or damaged log device.
 311 .RE
 312
 313 .sp
 314 .ne 2
 315 .na
 316 \fBresilver.start\fR
 317 .ad
 318 .RS 12n
 319 Issued when a resilver is started.
 320 .RE
 321
 322 .sp
 323 .ne 2
 324 .na
 325 \fBresilver.finish\fR
 326 .ad
 327 .RS 12n
 328 Issued when the running resilver have finished.
 329 .RE
 330
 331 .sp
 332 .ne 2
 333 .na
 334 \fBscrub.start\fR
 335 .ad
 336 .RS 12n
 337 Issued when a scrub is started on a pool.
 338 .RE
 339
 340 .sp
 341 .ne 2
 342 .na
 343 \fBscrub.finish\fR
 344 .ad
 345 .RS 12n
 346 Issued when a pool has finished scrubbing.
 347 .RE
 348
 349 .sp
 350 .ne 2
 351 .na
 352 \fBscrub.abort\fR
 353 .ad
 354 .RS 12n
 355 Issued when a scrub is aborted on a pool.
 356 .RE
 357
 358 .sp
 359 .ne 2
 360 .na
 361 \fBscrub.resume\fR
 362 .ad
 363 .RS 12n
 364 Issued when a scrub is resumed on a pool.
 365 .RE
 366
 367 .sp
 368 .ne 2
 369 .na
 370 \fBscrub.paused\fR
 371 .ad
 372 .RS 12n
 373 Issued when a scrub is paused on a pool.
 374 .RE
 375
 376 .sp
 377 .ne 2
 378 .na
 379 \fBbootfs.vdev.attach\fR
 380 .ad
 381 .RS 12n
 382 .RE
 383
 384 .SS "PAYLOADS"
 385 .sp
 386 .LP
 387 This is the payload (data, information) that accompanies an
 388 event.
 389 .sp
 390 For
 391 .BR zed (8),
 392 these are set to uppercase and prefixed with \fBZEVENT_\fR.
 393
 394 .sp
 395 .ne 2
 396 .na
 397 \fBpool\fR
 398 .ad
 399 .RS 12n
 400 Pool name.
 401 .RE
 402
 403 .sp
 404 .ne 2
 405 .na
 406 \fBpool_failmode\fR
 407 .ad
 408 .RS 12n
 409 Failmode - \fBwait\fR, \fBcontinue\fR or \fBpanic\fR.
 410 See
 411 .BR zpool (8)
 412 (\fIfailmode\fR property) for more information.
 413 .RE
 414
 415 .sp
 416 .ne 2
 417 .na
 418 \fBpool_guid\fR
 419 .ad
 420 .RS 12n
 421 The GUID of the pool.
 422 .RE
 423
 424 .sp
 425 .ne 2
 426 .na
 427 \fBpool_context\fR
 428 .ad
 429 .RS 12n
 430 The load state for the pool (0=none, 1=open, 2=import, 3=tryimport, 4=recover
 431 5=error).
 432 .RE
 433
 434 .sp
 435 .ne 2
 436 .na
 437 \fBvdev_guid\fR
 438 .ad
 439 .RS 12n
 440 The GUID of the vdev in question (the vdev failing or operated upon with
 441 \fBzpool clear\fR etc).
 442 .RE
 443
 444 .sp
 445 .ne 2
 446 .na
 447 \fBvdev_type\fR
 448 .ad
 449 .RS 12n
 450 Type of vdev - \fBdisk\fR, \fBfile\fR, \fBmirror\fR etc. See
 451 .BR zpool (8)
 452 under \fBVirtual Devices\fR for more information on possible values.
 453 .RE
 454
 455 .sp
 456 .ne 2
 457 .na
 458 \fBvdev_path\fR
 459 .ad
 460 .RS 12n
 461 Full path of the vdev, including any \fI-partX\fR.
 462 .RE
 463
 464 .sp
 465 .ne 2
 466 .na
 467 \fBvdev_devid\fR
 468 .ad
 469 .RS 12n
 470 ID of vdev (if any).
 471 .RE
 472
 473 .sp
 474 .ne 2
 475 .na
 476 \fBvdev_fru\fR
 477 .ad
 478 .RS 12n
 479 Physical FRU location.
 480 .RE
 481
 482 .sp
 483 .ne 2
 484 .na
 485 \fBvdev_state\fR
 486 .ad
 487 .RS 12n
 488 State of vdev (0=uninitialized, 1=closed, 2=offline, 3=removed, 4=failed to open, 5=faulted, 6=degraded, 7=healthy).
 489 .RE
 490
 491 .sp
 492 .ne 2
 493 .na
 494 \fBvdev_ashift\fR
 495 .ad
 496 .RS 12n
 497 The ashift value of the vdev.
 498 .RE
 499
 500 .sp
 501 .ne 2
 502 .na
 503 \fBvdev_complete_ts\fR
 504 .ad
 505 .RS 12n
 506 The time the last I/O completed for the specified vdev.
 507 .RE
 508
 509 .sp
 510 .ne 2
 511 .na
 512 \fBvdev_delta_ts\fR
 513 .ad
 514 .RS 12n
 515 The time since the last I/O completed for the specified vdev.
 516 .RE
 517
 518 .sp
 519 .ne 2
 520 .na
 521 \fBvdev_spare_paths\fR
 522 .ad
 523 .RS 12n
 524 List of spares, including full path and any \fI-partX\fR.
 525 .RE
 526
 527 .sp
 528 .ne 2
 529 .na
 530 \fBvdev_spare_guids\fR
 531 .ad
 532 .RS 12n
 533 GUID(s) of spares.
 534 .RE
 535
 536 .sp
 537 .ne 2
 538 .na
 539 \fBvdev_read_errors\fR
 540 .ad
 541 .RS 12n
 542 How many read errors that have been detected on the vdev.
 543 .RE
 544
 545 .sp
 546 .ne 2
 547 .na
 548 \fBvdev_write_errors\fR
 549 .ad
 550 .RS 12n
 551 How many write errors that have been detected on the vdev.
 552 .RE
 553
 554 .sp
 555 .ne 2
 556 .na
 557 \fBvdev_cksum_errors\fR
 558 .ad
 559 .RS 12n
 560 How many checksum errors that have been detected on the vdev.
 561 .RE
 562
 563 .sp
 564 .ne 2
 565 .na
 566 \fBparent_guid\fR
 567 .ad
 568 .RS 12n
 569 GUID of the vdev parent.
 570 .RE
 571
 572 .sp
 573 .ne 2
 574 .na
 575 \fBparent_type\fR
 576 .ad
 577 .RS 12n
 578 Type of parent. See \fBvdev_type\fR.
 579 .RE
 580
 581 .sp
 582 .ne 2
 583 .na
 584 \fBparent_path\fR
 585 .ad
 586 .RS 12n
 587 Path of the vdev parent (if any).
 588 .RE
 589
 590 .sp
 591 .ne 2
 592 .na
 593 \fBparent_devid\fR
 594 .ad
 595 .RS 12n
 596 ID of the vdev parent (if any).
 597 .RE
 598
 599 .sp
 600 .ne 2
 601 .na
 602 \fBzio_objset\fR
 603 .ad
 604 .RS 12n
 605 The object set number for a given I/O.
 606 .RE
 607
 608 .sp
 609 .ne 2
 610 .na
 611 \fBzio_object\fR
 612 .ad
 613 .RS 12n
 614 The object number for a given I/O.
 615 .RE
 616
 617 .sp
 618 .ne 2
 619 .na
 620 \fBzio_level\fR
 621 .ad
 622 .RS 12n
 623 The indirect level for the block. Level 0 is the lowest level and includes
 624 data blocks. Values > 0 indicate metadata blocks at the appropriate level.
 625 .RE
 626
 627 .sp
 628 .ne 2
 629 .na
 630 \fBzio_blkid\fR
 631 .ad
 632 .RS 12n
 633 The block ID for a given I/O.
 634 .RE
 635
 636 .sp
 637 .ne 2
 638 .na
 639 \fBzio_err\fR
 640 .ad
 641 .RS 12n
 642 The errno for a failure when handling a given I/O. The errno is compatible
 643 with \fBerrno\fR(3) with the value for EBADE (0x34) used to indicate ZFS
 644 checksum error.
 645 .RE
 646
 647 .sp
 648 .ne 2
 649 .na
 650 \fBzio_offset\fR
 651 .ad
 652 .RS 12n
 653 The offset in bytes of where to write the I/O for the specified vdev.
 654 .RE
 655
 656 .sp
 657 .ne 2
 658 .na
 659 \fBzio_size\fR
 660 .ad
 661 .RS 12n
 662 The size in bytes of the I/O.
 663 .RE
 664
 665 .sp
 666 .ne 2
 667 .na
 668 \fBzio_flags\fR
 669 .ad
 670 .RS 12n
 671 The current flags describing how the I/O should be handled.  See the
 672 \fBI/O FLAGS\fR section for the full list of I/O flags.
 673 .RE
 674
 675 .sp
 676 .ne 2
 677 .na
 678 \fBzio_stage\fR
 679 .ad
 680 .RS 12n
 681 The current stage of the I/O in the pipeline.  See the \fBI/O STAGES\fR
 682 section for a full list of all the I/O stages.
 683 .RE
 684
 685 .sp
 686 .ne 2
 687 .na
 688 \fBzio_pipeline\fR
 689 .ad
 690 .RS 12n
 691 The valid pipeline stages for the I/O.  See the \fBI/O STAGES\fR section for a
 692 full list of all the I/O stages.
 693 .RE
 694
 695 .sp
 696 .ne 2
 697 .na
 698 \fBzio_delay\fR
 699 .ad
 700 .RS 12n
 701 The time elapsed (in nanoseconds) waiting for the block layer to complete the
 702 I/O.  Unlike \fBzio_delta\fR this does not include any vdev queuing time and is
 703 therefore solely a measure of the block layer performance.
 704 .RE
 705
 706 .sp
 707 .ne 2
 708 .na
 709 \fBzio_timestamp\fR
 710 .ad
 711 .RS 12n
 712 The time when a given I/O was submitted.
 713 .RE
 714
 715 .sp
 716 .ne 2
 717 .na
 718 \fBzio_delta\fR
 719 .ad
 720 .RS 12n
 721 The time required to service a given I/O.
 722 .RE
 723
 724 .sp
 725 .ne 2
 726 .na
 727 \fBprev_state\fR
 728 .ad
 729 .RS 12n
 730 The previous state of the vdev.
 731 .RE
 732
 733 .sp
 734 .ne 2
 735 .na
 736 \fBcksum_expected\fR
 737 .ad
 738 .RS 12n
 739 The expected checksum value for the block.
 740 .RE
 741
 742 .sp
 743 .ne 2
 744 .na
 745 \fBcksum_actual\fR
 746 .ad
 747 .RS 12n
 748 The actual checksum value for an errant block.
 749 .RE
 750
 751 .sp
 752 .ne 2
 753 .na
 754 \fBcksum_algorithm\fR
 755 .ad
 756 .RS 12n
 757 Checksum algorithm used. See \fBzfs\fR(8) for more information on checksum
 758 algorithms available.
 759 .RE
 760
 761 .sp
 762 .ne 2
 763 .na
 764 \fBcksum_byteswap\fR
 765 .ad
 766 .RS 12n
 767 Whether or not the data is byteswapped.
 768 .RE
 769
 770 .sp
 771 .ne 2
 772 .na
 773 \fBbad_ranges\fR
 774 .ad
 775 .RS 12n
 776 [start, end) pairs of corruption offsets. Offsets are always aligned on a
 777 64-bit boundary, and can include some gaps of non-corruption.
 778 (See \fBbad_ranges_min_gap\fR)
 779 .RE
 780
 781 .sp
 782 .ne 2
 783 .na
 784 \fBbad_ranges_min_gap\fR
 785 .ad
 786 .RS 12n
 787 In order to bound the size of the \fBbad_ranges\fR array, gaps of non-corruption
 788 less than or equal to \fBbad_ranges_min_gap\fR bytes have been merged with
 789 adjacent corruption. Always at least 8 bytes, since corruption is detected
 790 on a 64-bit word basis.
 791 .RE
 792
 793 .sp
 794 .ne 2
 795 .na
 796 \fBbad_range_sets\fR
 797 .ad
 798 .RS 12n
 799 This array has one element per range in \fBbad_ranges\fR. Each element contains
 800 the count of bits in that range which were clear in the good data and set
 801 in the bad data.
 802 .RE
 803
 804 .sp
 805 .ne 2
 806 .na
 807 \fBbad_range_clears\fR
 808 .ad
 809 .RS 12n
 810 This array has one element per range in \fBbad_ranges\fR. Each element contains
 811 the count of bits for that range which were set in the good data and clear in
 812 the bad data.
 813 .RE
 814
 815 .sp
 816 .ne 2
 817 .na
 818 \fBbad_set_bits\fR
 819 .ad
 820 .RS 12n
 821 If this field exists, it is an array of: (bad data & ~(good data)); that is,
 822 the bits set in the bad data which are cleared in the good data. Each element
 823 corresponds a byte whose offset is in a range in \fBbad_ranges\fR, and the
 824 array is ordered by offset. Thus, the first element is the first byte in the
 825 first \fBbad_ranges\fR range, and the last element is the last byte in the last
 826 \fBbad_ranges\fR range.
 827 .RE
 828
 829 .sp
 830 .ne 2
 831 .na
 832 \fBbad_cleared_bits\fR
 833 .ad
 834 .RS 12n
 835 Like \fBbad_set_bits\fR, but contains: (good data & ~(bad data)); that is,
 836 the bits set in the good data which are cleared in the bad data.
 837 .RE
 838
 839 .sp
 840 .ne 2
 841 .na
 842 \fBbad_set_histogram\fR
 843 .ad
 844 .RS 12n
 845 If this field exists, it is an array of counters. Each entry counts bits set
 846 in a particular bit of a big-endian uint64 type. The first entry counts bits
 847 set in the high-order bit of the first byte, the 9th byte, etc, and the last
 848 entry counts bits set of the low-order bit of the 8th byte, the 16th byte, etc.
 849 This information is useful for observing a stuck bit in a parallel data path,
 850 such as IDE or parallel SCSI.
 851 .RE
 852
 853 .sp
 854 .ne 2
 855 .na
 856 \fBbad_cleared_histogram\fR
 857 .ad
 858 .RS 12n
 859 If this field exists, it is an array of counters. Each entry counts bit clears
 860 in a particular bit of a big-endian uint64 type. The first entry counts bits
 861 clears of the high-order bit of the first byte, the 9th byte, etc, and the
 862 last entry counts clears of the low-order bit of the 8th byte, the 16th byte,
 863 etc. This information is useful for observing a stuck bit in a parallel data
 864 path, such as IDE or parallel SCSI.
 865 .RE
 866
 867 .SS "I/O STAGES"
 868 .sp
 869 .LP
 870 The ZFS I/O pipeline is comprised of various stages which are defined
 871 below.  The individual stages are used to construct these basic I/O
 872 operations: Read, Write, Free, Claim, and Ioctl.  These stages may be
 873 set on an event to describe the life cycle of a given I/O.
 874
 875 .TS
 876 tab(:);
 877 l l l .
 878 Stage:Bit Mask:Operations
 879 _:_:_
 880 ZIO_STAGE_OPEN:0x00000001:RWFCI
 881
 882 ZIO_STAGE_READ_BP_INIT:0x00000002:R----
 883 ZIO_STAGE_WRITE_BP_INIT:0x00000004:-W---
 884 ZIO_STAGE_FREE_BP_INIT:0x00000008:--F--
 885 ZIO_STAGE_ISSUE_ASYNC:0x00000010:RWF--
 886 ZIO_STAGE_WRITE_COMPRESS:0x00000020:-W---
 887
 888 ZIO_STAGE_ENCRYPT:0x00000040:-W---
 889 ZIO_STAGE_CHECKSUM_GENERATE:0x00000080:-W---
 890
 891 ZIO_STAGE_NOP_WRITE:0x00000100:-W---
 892
 893 ZIO_STAGE_DDT_READ_START:0x00000200:R----
 894 ZIO_STAGE_DDT_READ_DONE:0x00000400:R----
 895 ZIO_STAGE_DDT_WRITE:0x00000800:-W---
 896 ZIO_STAGE_DDT_FREE:0x00001000:--F--
 897
 898 ZIO_STAGE_GANG_ASSEMBLE:0x00002000:RWFC-
 899 ZIO_STAGE_GANG_ISSUE:0x00004000:RWFC-
 900
 901 ZIO_STAGE_DVA_THROTTLE:0x00008000:-W---
 902 ZIO_STAGE_DVA_ALLOCATE:0x00010000:-W---
 903 ZIO_STAGE_DVA_FREE:0x00020000:--F--
 904 ZIO_STAGE_DVA_CLAIM:0x00040000:---C-
 905
 906 ZIO_STAGE_READY:0x00080000:RWFCI
 907
 908 ZIO_STAGE_VDEV_IO_START:0x00100000:RW--I
 909 ZIO_STAGE_VDEV_IO_DONE:0x00200000:RW--I
 910 ZIO_STAGE_VDEV_IO_ASSESS:0x00400000:RW--I
 911
 912 ZIO_STAGE_CHECKSUM_VERIFY:0x00800000:R----
 913
 914 ZIO_STAGE_DONE:0x01000000:RWFCI
 915 .TE
 916
 917 .SS "I/O FLAGS"
 918 .sp
 919 .LP
 920 Every I/O in the pipeline contains a set of flags which describe its
 921 function and are used to govern its behavior.  These flags will be set
 922 in an event as an \fBzio_flags\fR payload entry.
 923
 924 .TS
 925 tab(:);
 926 l l .
 927 Flag:Bit Mask
 928 _:_
 929 ZIO_FLAG_DONT_AGGREGATE:0x00000001
 930 ZIO_FLAG_IO_REPAIR:0x00000002
 931 ZIO_FLAG_SELF_HEAL:0x00000004
 932 ZIO_FLAG_RESILVER:0x00000008
 933 ZIO_FLAG_SCRUB:0x00000010
 934 ZIO_FLAG_SCAN_THREAD:0x00000020
 935 ZIO_FLAG_PHYSICAL:0x00000040
 936
 937 ZIO_FLAG_CANFAIL:0x00000080
 938 ZIO_FLAG_SPECULATIVE:0x00000100
 939 ZIO_FLAG_CONFIG_WRITER:0x00000200
 940 ZIO_FLAG_DONT_RETRY:0x00000400
 941 ZIO_FLAG_DONT_CACHE:0x00000800
 942 ZIO_FLAG_NODATA:0x00001000
 943 ZIO_FLAG_INDUCE_DAMAGE:0x00002000
 944
 945 ZIO_FLAG_IO_ALLOCATING:0x00004000
 946 ZIO_FLAG_IO_RETRY:0x00008000
 947 ZIO_FLAG_PROBE:0x00010000
 948 ZIO_FLAG_TRYHARD:0x00020000
 949 ZIO_FLAG_OPTIONAL:0x00040000
 950
 951 ZIO_FLAG_DONT_QUEUE:0x00080000
 952 ZIO_FLAG_DONT_PROPAGATE:0x00100000
 953 ZIO_FLAG_IO_BYPASS:0x00200000
 954 ZIO_FLAG_IO_REWRITE:0x00400000
 955 ZIO_FLAG_RAW_COMPRESS:0x00800000
 956 ZIO_FLAG_RAW_ENCRYPT:0x01000000
 957
 958 ZIO_FLAG_GANG_CHILD:0x02000000
 959 ZIO_FLAG_DDT_CHILD:0x04000000
 960 ZIO_FLAG_GODFATHER:0x08000000
 961 ZIO_FLAG_NOPWRITE:0x10000000
 962 ZIO_FLAG_REEXECUTED:0x20000000
 963 ZIO_FLAG_DELEGATED:0x40000000
 964 ZIO_FLAG_FASTWRITE:0x80000000
 965 .TE