Go to main content

man pages section 8: System Administration Commands

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

shadowstat(8)

Name

shadowstat - report shadow migration statistics

Synopsis

/usr/sbin/shadowstat [count]
/usr/sbin/shadowstat -D /path [count]
/usr/sbin/shadowstat -E
/usr/sbin/shadowstat -e /path

Description

The shadowstat utility reports statistics or error information for in-progress shadow migrations. By default, with no arguments, a line of statistics output is presented for each migrating file system; the output looks similar to the following:

                        EST
                BYTES   BYTES           ELAPSED
DATASET         XFRD    LEFT    ERRORS  TIME
pool/newfs      2.10M   28.8G   -       00:02:45

Each line identifies bytes transferred thus far, a rough estimate of bytes left to transfer, number of migration errors, and the time elapsed since the migration was started.

The –D option may be used to specify the mount path for a particular dataset of interest, data for any other migrations in progress will not be listed.

If count is unspecified, updated values are presented every few seconds until the program is terminated. If count is specified, updates only occur count times, after which the program exits.

The –E option can be used to obtain a list of files that have errors preventing their migration. There will be a list for each in-progress migration.

The –e option can be used to obtain a list of files that have errors preventing their migration for the specified file system.

A user must have the solaris.admin.shadow-migration.read authorization to use this command.

Attributes

See attributes(7) for descriptions of the following attributes:

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Availability
system/file-system/shadow-migration
Interface Stability
Committed

See Also

attributes(7), shadowd(8), zfs(8)