From 25b89d16e166f1afbc544ec0c464c07ff8b2e4e5 Mon Sep 17 00:00:00 2001 From: Thomas Lamprecht Date: Sat, 19 Nov 2022 16:10:22 +0100 Subject: [PATCH] sysadmin zfs: document pool naming rules Signed-off-by: Thomas Lamprecht --- local-zfs.adoc | 15 ++++++++++++--- 1 file changed, 12 insertions(+), 3 deletions(-) diff --git a/local-zfs.adoc b/local-zfs.adoc index 34eb06b..014f587 100644 --- a/local-zfs.adoc +++ b/local-zfs.adoc @@ -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 ---- +[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 <>): ----