Naming ZFS Components

Each ZFS component, such as datasets and pools, must be named according to the following rules:

  • Each component can contain only alphanumeric characters in addition to the following special characters:

    • Underscore (_)

    • Hyphen (-)

    • Colon (:)

    • Period (.)

    • Blank (" ")

      Note:

      Tabs and other white spaces are not valid.
  • Pool names must begin with a letter and can contain only alphanumeric characters as well as underscore (_), dash (-), and period (.). Note the following pool name restrictions:

    • The beginning sequence c [0-9] is not allowed.

    • The name log is reserved.

    • A name that begins with mirror, raidz, raidz1, raidz2, raidz3, or spare is not allowed because these names are reserved.

    • Pool names must not contain a percent sign (%).

  • Dataset names must begin with an alphanumeric character.

  • Dataset names must not contain a percent sign (%).

  • Empty components are not allowed.