zfsa-pool-import(1)

NAME

zfsa-pool-import - Import a pool found on the connected disks, or list the pools that can be imported

SYNOPSIS

zfsa pool import [GLOBAL OPTIONS] [--name] [--readonly] [--altroot] [--no-mount] [--force] [--load-keys] [--passphrase-file] [--passphrase-fd] [-h|--help] [POOL]

DESCRIPTION

Import a pool found on the connected disks, or list the pools that can be imported.

Don't use --force to get past an unexplained warning that the pool is in use: importing a pool that another system is using can destroy it. Use --altroot and --no-mount when repairing a system from live media, so the pool's mountpoints can't cover the running one.

OPTIONS

--name <NEW>

Import it under this name

--readonly

Import it read only

--altroot <DIR>

Mount everything below this directory

--no-mount

Mount nothing

--force

Import even if the pool looks in use by another system

--load-keys

Unlock the encrypted datasets with a passphrase

--passphrase-file <FILE>

Read the passphrase from the first line of this file

--passphrase-fd <N>

Read the passphrase from this open descriptor (3<file, <(...))

-h, --help

Print help (see a summary with '-h')

[POOL]

The pool's name or id. Leave out to list pools that can be imported

EXAMPLES

List the pools that can be imported:

zfsa pool import

Import tank under the name archive, read only:

zfsa pool import tank --name archive --readonly

From live media, import the system pool below /mnt without mounting it:

zfsa --local pool import rpool --altroot /mnt --no-mount

SEE ALSO

zfsa(1) for the global options, authorization, confirmations and exit status, zfsa-pool(1).