zfsa-dataset-create(1)

NAME

zfsa-dataset-create - Create a dataset or volume

SYNOPSIS

zfsa dataset create [GLOBAL OPTIONS] [--purpose] [--volume] [--encrypt] [--quota] [--policy] [-o|--option] [--passphrase-file] [--passphrase-fd] [-h|--help] <NAME>

DESCRIPTION

Create a dataset or volume.

The parent dataset must exist. With --encrypt the dataset becomes its own encryption root; the passphrase is asked for twice on a terminal, or read with --passphrase-file or --passphrase-fd, never from an argument.

OPTIONS

--purpose <PURPOSE>

What it is for. Sets starting properties (-o still wins)

Possible values:

• general: Everything inherited

• media: recordsize=1M

• database: recordsize=16K

• vm-files: Virtual machine disk images as files: recordsize=64K

• backups: Received backups: canmount=noauto, readonly=on

--volume <SIZE>

Make a volume of this size instead of a filesystem

--encrypt

Encrypt with a passphrase

--quota <SIZE>

Limit the space it and its snapshots can use

--policy <NAME>

Add it to a snapshot policy

-o, --option <PROPERTY=VALUE>

Set a property as property=value. Repeat for more

--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')

<NAME>

The new dataset's full name, such as tank/photos

EXAMPLES

A filesystem for photos, with a quota and in the policy photos:

zfsa dataset create tank/photos --purpose media --quota 500G --policy photos

An encrypted filesystem that asks for its passphrase:

zfsa dataset create tank/private --encrypt

A 20 GiB volume for a virtual machine:

zfsa dataset create tank/vm/disk0 --volume 20G

SEE ALSO

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