man pages section 8: System Administration Commands

shadowadm (8)

Name

shadowadm - Control shadow migrations

Synopsis

/usr/sbin/shadowadm list [[-p] -o field[,...]]

/usr/sbin/shadowadm stop /path

/usr/sbin/shadowadm start /path

/usr/sbin/shadowadm cancel /path

Description

The shadowadm command allows an administrator to control background migrations being performed by shadowd. Shadow migration moves data by foreground migration and background migration. Foreground migration occurs when applications and users directly access the migration target. Background migration is done by shadowd accessing the migration target.

Sub Commands

The shadowadm command has the following subcommands:

list

Provides a list of in-progress or stopped migrations.

–o field[,...]

A case-insensitive, comma-separated list of output fields to display. The field name must be one of the fields listed below, or a special value all, to display all fields. For each migration target, the following fields can be displayed:

path

The path where the migration target is mounted.

name

The dataset name of the migration target.

state

The status of the target migration.

–p

Display using a stable machine-parseable format.

stop

Stops background migration for the mount-path.

start

Resumes stopped background migration for the mount-path.

cancel

Cancels both foreground and background migration for the mount-path. Migration cannot be resumed.

A user must have the solaris.admin.shadow-migration.modify 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), shadowstat(8), zfs(8)