1 '\" te
   2 .\" Copyright (c) 2007, Sun Microsystems, Inc.  All rights reserved.
   3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   5 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   6 .TH DSSTAT 1M "Oct 2, 2007"
   7 .SH NAME
   8 dsstat \- report Sun StorageTek Availability Suite I/O statistics
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fBdsstat\fR \fB-m\fR \fImode\fR [\fB-r\fR \fIreport-options\fR] [\fB-d\fR \fIdisplay-options\fR]
  13  [\fB-s\fR \fIvolume-sets\fR] [\fB-f\fR | \fB-F\fR] [\fB-z\fR] [\fIinterval\fR [\fIcount\fR]]
  14 .fi
  15 
  16 .SH DESCRIPTION
  17 .sp
  18 .LP
  19 The \fBdsstat\fR command collects and reports I/O statistics for the Sun
  20 StorageTek Availability Suite products.
  21 .SH OPTIONS
  22 .sp
  23 .LP
  24 The \fBdsstat\fR supports the following options:
  25 .sp
  26 .ne 2
  27 .na
  28 \fB\fB-m\fR \fB\fImode\fR\fR\fR
  29 .ad
  30 .sp .6
  31 .RS 4n
  32 Specifies the mode(s) of operation. Valid modes are:
  33 .sp
  34 .ne 2
  35 .na
  36 \fB\fBcache\fR\fR
  37 .ad
  38 .sp .6
  39 .RS 4n
  40 Cache statistics
  41 .RE
  42 
  43 .sp
  44 .ne 2
  45 .na
  46 \fB\fBii\fR\fR
  47 .ad
  48 .sp .6
  49 .RS 4n
  50 Point-in-Time Copy statistics
  51 .RE
  52 
  53 .sp
  54 .ne 2
  55 .na
  56 \fB\fBsndr\fR\fR
  57 .ad
  58 .sp .6
  59 .RS 4n
  60 Remote Mirror statistics
  61 .RE
  62 
  63 To display statistics for multiple services simultaneously, use the \fB-m\fR
  64 switch to specify each of the modes required. For example:
  65 .sp
  66 .in +2
  67 .nf
  68 % \fBdsstat -m ii -m sndr\fR
  69 % \fBdsstat -m ii -m sndr -m cache\fR
  70 .fi
  71 .in -2
  72 .sp
  73 
  74 To determine which statistics are being reported from which service, use the
  75 \fIrole\fR field, described below. When cache statistics are requested as one
  76 of the multiple services, the \fBrkps\fR and \fBwkps\fR statistics is further
  77 divided into \fBcrkps\fR, \fBdrkps\fR, \fBcwkps\fR, and \fBdwkps\fR. If no
  78 \fB-m\fR switch is specified, then \fBdsstat\fR displays default statistics for
  79 all of the valid modes as described above. See "Field Descriptions," below for
  80 descriptions of these fields.
  81 .RE
  82 
  83 .sp
  84 .ne 2
  85 .na
  86 \fB\fB-r\fR \fB\fIreport-options\fR\fR\fR
  87 .ad
  88 .sp .6
  89 .RS 4n
  90 Specifies the volume components to be displayed. Each item is represented by a
  91 single character, and multiple items can be selected. The \fIreport-options\fR
  92 vary based on the mode(s) specified above. This option is not used for
  93 \fBcache\fR mode.
  94 .sp
  95 Valid \fIreport-options\fR for \fBii\fR mode are:
  96 .sp
  97 .ne 2
  98 .na
  99 \fB\fBm\fR\fR
 100 .ad
 101 .RS 13n
 102 Master volume statistics.
 103 .RS +4
 104 .TP
 105 .ie t \(bu
 106 .el o
 107 For the "report-options for ii mode": \fBm\fR, \fBs\fR, \fBb\fR, \fBo\fR
 108 .RE
 109 .RS +4
 110 .TP
 111 .ie t \(bu
 112 .el o
 113 For the "report-options for sndr mode": \fBb\fR, \fBn\fR
 114 .RE
 115 .RS +4
 116 .TP
 117 .ie t \(bu
 118 .el o
 119 For the "display-options for cache mode": \fBr\fR, \fBw\fR, \fBd\fR, \fBc\fR,
 120 \fBs\fR, \fBf\fR
 121 .RE
 122 .RS +4
 123 .TP
 124 .ie t \(bu
 125 .el o
 126 For the "display-options for ii mode": \fBr\fR, \fBw\fR, \fBt\fR, \fBs\fR,
 127 \fBp\fR, \fBf\fR
 128 .RE
 129 .RE
 130 
 131 .sp
 132 .ne 2
 133 .na
 134 \fB\fBs\fR\fR
 135 .ad
 136 .RS 13n
 137 Shadow volume statistics.
 138 .RE
 139 
 140 .sp
 141 .ne 2
 142 .na
 143 \fB\fBb\fR\fR
 144 .ad
 145 .RS 13n
 146 Bitmap volume statistics.
 147 .RE
 148 
 149 .sp
 150 .ne 2
 151 .na
 152 \fB\fBo\fR\fR
 153 .ad
 154 .RS 13n
 155 Overflow volume statistics, if attached.
 156 .RE
 157 
 158 Valid \fIreport-options\fR for \fBsndr\fR mode are:
 159 .sp
 160 .ne 2
 161 .na
 162 \fB\fBb\fR\fR
 163 .ad
 164 .RS 13n
 165 Bitmap volume statistics.
 166 .RE
 167 
 168 .sp
 169 .ne 2
 170 .na
 171 \fB\fBn\fR\fR
 172 .ad
 173 .RS 13n
 174 Network volume statistics.
 175 .RE
 176 
 177 .RE
 178 
 179 .sp
 180 .ne 2
 181 .na
 182 \fB\fB-d\fR \fIdisplay-options\fR\fR
 183 .ad
 184 .sp .6
 185 .RS 4n
 186 Specifies the statistics to be displayed. The types of statistics are
 187 represented by a single character; multiple types can be specified.
 188 .sp
 189 For \fBcache\fR mode, the valid \fIdisplay-options\fR are:
 190 .sp
 191 .ne 2
 192 .na
 193 \fB\fBr\fR\fR
 194 .ad
 195 .RS 13n
 196 Detailed read statistics.
 197 .RE
 198 
 199 .sp
 200 .ne 2
 201 .na
 202 \fB\fBw\fR\fR
 203 .ad
 204 .RS 13n
 205 Detailed write statistics.
 206 .RE
 207 
 208 .sp
 209 .ne 2
 210 .na
 211 \fB\fBs\fR\fR
 212 .ad
 213 .RS 13n
 214 Summary statistics.
 215 .RE
 216 
 217 .sp
 218 .ne 2
 219 .na
 220 \fB\fBf\fR\fR
 221 .ad
 222 .RS 13n
 223 Cache behavior flags.
 224 .RE
 225 
 226 The following \fIdisplay-options\fR are available only for cache mode, they
 227 need to be combined with the mode options (\fB-m\fR)
 228 .sp
 229 .ne 2
 230 .na
 231 \fB\fBd\fR\fR
 232 .ad
 233 .RS 13n
 234 Destaged data statistics.
 235 .RE
 236 
 237 .sp
 238 .ne 2
 239 .na
 240 \fB\fBc\fR\fR
 241 .ad
 242 .RS 13n
 243 Write cancellation statistics.
 244 .RE
 245 
 246 The default \fIdisplay-options\fR for \fBcache\fR are \fBsf\fR.
 247 .sp
 248 For \fBii\fR mode, the valid \fIdisplay-options\fR are:
 249 .sp
 250 .ne 2
 251 .na
 252 \fB\fBr\fR\fR
 253 .ad
 254 .sp .6
 255 .RS 4n
 256 Detailed read statistics.
 257 .RE
 258 
 259 .sp
 260 .ne 2
 261 .na
 262 \fB\fBw\fR\fR
 263 .ad
 264 .sp .6
 265 .RS 4n
 266 Detailed write statistics.
 267 .RE
 268 
 269 .sp
 270 .ne 2
 271 .na
 272 \fB\fBt\fR\fR
 273 .ad
 274 .sp .6
 275 .RS 4n
 276 Timing statistics.
 277 .RE
 278 
 279 .sp
 280 .ne 2
 281 .na
 282 \fB\fBs\fR\fR
 283 .ad
 284 .sp .6
 285 .RS 4n
 286 Summary statistics.
 287 .RE
 288 
 289 .sp
 290 .ne 2
 291 .na
 292 \fB\fBp\fR\fR
 293 .ad
 294 .sp .6
 295 .RS 4n
 296 Percentage of volume requiring sync.
 297 .RE
 298 
 299 .sp
 300 .ne 2
 301 .na
 302 \fB\fBf\fR\fR
 303 .ad
 304 .sp .6
 305 .RS 4n
 306 Volume type/status flags.
 307 .RE
 308 
 309 The default \fIdisplay-options\fR for \fBii\fR are \fBspf\fR. For \fBsndr\fR
 310 mode, the valid \fIdisplay-options\fR are:
 311 .sp
 312 .ne 2
 313 .na
 314 \fB\fBr\fR\fR
 315 .ad
 316 .RS 13n
 317 Detailed read statistics.
 318 .RE
 319 
 320 .sp
 321 .ne 2
 322 .na
 323 \fB\fBw\fR\fR
 324 .ad
 325 .RS 13n
 326 Detailed write statistics.
 327 .RE
 328 
 329 .sp
 330 .ne 2
 331 .na
 332 \fB\fBt\fR\fR
 333 .ad
 334 .RS 13n
 335 Timing statistics.
 336 .RE
 337 
 338 .sp
 339 .ne 2
 340 .na
 341 \fB\fBs\fR\fR
 342 .ad
 343 .RS 13n
 344 Summary statistics.
 345 .RE
 346 
 347 .sp
 348 .ne 2
 349 .na
 350 \fB\fBp\fR\fR
 351 .ad
 352 .RS 13n
 353 Percentage of volume requiring sync.
 354 .RE
 355 
 356 .sp
 357 .ne 2
 358 .na
 359 \fB\fBf\fR\fR
 360 .ad
 361 .RS 13n
 362 Volume type/status flags.
 363 .RE
 364 
 365 .sp
 366 .ne 2
 367 .na
 368 \fB\fBq\fR\fR
 369 .ad
 370 .RS 13n
 371 Asynchronous queue statistics.
 372 .RE
 373 
 374 The following \fIdisplay-option\fR is only available for \fBsndr\fR mode, and
 375 needs to be combined with the mode options (\fB-m\fR).
 376 .sp
 377 .ne 2
 378 .na
 379 \fB\fBq\fR\fR
 380 .ad
 381 .RS 13n
 382 Asynchronous queue statistics.
 383 .RE
 384 
 385 The default \fIdisplay-options\fR for \fBsndr\fR are \fBspf\fR.
 386 .sp
 387 Specifying the summary \fIdisplay-option\fR causes \fBr\fR \fBw\fR \fBt\fR
 388 \fIdisplay-options\fR to be ignored.
 389 .RE
 390 
 391 .sp
 392 .ne 2
 393 .na
 394 \fB\fB-s\fR \fB\fIvolume-sets\fR\fR\fR
 395 .ad
 396 .RS 20n
 397 Filters the output to include only the specified \fIvolume-sets\fR, where
 398 \fIvolume-sets\fR is a comma-delimited list of volume names. When displaying
 399 Remote Mirror statistics, the name specified is compared to the Remote Mirror
 400 primary volume to determine if they match. Additionally, an Remote Mirror
 401 volume should be specified as \fI<host>\fR:\fI<volume>\fR where \fI<host>\fR is
 402 the primary or secondary host and \fI<volume>\fR is the volume name by which
 403 that host recognizes the volume set. When specifying multiple Remote Mirror
 404 volumes sets, be aware that each volume set specified is evaluated
 405 individually, using the rules above. When displaying Point-in-Time Copy
 406 statistics, the volume name specified is compared to the Point-in-Time Copy
 407 shadow volume to determine if they match.
 408 .RE
 409 
 410 .sp
 411 .ne 2
 412 .na
 413 \fB\fB-f\fR\fR
 414 .ad
 415 .RS 20n
 416 Output field headers at every reporting cycle.
 417 .RE
 418 
 419 .sp
 420 .ne 2
 421 .na
 422 \fB\fB-F\fR\fR
 423 .ad
 424 .RS 20n
 425 Output field headers once, when reporting begins.
 426 .RE
 427 
 428 .sp
 429 .ne 2
 430 .na
 431 \fB\fB-z\fR\fR
 432 .ad
 433 .RS 20n
 434 Suppress report lines that have zero values or no activity.
 435 .RE
 436 
 437 .SH OPERANDS
 438 .sp
 439 .LP
 440 The \fBdsstat\fR command line supports the following operands:
 441 .sp
 442 .ne 2
 443 .na
 444 \fB\fIinterval\fR\fR
 445 .ad
 446 .sp .6
 447 .RS 4n
 448 Specifies the \fIinterval\fR for each report, in seconds. If no \fIinterval\fR
 449 is specified, a single report with a one second \fIinterval\fR is output.
 450 .sp
 451 Due to the varying number of entries in a given set and the varying number of
 452 sets, header information might appear in the middle of a set being reported. To
 453 avoid this, use the \fB-f\fR or \fB-F\fR options to display the header
 454 information at the desired time.
 455 .RE
 456 
 457 .sp
 458 .ne 2
 459 .na
 460 \fB\fIcount\fR\fR
 461 .ad
 462 .sp .6
 463 .RS 4n
 464 Specifies the number of reports to generate. If no \fIcount\fR is specified,
 465 output continues until interrupted.
 466 .RE
 467 
 468 .SS "Field Descriptions"
 469 .sp
 470 .LP
 471 Unless otherwise specified, all fields are per-second averages based on the
 472 data collected during the specified \fIinterval\fR.
 473 .sp
 474 .ne 2
 475 .na
 476 \fB\fBname\fR\fR
 477 .ad
 478 .RS 13n
 479 Name of the entity being reported
 480 .RE
 481 
 482 .sp
 483 .ne 2
 484 .na
 485 \fB\fBt\fR\fR
 486 .ad
 487 .RS 13n
 488 Volume type
 489 .RE
 490 
 491 .sp
 492 .ne 2
 493 .na
 494 \fB\fBs\fR\fR
 495 .ad
 496 .RS 13n
 497 Volume status
 498 .RE
 499 
 500 .sp
 501 .ne 2
 502 .na
 503 \fB\fBr\fR\fR
 504 .ad
 505 .RS 13n
 506 Cache read behavior
 507 .RE
 508 
 509 .sp
 510 .ne 2
 511 .na
 512 \fB\fBw\fR\fR
 513 .ad
 514 .RS 13n
 515 Cache write behavior
 516 .RE
 517 
 518 .sp
 519 .ne 2
 520 .na
 521 \fB\fBpct\fR\fR
 522 .ad
 523 .RS 13n
 524 Percentage of volume requiring sync
 525 .RE
 526 
 527 .sp
 528 .ne 2
 529 .na
 530 \fB\fBrole\fR\fR
 531 .ad
 532 .RS 13n
 533 Role of the item being reported
 534 .RE
 535 
 536 .sp
 537 .ne 2
 538 .na
 539 \fB\fBtps\fR\fR
 540 .ad
 541 .RS 13n
 542 Total number of reads + writes
 543 .RE
 544 
 545 .sp
 546 .ne 2
 547 .na
 548 \fB\fBrtps\fR\fR
 549 .ad
 550 .RS 13n
 551 Number of reads
 552 .RE
 553 
 554 .sp
 555 .ne 2
 556 .na
 557 \fB\fBwtps\fR\fR
 558 .ad
 559 .RS 13n
 560 Number of writes
 561 .RE
 562 
 563 .sp
 564 .ne 2
 565 .na
 566 \fB\fBkps\fR\fR
 567 .ad
 568 .RS 13n
 569 Total kilobytes read + written
 570 .RE
 571 
 572 .sp
 573 .ne 2
 574 .na
 575 \fB\fBrkps\fR\fR
 576 .ad
 577 .RS 13n
 578 Kilobytes read
 579 .RE
 580 
 581 .sp
 582 .ne 2
 583 .na
 584 \fB\fBwkps\fR\fR
 585 .ad
 586 .RS 13n
 587 Kilobytes written
 588 .RE
 589 
 590 .sp
 591 .ne 2
 592 .na
 593 \fB\fBcrkps\fR\fR
 594 .ad
 595 .RS 13n
 596 Kilobytes read from cache
 597 .RE
 598 
 599 .sp
 600 .ne 2
 601 .na
 602 \fB\fBdrkps\fR\fR
 603 .ad
 604 .RS 13n
 605 Kilobytes read from disk
 606 .RE
 607 
 608 .sp
 609 .ne 2
 610 .na
 611 \fB\fBcwkps\fR\fR
 612 .ad
 613 .RS 13n
 614 Kilobytes written to cache
 615 .RE
 616 
 617 .sp
 618 .ne 2
 619 .na
 620 \fB\fBdwkps\fR\fR
 621 .ad
 622 .RS 13n
 623 Kilobytes written to disk
 624 .RE
 625 
 626 .sp
 627 .ne 2
 628 .na
 629 \fB\fBckps\fR\fR
 630 .ad
 631 .RS 13n
 632 Kilobytes transferred to or from cache
 633 .RE
 634 
 635 .sp
 636 .ne 2
 637 .na
 638 \fB\fBdkps\fR\fR
 639 .ad
 640 .RS 13n
 641 Kilobytes transferred to or from disk
 642 .RE
 643 
 644 .sp
 645 .ne 2
 646 .na
 647 \fB\fBsvt\fR\fR
 648 .ad
 649 .RS 13n
 650 Service time per operation
 651 .RE
 652 
 653 .sp
 654 .ne 2
 655 .na
 656 \fB\fBhit\fR\fR
 657 .ad
 658 .RS 13n
 659 Read hits during \fIinterval\fR
 660 .RE
 661 
 662 .sp
 663 .ne 2
 664 .na
 665 \fB\fBds/s\fR\fR
 666 .ad
 667 .RS 13n
 668 Kilobytes destaged from cache
 669 .RE
 670 
 671 .sp
 672 .ne 2
 673 .na
 674 \fB\fBcn/s\fR\fR
 675 .ad
 676 .RS 13n
 677 Number of write cancellations
 678 .RE
 679 
 680 .sp
 681 .ne 2
 682 .na
 683 \fB\fBq\fR\fR
 684 .ad
 685 .RS 13n
 686 Type of asynchronous queuing being used
 687 .RE
 688 
 689 .sp
 690 .ne 2
 691 .na
 692 \fB\fBqi\fR\fR
 693 .ad
 694 .RS 13n
 695 Number of items currently queued
 696 .RE
 697 
 698 .sp
 699 .ne 2
 700 .na
 701 \fB\fBqk\fR\fR
 702 .ad
 703 .RS 13n
 704 Kilobytes currently queued
 705 .RE
 706 
 707 .sp
 708 .ne 2
 709 .na
 710 \fB\fBqhwi\fR\fR
 711 .ad
 712 .RS 13n
 713 High water mark of queued items
 714 .RE
 715 
 716 .sp
 717 .ne 2
 718 .na
 719 \fB\fBqhwk\fR\fR
 720 .ad
 721 .RS 13n
 722 High water mark of queued kilobytes
 723 .RE
 724 
 725 .sp
 726 .LP
 727 The \fBname\fR field displays only the last 16 characters of the name.
 728 .sp
 729 .LP
 730 Valid cache behaviors for \fBcache\fR are:
 731 .sp
 732 .ne 2
 733 .na
 734 \fB\fBC\fR\fR
 735 .ad
 736 .RS 13n
 737 Cache reads/writes
 738 .RE
 739 
 740 .sp
 741 .ne 2
 742 .na
 743 \fB\fBD\fR\fR
 744 .ad
 745 .RS 13n
 746 Disk reads/writes
 747 .RE
 748 
 749 .sp
 750 .LP
 751 Valid volume types for \fBii\fR are:
 752 .sp
 753 .ne 2
 754 .na
 755 \fB\fBI\fR\fR
 756 .ad
 757 .RS 13n
 758 Independent shadow volume
 759 .RE
 760 
 761 .sp
 762 .ne 2
 763 .na
 764 \fB\fBD\fR\fR
 765 .ad
 766 .RS 13n
 767 Dependent shadow volume
 768 .RE
 769 
 770 .sp
 771 .LP
 772 Valid volume status for \fBii\fR is:
 773 .sp
 774 .ne 2
 775 .na
 776 \fB\fBC\fR\fR
 777 .ad
 778 .RS 13n
 779 Copy in progress
 780 .RE
 781 
 782 .sp
 783 .ne 2
 784 .na
 785 \fB\fB-\fR\fR
 786 .ad
 787 .RS 13n
 788 No copy in progress
 789 .RE
 790 
 791 .sp
 792 .LP
 793 Valid volume types for \fBsndr\fR are:
 794 .sp
 795 .ne 2
 796 .na
 797 \fB\fBP\fR\fR
 798 .ad
 799 .RS 13n
 800 This is the primary host of this volume set
 801 .RE
 802 
 803 .sp
 804 .ne 2
 805 .na
 806 \fB\fBS\fR\fR
 807 .ad
 808 .RS 13n
 809 This is the secondary host of this volume set
 810 .RE
 811 
 812 .sp
 813 .LP
 814 Valid volume status for \fBsndr\fR is:
 815 .sp
 816 .ne 2
 817 .na
 818 \fB\fBL\fR\fR
 819 .ad
 820 .RS 13n
 821 Changes to this volume are being logged
 822 .RE
 823 
 824 .sp
 825 .ne 2
 826 .na
 827 \fB\fBQ\fR\fR
 828 .ad
 829 .RS 13n
 830 Volume are in queuing mode
 831 .RE
 832 
 833 .sp
 834 .ne 2
 835 .na
 836 \fB\fBR\fR\fR
 837 .ad
 838 .RS 13n
 839 Replicating changes to secondary
 840 .RE
 841 
 842 .sp
 843 .ne 2
 844 .na
 845 \fB\fBSY\fR\fR
 846 .ad
 847 .RS 13n
 848 Synchronization in progress. Sending data.
 849 .RE
 850 
 851 .sp
 852 .ne 2
 853 .na
 854 \fB\fBRS\fR\fR
 855 .ad
 856 .RS 13n
 857 Reverse synchronization in progress. Receiving data.
 858 .RE
 859 
 860 .sp
 861 .ne 2
 862 .na
 863 \fB\fBSN\fR\fR
 864 .ad
 865 .RS 13n
 866 Synchronization needed
 867 .RE
 868 
 869 .sp
 870 .ne 2
 871 .na
 872 \fB\fBRN\fR\fR
 873 .ad
 874 .RS 13n
 875 Reverse synchronization needed
 876 .RE
 877 
 878 .sp
 879 .ne 2
 880 .na
 881 \fB\fBVF\fR\fR
 882 .ad
 883 .RS 13n
 884 Volume failed
 885 .RE
 886 
 887 .sp
 888 .ne 2
 889 .na
 890 \fB\fBBF\fR\fR
 891 .ad
 892 .RS 13n
 893 Bitmap failed
 894 .RE
 895 
 896 .sp
 897 .ne 2
 898 .na
 899 \fB\fBQF\fR\fR
 900 .ad
 901 .RS 13n
 902 Queue failed
 903 .RE
 904 
 905 .sp
 906 .LP
 907 Valid queue types for \fBsndr\fR are:
 908 .sp
 909 .ne 2
 910 .na
 911 \fB\fBD\fR\fR
 912 .ad
 913 .RS 13n
 914 Disk-based queuing enabled
 915 .RE
 916 
 917 .sp
 918 .ne 2
 919 .na
 920 \fB\fBM\fR\fR
 921 .ad
 922 .RS 13n
 923 Memory-based queuing enabled
 924 .RE
 925 
 926 .sp
 927 .LP
 928 Volume roles for \fBsndr\fR are:
 929 .sp
 930 .ne 2
 931 .na
 932 \fB\fBnet\fR\fR
 933 .ad
 934 .RS 13n
 935 Network volume statistics
 936 .RE
 937 
 938 .sp
 939 .ne 2
 940 .na
 941 \fB\fBbmp\fR\fR
 942 .ad
 943 .RS 13n
 944 Bitmap volume statistics
 945 .RE
 946 
 947 .sp
 948 .LP
 949 Volume roles for \fBii\fR are:
 950 .sp
 951 .ne 2
 952 .na
 953 \fB\fBmst\fR\fR
 954 .ad
 955 .RS 13n
 956 Master volume statistics
 957 .RE
 958 
 959 .sp
 960 .ne 2
 961 .na
 962 \fB\fBshd\fR\fR
 963 .ad
 964 .RS 13n
 965 Shadow volume statistics
 966 .RE
 967 
 968 .sp
 969 .ne 2
 970 .na
 971 \fB\fBbmp\fR\fR
 972 .ad
 973 .RS 13n
 974 Bitmap volume statistics
 975 .RE
 976 
 977 .sp
 978 .ne 2
 979 .na
 980 \fB\fBovr\fR\fR
 981 .ad
 982 .RS 13n
 983 Overflow volume statistics
 984 .RE
 985 
 986 .SH EXAMPLES
 987 .LP
 988 \fBExample 1 \fRReport Cache Statistics
 989 .sp
 990 .LP
 991 The following example shows the display of Report Cache statistics, with
 992 detailed breakdowns of read and writes to cache/disk. Reports are generated at
 993 five second intervals. Reporting is limited to the set
 994 \fB/dev/rdsk/c1t1d0s0\fR.
 995 
 996 .sp
 997 .in +2
 998 .nf
 999  # dsstat -m cache -d rw -s /dev/rdsk/c1t1d0s0 5
1000 - read -             - write -
1001 name                ckps   dkps    hit   ckps   dkps    hit
1002 dev/rdsk/c1t1d0s0      0      0   0.00      0      0   0.00
1003 dev/rdsk/c1t1d0s0      3   2396   0.13    983    763 100.00
1004 dev/rdsk/c1t1d0s0   2399    799  75.00   2815   2686 100.00
1005 dev/rdsk/c1t1d0s0   3200    800  80.00   2755   2908 100.00
1006 dev/rdsk/c1t1d0s0   3999    799  83.33   2809   2868 100.00
1007 dev/rdsk/c1t1d0s0   4800    800  85.71   2867   2931 100.00
1008 .fi
1009 .in -2
1010 
1011 .LP
1012 \fBExample 2 \fRReport Master, Shadow and Bitmap Statistics
1013 .sp
1014 .LP
1015 Report master, shadow and bitmap statistics for Point-in-Time Copy, using
1016 default output. Generate reports at two second intervals.
1017 
1018 .sp
1019 .in +2
1020 .nf
1021 # dsstat -m ii -r msb 2
1022 name               t  s    pct role    kps   tps  svt
1023 dev/rdsk/c0t1d0s5  I  C  96.15  mst  19921    38   22
1024 dev/rdsk/c0t1d0s6               shd   9960    19   20
1025 dev/rdsk/c0t1d0s7               bmp     39    77    2
1026 dev/rdsk/c0t1d0s5  I  C  94.24  mst  19623    38   22
1027 dev/rdsk/c0t1d0s6               shd   9939    19   20
1028 dev/rdsk/c0t1d0s7               bmp     39    77    2
1029 dev/rdsk/c0t1d0s5  I  C  92.34  mst  19969    39   22
1030 dev/rdsk/c0t1d0s6               shd   9984    19   20
1031 dev/rdsk/c0t1d0s7               bmp     39    78    2
1032 .fi
1033 .in -2
1034 
1035 .LP
1036 \fBExample 3 \fRReport Network Statistics for Remote Mirror
1037 .sp
1038 .LP
1039 Report network statistics for Remote Mirror, using detailed read, write
1040 statistics. Report includes volume type/status flags and percentages. Generate
1041 reports at two second intervals. Limit reporting to the set
1042 \fB/dev/rdsk/c0t1d0s0\fR.
1043 
1044 .sp
1045 .in +2
1046 .nf
1047 # dsstat -m sndr -r n -d rwpf -s /dev/rdsk/c0t1d0s0 2
1048 name               t  s    pct role   rkps  rtps   wkps  wtps
1049 dev/rdsk/c0t1d0s0  P  L 100.00  sec      0     0      0     0
1050 dev/rdsk/c0t1d0s0  P SY  99.90  sec      0     0    288     9
1051 dev/rdsk/c0t1d0s0  P SY  97.90  sec      0     0   5296   165
1052 dev/rdsk/c0t1d0s0  P SY  95.81  sec      0     0   5184   161
1053 dev/rdsk/c0t1d0s0  P SY  93.81  sec      0     0   5280   164
1054 dev/rdsk/c0t1d0s0  P SY  91.71  sec      0     0   5198   162
1055 .fi
1056 .in -2
1057 
1058 .SH EXIT STATUS
1059 .sp
1060 .LP
1061 The following exit values are returned:
1062 .sp
1063 .ne 2
1064 .na
1065 \fB\fB0\fR\fR
1066 .ad
1067 .RS 13n
1068 Successful completion.
1069 .RE
1070 
1071 .sp
1072 .ne 2
1073 .na
1074 \fB\fB1\fR\fR
1075 .ad
1076 .RS 13n
1077 Successful completion, no statistics to report.
1078 .RE
1079 
1080 .sp
1081 .ne 2
1082 .na
1083 \fB\fB2\fR\fR
1084 .ad
1085 .RS 13n
1086 An invalid argument has been encountered.
1087 .RE
1088 
1089 .sp
1090 .ne 2
1091 .na
1092 \fB\fB3\fR\fR
1093 .ad
1094 .RS 13n
1095 No memory is available to create \fBkstat\fR statistics.
1096 .RE
1097 
1098 .sp
1099 .ne 2
1100 .na
1101 \fB\fB4\fR\fR
1102 .ad
1103 .RS 13n
1104 An unknown error has occurred.
1105 .RE
1106 
1107 .SH ATTRIBUTES
1108 .sp
1109 .LP
1110 See \fBattributes\fR(5) for descriptions of the following attributes:
1111 .sp
1112 
1113 .sp
1114 .TS
1115 box;
1116 c | c
1117 l | l .
1118 ATTRIBUTE TYPE  ATTRIBUTE VALUE
1119 _
1120 Interface Stability     Evolving
1121 .TE
1122 
1123 .SH SEE ALSO
1124 .sp
1125 .LP
1126 \fBdscfg\fR(1M), \fBsvadm\fR(1M), \fBds.log\fR(4), \fBrdc.cf\fR(4),
1127 \fBattributes\fR(5)