Manual Pages for UNIX Operating System command usage for man ndmpstat

System Administration Commands                       ndmpstat(1M)



NAME
     ndmpstat - show NDMP backup progress statistics

SYNOPSIS
     ndmpstat  [tapes] [interval [count]]


DESCRIPTION
     The ndmpstat utility reports Network Data Management  Proto-
     col (NDMP) statistics, among which are  NDMP worker threads,
     disk IO, tape IO, files operation, performance,  and  backup
     activity.


     ndmpstat reports the aggregate statistics for all tapes  and
     disks.  In order to obtain statistics for specific tape dev-
     ices, the tape device name should be passed as  argument  to
     the utility.


     When invoked, ndmpstat begins its display  with  a  one-line
     summary  of  the NDMP daemon activity since the NDMP service
     was invoked.

  Display Fields
     The fields in ndmpstat output are described as follows:

     wthr

         Report the number of worker threads  in  each   of   the
         four following states:

         r

             the number of worker threads running


         w

             the number of blocked worker threads that are  wait-
             ing for resources such as I/O and paging


         b

             the number of backup operations currently running


         r

             the number of restore operations currently running




SunOS 5.11          Last change: 21 Jun 2007                    1






System Administration Commands                       ndmpstat(1M)



     file

         Report on usage of filesystem.

         rd

             the number of files being read


         wr

             the number of files being written



     disk

         Report the number of disk operations per interval.

         rd

             the number of disk blocks being read


         wr

             the number of disk blocks being written



     tape

         Report the number of tape operations per interval. There
         are  slots  for  up to four tapes, labeled with a single
         number. The number indicates  the  name  of  the  device
         under /dev/rmt.

         rd

             the number of tape blocks being read


         wr

             the number of tape blocks being written



     bytes

         Report the number of  bytes  transferred.  This  is  the
         aggregate  value  of  both  tape  and  disk devices. The



SunOS 5.11          Last change: 21 Jun 2007                    2






System Administration Commands                       ndmpstat(1M)



         number is in kilobytes.

         rd

             the number of kilobytes being read


         wr

             the number of kilobytes being written



     perf

         Displays  a  rough  estimate  of  performance   of   the
         backup/restore operation in megabytes per second.

         bk

             backup performance


         rs

             restore performance



     prcnt

         Display the comparative usage of resources, in percent.

         dsk

             disk I/O time


         tpe

             tape I/O time


         otr

             other time (memory or idle)




     See EXAMPLES.




SunOS 5.11          Last change: 21 Jun 2007                    3






System Administration Commands                       ndmpstat(1M)



OPERANDS
     The following operands are supported:

     count       Specifies the number of times that  the  statis-
                 tics display is repeated.


     tape        Specifies which tapes are to be  given  priority
                 in  the  output.  A command line is limited to a
                 maximum of four tape devices. A common tape name
                 is /dev/rmt/n, where n is an integer.


     interval    Specifies  the  number  of  seconds  over  which
                 ndmpstat   summarizes  activity.  The  specified
                 interval remains in effect till the  command  is
                 terminated.


EXAMPLES
     Example 1 Using ndmpstat


     The following command displays  a  summary  of  NDMP  daemon
     activity at five-second intervals.


       example% ndmpstat 5
       wthr     file      disk      tape        bytes      perf       prcnt
       r w b r rd  wr    rd  wr   rd    wr     rd    wr   bk  rs  dsk  tpe  otr
       1 0 3 6 50   9   1250  0  32544 4455   42335 3234   5  4   20   40   40
       1 0 0 1  1   0    128  0    0   128     64    64    1  0    0   80   20
       1 0 0 1  2   0    128  0    0     0     64     0    1  0   80    0   20
       1 0 0 1  1   0    128  0    0     0     64     0    1  0   80    0   20
       1 0 0 1  3   0    128  0    0     0     64     0    0  0   80    0   20
       1 0 0 1  1   0    128  0    0   128     64    64    1  0    0   80   20
       ^C
       example%



ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:











SunOS 5.11          Last change: 21 Jun 2007                    4






System Administration Commands                       ndmpstat(1M)



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | service/storage/ndmp        |
    |_____________________________|_____________________________|
    | Interface Stability         | See below                   |
    |_____________________________|_____________________________|



     Invocation is evolving. Human readable output is unstable.

SEE ALSO
     iostat(1M),  mpstat(1M),  ndmpd(1M),   ndmpadm(1M),   attri-
     butes(5)

NOTES
     Performance numbers are not accurate and are rounded  up  at
     the MB/sec. boundary.




































SunOS 5.11          Last change: 21 Jun 2007                    5