Copyright (c) 2007, Sun Microsystems, Inc. All Rights Reserved
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.
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.
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]
ndmpstat [tapes] [interval [count]]
The ndmpstat utility reports Network Data Management Protocol (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 devices, 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.
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 waiting for resources such as I/O and paging
b
the number of backup operations currently running
r
the number of restore operations currently running
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 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.
The following operands are supported:
count
Specifies the number of times that the statistics 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.
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%
See attributes(5) for descriptions of the following attributes:
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
| Interface Stability | See below |
Invocation is evolving. Human readable output is unstable.
iostat(1M), mpstat(1M), ndmpd(1M), ndmpadm(1M), attributes(5)
Performance numbers are not accurate and are rounded up at the MB/sec. boundary.