mirror of
https://git.proxmox.com/git/mirror_zfs.git
synced 2026-05-28 17:39:23 +03:00
Lint most manpages
Reviewed-by: Richard Laager <rlaager@wiktel.com> Reviewed-by: Brian Behlendorf <behlendorf1@llnl.gov> Reviewed-by: Tony Nguyen <tony.nguyen@delphix.com> Reviewed-by: Ryan Moeller <ryan@iXsystems.com> Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz> Closes #12129
This commit is contained in:
наб
+68
-47
@@ -18,7 +18,6 @@
|
||||
.\"
|
||||
.\" CDDL HEADER END
|
||||
.\"
|
||||
.\"
|
||||
.\" Copyright (c) 2007, Sun Microsystems, Inc. All Rights Reserved.
|
||||
.\" Copyright (c) 2012, 2018 by Delphix. All rights reserved.
|
||||
.\" Copyright (c) 2012 Cyril Plisko. All Rights Reserved.
|
||||
@@ -30,50 +29,53 @@
|
||||
.Dd August 9, 2019
|
||||
.Dt ZPOOL-IMPORT 8
|
||||
.Os
|
||||
.
|
||||
.Sh NAME
|
||||
.Nm zpool-import
|
||||
.Nd Lists ZFS storage pools available to import or import the specified pools
|
||||
.Nd import ZFS storage pools or list available pools
|
||||
.Sh SYNOPSIS
|
||||
.Nm zpool
|
||||
.Cm import
|
||||
.Op Fl D
|
||||
.Op Fl d Ar dir Ns | Ns device
|
||||
.Oo Fl d Ar dir Ns | Ns Ar device Oc Ns …
|
||||
.Nm zpool
|
||||
.Cm import
|
||||
.Fl a
|
||||
.Op Fl DflmN
|
||||
.Op Fl F Oo Fl n Oc Oo Fl T Oc Oo Fl X Oc
|
||||
.Op Fl F Op Fl nTX
|
||||
.Op Fl -rewind-to-checkpoint
|
||||
.Op Fl c Ar cachefile Ns | Ns Fl d Ar dir Ns | Ns device
|
||||
.Op Fl c Ar cachefile Ns | Ns Fl d Ar dir Ns | Ns Ar device
|
||||
.Op Fl o Ar mntopts
|
||||
.Oo Fl o Ar property Ns = Ns Ar value Oc Ns ...
|
||||
.Oo Fl o Ar property Ns = Ns Ar value Oc Ns …
|
||||
.Op Fl R Ar root
|
||||
.Nm zpool
|
||||
.Cm import
|
||||
.Op Fl Dflm
|
||||
.Op Fl F Oo Fl n Oc Oo Fl T Oc Oo Fl X Oc
|
||||
.Op Fl Dflmt
|
||||
.Op Fl F Op Fl nTX
|
||||
.Op Fl -rewind-to-checkpoint
|
||||
.Op Fl c Ar cachefile Ns | Ns Fl d Ar dir Ns | Ns device
|
||||
.Op Fl c Ar cachefile Ns | Ns Fl d Ar dir Ns | Ns Ar device
|
||||
.Op Fl o Ar mntopts
|
||||
.Oo Fl o Ar property Ns = Ns Ar value Oc Ns ...
|
||||
.Oo Fl o Ar property Ns = Ns Ar value Oc Ns …
|
||||
.Op Fl R Ar root
|
||||
.Op Fl s
|
||||
.Ar pool Ns | Ns Ar id
|
||||
.Op Ar newpool Oo Fl t Oc
|
||||
.Op Ar newpool
|
||||
.
|
||||
.Sh DESCRIPTION
|
||||
.Bl -tag -width Ds
|
||||
.It Xo
|
||||
.Nm zpool
|
||||
.Cm import
|
||||
.Op Fl D
|
||||
.Op Fl d Ar dir Ns | Ns device
|
||||
.Oo Fl d Ar dir Ns | Ns Ar device Oc Ns …
|
||||
.Xc
|
||||
Lists pools available to import.
|
||||
If the
|
||||
.Fl d or
|
||||
.Fl c
|
||||
options are not specified, this command searches for devices using libblkid
|
||||
on Linux and geom on FreeBSD.
|
||||
on Linux and geom on
|
||||
.Fx .
|
||||
The
|
||||
.Fl d
|
||||
option can be specified multiple times, and all directories are searched.
|
||||
@@ -114,10 +116,10 @@ Lists destroyed pools only.
|
||||
.Cm import
|
||||
.Fl a
|
||||
.Op Fl DflmN
|
||||
.Op Fl F Oo Fl n Oc Oo Fl T Oc Oo Fl X Oc
|
||||
.Op Fl c Ar cachefile Ns | Ns Fl d Ar dir Ns | Ns device
|
||||
.Op Fl F Op Fl nTX
|
||||
.Op Fl c Ar cachefile Ns | Ns Fl d Ar dir Ns | Ns Ar device
|
||||
.Op Fl o Ar mntopts
|
||||
.Oo Fl o Ar property Ns = Ns Ar value Oc Ns ...
|
||||
.Oo Fl o Ar property Ns = Ns Ar value Oc Ns …
|
||||
.Op Fl R Ar root
|
||||
.Op Fl s
|
||||
.Xc
|
||||
@@ -168,12 +170,13 @@ If successful, the data from the discarded transactions is irretrievably lost.
|
||||
This option is ignored if the pool is importable or already imported.
|
||||
.It Fl l
|
||||
Indicates that this command will request encryption keys for all encrypted
|
||||
datasets it attempts to mount as it is bringing the pool online. Note that if
|
||||
any datasets have a
|
||||
datasets it attempts to mount as it is bringing the pool online.
|
||||
Note that if any datasets have a
|
||||
.Sy keylocation
|
||||
of
|
||||
.Sy prompt
|
||||
this command will block waiting for the keys to be entered. Without this flag
|
||||
this command will block waiting for the keys to be entered.
|
||||
Without this flag
|
||||
encrypted datasets will be left unavailable until the keys are loaded.
|
||||
.It Fl m
|
||||
Allows a pool to import when there is a missing log device.
|
||||
@@ -221,36 +224,42 @@ administrator can see how the pool would look like if they were
|
||||
to fully rewind.
|
||||
.It Fl s
|
||||
Scan using the default search path, the libblkid cache will not be
|
||||
consulted. A custom search path may be specified by setting the
|
||||
ZPOOL_IMPORT_PATH environment variable.
|
||||
consulted.
|
||||
A custom search path may be specified by setting the
|
||||
.Sy ZPOOL_IMPORT_PATH
|
||||
environment variable.
|
||||
.It Fl X
|
||||
Used with the
|
||||
.Fl F
|
||||
recovery option. Determines whether extreme
|
||||
measures to find a valid txg should take place. This allows the pool to
|
||||
recovery option.
|
||||
Determines whether extreme measures to find a valid txg should take place.
|
||||
This allows the pool to
|
||||
be rolled back to a txg which is no longer guaranteed to be consistent.
|
||||
Pools imported at an inconsistent txg may contain uncorrectable
|
||||
checksum errors. For more details about pool recovery mode, see the
|
||||
Pools imported at an inconsistent txg may contain uncorrectable checksum errors.
|
||||
For more details about pool recovery mode, see the
|
||||
.Fl F
|
||||
option, above. WARNING: This option can be extremely hazardous to the
|
||||
option, above.
|
||||
WARNING: This option can be extremely hazardous to the
|
||||
health of your pool and should only be used as a last resort.
|
||||
.It Fl T
|
||||
Specify the txg to use for rollback. Implies
|
||||
Specify the txg to use for rollback.
|
||||
Implies
|
||||
.Fl FX .
|
||||
For more details
|
||||
about pool recovery mode, see the
|
||||
.Fl X
|
||||
option, above. WARNING: This option can be extremely hazardous to the
|
||||
option, above.
|
||||
WARNING: This option can be extremely hazardous to the
|
||||
health of your pool and should only be used as a last resort.
|
||||
.El
|
||||
.It Xo
|
||||
.Nm zpool
|
||||
.Cm import
|
||||
.Op Fl Dflm
|
||||
.Op Fl F Oo Fl n Oc Oo Fl t Oc Oo Fl T Oc Oo Fl X Oc
|
||||
.Op Fl c Ar cachefile Ns | Ns Fl d Ar dir Ns | Ns device
|
||||
.Op Fl Dflmt
|
||||
.Op Fl F Op Fl nTX
|
||||
.Op Fl c Ar cachefile Ns | Ns Fl d Ar dir Ns | Ns Ar device
|
||||
.Op Fl o Ar mntopts
|
||||
.Oo Fl o Ar property Ns = Ns Ar value Oc Ns ...
|
||||
.Oo Fl o Ar property Ns = Ns Ar value Oc Ns …
|
||||
.Op Fl R Ar root
|
||||
.Op Fl s
|
||||
.Ar pool Ns | Ns Ar id
|
||||
@@ -309,12 +318,13 @@ If successful, the data from the discarded transactions is irretrievably lost.
|
||||
This option is ignored if the pool is importable or already imported.
|
||||
.It Fl l
|
||||
Indicates that this command will request encryption keys for all encrypted
|
||||
datasets it attempts to mount as it is bringing the pool online. Note that if
|
||||
any datasets have a
|
||||
datasets it attempts to mount as it is bringing the pool online.
|
||||
Note that if any datasets have a
|
||||
.Sy keylocation
|
||||
of
|
||||
.Sy prompt
|
||||
this command will block waiting for the keys to be entered. Without this flag
|
||||
this command will block waiting for the keys to be entered.
|
||||
Without this flag
|
||||
encrypted datasets will be left unavailable until the keys are loaded.
|
||||
.It Fl m
|
||||
Allows a pool to import when there is a missing log device.
|
||||
@@ -350,38 +360,49 @@ property to
|
||||
.Ar root .
|
||||
.It Fl s
|
||||
Scan using the default search path, the libblkid cache will not be
|
||||
consulted. A custom search path may be specified by setting the
|
||||
ZPOOL_IMPORT_PATH environment variable.
|
||||
consulted.
|
||||
A custom search path may be specified by setting the
|
||||
.Sy ZPOOL_IMPORT_PATH
|
||||
environment variable.
|
||||
.It Fl X
|
||||
Used with the
|
||||
.Fl F
|
||||
recovery option. Determines whether extreme
|
||||
measures to find a valid txg should take place. This allows the pool to
|
||||
recovery option.
|
||||
Determines whether extreme measures to find a valid txg should take place.
|
||||
This allows the pool to
|
||||
be rolled back to a txg which is no longer guaranteed to be consistent.
|
||||
Pools imported at an inconsistent txg may contain uncorrectable
|
||||
checksum errors. For more details about pool recovery mode, see the
|
||||
checksum errors.
|
||||
For more details about pool recovery mode, see the
|
||||
.Fl F
|
||||
option, above. WARNING: This option can be extremely hazardous to the
|
||||
option, above.
|
||||
WARNING: This option can be extremely hazardous to the
|
||||
health of your pool and should only be used as a last resort.
|
||||
.It Fl T
|
||||
Specify the txg to use for rollback. Implies
|
||||
Specify the txg to use for rollback.
|
||||
Implies
|
||||
.Fl FX .
|
||||
For more details
|
||||
about pool recovery mode, see the
|
||||
.Fl X
|
||||
option, above. WARNING: This option can be extremely hazardous to the
|
||||
option, above.
|
||||
WARNING: This option can be extremely hazardous to the
|
||||
health of your pool and should only be used as a last resort.
|
||||
.It Fl t
|
||||
Used with
|
||||
.Sy newpool .
|
||||
Specifies that
|
||||
.Sy 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 -o cachefile=none when not explicitly specified.
|
||||
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
|
||||
.Fl o Sy cachefile Ns = Ns Sy none
|
||||
when not explicitly specified.
|
||||
.El
|
||||
.El
|
||||
.
|
||||
.Sh SEE ALSO
|
||||
.Xr zpool-export 8 ,
|
||||
.Xr zpool-list 8 ,
|
||||
|
||||
Reference in New Issue
Block a user