sysadmin zfs: document pool naming rules

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
This commit is contained in:
Thomas Lamprecht 2022-11-19 16:10:22 +01:00
parent 7a051d10c9
commit 25b89d16e1

View File

@ -311,14 +311,23 @@ manual pages, which can be read with:
Create a new zpool
^^^^^^^^^^^^^^^^^^
To create a new pool, at least one disk is needed. The `ashift` should
have the same sector-size (2 power of `ashift`) or larger as the
underlying disk.
To create a new pool, at least one disk is needed. The `ashift` should have the
same sector-size (2 power of `ashift`) or larger as the underlying disk.
----
# zpool create -f -o ashift=12 <pool> <device>
----
[TIP]
====
Pool names must adhere to the following rules:
* begin with a letter (a-z or A-Z)
* contain only alphanumeric, `-`, `_`, `.`, `:` or ` ` (space) characters
* must *not begin* with one of `mirror`, `raidz`, `draid` or `spare`
* must not be `log`
====
To activate compression (see section <<zfs_compression,Compression in ZFS>>):
----