Differential D14972 Diff 41396 head/cddl/contrib/opensolaris/cmd/zpool/zpool.8

Changeset View

Standalone View

head/cddl/contrib/opensolaris/cmd/zpool/zpool.8

	Show First 20 Lines • Show All 56 Lines • ▼ Show 20 Lines
	.Cm create			.Cm create
	.Op Fl fnd			.Op Fl fnd
	.Op Fl o Ar property Ns = Ns Ar value			.Op Fl o Ar property Ns = Ns Ar value
	.Ar ...			.Ar ...
	.Op Fl O Ar file-system-property Ns = Ns Ar value			.Op Fl O Ar file-system-property Ns = Ns Ar value
	.Ar ...			.Ar ...
	.Op Fl m Ar mountpoint			.Op Fl m Ar mountpoint
	.Op Fl R Ar root			.Op Fl R Ar root
				.Op Fl t Ar tempname
	.Ar pool vdev ...			.Ar pool vdev ...
	.Nm			.Nm
	.Cm destroy			.Cm destroy
	.Op Fl f			.Op Fl f
	.Ar pool			.Ar pool
	.Nm			.Nm
	.Cm detach			.Cm detach
	.Ar pool device			.Ar pool device
	Show All 37 Lines
	.Ar ...			.Ar ...
	.Op Fl -rewind-to-checkpoint			.Op Fl -rewind-to-checkpoint
	.Op Fl d Ar dir \| Fl c Ar cachefile			.Op Fl d Ar dir \| Fl c Ar cachefile
	.Op Fl D			.Op Fl D
	.Op Fl f			.Op Fl f
	.Op Fl m			.Op Fl m
	.Op Fl N			.Op Fl N
	.Op Fl R Ar root			.Op Fl R Ar root
				.Op Fl t
	.Op Fl F Op Fl n			.Op Fl F Op Fl n
	.Ar pool \| id			.Ar pool \| id
	.Op Ar newpool			.Op Ar newpool
	.Nm			.Nm
	.Cm iostat			.Cm iostat
	.Op Fl T Cm d Ns \| Ns Cm u			.Op Fl T Cm d Ns \| Ns Cm u
	.Op Fl v			.Op Fl v
	.Op Ar pool			.Op Ar pool
	▲ Show 20 Lines • Show All 830 Lines • ▼ Show 20 Lines
	.Cm create			.Cm create
	.Op Fl fnd			.Op Fl fnd
	.Op Fl o Ar property Ns = Ns Ar value			.Op Fl o Ar property Ns = Ns Ar value
	.Ar ...			.Ar ...
	.Op Fl O Ar file-system-property Ns = Ns Ar value			.Op Fl O Ar file-system-property Ns = Ns Ar value
	.Ar ...			.Ar ...
	.Op Fl m Ar mountpoint			.Op Fl m Ar mountpoint
	.Op Fl R Ar root			.Op Fl R Ar root
				.Op Fl t Ar tempname
	.Ar pool vdev ...			.Ar pool vdev ...
	.Xc			.Xc
	.Pp			.Pp
	Creates a new storage pool containing the virtual devices specified on the			Creates a new storage pool containing the virtual devices specified on the
	command line. The pool name must begin with a letter, and can only contain			command line. The pool name must begin with a letter, and can only contain
	alphanumeric characters as well as underscore ("_"), dash ("-"), and period			alphanumeric characters as well as underscore ("_"), dash ("-"), and period
	("."). The pool names "mirror", "raidz", "spare" and "log" are reserved, as are			("."). The pool names "mirror", "raidz", "spare" and "log" are reserved, as are
	names beginning with the pattern "c[0-9]". The			names beginning with the pattern "c[0-9]". The
	▲ Show 20 Lines • Show All 85 Lines • ▼ Show 20 Lines
	if			if
	.Sy altroot			.Sy altroot
	is specified. The mount point must be an absolute path,			is specified. The mount point must be an absolute path,
	.Qq Cm legacy ,			.Qq Cm legacy ,
	or			or
	.Qq Cm none .			.Qq Cm none .
	For more information on dataset mount points, see			For more information on dataset mount points, see
	.Xr zfs 8 .			.Xr zfs 8 .
				.It Fl t Ar tempname
				Sets the in-core pool name to
				.Pa tempname
				while the on-disk name will be the name specified as the pool name
				.Pa pool .
				This will set the default
				.Sy cachefile
				property to
				.Sy none .
				This is intended to handle name space collisions when creating pools
				for other systems, such as virtual machines or physical machines
				whose pools live on network block devices.
	.El			.El
	.It Xo			.It Xo
	.Nm			.Nm
	.Cm destroy			.Cm destroy
	.Op Fl f			.Op Fl f
	.Ar pool			.Ar pool
	.Xc			.Xc
	.Pp			.Pp
	▲ Show 20 Lines • Show All 238 Lines • ▼ Show 20 Lines
	.Op Fl o Ar property Ns = Ns Ar value			.Op Fl o Ar property Ns = Ns Ar value
	.Ar ...			.Ar ...
	.Op Fl d Ar dir \| Fl c Ar cachefile			.Op Fl d Ar dir \| Fl c Ar cachefile
	.Op Fl D			.Op Fl D
	.Op Fl f			.Op Fl f
	.Op Fl m			.Op Fl m
	.Op Fl N			.Op Fl N
	.Op Fl R Ar root			.Op Fl R Ar root
				.Op Fl t
	.Op Fl F Op Fl n			.Op Fl F Op Fl n
	.Ar pool \| id			.Ar pool \| id
	.Op Ar newpool			.Op Ar newpool
	.Xc			.Xc
	.Pp			.Pp
	Imports a specific pool. A pool can be identified by its name or the numeric			Imports a specific pool. A pool can be identified by its name or the numeric
	identifier. If			identifier. If
	.Ar newpool			.Ar newpool
	▲ Show 20 Lines • Show All 43 Lines • ▼ Show 20 Lines
	.It Fl m			.It Fl m
	Allows a pool to import when there is a missing log device. Recent transactions			Allows a pool to import when there is a missing log device. Recent transactions
	can be lost because the log device will be discarded.			can be lost because the log device will be discarded.
	.It Fl N			.It Fl N
	Import the pool without mounting any file systems.			Import the pool without mounting any file systems.
	.It Fl R Ar root			.It Fl R Ar root
	Equivalent to			Equivalent to
	.Qq Fl o Cm cachefile=none,altroot= Ns Pa root			.Qq Fl o Cm cachefile=none,altroot= Ns Pa root
				.It Fl t
				Used with
				.Ar newpool .
				Specifies that
				.Ar newpool
				is temporary.
				Temporary pool names last until export.
				Ensures that the original pool name will be used in all label updates and
				therefore is retained upon export.
				Will also set
				.Sy cachefile
				property to
				.Sy none
				when not explicitly specified.
	.It Fl F			.It Fl F
	Recovery mode for a non-importable pool. Attempt to return the pool to an			Recovery mode for a non-importable pool. Attempt to return the pool to an
	importable state by discarding the last few transactions. Not all damaged pools			importable state by discarding the last few transactions. Not all damaged pools
	can be recovered by using this option. If successful, the data from the			can be recovered by using this option. If successful, the data from the
	discarded transactions is irretrievably lost. This option is ignored if the			discarded transactions is irretrievably lost. This option is ignored if the
	pool is importable or already imported.			pool is importable or already imported.
	.It Fl n			.It Fl n
	Used with the			Used with the
	▲ Show 20 Lines • Show All 772 Lines • Show Last 20 Lines